Atributos
Pares de chave/valor JSON no corpo da solicitação
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
O cabeçalho acima é uma entrada necessária para que esta solicitação de landed cost seja concluída com êxito.
| Campo↕ | Notas↕ |
|---|---|
currency NECESSÁRIO | A cadeia de moeda base, representada por um código ISO de três letras. |
discounts OPCIONAL | Informações relativas a qualquer desconto, incluindo identificação, valor e quaisquer detalhes. |
discounts.id OPCIONAL | O identificador exclusivo de desconto do comerciante ou exportador. |
discounts.amount OPCIONAL | Um decimal com o valor do desconto, em dólares e centavos. |
discounts.detail OPCIONAL | Recursos, atributos ou descrições adicionais do desconto. |
items NECESSÁRIO | A lista de itens que são exportados. hash |
items.id NECESSÁRIO | O identificador exclusivo do item do comerciante ou exportador. |
items.amount NECESSÁRIO | Um decimal com o total de um único item, em dólares e centavos. |
items.amount_discount OPCIONAL | O valor do desconto aplicado ao item. |
items.brand OPCIONAL | A marca do item, por exemplo, Leatherman. |
items.category OPCIONAL | Descrição da categoria do item, por exemplo, Roupas. |
items.color OPCIONAL | Cor do item. |
items.country_of_origin OPCIONAL | O país de fabricação ou produção, representado por um código ISO de duas letras. É recomendado para cotações mais precisas. Se nenhum país de origem for recebido, será utilizada a taxa da nação mais favorecida (NMF). |
items.description_customs OPCIONAL | A descrição sugerida de mercadorias para a fatura comercial. Esta descrição geralmente difere de uma descrição de varejo e normalmente inclui uma descrição geral do que é, do que é feito e para que é usado. |
items.description_retail OPCIONAL | A descrição de varejo do item. |
items.detail OPCIONAL | Recursos, atributos ou descrições adicionais do item. |
items.dimensions OPCIONAL | O tamanho do envio. Recomenda-se obter cotações mais precisas para países onde as tarifas são afetadas pelas dimensões do item. hash |
items.dimensions.height OPCIONAL | Um decimal para a altura do item. |
items.dimensions.length OPCIONAL | Um decimal para o comprimento do item. |
items.dimensions.unit OPCIONAL | A unidade de medida das dimensões do item. Valores possíveis: inch, centimeter, millimeter e null. Quando for null, inch será usado. |
items.dimensions.width OPCIONAL | Um decimal para a largura do item. |
items.duty_tax_fee_free OPCIONAL | Uma sequência para especificar se o item não deve ser incluído no cálculo do landed cost. Quando exclude for enviado na solicitação, o item aparecerá como removed_items na resposta da API. |
items.hs_code OPCIONAL | Código HS do artigo, de 2 a 10 dígitos. |
items.image_url OPCIONAL | O URL da imagem. |
items.quantity NECESSÁRIO | Um número inteiro com a quantidade do item. |
items.upc_code OPCIONAL | A sequência de código UPC do item. |
items.weight OPCIONAL | Um decimal para o peso do item. |
items.weight_unit OPCIONAL | A unidade de cadeia de medida para peso. Valores possíveis: pound, ounce, kilogram e null. Quando for null, pound será usado. |
landed_cost OPCIONAL | O tipo de solicitação de landed cost. Os valores possíveis incluem delivery_duty_paid e delivery_duty_unpaid. As taxas de um landed cost podem diferir dependendo do envio de DDP ou DDU. Se for null, será assumida uma solicitação DDP. Se uma solicitação DDP for feita e o DDP não estiver disponível, um erro 400 será retornado com uma mensagem indicando que o DDP não está disponível para o nível de serviço fornecido. DDP e DDU normalmente estão disponíveis em cada nível de serviço, portanto, certifique-se de que isso possa ser configurado por nível de serviço e não por nível de conta. |
sale_type OPCIONAL | Um indicador do tipo de venda. Valores possíveis: not_for_resale for_resale. Se for null, será assumida uma solicitação not_for_resale. |
ship_from_country NECESSÁRIO | A string do país de origem da remessa, representada por um código ISO de duas letras. |
ship_to NECESSÁRIO | O endereço de destino. hash |
ship_to.city OPCIONAL* | Uma rede para a cidade, vila, distrito, subúrbio ou vila do cliente. Dependendo do país de importação, este campo pode ser OBRIGATÓRIO. |
ship_to.country NECESSÁRIO | Uma string para o país de destino no qual a conta bancária está localizada, representada por um código ISO de duas letras. |
ship_to.postal_code OPCIONAL* | Uma string para o CEP de destino. Este campo pode ser obrigatório em envios entre a Irlanda do Norte e a União Europeia. |
ship_to.state OPCIONAL* | Uma string para o código de status de destino, quando disponível. Se o país de importação for Brasil ou Canadá, este campo é obrigatório. |
shipping NECESSÁRIO | Detalhes de envio como valor, valor do desconto e nível de serviço com a transportadora. hash |
shipping.amount NECESSÁRIO | Uma casa decimal para o valor total dos custos de envio, em dólares e centavos. |
shipping.amount_discount OPCIONAL | Um decimal para o valor do desconto aplicado ao frete. |
shipping.service_level NECESSÁRIO | O service_level com a operadora. Consulte a documentação da operadora para obter a lista completa de níveis de serviço disponíveis por operadora. |
*Este campo é opcional dependendo dos requisitos do campo de endereço do país importador.
1
{2
"currency": "USD",3
"discounts": [4
{5
"id": "sale124",6
"amount": 43,7
"detail": null8
}9
],10
"items": [11
{12
"id": "294395",13
"amount": 75,14
"amount_discount": 0,15
"brand": null,16
"category": "Women's Clothing",17
"color": null,18
"country_of_origin": "FR",19
"description_customs": null,20
"description_retail": "Hoka One Running Shoe - Women's",21
"detail": null,22
"dimensions": {23
"height": 4,24
"length": 6,25
"unit": "inch",26
"width": 1127
},28
"duty_tax_fee_free": null,29
"hs_code": "6116.10.00",30
"image_url": "https://zonos.com/images/handbag.webp",31
"quantity": 1,32
"upc_code": null,33
"weight": 10,34
"weight_unit": "pound"35
},36
{37
"id": "294396",38
"amount": 15,39
"country_of_origin": "CN",40
"country_of_origin_source": "account_default",41
"description_customs": "Men's t-shirt 100% polyester",42
"description_retail": "Galaxy Quest Men's Tee Blue",43
"detail": null,44
"dimensions": {45
"height": 4,46
"lenght": 6,47
"unit": "inch",48
"width": 1149
},50
"duty_tax_fee_free": "exclude",51
"hs_code": "6217.10",52
"image_url": null,53
"note": null,54
"quantity": 1,55
"upc_code": null,56
"weight": 1,57
"weight_unit": "pound"58
}59
],60
"landed_cost": "delivery_duty_paid",61
"sale_type": "not_for_resale",62
"ship_from_country": "US",63
"ship_to": {64
"city": "Campinas",65
"country": "BR",66
"postal_code": "75828-000",67
"state": "SP"68
},69
"shipping": {70
"amount": 14.23,71
"amount_discount": 0,72
"service_level": "ups_express_saver"73
},74
"tariff_rate": "zonos_preferred"75
}
Solicitar um Landed Cost
Encontre os pares chave/valor em uma solicitação de landed cost.
Embora Zonos Landed Cost possa fornecer um landed cost preciso com base apenas na descrição do item, quanto mais informações forem fornecidas, mais precisa será a cotação do landed cost. As entradas OBRIGATÓRIAS e OPCIONAIS estão listadas abaixo, mas é recomendado que você preencha o máximo possível de campos OPCIONAIS.