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

> Lo que exige importar mercancía a Colombia, por subpartida arancelaria: el régimen de importación, el decreto arancelario, la vigencia de la licencia, cada entidad que debe dar visto bueno y la descripción mínima que debe llevar la declaración.

La Ventanilla Única de Comercio Exterior (VUCE) de Colombia, a cargo del Ministerio de Comercio (MinCIT), publica para cada subpartida arancelaria lo que exige importar bajo ella: el régimen de importación, el decreto que fija el arancel, la vigencia de la licencia o registro de importación, las entidades que deben dar visto bueno (INVIMA, ICA, FNE y otras) con el requisito previo que pide cada una y su normatividad, y la descripción mínima de la mercancía que debe llevar la declaración de importación.

Consulta con la subpartida completa de 10 dígitos. La primera consulta de una subpartida lee la VUCE; las siguientes dentro de 7 días responden desde la respuesta guardada por Croma, que se vuelve a leer con regularidad para seguir cada nueva circular.

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

Lo que la VUCE lista hoy para una subpartida. El ejemplo son medicamentos de uso humano, que requieren visto bueno del INVIMA y del FNE.

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

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

Devuelve `found`, `tariff_code`, `checked_at` (cuándo se consultó a la VUCE 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), `description` (el texto de la subpartida en el último decreto arancelario), `import_regime` (`LIBRE` o `PREVIA`), `requires_import_license` (`true` para `PREVIA`: importar exige licencia previa del MinCIT), `status` (p. ej. `Activo`), `legal_basis` (el decreto arancelario), `license_validity_months`, `note` (acuerdos comerciales y contingentes que aplican, cuando VUCE los lista), `approvals_regulation` (la circular vigente para vistos buenos), `requires_approvals`, `authorities`, `approvals`, `minimum_descriptions`, `minimum_description_sections`, `minimum_description_text`, `additional_information` y `checked_at`.

`authorities` lista una vez cada entidad que debe aprobar la importación, con `code` (el de la VUCE, p. ej. `GRUPOICA`) y `name` (p. ej. `Instituto Colombiano Agropecuario (ICA)`).

Cada elemento de `approvals` es una entidad que debe dar visto bueno a la importación: `authority` (p. ej. `INVIMA`, `GRUPOICA`, `FNE`), `authority_name`, `description` (qué mercancías cubre), `control` (p. ej. `VB`), `prior_requirement` (p. ej. `Registro Sanitario (RS)`), `prior_requirement_description`, `legal_basis`, `marginal_notes`, `observation` y `group`. Una lista vacía significa que ninguna entidad debe aprobar la importación.

Cada elemento de `minimum_descriptions` es un control sobre cómo se describe la mercancía en la declaración de importación: `authority`, `control` (p. ej. `DM`), `control_description` y `legal_basis`. `minimum_description_text` lista lo que esa descripción debe incluir, textual para todo el capítulo de la subpartida; `minimum_description_sections` lo divide en secciones (`title`, p. ej. `IX. Confecciones`) y los campos que exige cada una (`label`, p. ej. `Composición porcentual`, y `guidance`).

> [!NOTE]
>
> Una subpartida que la VUCE no lista devuelve `found: false` con HTTP 200, no un error.

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