Configura Zonos
Primero, regístrate para obtener una cuenta de Zonos y configura tu cuenta en el panel de Zonos. Luego podrás obtener tu clave API, que te permitirá autenticarte con la API de Zonos.
Establece la moneda base
Para proporcionar contexto sobre los montos de dinero incluidos en una solicitud de landed cost, debes especificar el código de moneda base de tu solicitud (como un código de moneda ISO). Esto se referirá a todos los valores monetarios en la solicitud y a la moneda en la que se mostrará el presupuesto resultante de landed cost. Puedes encontrar una lista de las monedas admitidas y sus códigos ISO en nuestra landed cost docs.
Solicitud
{
"currency": "USD"
}
Proporcionar detalles del artículo
Para obtener una cotización precisa del posible costo landed cost utilizando Zonos, deberá proporcionar la mayor cantidad de detalles por artículo posible, incluidos los códigos armonizados (HS). En general, cuanta más información incluya, más precisa será su cotización.
Si bien proporcionar códigos HS permite que Zonos Landed Cost devuelva los cálculos más precisos y completos, es posible aproximar el costo real landed cost sin un código HS. Sin embargo, tenga en cuenta que si el costo total de sus artículos supera el umbral de minimis, es posible que se requiera un código HS. En esos casos, enviar una solicitud sin un código HS resultará en un error.
Para cada artículo que desee incluir en su cotización de costo landed cost, agregue una entrada al array items en el cuerpo de la solicitud.
Solicitud
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Agregar direcciones de envío
Se requieren las ubicaciones de envío y destino para su envío para calcular el landed cost. Se requiere una dirección completa para el destino del envío, pero incluir el país de envío es suficiente para la mayoría de las cotizaciones de landed cost.
Solicitud
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Proporcionar costos de envío
La API de Zonos Landed Cost no calcula los costos de envío, se enfoca en los aranceles de aduana, impuestos y tarifas. Dado que el envío es un aspecto considerable de un presupuesto total de landed cost y un factor significativo en cómo se calculan las cosas, es esencial especificar el costo de envío por adelantado. Este valor se puede obtener utilizando una API de calificación de envíos, como la API de Calificación de Zonos, o por una variedad de otros medios, como el software de envío de su transportista, tablas de rate, etc.
La información relacionada con los costos de envío, incluido el monto total de envío, se envía a través del campo envío en su solicitud de API.
Solicitud
{
"shipping": {
"amount": 14.23
}
}
Si bien solo se requiere la cantidad, también puedes proporcionar un nombre de nivel de servicio para permitir que la API calcule las tarifas del transportista según la cantidad proporcionada. Puedes ver una lista de transportistas admitidos y niveles de servicio en nuestra documentación de Landed Cost.
Solicitud
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Enviar una solicitud de API
Ahora que has construido tu solicitud y la has configurado, puedes enviar una solicitud POST a la API de Zonos Landed Cost. Asegúrate de autenticarte con tu clave de API y proporcionar el encabezado de versión correcto en tu solicitud.
POST https://api.zonos.com/v1/landed_cost
Solicitud
{
"currency": "USD",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
],
"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"
}
}
Respuesta
{
"id": "ldct_1AoaDV8MZ8SAmsVFFTWISI",
"amount_subtotal": {
"duties": 53.54,
"fees": 27.64,
"taxes": 33.96
},
"currency": {
"id": "1aad3b7e-c",
"base": "USD",
"date": "2022-09-06T20:57:10.333+0000",
"rates": [
{
"currency": "BRL",
"rate": 5.2499
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"country_of_origin_source": "api_request",
"description_customs": null,
"description_retail": null,
"hs_code": "6116.10.00",
"hs_code_source": "api_request",
"note": "",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "BR"
},
"de_minimis": [
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Duty applies to all shipments",
"threshold": "above",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 45.0,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.538,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "shipping"
}
],
"fees": [
{
"amount": 15.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 12.0,
"description": "UPS Disbursement Fee",
"item_id": null,
"formula": "2.00% of duties & taxes amount with a minimum of 12 usd, whichever is greater",
"note": null,
"type": "advancement"
},
{
"amount": 0.64,
"description": "UPS Currency Conversion Fee",
"item_id": null,
"formula": ".75% of the amount converted",
"note": null,
"type": "currency_conversion_fee"
}
],
"taxes": [
{
"amount": 16.46,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "shipping"
},
{
"amount": 9.88,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the item",
"type": "duty"
},
{
"amount": 1.87,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the shipping",
"type": "duty"
},
{
"amount": 2.63,
"description": "ICMS",
"item_id": null,
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "advancement"
}
],
"removed_items": [],
"remittance": [],
"landedCostGuaranteeCode": "ZONOS"
}
Calcula un landed cost
Aprende cómo solicitar un landed cost a través de la API REST.
REST
La API de Zonos Landed Cost te permite obtener rápidamente un presupuesto altamente preciso de landed cost para envíos de importación y exportación transfronterizos. Si bien proporcionar códigos armonizados (HS) permite que Zonos Landed Cost devuelva el cálculo de aranceles más preciso, también devolveremos la cantidad aproximada de aranceles e impuestos incluso cuando no se proporcione un código armonizado.