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

# VUCE

> O que importar mercadorias para a Colômbia exige, por subposição tarifária: o regime de importação, o decreto tarifário, a validade da licença, cada entidade que deve aprovar a importação e a descrição mínima que a declaração deve levar.

A Ventanilla Única de Comercio Exterior (VUCE) da Colômbia, a cargo do Ministério do Comércio (MinCIT), publica para cada subposição tarifária o que uma importação sob ela exige: o regime de importação, o decreto que fixa a tarifa, a validade da licença ou registro de importação, as entidades que devem dar o visto bueno (INVIMA, ICA, FNE e outras) com o requisito prévio que cada uma pede e suas normas, e a descrição mínima da mercadoria que a declaração de importação deve levar.

Consulte com a subposição completa de 10 dígitos. A primeira consulta de uma subposição lê a VUCE; as seguintes dentro de 7 dias respondem a partir da resposta guardada pela Croma, que é relida regularmente para acompanhar cada nova circular.

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

O que a VUCE lista hoje para uma subposição. O exemplo são medicamentos de uso humano, que precisam do visto bueno do INVIMA e do FNE.

> [!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. |

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

Retorna `found`, `tariff_code`, `checked_at` (quando a VUCE 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), `description` (o texto da subposição no último decreto tarifário), `import_regime` (`LIBRE` ou `PREVIA`), `requires_import_license` (`true` para `PREVIA`: importar exige licença prévia do MinCIT), `status` (p. ex. `Activo`), `legal_basis` (o decreto tarifário), `license_validity_months`, `note` (acordos comerciais e cotas que se aplicam, quando a VUCE os lista), `approvals_regulation` (a circular vigente para vistos buenos), `requires_approvals`, `authorities`, `approvals`, `minimum_descriptions`, `minimum_description_sections`, `minimum_description_text`, `additional_information` e `checked_at`.

`authorities` lista uma vez cada entidade que deve aprovar a importação, com `code` (o da VUCE, p. ex. `GRUPOICA`) e `name` (p. ex. `Instituto Colombiano Agropecuario (ICA)`).

Cada item de `approvals` é uma entidade que deve aprovar a importação (visto bueno): `authority` (p. ex. `INVIMA`, `GRUPOICA`, `FNE`), `authority_name`, `description` (quais mercadorias cobre), `control` (p. ex. `VB`), `prior_requirement` (p. ex. `Registro Sanitario (RS)`), `prior_requirement_description`, `legal_basis`, `marginal_notes`, `observation` e `group`. Uma lista vazia significa que nenhuma entidade precisa aprovar a importação.

Cada item de `minimum_descriptions` é um controle sobre como a mercadoria é descrita na declaração de importação: `authority`, `control` (p. ex. `DM`), `control_description` e `legal_basis`. `minimum_description_text` lista o que essa descrição deve incluir, literal para todo o capítulo da subposição; `minimum_description_sections` o divide em seções (`title`, p. ex. `IX. Confecciones`) e os campos que cada uma exige (`label`, p. ex. `Composición porcentual`, e `guidance`).

> [!NOTE]
>
> Uma subposição que a VUCE não lista retorna `found: false` com HTTP 200, não um erro.

> **[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.