Saltar al contenido principal
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 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.
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).
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).
Una subpartida que la VUCE no lista devuelve found: false con HTTP 200, no un error.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.