Configure Zonos
Primeiro, registre-se para uma conta Zonos e configure sua conta no Zonos Dashboard. Você poderá então obter sua chave API, que permitirá que você se autentique com a API Zonos.
Defina a moeda base
Para fornecer contexto sobre os valores monetários incluídos em uma solicitação de landed cost, você precisa especificar o código da moeda base da sua solicitação (como um código de moeda ISO). Isso se referirá a todos os valores monetários na solicitação e em qual moeda a cotação resultante de landed cost será apresentada. Você pode encontrar uma lista de moedas suportadas e seus códigos ISO em nossa documentação de landed cost.
Solicitação
{
"currency": "USD"
}
Fornecer detalhes do item
Para obter uma cotação de custo total possível landed cost precisa usando Zonos, você precisará fornecer o máximo de detalhes por item possível, incluindo códigos harmonizados (HS). Geralmente, quanto mais informações você incluir, mais precisa será sua cotação.
Ao fornecer códigos HS, permite que Zonos Landed Cost retorne os cálculos mais precisos e completos, é possível aproximar o custo total real landed cost sem um código HS. No entanto, observe que se o custo total dos seus itens exceder o limite de minimis, um código HS pode ser necessário. Nestes casos, enviar uma solicitação sem um código HS resultará em um erro.
Para cada item que você deseja incluir em sua cotação de landed cost, adicione uma entrada à matriz items no corpo da solicitação.
Solicitação
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Adicionar endereços de entrega
Os locais de envio e entrega para o seu envio são necessários para calcular o landed cost. Um endereço completo é necessário para o destino do envio, mas incluir o país de origem é suficiente para a maioria das cotações de landed cost.
Solicitação
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Fornecer custos de envio
A API Zonos Landed Cost não calcula os custos de envio - ela se concentra em taxas alfandegárias, impostos e taxas. Como o envio é um aspecto considerável de uma cotação de custo total landed cost e um fator significativo na forma como as coisas são calculadas, é essencial especificar o custo de envio antecipadamente. Esse valor pode ser obtido usando uma API de classificação de remessa, como a API de Classificação Zonos, ou por meio de uma variedade de outros meios, como o software de envio da sua transportadora, tabelas de rate, etc.
As informações relacionadas aos custos de envio, incluindo o valor total do envio, são enviadas por meio do campo shipping em sua solicitação de API.
Solicitação
{
"shipping": {
"amount": 14.23
}
}
Enquanto apenas o valor é necessário, você também pode fornecer um nome de nível de serviço para permitir que a API calcule as taxas do transportador com base no valor fornecido. Você pode ver uma lista de transportadoras e níveis de serviço suportados em nossa documentação do Landed Cost.
Solicitação
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Enviar uma solicitação de API
Agora que você construiu sua solicitação e a configurou, você pode enviar uma solicitação POST para a API de Zonos Landed Cost. Certifique-se de autenticar com sua chave de API e fornecer o cabeçalho de versão correto em sua solicitação.
POST https://api.zonos.com/v1/landed_cost
Solicitação
{
"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"
}
}
Resposta
{
"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"
}
Calcule um landed cost
Aprenda como solicitar um landed cost via REST API.REST
A API Zonos Landed Cost permite que você obtenha rapidamente uma cotação de landed cost altamente precisa para remessas de importação e exportação transfronteiriças. Embora fornecer códigos harmonizados (HS) permita que Zonos Landed Cost retorne o cálculo de impostos mais preciso, nós retornaremos o valor aproximado de impostos e taxas mesmo quando um código harmonizado não for fornecido.