Atributos
Pares clave/valor JSON en el cuerpo de la solicitud
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
El encabezado anterior es una entrada requerida para que esta solicitud de landed cost se complete con éxito.
| Campo | Notas |
|---|---|
currency REQUERIDO | La cadena de moneda base, representada por un código ISO de tres letras. |
discounts OPCIONAL | La información relacionada con cualquier descuento, incluyendo el id, monto y cualquier detalle. |
discounts.id OPCIONAL | El identificador único del descuento para el comerciante o exportador. |
discounts.amount OPCIONAL | Un decimal con el monto del descuento, en dólares y centavos. |
discounts.detail OPCIONAL | Características adicionales, atributos o descripciones del descuento. |
items REQUERIDO | La lista de artículos que se exportan. hash |
items.id REQUERIDO | El identificador único del artículo para el comerciante o exportador. |
items.amount REQUERIDO | Un decimal con el total de un solo artículo, en dólares y centavos. |
items.amount_discount OPCIONAL | El monto del descuento que se aplica al artículo. |
items.brand OPCIONAL | La marca del artículo, por ejemplo "Leatherman”. |
items.category OPCIONAL | Descripción de la categoría del artículo, por ejemplo "Ropa." |
items.color OPCIONAL | Color del artículo. |
items.country_of_origin OPCIONAL | El país de fabricación o producción, representado por un código ISO de dos letras. Esto se recomienda para obtener cotizaciones más precisas. Si no se recibe ningún país de origen, se utilizará la Nación Más Favorecida (MFN) rate. |
items.description_customs OPCIONAL | La descripción sugerida de los bienes para la factura comercial. Esta descripción suele ser diferente de una descripción minorista y generalmente incluirá una descripción general de qué es, de qué está hecho y para qué se utiliza. |
items.description_retail OPCIONAL | La descripción minorista del artículo. |
items.detail OPCIONAL | Características adicionales, atributos o descripciones del artículo. |
items.dimensions OPCIONAL | El tamaño del envío. Se recomienda para obtener cotizaciones más precisas en países donde los aranceles se ven afectados por las dimensiones del artículo. hash |
items.dimensions.height OPCIONAL | Un decimal para la altura del artículo. |
items.dimensions.length OPCIONAL | Un decimal para la longitud del artículo. |
items.dimensions.unit OPCIONAL | La unidad de medida para las dimensiones del artículo. Los valores posibles son pulgada, centímetro, milímetro y nulo. Cuando es nulo, se usará pulgada. |
items.dimensions.width OPCIONAL | Un decimal para el ancho del artículo. |
items.duty_tax_fee_free OPCIONAL | Una cadena para especificar si el artículo no debe incluirse en el cálculo de landed cost. Cuando se envía excluir en la solicitud, el artículo aparecerá en removed_items en la respuesta de la API. |
items.hs_code OPCIONAL | Código HS del artículo, de 2 a 10 dígitos. |
items.image_url OPCIONAL | La URL de la imagen. |
items.quantity REQUERIDO | Un entero con la cantidad del artículo. |
items.upc_code OPCIONAL | La cadena de código UPC para el artículo. |
items.weight OPCIONAL | Un decimal para el peso del artículo. |
items.weight_unit OPCIONAL | La cadena de unidad de medida para el peso. Los valores posibles son libra, onza, kilogramo y nulo. Cuando es nulo, se usará libra. |
landed_cost OPCIONAL | El tipo de solicitud para un landed cost. Los valores posibles incluyen delivery_duty_paid y delivery_duty_unpaid. Las tarifas para un landed cost pueden diferir, ya sea que se envíe DDP o DDU. Si es null, se asumirá una solicitud DDP. Si se realiza una solicitud DDP y DDP no está disponible, se devolverá un error 400 con un mensaje que indique que DDP no está disponible para el nivel de servicio proporcionado.DDP y DDU suelen estar disponibles en cada nivel de servicio, así que asegúrese de que esto se pueda configurar en función del nivel de servicio en lugar del nivel de cuenta. |
sale_type OPCIONAL | Un indicador del tipo de venta. Los valores posibles incluyen not_for_resale y for_resale. Si es null, se asumirá una solicitud not_for_resale. |
ship_from_country REQUERIDO | La cadena del país de envío, representado por un código ISO de dos letras. |
ship_to REQUERIDO | La dirección de destino. hash |
ship_to.city OPCIONAL* | Una cadena para la ciudad, pueblo, distrito, suburbio o aldea de la dirección del cliente. Dependiendo del país de importación, este campo puede ser REQUERIDO. |
ship_to.country REQUERIDO | Una cadena para el país de destino en el que se encuentra la cuenta bancaria, representado por un código ISO de dos letras. |
ship_to.postal_code OPCIONAL* | Una cadena para el código postal de destino. Este campo puede ser requerido cuando el envío es entre Irlanda del Norte y la Unión Europea. |
ship_to.state OPCIONAL* | Una cadena para el código de estado de destino cuando esté disponible. Si el país de importación es Brasil o Canadá, este campo es requerido. |
shipping REQUERIDO | Los detalles de envío como el monto, monto de descuento y nivel de servicio con el transportista. hash |
shipping.amount REQUERIDO | Un decimal para el total de los costos de envío, en dólares y centavos. |
shipping.amount_discount OPCIONAL | Un decimal para el monto del descuento que se aplica al envío. |
shipping.service_level REQUERIDO | El nivel de servicio con el transportista. Consulte la documentación del transportista para ver la lista completa de niveles de servicio disponibles por transportista. |
*Este campo es opcional dependiendo de los requisitos del campo de dirección para el país de importación.
Solicitud de ejemplo
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"
}
Respuesta de ejemplo
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"
}
]
}
Solicita un landed cost
Encuentra los pares clave/valor en una solicitud de landed cost.
Aunque Zonos Landed Cost es capaz de proporcionar un landed cost preciso basado únicamente en la descripción de un artículo, cuanta más información se proporcione, más precisa será la cotización de landed cost. A continuación se presentan entradas OBLIGATORIAS y OPCIONALES, pero se recomienda completar tantos campos OPCIONALES como sea posible.