Configurar o Zonos
Primeiro, registre-se para obter uma conta da Zonos e configure sua conta no Zonos Dashboard. Depois, você poderá obter sua chave de API, que lhe permitirá autenticar-se com a API de Zonos.
Definir a moeda base
Para fornecer contexto sobre os montantes monetários incluídos num pedido de Landed Cost, deve especificar o código de moeda de base do seu pedido (como código de moeda ISO). Isto aplica-se a todos os valores monetários do pedido e à moeda em que será apresentada a cotação de Landed Cost resultante. Você pode encontrar uma lista de moedas admitidas e seus códigos ISO em nossa documentação do Landed Cost.
{ "currency": "USD"}Fornecer detalhes de artigos
Para obter uma cotação de Landed Cost o mais precisa possível com Zonos, deve fornecer o maior detalhe possível por artigo, incluindo os códigos harmonizados (HS). Em geral, quanto mais informação inclua, mais precisa será sua cotação.
Embora o fornecimento de códigos HS permita que a Zonos Landed Cost retorne os cálculos mais precisos e completos, é possível aproximar o Landed Cost real sem um código HS. No entanto, tenha em conta que se o custo total dos seus artigos exceder o limiar de minimis, pode ser necessário um código HS. Nesses casos, enviar um pedido sem código HS dará como resultado um erro.
Para cada artigo que deseje incluir na sua cotação de Landed Cost, adicione uma entrada à matriz items no corpo do pedido.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Adicionar endereços de envio
Os locais de envio de origem e destino são necessários para calcular o Landed Cost. É necessário um endereço completo para o destino da expedição, mas incluir o país de origem é suficiente para a maioria das cotações de Landed Cost.
{ "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state": "SP" }}Fornecer custos de envio
A API de Zonos Landed Cost não calcula os custos de envio; centra-se em tarifas, impostos e taxas aduaneiras. Uma vez que o envio é um aspecto considerável de uma cotação total de Landed Cost e um fator significativo nos cálculos, é essencial especificar o custo de envio adiantado. Este valor pode ser obtido através de uma API de tarifação de envio, como a API de Rating de Zonos, ou por outros meios, como o software de envio do seu transportador, tabelas de tarifas, etc.
A informação relacionada com os custos de envio, incluindo o montante total de envio, é enviada através do campo shipping no seu pedido de API.
{ "shipping": { "amount": 14.23 }}Embora apenas seja necessário o montante, você também pode fornecer um nome de nível de serviço para que a API calcule as taxas do transportador sobre o valor fornecido. Você pode ver uma lista de transportadores e níveis de serviço admitidos em nossa documentação do Landed Cost.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}Enviar um pedido de API
Depois de ter construído e configurado o seu pedido, você pode enviar um pedido POST à API de Zonos Landed Cost. Certifique-se de autenticar-se com a sua chave de API e fornecer o cabeçalho de versão correto no seu pedido.
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",
Calcular um Landed Cost
Aprenda a solicitar um Landed Cost através da API REST.REST
A API de Zonos Landed Cost permite-lhe obter rapidamente uma cotação de Landed Cost muito precisa para remessas de importação e exportação transfronteiriças. Embora o fornecimento de códigos harmonizados (HS) permita que a Zonos Landed Cost retorne o cálculo de tarifas mais preciso, retornaremos o montante aproximado de tarifas e impostos mesmo que não seja fornecido um código harmonizado.