ForHosting KIT · Utilidades de desarrollo

Calcule el arancel de importación por valor y categoría

Este estimador aplica al valor declarado de un envío el porcentaje de la categoría indicado en la tabla que usted proporciona.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Devuelve la tasa encontrada y el arancel estimado para que el cálculo sea comprobable y reproducible. No clasifica mercancías, consulta tarifas oficiales, añade impuestos ni determina exenciones. Use datos válidos para su envío y considere el resultado una estimación, no una liquidación aduanera.

Prepare el valor declarado y la tabla de categorías

Comience con el valor declarado que corresponda como base del arancel en su escenario. Introdúzcalo como número no negativo, sin símbolo monetario ni separador de millares. Después facilite una tabla donde cada fila tenga un nombre de categoría único y un valor rate_percent no negativo. La categoría del envío debe coincidir exactamente con una fila, incluidas mayúsculas y espacios. Esta coincidencia estricta evita elegir en silencio una clasificación parecida pero jurídicamente distinta. Escriba las tasas como porcentajes: un rate_percent de 7.5 significa siete y medio por ciento, no el decimal 0.075. Mantenga todos los importes en la misma moneda, pues no se consultan tipos de cambio. Antes de calcular, confirme que el valor, la clasificación y la tabla sean adecuados para el país de destino y la fecha. Las reglas de valoración, el origen preferencial y las exenciones pueden cambiar la base o la tasa aplicable.

Comprenda el cálculo y el resultado

El estimador busca la categoría exacta en la tabla, toma su porcentaje y multiplica el valor declarado por la tasa dividida entre cien. La relación es: arancel estimado igual a valor declarado por rate_percent dividido entre cien. El resultado incluye declared_value, la categoría encontrada, duty_rate_percent y estimated_duty, de modo que otra persona pueda auditar los datos sin reconstruir la búsqueda. El algoritmo no redondea, para conservar el resultado determinista y no imponer una regla de decimales que puede variar entre autoridades. Su proceso contable puede redondearlo después conforme a la norma aplicable. Una tasa cero o un valor cero producen un arancel cero. Si falta la categoría solicitada, se devuelve un error de entrada en vez de asumir una tasa predeterminada. También se rechazan categorías duplicadas porque vuelven ambigua la tabla, aunque sus porcentajes coincidan.

Integre la estimación en el coste en destino

Use este resultado como un componente del coste en destino, no como la cantidad final exigible por aduanas. Los cargos reales pueden incluir IVA de importación, impuestos especiales, medidas antidumping, corretaje, manipulación y otros conceptos. Algunas autoridades calculan sobre un valor aduanero que incorpora transporte, seguro, cánones u otros ajustes, y no solo la factura. Las preferencias de origen o los umbrales mínimos pueden reducir el cargo, pero requieren datos que esta herramienta no solicita. Para planificación, conserve la tabla utilizada junto al resultado. En operaciones de catálogo, calcule por artículo o clasificación y agregue solo tras confirmar si la aduana trata el envío por línea o por consignación. Repita el cálculo cuando cambien clasificación, valor, origen, destino, moneda o tarifa vigente. El navegador sirve para comprobaciones manuales y la API cuesta $0.002 por solicitud al automatizar compras, precios o informes.

Planifique el coste en destino

Aplique una tasa verificada al valor declarado antes de comparar opciones de abastecimiento.

Compruebe una hipótesis del catálogo

Confirme el arancel generado por la tabla de categorías de un flujo de precios de comercio electrónico.

Audite un cálculo manual

Muestre el porcentaje encontrado junto al arancel para rastrear el resultado hasta su fila.

¿Qué fórmula utiliza el estimador?

Multiplica declared_value por duty_rate_percent y divide el resultado entre cien.

¿Busca la categoría o tasa aduanera correcta?

No. Usted debe proporcionar la categoría del envío y la tabla de tasas aplicable.

¿Qué ocurre si la categoría no figura en la tabla?

La solicitud devuelve un error de entrada que identifica la categoría ausente; nunca sustituye una tasa predeterminada.

¿Incluye impuestos, corretaje o transporte?

No. Solo calcula el arancel a partir del valor declarado y el porcentaje que usted proporciona.

¿Qué moneda debo utilizar?

Use la moneda adecuada para su valoración y mantenga en ella tanto el valor declarado como el arancel resultante.

¿Cuánto cuesta una solicitud de API?

La API cuesta $0.002 por solicitud. La versión del navegador se ejecuta localmente para estimaciones manuales.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/ecom/customs-duty-estimate

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/ecom/customs-duty-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"declared_value":1250,"category":"footwear","duty_rates":[{"category":"books","rate_percent":0},{"category":"footwear","rate_percent":12.5}]}'
{
  "declared_value": 1250,
  "category": "footwear",
  "duty_rates": [
    {
      "category": "books",
      "rate_percent": 0
    },
    {
      "category": "footwear",
      "rate_percent": 12.5
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.customs_duty_estimate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_items500
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →