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.
Se recomienda encarecidamente un código HS. A diferencia del landed cost básico, el landed cost completo incluirá detalle a nivel de artículo de las tasas arancelarias por código HS.
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., Ropa.
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. Los cargos 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_resalefor_resale. Si es null, se asumirá una solicitud not_for_resale.
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":null
8}
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",
Solicitar un landed cost
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.
Atributos
Pares clave/valor JSON en el cuerpo de la solicitud
POST |
https://api.zonos.com/v1/landed_costHEADER
zonos-version: 2019-11-21currencyREQUIREDdiscountsOPTIONALdiscounts.idOPTIONALdiscounts.amountOPTIONALdiscounts.detailOPTIONALitemsREQUIREDhashitems.idREQUIREDitems.amountREQUIREDitems.amount_discountOPTIONALitems.brandOPTIONALitems.categoryOPTIONALitems.colorOPTIONALitems.country_of_originOPTIONALitems.description_customsOPTIONALitems.description_retailOPTIONALitems.detailOPTIONALitems.dimensionsOPTIONALhashitems.dimensions.heightOPTIONALitems.dimensions.lengthOPTIONALitems.dimensions.unitOPTIONALinch,centimeter,millimeterynull. Cuando esnull, se utilizaráinch.items.dimensions.widthOPTIONALitems.duty_tax_fee_freeOPTIONALexcludeen la solicitud, el artículo aparecerá enremoved_itemsen la respuesta de la API.items.hs_codeOPTIONALitems.image_urlOPTIONALitems.quantityREQUIREDitems.upc_codeOPTIONALitems.weightOPTIONALitems.weight_unitOPTIONALpound,ounce,kilogramynull. Cuando esnull, se utilizarápound.landed_costOPTIONALdelivery_duty_paidydelivery_duty_unpaid. Los cargos de un landed cost pueden diferir según se envíe DDP o DDU. Si esnull, 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_typeOPTIONALnot_for_resalefor_resale. Si esnull, se asumirá una solicitudnot_for_resale.ship_from_countryREQUIREDship_toREQUIREDhashship_to.cityOPTIONAL*ship_to.countryREQUIREDship_to.postal_codeOPTIONAL*ship_to.stateOPTIONAL*shippingREQUIREDhashshipping.amountREQUIREDshipping.amount_discountOPTIONALshipping.service_levelREQUIRED{"currency": "USD","discounts": [{"id": "sale124","amount": 43,"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.webp","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"}¿Fue útil esta página?