Sett opp Zonos
Først, registrer deg for en Zonos konto og konfigurer kontoen din på Zonos Dashboard. Du vil da kunne få API-nøkkelen din, som lar deg autentisere deg med Zonos API.
Sett basisvaluta
For å gi kontekst om pengebeløpene som er inkludert i en landed cost forespørsel, må du spesifisere basisvalutakoden for forespørselen din (som en ISO-valutakode). Dette vil referere til alle pengeverdi i forespørselen og hvilken valuta det resulterende landed cost tilbudet vil bli gjengitt i. Du kan finne en liste over støttede valutaer og deres ISO-koder i våre landed cost doku.
Forespørsel
{
"currency": "USD"
}
Gi detaljene for varen
For å få et nøyaktig mulig landed cost tilbud ved bruk av Zonos, må du oppgi så mye per-vare detalj som mulig, inkludert harmoniserte (HS) koder. Generelt, jo mer informasjon du inkluderer, jo mer nøyaktig vil tilbudet ditt være.
Å oppgi HS-koder gjør at Zonos Landed Cost kan returnere de mest nøyaktige og komplette beregningene, men det er mulig å anslå den faktiske landed cost uten en HS-kode. Vær imidlertid oppmerksom på at hvis den totale kostnaden for varene dine overstiger de minimis terskelen, kan en HS-kode være nødvendig. I slike tilfeller vil det å sende en forespørsel uten en HS-kode resultere i en feil.
For hver vare du ønsker å inkludere i ditt landed cost tilbud, legg til en oppføring i items-arrayet i forespørselens kropp.
Forespørsel
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Legg til fraktadresser
Stedene for avsendelse og mottakelse av forsendelsen din er nødvendige for å beregne landed cost. En fullstendig adresse er nødvendig for forsendelsesdestinasjonen, men det er tilstrekkelig å inkludere avsendelseslandet for de fleste landed cost-tilbud.
Forespørsel
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Oppgi fraktkostnader
Zonos Landed Cost API-en beregner ikke fraktkostnader - den fokuserer på tollavgifter, skatter og gebyrer. Fordi frakt er en betydelig del av et totalt landed cost tilbud og en viktig faktor i hvordan ting beregnes, er det avgjørende å spesifisere fraktkostnaden på forhånd. Denne verdien kan oppnås ved å bruke en fraktvurderings-API, som Zonos Rating API, eller ved en rekke andre metoder, som fraktprogramvaren til din transportør, rate tabeller, osv.
Informasjon relatert til fraktkostnader, inkludert det totale fraktbeløpet, sendes via shipping feltet i API-forespørselen din.
Forespørsel
{
"shipping": {
"amount": 14.23
}
}
Mens det kun er beløpet som kreves, kan du også gi et servicenivånavn for å aktivere API-en til å beregne fraktkostnader basert på det oppgitte beløpet. Du kan se en liste over støttede transportører og servicenivåer i våre Landed Cost-dokumenter.
Forespørsel
{
"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 med API-nøkkelen din og gi den riktige versjonshodet i forespørselen din.
POST https://api.zonos.com/v1/landed_cost
Forespørsel
{
"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": "SP"
},
"shipping": {
"amount": 14.23,
"amount_discount": 0,
"service_level": "ups_express_saver"
}
}
Svar
{
"id": "ldct_1AoaDV8MZ8SAmsVFFTWISI",
"amount_subtotal": {
"duties": 53.54,
"fees": 27.64,
"taxes": 33.96
},
"currency": {
"id": "1aad3b7e-c",
"base": "USD",
"date": "2022-09-06T20:57:10.333+0000",
"rates": [
{
"currency": "BRL",
"rate": 5.2499
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"country_of_origin_source": "api_request",
"description_customs": null,
"description_retail": null,
"hs_code": "6116.10.00",
"hs_code_source": "api_request",
"note": "",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "BR"
},
"de_minimis": [
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Duty applies to all shipments",
"threshold": "above",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 45.0,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.538,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "shipping"
}
],
"fees": [
{
"amount": 15.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 12.0,
"description": "UPS Disbursement Fee",
"item_id": null,
"formula": "2.00% of duties & taxes amount with a minimum of 12 usd, whichever is greater",
"note": null,
"type": "advancement"
},
{
"amount": 0.64,
"description": "UPS Currency Conversion Fee",
"item_id": null,
"formula": ".75% of the amount converted",
"note": null,
"type": "currency_conversion_fee"
}
],
"taxes": [
{
"amount": 16.46,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "shipping"
},
{
"amount": 9.88,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the item",
"type": "duty"
},
{
"amount": 1.87,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the shipping",
"type": "duty"
},
{
"amount": 2.63,
"description": "ICMS",
"item_id": null,
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "advancement"
}
],
"removed_items": [],
"remittance": [],
"landedCostGuaranteeCode": "ZONOS"
}
Beregn et landed cost
Lær hvordan du ber om et landed cost via REST API.REST
API-en for Zonos Landed Cost lar deg raskt få et svært nøyaktig landed cost tilbud for grenseoverskridende import- og eksportforsendelser. Ved å oppgi harmoniserte (HS) koder lar Zonos Landed Cost deg returnere den mest nøyaktige beregningen av avgifter, men vi vil returnere det omtrentlige beløpet av avgifter og skatter selv når en harmonisert kode ikke er oppgitt.