Konfigurera Zonos
Registrera er först för ett Zonos-konto och konfigurera ert konto i Zonos Dashboard. Därefter kan ni hämta er API-nyckel, som låter er autentisera mot Zonos API.
Ange basvaluta
För att ge sammanhang om penningbelopp som ingår i en landed cost-förfrågan behöver ni ange förfrågans basvalutakod (som en ISO-valutakod). Detta avser alla monetära värden i förfrågan och i vilken valuta den resulterande landed cost-offerten renderas. Ni hittar en lista över stödda valutor och deras ISO-koder i våra landed cost-dokument.
{ "currency": "USD"}Ange artikeluppgifter
För att få en så exakt landed cost-offert som möjligt med Zonos behöver ni ange så mycket detaljer per artikel som möjligt, inklusive harmoniserade (HS) koder. Generellt gäller att ju mer information ni inkluderar, desto mer exakt blir er offert.
Att ange HS-koder gör att Zonos Landed Cost kan returnera de mest exakta och kompletta beräkningarna, men det är möjligt att uppskatta den faktiska landed cost utan en HS-kod. Observera dock att om era artiklars totalkostnad överstiger de minimis-tröskeln kan en HS-kod krävas. I dessa fall ger en förfrågan utan HS-kod ett fel.
För varje artikel ni vill inkludera i er landed cost-offert lägger ni till en post i arrayen items i förfrågans body.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Lägg till fraktadresser
Platserna för avsändning och mottagning för er sändning krävs för att beräkna landed cost. En fullständig adress krävs för sändningens destination, men att ange avsändningslandet räcker för de flesta landed cost-offerter.
{ "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state": "SP" }}Ange fraktkostnader
Zonos Landed Cost API beräknar inte fraktkostnader — det fokuserar på tullar, skatter och avgifter. Eftersom frakt är en betydande del av en total landed cost-offert och en viktig faktor i hur saker beräknas, är det viktigt att ange fraktkostnaden i förväg. Detta värde kan erhållas genom att använda ett API för fraktprissättning, som Zonos Rating API, eller på flera andra sätt, till exempel er transportörs fraktprogram, pristabeller osv.
Information om fraktkostnader, inklusive det totala fraktbeloppet, skickas via fältet shipping i er API-förfrågan.
{ "shipping": { "amount": 14.23 }}Även om endast beloppet krävs kan ni också ange ett namn på servicenivå för att låta API:et beräkna transportöravgifter utifrån det angivna beloppet. Ni kan se en lista över stödda transportörer och servicenivåer i våra Landed Cost-dokument.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}Skicka en API-förfrågan
Nu när ni har byggt er förfrågan och konfigurerat den kan ni skicka en POST-förfrågan till Zonos Landed Cost API. Se till att autentisera med er API-nyckel och ange rätt versionsheader i er förfrågan.
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"
Beräkna en landed cost
Lär er hur ni begär en landed cost via REST API.REST
Zonos Landed Cost API låter er snabbt få en mycket exakt landed cost-offert för gränsöverskridande import- och exportsändningar. Att ange harmoniserade (HS) koder gör att Zonos Landed Cost kan returnera den mest exakta tullberäkningen, men vi returnerar det ungefärliga beloppet för tullar och skatter även när en harmoniserad kod inte anges.