Lær hvordan du ber om en landed cost via REST API.
REST
Zonos Landed Cost API lar deg raskt få et svært nøyaktig landed cost-tilbud for grensekryssende import- og eksportforsendelser. Mens det å oppgi harmoniserte (HS) koder gjør det mulig for Zonos Landed Cost å returnere den mest nøyaktige tollberegningen, vil vi returnere det omtrentlige beløpet for toll og skatter selv når en harmonisert kode ikke oppgis.
1
Sett opp Zonos
Først registrerer du deg for en Zonos-konto og konfigurerer kontoen din på Zonos
Dashboard. Du vil da kunne få API-nøkkelen din, som lar deg autentisere deg med Zonos API.
2
Angi basisvaluta
For å gi kontekst til pengebeløpene som inngår i en landed cost-forespørsel, må du angi forespørselens basisvalutakode (som en ISO-valutakode). Denne vil gjelde for alle pengeverdier i forespørselen og avgjøre hvilken valuta det resulterende landed cost-tilbudet blir gjengitt i. Du kan finne en liste over støttede valutaer og deres ISO-koder i vår landed cost-dokumentasjon.
1{
2"currency":"USD"
3}
3
Oppgi varedetaljer
For å få et mest mulig nøyaktig landed cost-tilbud med Zonos, må du oppgi så mange detaljer som mulig per vare, inkludert harmoniserte (HS) koder. Generelt sett blir tilbudet mer nøyaktig jo mer informasjon du inkluderer.
Selv om det å oppgi HS-koder gjør det mulig for Zonos Landed Cost å returnere de mest nøyaktige og fullstendige beregningene, er det mulig å beregne en tilnærmet landed cost uten en HS-kode. Vær imidlertid oppmerksom på at hvis varenes totale kostnad overstiger de minimis-terskelen, kan en HS-kode være påkrevd. I slike tilfeller vil en forespørsel uten HS-kode resultere i en feil.
For hver vare du vil inkludere i landed cost-tilbudet ditt, legger du til en oppføring i items-matrisen i forespørselsteksten.
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
Legg til fraktadresser
Avsender- og mottakerstedene for forsendelsen din er nødvendige for å beregne landed cost. En fullstendig adresse er nødvendig for forsendelsens destinasjon, men det er nok å oppgi avsenderlandet 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
Oppgi fraktkostnader
Zonos Landed Cost API beregner ikke fraktkostnader – det fokuserer på tollavgifter, skatter og gebyrer. Fordi frakt utgjør en betydelig del av et samlet landed cost-tilbud og er en viktig faktor for hvordan beregningene gjøres, er det avgjørende å oppgi fraktkostnaden på forhånd. Denne verdien kan hentes ved hjelp av et fraktprisings-API, for eksempel Zonos Rating API, eller på andre måter, som transportørens fraktprogramvare, prislister osv.
Informasjon knyttet til fraktkostnader, inkludert det totale fraktbeløpet, sendes via shipping-feltet i API-forespørselen din.
1{
2"shipping":{
3"amount":14.23
4}
5}
Selv om det kun er beløpet som er påkrevd, kan du også oppgi et servicenivånavn slik at API-et kan beregne transportørgebyrer basert på det oppgitte beløpet. Du finner en liste over støttede transportører og servicenivåer i vår Landed Cost-dokumentasjon.
1{
2"shipping":{
3"amount":14.23,
4"service_level":"ups_express_saver"
5}
6}
6
Send en API-forespørsel
Nå som du har bygget forespørselen din og konfigurert den, kan du sende en POST-forespørsel til Zonos Landed Cost API. Sørg for å autentisere deg med API-nøkkelen din og oppgi riktig versjonshode i forespørselen din.
Opprett en landed cost
Beregn en landed cost
Lær hvordan du ber om en landed cost via REST API.REST
Zonos Landed Cost API lar deg raskt få et svært nøyaktig landed cost-tilbud for grensekryssende import- og eksportforsendelser. Mens det å oppgi harmoniserte (HS) koder gjør det mulig for Zonos Landed Cost å returnere den mest nøyaktige tollberegningen, vil vi returnere det omtrentlige beløpet for toll og skatter selv når en harmonisert kode ikke oppgis.
Sett opp Zonos
Først registrerer du deg for en Zonos-konto og konfigurerer kontoen din på Zonos Dashboard. Du vil da kunne få API-nøkkelen din, som lar deg autentisere deg med Zonos API.
Angi basisvaluta
For å gi kontekst til pengebeløpene som inngår i en landed cost-forespørsel, må du angi forespørselens basisvalutakode (som en ISO-valutakode). Denne vil gjelde for alle pengeverdier i forespørselen og avgjøre hvilken valuta det resulterende landed cost-tilbudet blir gjengitt i. Du kan finne en liste over støttede valutaer og deres ISO-koder i vår landed cost-dokumentasjon.
{"currency": "USD"}Oppgi varedetaljer
For å få et mest mulig nøyaktig landed cost-tilbud med Zonos, må du oppgi så mange detaljer som mulig per vare, inkludert harmoniserte (HS) koder. Generelt sett blir tilbudet mer nøyaktig jo mer informasjon du inkluderer.
Selv om det å oppgi HS-koder gjør det mulig for Zonos Landed Cost å returnere de mest nøyaktige og fullstendige beregningene, er det mulig å beregne en tilnærmet landed cost uten en HS-kode. Vær imidlertid oppmerksom på at hvis varenes totale kostnad overstiger de minimis-terskelen, kan en HS-kode være påkrevd. I slike tilfeller vil en forespørsel uten HS-kode resultere i en feil.
For hver vare du vil inkludere i landed cost-tilbudet ditt, legger du til en oppføring i
items-matrisen i forespørselsteksten.{"items": [{"id": "294395","amount": 75,"country_of_origin": "FR","description_customs": null,"hs_code": "6116.10.00","quantity": 1}]}Legg til fraktadresser
Avsender- og mottakerstedene for forsendelsen din er nødvendige for å beregne landed cost. En fullstendig adresse er nødvendig for forsendelsens destinasjon, men det er nok å oppgi avsenderlandet for de fleste landed cost-tilbud.
{"ship_from_country": "US","ship_to": {"city": "Campinas","country": "BR","postal_code": "75828-000","state": "SP"}}Oppgi fraktkostnader
Zonos Landed Cost API beregner ikke fraktkostnader – det fokuserer på tollavgifter, skatter og gebyrer. Fordi frakt utgjør en betydelig del av et samlet landed cost-tilbud og er en viktig faktor for hvordan beregningene gjøres, er det avgjørende å oppgi fraktkostnaden på forhånd. Denne verdien kan hentes ved hjelp av et fraktprisings-API, for eksempel Zonos Rating API, eller på andre måter, som transportørens fraktprogramvare, prislister osv.
Informasjon knyttet til fraktkostnader, inkludert det totale fraktbeløpet, sendes via
shipping-feltet i API-forespørselen din.{"shipping": {"amount": 14.23}}Selv om det kun er beløpet som er påkrevd, kan du også oppgi et servicenivånavn slik at API-et kan beregne transportørgebyrer basert på det oppgitte beløpet. Du finner en liste over støttede transportører og servicenivåer i vår Landed Cost-dokumentasjon.
{"shipping": {"amount": 14.23,"service_level": "ups_express_saver"}}Send en API-forespørsel
Nå som du har bygget forespørselen din og konfigurert den, kan du sende en
POST-forespørsel til Zonos Landed Cost API. Sørg for å autentisere deg med API-nøkkelen din og oppgi riktig versjonshode i forespørselen din.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",Var denne siden nyttig?