Atributos
Pares chave/valor JSON no corpo da solicitação
POST | https://api.zonos.com/v1/landed_cost
CABEÇALHO zonos-version: 2019-11-21
O cabeçalho acima é uma entrada obrigatória para que esta solicitação de landed cost seja concluída com sucesso.
| Campo | Notas |
|---|---|
currency OBRIGATÓRIO | A string da moeda base, representada por um código ISO de três letras. |
discounts OPCIONAL | As informações relacionadas a quaisquer descontos, incluindo o id, valor e quaisquer detalhes. |
discounts.id OPCIONAL | O identificador único do desconto para o comerciante ou exportador. |
discounts.amount OPCIONAL | Um decimal com o valor do desconto, em dólares e centavos. |
discounts.detail OPCIONAL | Recursos adicionais, atributos ou descrições do desconto. |
items OBRIGATÓRIO | A lista de itens sendo exportados. hash |
items.id OBRIGATÓRIO | O identificador único do item para o comerciante ou exportador. |
items.amount OBRIGATÓRIO | Um decimal com o total de um único item, em dólares e centavos. |
items.amount_discount OPCIONAL | O valor do desconto que se aplica ao item. |
items.brand OPCIONAL | A marca do item, por exemplo, "Leatherman.” |
items.category OPCIONAL | Descrição da categoria do item, por exemplo, "Vestuário." |
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. Isso é recomendado para obter cotações mais precisas. Se nenhum país de origem for recebido, a Taxa de Nação Mais Favorecida (MFN) rate é usada. |
items.description_customs OPCIONAL | A descrição sugerida dos bens para a fatura comercial. Esta descrição geralmente difere de uma descrição de varejo e normalmente incluirá 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 adicionais, atributos ou descrições do item. |
items.dimensions OPCIONAL | O tamanho do envio. Isso é recomendado para obter cotações mais precisas em países onde as tarifas são impactadas 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 para as dimensões do item. Os valores possíveis são polegada, centímetro, milímetro e nulo. Quando nulo, polegada será usada. |
items.dimensions.width OPCIONAL | Um decimal para a largura do item. |
items.duty_tax_fee_free OPCIONAL | Uma string para especificar se o item não deve ser incluído no cálculo de landed cost. Quando excluir é enviado na solicitação, o item aparecerá em removed_items na resposta da API. |
items.hs_code OPCIONAL | Código HS do item, de 2 a 10 dígitos. |
items.image_url OPCIONAL | A URL da imagem. |
items.quantity OBRIGATÓRIO | Um inteiro com a quantidade do item. |
items.upc_code OPCIONAL | A string do código UPC para o item. |
items.weight OPCIONAL | Um decimal para o peso do item. |
items.weight_unit OPCIONAL | A string da unidade de medida para o peso. Os valores possíveis são libra, onça, quilograma e nulo. Quando nulo, libra será usada. |
landed_cost OPCIONAL | O tipo de solicitação para um landed cost. Os valores possíveis incluem delivery_duty_paid e delivery_duty_unpaid. As taxas para um landed cost podem ser diferentes, seja enviado DDP ou DDU. Se for null, uma solicitação DDP será assumida. Se uma solicitação DDP for feita e DDP não estiver disponível, um erro 400 será retornado com uma mensagem informando que o DDP não está disponível para o nível de serviço fornecido. DDP e DDU geralmente estão disponíveis em cada nível de serviço, portanto, certifique-se de que isso possa ser configurado com base em cada nível de serviço, em vez do nível da conta. |
sale_type OPCIONAL | Um indicador do tipo de venda. Os valores possíveis incluem not_for_resale e for_resale. Se for null, uma solicitação not_for_resale será assumida. |
ship_from_country OBRIGATÓRIO | A string do país de origem, representado por um código ISO de duas letras. |
ship_to OBRIGATÓRIO | O endereço de destino. hash |
ship_to.city OPCIONAL* | Uma string para a cidade, bairro, distrito ou vila do cliente. Dependendo do país de importação, este campo pode ser OBRIGATÓRIO. |
ship_to.country OBRIGATÓRIO | Uma string para o país de destino onde a conta bancária está localizada, representado por um código ISO de duas letras. |
ship_to.postal_code OPCIONAL* | Uma string para o código postal de destino. Este campo pode ser necessário quando o envio é entre a Irlanda do Norte e a União Europeia. |
ship_to.state OPCIONAL* | Uma string para o código do estado de destino, quando disponível. Se o país de importação for Brasil ou Canadá, este campo é obrigatório. |
shipping OBRIGATÓRIO | Os detalhes do envio, como o valor, valor do desconto e nível de serviço com a transportadora. hash |
shipping.amount OBRIGATÓRIO | Um decimal para o total das despesas de envio, em dólares e centavos. |
shipping.amount_discount OPCIONAL | Um decimal para o valor do desconto aplicado ao envio. |
shipping.service_level OBRIGATÓRIO | O nível de serviço com a transportadora. Consulte a documentação da transportadora para a lista completa dos níveis de serviço disponíveis por transportadora. |
*Este campo é opcional, dependendo dos requisitos do campo de endereço para o país de importação.
Exemplo de solicitação
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
{
"currency": "USD",
"discounts": [
{
"id": "sale124",
"amount": 43.0,
"detail": null
}
],
"items": [
{
"id": "294395",
"amount": 75,
"amount_discount": 0,
"brand": null,
"category": "Women's Clothing",
"color": null,
"country_of_origin": "FR",
"description_customs": null,
"description_retail": "Hoka One Running Shoe - Women's",
"detail": null,
"dimensions": {
"height": 4,
"length": 6,
"unit": "inch",
"width": 11
},
"duty_tax_fee_free": null,
"hs_code": "6116.10.00",
"image_url": "https://zonos.com/images/handbag.png",
"quantity": 1,
"upc_code": null,
"weight": 10,
"weight_unit": "pound"
},
{
"id": "294396",
"amount": 15,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Men's t-shirt 100% polyester",
"description_retail": "Galaxy Quest Men's Tee Blue",
"detail": null,
"dimensions": {
"height": 4,
"lenght": 6,
"unit": "inch",
"width": 11
},
"duty_tax_fee_free": "exclude",
"hs_code": "6217.10",
"image_url": null,
"note": null,
"quantity": 1,
"upc_code": null,
"weight": 1,
"weight_unit": "pound"
}
],
"landed_cost": "delivery_duty_paid",
"sale_type": "not_for_resale",
"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"
},
"tariff_rate": "zonos_preferred"
}
Resposta de exemplo
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
{
"id": "ldct_eab3008d-a8ca-4bd7-bf6d-cd178fe3cd77",
"amount_subtotal": {
"duties": 27.74,
"fees": 15.33,
"taxes": 16.23
},
"currency": {
"id": "curr_8fb20952-d",
"base": "USD",
"date": "2019-11-04T20:42:40.999+0000",
"rates": [
{
"currency": "BRL",
"rate": 0.2274
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 32.0,
"country_of_origin": "FR",
"country_of_origin_source": null,
"description_customs": "Women's Tennis Shoe",
"description_retail": "Hoka One Running Shoe - Women's",
"detail": null,
"dimensions": {
"height": 4.0,
"length": 6.0,
"unit": "inch",
"width": 11.0
},
"hs_code": "6116.10.00",
"hs_code_source": "account_default",
"image_url": "https://zonos.com/images/handbag.png",
"note": null,
"quantity": 1,
"upc_code": null,
"weight": 10.0,
"weight_unit": "pound"
}
],
"ship_to_country": "BR",
"shipping_amount": 14.23
},
"de_minimis": [
{
"formula": "Less than 0 BRL",
"method": "FOB",
"note": null,
"threshold": "above",
"type": "duty"
},
{
"formula": "Less than 0 BRL",
"method": "FOB",
"note": null,
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 19.2,
"description": "duty",
"formula": "60%",
"item_id": "294395",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.54,
"description": "Duty",
"formula": "60%",
"item_id": null,
"note": null,
"type": "shipping"
}
],
"fees": [
{
"amount": 22.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"formula": "15 USD",
"item_id": null,
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 0.33,
"description": "UPS Currency Conversion Fee",
"formula": ".75% of the amount converted",
"item_id": null,
"note": null,
"type": "currency_conversion_fee"
}
],
"removed_items": [
{
"id": "294396",
"amount": 15,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Men's t-shirt 100% polyester",
"description_retail": "Galaxy Quest Men's Tee Blue",
"hs_code": "6217.10",
"hs_code_source": "account_default",
"note": null,
"quantity": 1
}
],
"remittance": [],
"taxes": [
{
"amount": 7.02,
"description": "ICMS",
"formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"item_id": "294395",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"item_id": null,
"note": null,
"type": "shipping"
},
{
"amount": 6.09,
"description": "ICMS",
"formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"item_id": null,
"note": null,
"type": "duty"
}
]
}
Solicite um landed cost
Encontre os pares chave/valor em uma solicitação de landed cost.
Embora o Zonos Landed Cost seja capaz de fornecer um landed cost preciso com base apenas na descrição de um item, quanto mais informações forem fornecidas, mais precisa será a cotação de landed cost. Abaixo estão entradas OBRIGATÓRIAS e OPCIONAIS, mas é recomendável preencher o máximo possível de campos OPCIONAIS.