date para obtener las tarifas vigentes ese día, desde 2007. La primera consulta de una subpartida lee la DIAN; las siguientes dentro de 7 días responden desde la respuesta guardada por Croma, que se vuelve a leer con regularidad para seguir cada nuevo decreto. Para lo que exige una importación más allá de las tarifas (vistos buenos, licencias, descripciones mínimas), consulta VUCE.
POST /co/dian-arancel/tariff/v1 Lookup
Lo que el arancel de la DIAN lista hoy para una subpartida. El ejemplo son abrigos de punto para hombre de las demás materias textiles: gravamen general del 40 %, IVA del 19 % y 0 % desde la mayoría de socios comerciales.
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).found, tariff_code, date (la fecha consultada, null para hoy), checked_at (cuándo se consultó a la DIAN 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), as_of (el día cuyas tarifas vigentes trae), nomenclature (p. ej. ARIAN), valid_from, valid_to y legal_basis de la subpartida misma, official_text (el texto oficial, un nivel por línea) con official_text_levels, official_text_valid_from, official_text_valid_to y official_text_legal_basis, physical_unit, import_duties, import_duty_percent, vat_rates, agreement_duties, trade_regimes y checked_at.
Cada tarifa y régimen trae valid_from y valid_to (AAAA-MM-DD; valid_to es null mientras no tenga fecha de fin) y legal_basis, la norma que la DIAN cita.
physical_unit es la unidad física en que se declaran las cantidades: code (p. ej. u, kg) y name. Cada elemento de import_duties es un gravamen general: concept (p. ej. GRAVAMEN ARANCELARIO), rate textual y rate_percent; import_duty_percent es el gravamen general vigente como número. Cada elemento de vat_rates es una tarifa de IVA a la importación: rate, rate_percent, treatment (EXENTO, EXCLUIDO o null) y applies_to, presente cuando la DIAN divide la subpartida por producto.
Cada elemento de agreement_duties es el gravamen preferencial de un acuerdo comercial para un país de origen: agreement_code (p. ej. 096), agreement, country, concept, rate, rate_percent, preference_index y preference_index_percent (el índice) y pid_rate (la tasa PID). Cada elemento de trade_regimes es el régimen de comercio para importaciones, regime (p. ej. LIBRE IMPORTACIÓN).
Una subpartida que la DIAN no lista, o que aún no regía en la fecha consultada, devuelve
found: false con HTTP 200, no un error. La fecha consulta las tarifas de una subpartida que existe hoy; el texto oficial y la unidad física son los de hoy.Referencia completa
Esquemas, todos los campos de respuesta y un playground interactivo.