POST /co/vuce/tariff/v1 Lookup
What VUCE lists today for one subpartida. The example is medicines for human use, which need a visto bueno from INVIMA and the FNE.
Answers from Croma’s copy when it holds a recent answer for the key, otherwise reads the source and keeps the answer. Every response says when the source was last asked (
checked_at) and where the answer came from (served_from).found, tariff_code, checked_at (when VUCE was last asked), served_from (copy, upstream or stale) and tariff. tariff carries tariff_code, chapter, heading and hs_code (its first two, four and six digits; hs_code is the Harmonized System subheading, the same worldwide), description (the subpartida’s text in the latest tariff decree), import_regime (LIBRE or PREVIA), requires_import_license (true for PREVIA: importing needs a prior license from MinCIT), status (e.g. Activo), legal_basis (the tariff decree), license_validity_months, note (trade agreements and quotas that apply, when VUCE lists any), approvals_regulation (the circular in force for vistos buenos), requires_approvals, authorities, approvals, minimum_descriptions, minimum_description_sections, minimum_description_text, additional_information and checked_at.
authorities lists each entity that must approve the import once, as code (VUCE’s, e.g. GRUPOICA) and name (e.g. Instituto Colombiano Agropecuario (ICA)).
Each entry of approvals is an entity that must approve the import (visto bueno): authority (e.g. INVIMA, GRUPOICA, FNE), authority_name, description (which goods it covers), control (e.g. VB), prior_requirement (e.g. Registro Sanitario (RS)), prior_requirement_description, legal_basis, marginal_notes, observation and group. An empty list means no entity has to approve the import.
Each entry of minimum_descriptions is a control on how the goods are described in the import declaration: authority, control (e.g. DM), control_description and legal_basis. minimum_description_text lists what that description must include, verbatim for the subpartida’s whole chapter; minimum_description_sections splits it into sections (title, e.g. IX. Confecciones) and the fields each one requires (label, e.g. Composición porcentual, and guidance).
A subpartida VUCE does not list returns
found: false with HTTP 200, not an error.Full reference
Schemas, all response fields, and an interactive playground.