date para obter as alíquotas vigentes nesse dia, desde 2007. A primeira consulta de uma subposição lê a DIAN; as seguintes dentro de 7 dias respondem a partir da resposta guardada pela Croma, que é relida regularmente para acompanhar cada novo decreto. Para o que uma importação exige além das alíquotas (vistos buenos, licenças, descrições mínimas), veja VUCE.
POST /co/dian-arancel/tariff/v1 Lookup
O que a tarifa da DIAN lista hoje para uma subposição. O exemplo são casacos de malha masculinos de outras matérias têxteis: imposto geral de 40 %, IVA de 19 % e 0 % da maioria dos parceiros comerciais.
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).found, tariff_code, date (a data consultada, null para hoje), checked_at (quando a DIAN 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), as_of (o dia cujas alíquotas vigentes traz), nomenclature (p. ex. ARIAN), valid_from, valid_to e legal_basis da própria subposição, official_text (o texto oficial, um nível por linha) com official_text_levels, official_text_valid_from, official_text_valid_to e official_text_legal_basis, physical_unit, import_duties, import_duty_percent, vat_rates, agreement_duties, trade_regimes e checked_at.
Cada alíquota e regime traz valid_from e valid_to (AAAA-MM-DD; valid_to é null enquanto não tiver data de fim) e legal_basis, a norma que a DIAN cita.
physical_unit é a unidade em que as quantidades são declaradas: code (p. ex. u, kg) e name. Cada item de import_duties é um imposto de importação geral: concept (p. ex. GRAVAMEN ARANCELARIO), rate literal e rate_percent; import_duty_percent é o imposto geral vigente como número. Cada item de vat_rates é uma alíquota de IVA na importação: rate, rate_percent, treatment (EXENTO, EXCLUIDO ou null) e applies_to, presente quando a DIAN divide a subposição por produto.
Cada item de agreement_duties é o imposto preferencial de um acordo comercial para um país de origem: agreement_code (p. ex. 096), agreement, country, concept, rate, rate_percent, preference_index e preference_index_percent (o índice) e pid_rate (a taxa PID). Cada item de trade_regimes é o regime de comércio para importações, regime (p. ex. LIBRE IMPORTACIÓN).
Uma subposição que a DIAN não lista, ou que ainda não vigorava na data consultada, retorna
found: false com HTTP 200, não um erro. A data consulta as alíquotas de uma subposição que existe hoje; o texto oficial e a unidade são os de hoje.Referência completa
Esquemas, todos os campos de resposta e um playground interativo.