Configure o Zonos
Primeiramente, registre-se para uma conta do Zonos e configure sua conta no Painel do Zonos. Em seguida, você poderá obter sua chave de API, que permitirá que você se autentique na API do 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 de landed cost resultante será exibida. Você pode encontrar uma lista de moedas suportadas e seus códigos ISO em nossos documentos 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
}
}
Embora apenas a quantidade seja necessária, 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 na quantidade fornecida. Você pode ver uma lista de transportadoras suportadas e níveis de serviço em nossa documentação 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 a API REST.REST
A API do Zonos Landed Cost permite que você obtenha rapidamente uma cotação altamente precisa de landed cost para remessas de importação e exportação transfronteiriças. Ao fornecer códigos harmonizados (NCM), o Zonos Landed Cost consegue retornar o cálculo de impostos mais preciso, mas iremos retornar uma estimativa dos impostos mesmo quando um código harmonizado não for fornecido.