Contraloría - Croma API

Resolve o “Certificado de Antecedentes de Responsabilidad Fiscal” da Contraloría General de la República: uma verificação contra o SIBOR (Sistema de Información del Boletín de Responsables Fiscales), o registro de pessoas declaradas fiscalmente responsáveis por dano aos recursos públicos. A Croma retorna esse veredicto como dados estruturados.

Solicitação

POST /co/contraloria/fiscal-records/v1

Campo	Tipo	Notas
`document_type`	string	Opcional. Um de `CC`, `CE`, `TI`, `PA`, `PEP`, `PPT`. O padrão é `CC`.
`document_number`	string	Obrigatório. Número do documento (entre 3 e 30 caracteres alfanuméricos).

curl https://api.croma.run/co/contraloria/fiscal-records/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "CC", "document_number": "1234567890" }'

Esta consulta é mais lenta que as demais (normalmente dezenas de segundos) enquanto o certificado é gerado sob demanda.

Resposta

Campo	Notas
`found`	`true` quando um certificado foi emitido (o SIBOR certifica qualquer consulta válida).
`document_type`, `document_type_label`	O tipo consultado e seu rótulo em espanhol.
`document_number`	O documento consultado.
`is_fiscal_responsible`	`true` quando está reportado como responsável fiscal; `false` para o veredicto limpo “NO SE ENCUENTRA REPORTADO”.
`verification_code`	Código de Verificación (documento + `yymmddhhmmss`), para verificar novamente o certificado oficial.
`certified_at`	Data e hora do certificado (ISO, hora local da Colômbia) derivada do código de verificação.
`status`	Frase CERTIFICA textual do certificado.
`message`	Corpo completo do certificado em texto simples, para auditoria ou exibição.

O resultado limpo é is_fiscal_responsible: false. O Boletín lista apenas pessoas declaradas fiscalmente responsáveis, então qualquer documento que não esteja nele certifica como não reportado. Use verification_code para confirmar a autenticidade do certificado com a Contraloría.

Referência completa

Esquemas, campos de resposta e um playground interativo.