> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Arancel de la DIAN

> Lo que cuesta importar mercancía a Colombia, por subpartida arancelaria: el texto oficial, la unidad física, el gravamen arancelario, el IVA, el gravamen preferencial de cada acuerdo comercial y país de origen, y el régimen de comercio, cada uno con su vigencia.

La Dirección de Impuestos y Aduanas Nacionales (DIAN) publica el arancel de aduanas de Colombia. Para cada subpartida arancelaria lista el texto oficial, la unidad física en que se declaran las cantidades, el gravamen arancelario general, el IVA a la importación, el gravamen preferencial de cada acuerdo comercial para cada país de origen (Comunidad Andina, Mercosur, los TLC con Estados Unidos, la Unión Europea, Canadá y otros) y el régimen de comercio para importaciones. Cada uno trae su vigencia (desde y hasta) y la norma que lo sustenta.

Consulta con la subpartida completa de 10 dígitos y, si quieres, una `date` para obtener las tarifas vigentes ese día, desde 2007. La primera consulta de una subpartida lee la DIAN; las siguientes dentro de 7 días responden desde la respuesta guardada por Croma, que se vuelve a leer con regularidad para seguir cada nuevo decreto. Para lo que exige una importación más allá de las tarifas (vistos buenos, licencias, descripciones mínimas), consulta [VUCE](https://docs.usecroma.com/es/guides/colombia/vuce.md).

`POST /co/dian-arancel/tariff/v1` [Lookup](https://docs.usecroma.com/es/datasets.md#lookups)

Lo que el arancel de la DIAN lista hoy para una subpartida. El ejemplo son abrigos de punto para hombre de las demás materias textiles: gravamen general del 40 %, IVA del 19 % y 0 % desde la mayoría de socios comerciales.

> [!NOTE]
>
> Responde desde la copia de Croma cuando tiene una respuesta reciente para la llave; si no, lee la fuente y guarda la respuesta. Cada respuesta dice cuándo se consultó la fuente por última vez (`checked_at`) y de dónde salió la respuesta (`served_from`).

| Campo | Tipo | Notas |
| - | - | - |
| `tariff_code` | string | **Obligatorio.** La subpartida completa de 10 dígitos, p. ej. `6101909000`. Se aceptan puntos entre los grupos (`6101.90.90.00`); una partida de 4 o 6 dígitos no. |
| `date` | string | Opcional, `aaaa-mm-dd`. Las tarifas vigentes ese día en vez de las de hoy, p. ej. `2020-01-01`. La historia empieza el 2007-01-01; una fecha futura trae lo que ya está decretado para ella. Cada fecha se guarda como una respuesta propia. |

```bash theme={"dark"}
curl https://api.croma.run/co/dian-arancel/tariff/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tariff_code": "6101909000" }'
```

Devuelve `found`, `tariff_code`, `date` (la fecha consultada, null para hoy), `checked_at` (cuándo se consultó a la DIAN por última vez), `served_from` (`copy`, `upstream` o `stale`) y `tariff`. `tariff` incluye `tariff_code`, `chapter`, `heading` y `hs_code` (sus dos, cuatro y seis primeros dígitos; `hs_code` es la subpartida del Sistema Armonizado, la misma en todo el mundo), `as_of` (el día cuyas tarifas vigentes trae), `nomenclature` (p. ej. `ARIAN`), `valid_from`, `valid_to` y `legal_basis` de la subpartida misma, `official_text` (el texto oficial, un nivel por línea) con `official_text_levels`, `official_text_valid_from`, `official_text_valid_to` y `official_text_legal_basis`, `physical_unit`, `import_duties`, `import_duty_percent`, `vat_rates`, `agreement_duties`, `trade_regimes` y `checked_at`.

Cada tarifa y régimen trae `valid_from` y `valid_to` (`AAAA-MM-DD`; `valid_to` es null mientras no tenga fecha de fin) y `legal_basis`, la norma que la DIAN cita.

`physical_unit` es la unidad física en que se declaran las cantidades: `code` (p. ej. `u`, `kg`) y `name`. Cada elemento de `import_duties` es un gravamen general: `concept` (p. ej. `GRAVAMEN ARANCELARIO`), `rate` textual y `rate_percent`; `import_duty_percent` es el gravamen general vigente como número. Cada elemento de `vat_rates` es una tarifa de IVA a la importación: `rate`, `rate_percent`, `treatment` (`EXENTO`, `EXCLUIDO` o null) y `applies_to`, presente cuando la DIAN divide la subpartida por producto.

Cada elemento de `agreement_duties` es el gravamen preferencial de un acuerdo comercial para un país de origen: `agreement_code` (p. ej. `096`), `agreement`, `country`, `concept`, `rate`, `rate_percent`, `preference_index` y `preference_index_percent` (el índice) y `pid_rate` (la tasa PID). Cada elemento de `trade_regimes` es el régimen de comercio para importaciones, `regime` (p. ej. `LIBRE IMPORTACIÓN`).

> [!NOTE]
>
> Una subpartida que la DIAN no lista, o que aún no regía en la fecha consultada, devuelve `found: false` con HTTP 200, no un error. La fecha consulta las tarifas de una subpartida que existe hoy; el texto oficial y la unidad física son los de hoy.

> [card] [Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.