Konfigurer Zonos
Registrer først en Zonos-konto, og konfigurer din konto på Zonos Dashboard. Derefter kan du hente din API-nøgle, som giver dig mulighed for at autentificere mod Zonos API.
Angiv basisvaluta
For at give kontekst om pengebeløb i en landed cost-anmodning skal du angive anmodningens basisvalutakode (som en ISO-valutakode). Dette gælder alle pengebeløb i anmodningen og den valuta, som det resulterende landed cost-tilbud vises i. Du kan finde en liste over understøttede valutaer og deres ISO-koder i vores landed cost-dokumentation.
{ "currency": "USD"}Angiv varedetaljer
For at få et så præcist landed cost-tilbud som muligt med Zonos skal du angive så mange oplysninger pr. vare som muligt, herunder harmoniserede (HS) koder. Generelt gælder det, at jo flere oplysninger du inkluderer, jo mere præcist bliver dit tilbud.
Selvom HS-koder gør det muligt for Zonos Landed Cost at returnere de mest præcise og komplette beregninger, er det muligt at estimere den faktiske landed cost uden en HS-kode. Bemærk dog, at hvis dine varers samlede omkostning overstiger de minimis-grænsen, kan en HS-kode være påkrævet. I disse tilfælde vil en anmodning uden HS-kode resultere i en fejl.
For hver vare, du vil inkludere i dit landed cost-tilbud, skal du tilføje en
post til items-arrayet i anmodningens body.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Tilføj forsendelsesadresser
Afsendelses- og modtagerlokationerne for din forsendelse er påkrævede for at beregne landed cost. En fuldstændig adresse er påkrævet for forsendelsens destination, men det er tilstrækkeligt at inkludere afsenderlandet for de fleste landed cost-tilbud.
{ "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state": "SP" }}Angiv forsendelsesomkostninger
Zonos Landed Cost API beregner ikke forsendelsesomkostninger — det fokuserer på told, skatter og gebyrer. Fordi forsendelse er en væsentlig del af et samlet landed cost-tilbud og en vigtig faktor i beregningerne, er det afgørende at angive forsendelsesomkostningen på forhånd. Denne værdi kan hentes ved hjælp af et forsendelsesrating-API, såsom Zonos Rating API, eller på andre måder, f.eks. din carriers forsendelsessoftware, prislister osv.
Oplysninger om forsendelsesomkostninger, herunder det samlede
forsendelsesbeløb, sendes via feltet shipping i din API-anmodning.
{ "shipping": { "amount": 14.23 }}Selvom kun beløbet er påkrævet, kan du også angive et service level-navn, så API'et kan beregne carrier-gebyrer ud fra det angivne beløb. Du kan se en liste over understøttede carriers og service levels i vores Landed Cost-dokumentation.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}Send en API-anmodning
Nu hvor du har bygget og konfigureret din anmodning, kan du sende en
POST-anmodning til Zonos Landed Cost API. Sørg for at autentificere med din
API-nøgle og angive den korrekte versionsheader i din anmodning.
POST https://api.zonos.com/v1/landed_cost
{ "currency": "USD", "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ], "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state"
Beregn en landed cost
Lær hvordan du anmoder om en landed cost via REST API'en.REST
Zonos Landed Cost API giver dig mulighed for hurtigt at få et meget præcist landed cost-tilbud til grænseoverskridende import- og eksportforsendelser. Selvom angivelse af harmoniserede (HS) koder gør det muligt for Zonos Landed Cost at returnere den mest præcise toldberegning, returnerer vi det omtrentlige beløb for told og skatter, selv når der ikke er angivet en harmoniseret kode.