Opsæt Zonos
Først skal du registrere dig for en Zonos konto og konfigurere din konto på Zonos Dashboard. Du vil derefter kunne få din API-nøgle, som vil give dig mulighed for at autentificere dig med Zonos API'en.
Sæt basisvaluta
For at give kontekst om pengebeløb, der er inkluderet i en landed cost anmodning, skal du angive din anmodnings basisvaluta kode (som en ISO valuta kode). Dette vil referere til alle monetære værdier i anmodningen og hvilken valuta det resulterende landed cost tilbud vil blive gengivet i. Du kan finde en liste over understøttede valutaer og deres ISO koder i vores landed cost docs.
Anmodning
{
"currency": "USD"
}
Angiv vareoplysninger
For at få et så præcist muligt landed cost tilbud ved hjælp af Zonos, skal du angive så mange detaljer pr. vare som muligt, herunder harmoniserede (HS) koder. Generelt gælder det, jo mere information du inkluderer, jo mere præcist vil dit tilbud være.
Selvom det at angive HS koder gør det muligt for Zonos Landed Cost at returnere de mest præcise og komplette beregninger, er det muligt at approximere den faktiske landed cost uden en HS kode. Vær dog opmærksom på, at hvis den samlede omkostning for dine varer overstiger de minimis grænsen, kan en HS kode være nødvendig. I sådanne tilfælde vil det at sende en anmodning uden en HS kode resultere i en fejl.
For hver vare, du ønsker at inkludere i dit landed cost tilbud, skal du tilføje en post til items arrayet i anmodningskroppen.
Anmodning
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Tilføj forsendelsesadresser
Forsendelsesstederne for din forsendelse er nødvendige for at beregne landed cost. En fuldstændig adresse er nødvendig for forsendelsesdestinationen, men det er tilstrækkeligt at inkludere afsendelseslandet for de fleste landed cost tilbud.
Anmodning
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Angiv forsendelsesomkostninger
API'en Zonos Landed Cost beregner ikke forsendelsesomkostninger - den fokuserer på told, skatter og gebyrer. Da forsendelse er en betydelig del af et samlet landed cost tilbud og en væsentlig faktor i, hvordan tingene beregnes, er det vigtigt at angive forsendelsesomkostningen på forhånd. Denne værdi kan opnås ved at bruge en forsendelsesvurderings-API, såsom Zonos Rating API, eller ved en række andre midler, såsom din transportørs forsendelsessoftware, rate diagrammer osv.
Oplysninger vedrørende forsendelsesomkostninger, herunder det samlede forsendelsesbeløb, sendes via feltet shipping i din API-anmodning.
Anmodning
{
"shipping": {
"amount": 14.23
}
}
Mens kun beløbet er påkrævet, kan du også angive et serviceniveau navn for at muliggøre, at API'en kan beregne transportørgebyrer baseret på det angivne beløb. Du kan se en liste over understøttede transportører og serviceniveauer i vores Landed Cost docs.
Anmodning
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Send an API request
Nu hvor du har opbygget din anmodning og konfigureret den, kan du sende en POST anmodning til Zonos Landed Cost API'en. Sørg for at autentificere med din API-nøgle og give den korrekte versionsheader i din anmodning.
POST https://api.zonos.com/v1/landed_cost
Anmodning
{
"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 anmoder om et landed cost via REST API'en.REST
API'en for Zonos Landed Cost giver dig mulighed for hurtigt at få et meget præcist landed cost tilbud til grænseoverskridende import- og eksportforsendelser. Mens det at give harmoniserede (HS) koder gør det muligt for Zonos Landed Cost at returnere den mest præcise toldberegning, vil vi returnere det omtrentlige beløb af told og skatter, selv når en harmoniseret kode ikke er angivet.