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.
1
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.
2
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.
1{
2"currency":"USD"
3}
3
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.
1{
2"items":[
3{
4"id":"294395",
5"amount":75,
6"country_of_origin":"FR",
7"description_customs":null,
8"hs_code":"6116.10.00",
9"quantity":1
10}
11]
12}
4
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.
1{
2"ship_from_country":"US",
3"ship_to":{
4"city":"Campinas",
5"country":"BR",
6"postal_code":"75828-000",
7"state":"SP"
8}
9}
5
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.
1{
2"shipping":{
3"amount":14.23
4}
5}
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.
1{
2"shipping":{
3"amount":14.23,
4"service_level":"ups_express_saver"
5}
6}
6
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.
Opret en landed cost
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.
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
shippingi 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"Var denne side nyttig?