Configurar Zonos
Primero, regístrese para obtener una cuenta de Zonos y configure su cuenta en Zonos Dashboard. Luego podrá obtener su clave de API, que le permitirá autenticarse con la API de Zonos.
Establecer moneda base
Para proporcionar contexto sobre los montos monetarios incluidos en una solicitud de Landed Cost, debe especificar el código de moneda base de su solicitud (como código de moneda ISO). Esto se aplicará a todos los valores monetarios de la solicitud y a la moneda en la que se mostrará la cotización de Landed Cost resultante. Puede encontrar una lista de monedas admitidas y sus códigos ISO en nuestra documentación de Landed Cost.
{ "currency": "USD"}Proporcionar detalles de artículos
Para obtener una cotización de Landed Cost lo más precisa posible con Zonos, deberá proporcionar el mayor detalle posible por artículo, 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 Landed Cost real sin un código HS. Sin embargo, tenga en cuenta que si el costo total de sus artículos supera el umbral de minimis, puede ser necesario un código HS. En esos casos, enviar una solicitud sin código HS dará como resultado un error.
Para cada artículo que desee incluir en su cotización de Landed Cost, agregue una entrada a la matriz items en el cuerpo de la 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
Las ubicaciones de envío de origen y destino son necesarias para calcular el Landed Cost. Se requiere una dirección completa para el destino del envío, pero incluir el país de origen es suficiente para la mayoría de las cotizaciones de Landed Cost.
{ "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 centra en aranceles, impuestos y tasas aduaneras. Dado que el envío es un aspecto considerable de una cotización total de Landed Cost y un factor significativo en los cálculos, es esencial especificar el costo de envío por adelantado. Este valor puede obtenerse mediante una API de tarificación de envíos, como la API de Rating de Zonos, o por otros medios, como el software de envío de su transportista, tablas de tarifas, 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 shipping en su solicitud de API.
{ "shipping": { "amount": 14.23 }}Si bien solo se requiere el monto, también puede proporcionar un nombre de nivel de servicio para que la API calcule las tasas del transportista sobre el monto proporcionado. Puede ver una lista de transportistas y niveles de servicio admitidos en nuestra documentación de Landed Cost.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}Enviar una solicitud de API
Una vez que haya construido y configurado su solicitud, puede enviar una solicitud POST a la API de Zonos Landed Cost. Asegúrese de autenticarse con su clave de API y proporcionar el encabezado de versión correcto en su solicitud.
POST https://api.zonos.com/v1/landed_cost
{ "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",
Calcular un Landed Cost
Aprenda a solicitar un Landed Cost a través de la API REST.REST
La API de Zonos Landed Cost le permite obtener rápidamente una cotización de Landed Cost muy precisa 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, devolveremos el monto aproximado de aranceles e impuestos incluso cuando no se proporcione un código armonizado.