Seguir un dossier

Devuelve el estado del dossier (pending, completed o failed) y, una vez concluido, el resultado completo. Solo la cuenta que creó el dossier puede leerlo.

Parámetros

idstringobligatorio

En la ruta. El dossie_id devuelto por POST /v1/dossie/cpf.

Gratuito. El cobro de 100 créditos ocurre una sola vez, cuando el dossier se concluye.

• Mientras el estado es pending, la respuesta trae solo el avance. Una vez concluido, el resultado queda guardado en su cuenta y puede consultarse en cualquier momento, sin costo adicional.
• Un dossier inexistente o de otra cuenta responde 404 con el código DOSSIER_NOT_FOUND.
• Valores de risk_level: HIGH (sancionado en el CEIS, el CNEP o una lista internacional, expulsado de la administración federal, licitante inidóneo en el TCU o en el registro de trabajo esclavo), MEDIUM (PEP, deuda activa desde R$ 50.000, inhabilitado para la función pública, cuentas irregulares o con implicación electoral en el TCU) y LOW (demás casos).

Campos del resultado

data.statusstring

pending, completed o failed.

data.completed_atstring

Cuándo terminó el dossier. Ausente mientras pending.

data.basic_infoobject

Datos cadastrales del titular.

data.basic_info.full_namestring

Nombre del titular.

data.basic_info.cadastral_statusstring | null

Situación cadastral en la Receita Federal (ej.: REGULAR).

data.basic_info.birth_datestring

Fecha de nacimiento, AAAA-MM-DD.

data.compliance_summary.has_sanctionsboolean

true si hay registro en el CEIS, el CNEP, el CEAF, una lista de sanciones internacional o como licitante inidóneo en el TCU.

data.compliance_summary.is_pepboolean

true si la persona es políticamente expuesta.

data.compliance_summary.has_active_debtsboolean

true si hay deuda activa de la Unión (PGFN).

data.compliance_summary.has_possible_matchesboolean

true si alguna fuente devolvió POSSIBLE_MATCH (búsqueda solo por nombre, puede ser un homónimo). Pide verificación y lleva el riesgo a MEDIUM como mínimo.

data.compliance_summary.risk_levelstring

LOW, MEDIUM o HIGH.

data.details.*.statusstring

Resultado de cada fuente: CLEAR (sin registros), MATCH (consta, encontrado por CPF), POSSIBLE_MATCH (la búsqueda fue solo por nombre y puede ser un homónimo, verifique antes de decidir), NOT_APPLICABLE (faltó un dato necesario, como el nombre) y UNAVAILABLE (la fuente falló tras los reintentos; el dossier entonces falla y no se cobra). Solo MATCH eleva el riesgo a HIGH; POSSIBLE_MATCH lo eleva como máximo a MEDIUM.

data.details.pepobject

is_pep y la fuente (CGU).

data.details.ceisobject

found: hay registro en el CEIS.

data.details.slave_laborobject

found: consta en el Registro de Empleadores del MTE (condiciones análogas a la esclavitud). matches trae, por entrada, match (cpf: el CPF del empleador es igual al consultado; name: empresario individual con el mismo nombre, un indicio), state, fiscal_action_year, workers_involved, decision_date e inclusion_date. data_base es la fecha de publicación de la lista (semestral).

data.details.pgfn_active_debtobject

found, total_amount (BRL), records_count y data_base (fecha de la base de la PGFN) de la deuda activa. El cruce es por 6 dígitos del CPF y nombre: es un indicio.

data.details.international_sanctionsobject

Listas de sanciones de OFAC (EE. UU.), ONU y Unión Europea. found, data_base y matches (source, matched_name, program, citizenship). Las listas no tienen CPF: el cruce es por nombre completo exacto y vale como indicio, verifique antes de concluir.

data.details.cnepobject

found: hay registro en el CNEP (Registro Nacional de Empresas Sancionadas), por CPF completo.

data.details.ceafobject

found: consta en el CEAF (Registro de Expulsiones de la Administración Federal). El Portal de la Transparencia publica el CPF parcialmente oculto, por lo que el cruce usa los dígitos visibles y el nombre completo y vale como indicio. matches trae punishment, published_at y agency.

data.details.tcuobject

Listas del Tribunal de Cuentas de la Unión, todas por CPF: unfit_bidder (licitantes inidóneos), disqualified (inhabilitados para la función pública), irregular_accounts (cuentas juzgadas irregulares) y electoral (cuentas irregulares con posible implicación electoral). Cada una tiene found y, si consta, matches con process, decision, final_judgment_date, end_date y uf.

data.errorobject

Solo cuando failed: code (SOURCE_UNAVAILABLE o CPF_NOT_FOUND) y message. No se cobra nada.