> ## 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.

# Tarifa da DIAN

> Quanto custa importar mercadorias para a Colômbia, por subposição tarifária: o texto oficial, a unidade física, o imposto de importação, o IVA, o imposto preferencial de cada acordo comercial e país de origem e o regime de comércio, cada um com sua vigência.

A autoridade tributária e aduaneira da Colômbia (DIAN) publica a tarifa nacional (arancel). Para cada subposição tarifária, lista o texto oficial, a unidade em que as quantidades são declaradas, o imposto de importação geral (gravamen arancelario), o IVA na importação, o imposto preferencial de cada acordo comercial para cada país de origem (Comunidade Andina, Mercosul, os TLCs com os Estados Unidos, a União Europeia, o Canadá e outros) e o regime de comércio para importações. Cada um traz sua vigência (de e até) e a norma que o sustenta.

Consulte com a subposição completa de 10 dígitos e, se quiser, uma `date` para obter as alíquotas vigentes nesse dia, desde 2007. A primeira consulta de uma subposição lê a DIAN; as seguintes dentro de 7 dias respondem a partir da resposta guardada pela Croma, que é relida regularmente para acompanhar cada novo decreto. Para o que uma importação exige além das alíquotas (vistos buenos, licenças, descrições mínimas), veja [VUCE](https://docs.usecroma.com/pt/guides/colombia/vuce.md).

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

O que a tarifa da DIAN lista hoje para uma subposição. O exemplo são casacos de malha masculinos de outras matérias têxteis: imposto geral de 40 %, IVA de 19 % e 0 % da maioria dos parceiros comerciais.

> [!NOTE]
>
> Responde a partir da cópia da Croma quando ela tem uma resposta recente para a chave; caso contrário, lê a fonte e guarda a resposta. Cada resposta diz quando a fonte foi consultada pela última vez (`checked_at`) e de onde veio a resposta (`served_from`).

| Campo | Tipo | Notas |
| - | - | - |
| `tariff_code` | string | **Obrigatório.** A subposição completa de 10 dígitos, p. ex. `6101909000`. Pontos entre os grupos (`6101.90.90.00`) são aceitos; uma posição de 4 ou 6 dígitos não. |
| `date` | string | Opcional, `aaaa-mm-dd`. As alíquotas vigentes nesse dia em vez das de hoje, p. ex. `2020-01-01`. O histórico começa em 2007-01-01; uma data futura traz o que já está decretado para ela. Cada data é guardada como uma resposta própria. |

```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" }'
```

Retorna `found`, `tariff_code`, `date` (a data consultada, null para hoje), `checked_at` (quando a DIAN foi consultada pela última vez), `served_from` (`copy`, `upstream` ou `stale`) e `tariff`. `tariff` traz `tariff_code`, `chapter`, `heading` e `hs_code` (seus dois, quatro e seis primeiros dígitos; `hs_code` é a subposição do Sistema Harmonizado, a mesma no mundo todo), `as_of` (o dia cujas alíquotas vigentes traz), `nomenclature` (p. ex. `ARIAN`), `valid_from`, `valid_to` e `legal_basis` da própria subposição, `official_text` (o texto oficial, um nível por linha) com `official_text_levels`, `official_text_valid_from`, `official_text_valid_to` e `official_text_legal_basis`, `physical_unit`, `import_duties`, `import_duty_percent`, `vat_rates`, `agreement_duties`, `trade_regimes` e `checked_at`.

Cada alíquota e regime traz `valid_from` e `valid_to` (`AAAA-MM-DD`; `valid_to` é null enquanto não tiver data de fim) e `legal_basis`, a norma que a DIAN cita.

`physical_unit` é a unidade em que as quantidades são declaradas: `code` (p. ex. `u`, `kg`) e `name`. Cada item de `import_duties` é um imposto de importação geral: `concept` (p. ex. `GRAVAMEN ARANCELARIO`), `rate` literal e `rate_percent`; `import_duty_percent` é o imposto geral vigente como número. Cada item de `vat_rates` é uma alíquota de IVA na importação: `rate`, `rate_percent`, `treatment` (`EXENTO`, `EXCLUIDO` ou null) e `applies_to`, presente quando a DIAN divide a subposição por produto.

Cada item de `agreement_duties` é o imposto preferencial de um acordo comercial para um país de origem: `agreement_code` (p. ex. `096`), `agreement`, `country`, `concept`, `rate`, `rate_percent`, `preference_index` e `preference_index_percent` (o índice) e `pid_rate` (a taxa PID). Cada item de `trade_regimes` é o regime de comércio para importações, `regime` (p. ex. `LIBRE IMPORTACIÓN`).

> [!NOTE]
>
> Uma subposição que a DIAN não lista, ou que ainda não vigorava na data consultada, retorna `found: false` com HTTP 200, não um erro. A data consulta as alíquotas de uma subposição que existe hoje; o texto oficial e a unidade são os de hoje.

> [card] [Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)
>
> Esquemas, todos os campos de resposta e um playground interativo.


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