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 un dato de entrada obligatorio para que esta solicitud de landed cost se complete correctamente.
| Campo↕ | Notas↕ |
|---|---|
currency REQUIRED | La cadena de moneda base, representada por un código ISO de tres letras. |
discounts OPTIONAL | La información relacionada con cualquier descuento, incluido el id, el monto y cualquier detalle. |
discounts.id OPTIONAL | El identificador único de descuento del comerciante o exportador. |
discounts.amount OPTIONAL | Un decimal con el monto del descuento, en dólares y centavos. |
discounts.detail OPTIONAL | Características, atributos o descripciones adicionales del descuento. |
items REQUIRED | La lista de artículos que se exportan. hash |
items.id REQUIRED | El identificador único del artículo del comerciante o exportador. |
items.amount REQUIRED | Un decimal con el total de un solo artículo, en dólares y centavos. |
items.amount_discount OPTIONAL | El monto del descuento que se aplica al artículo. |
items.brand OPTIONAL | La marca del artículo, p. ej., Leatherman. |
items.category OPTIONAL | Descripción de categoría del artículo, p. ej., Clothing. |
items.color OPTIONAL | Color del artículo. |
items.country_of_origin OPTIONAL | El país de fabricación o producción, representado por un código ISO de dos letras. Se recomienda para las cotizaciones más precisas. Si no se recibe país de origen, se utiliza la tasa de nación más favorecida (MFN). |
items.description_customs OPTIONAL | La descripción sugerida de mercancías para la factura comercial. Esta descripción suele diferir de una descripción minorista e incluirá normalmente una descripción general de qué es, de qué está hecho y para qué se utiliza. |
items.description_retail OPTIONAL | La descripción minorista del artículo. |
items.detail OPTIONAL | Características, atributos o descripciones adicionales del artículo. |
items.dimensions OPTIONAL | El tamaño del envío. Se recomienda para obtener las cotizaciones más precisas a países donde los aranceles se ven afectados por las dimensiones del artículo. hash |
items.dimensions.height OPTIONAL | Un decimal para la altura del artículo. |
items.dimensions.length OPTIONAL | Un decimal para la longitud del artículo. |
items.dimensions.unit OPTIONAL | La unidad de medida para las dimensiones del artículo. Valores posibles: inch, centimeter, millimeter y null. Cuando es null, se utilizará inch. |
items.dimensions.width OPTIONAL | Un decimal para el ancho del artículo. |
items.duty_tax_fee_free OPTIONAL | Una cadena para especificar si el artículo no debe incluirse en el cálculo de landed cost. Cuando se envía exclude en la solicitud, el artículo aparecerá en removed_items en la respuesta de la API. |
items.hs_code OPTIONAL | Código HS del artículo, de 2 a 10 dígitos. |
items.image_url OPTIONAL | La URL de la imagen. |
items.quantity REQUIRED | Un entero con la cantidad del artículo. |
items.upc_code OPTIONAL | La cadena de código UPC del artículo. |
items.weight OPTIONAL | Un decimal para el peso del artículo. |
items.weight_unit OPTIONAL | La cadena de unidad de medida para el peso. Valores posibles: pound, ounce, kilogram y null. Cuando es null, se utilizará pound. |
landed_cost OPTIONAL | El tipo de solicitud de landed cost. Los valores posibles incluyen delivery_duty_paid y delivery_duty_unpaid. Las tasas de un landed cost pueden diferir según 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 indica 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 por nivel de servicio en lugar de a nivel de cuenta. |
sale_type OPTIONAL | Un indicador del tipo de venta. Valores posibles: not_for_resale for_resale. Si es null, se asumirá una solicitud not_for_resale. |
ship_from_country REQUIRED | La cadena del país de origen del envío, representada por un código ISO de dos letras. |
ship_to REQUIRED | La dirección de destino. hash |
ship_to.city OPTIONAL* | Una cadena para la ciudad, pueblo, distrito, suburbio o aldea del cliente. Según el país de importación, este campo puede ser OBLIGATORIO. |
ship_to.country REQUIRED | Una cadena para el país de destino en el que se encuentra la cuenta bancaria, representada por un código ISO de dos letras. |
ship_to.postal_code OPTIONAL* | Una cadena para el código postal de destino. Este campo puede ser obligatorio cuando el envío es entre Irlanda del Norte y la Unión Europea. |
ship_to.state OPTIONAL* | 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 obligatorio. |
shipping REQUIRED | Los detalles de envío, como el monto, el monto de descuento y el nivel de servicio con el transportista. hash |
shipping.amount REQUIRED | Un decimal para la suma total de los costos de envío, en dólares y centavos. |
shipping.amount_discount OPTIONAL | Un decimal para el monto del descuento que se aplica al envío. |
shipping.service_level REQUIRED | El service_level con el transportista. Consulte la documentación de transportistas para obtener la lista completa de niveles de servicio disponibles por transportista. |
*Este campo es opcional según los requisitos de campos de dirección del país de importación.
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 un landed cost
Encuentre los pares clave/valor en una solicitud de landed cost.
Aunque Zonos Landed Cost puede proporcionar un landed cost preciso basándose ú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 indican las entradas OBLIGATORIAS y OPCIONALES, pero se recomienda completar tantos campos OPCIONALES como sea posible.