Resumo: a régua é a configuração da sua organização sobre o que exigir de cada tipo de documento. Ela é versionada: salvar publica uma versão nova e a anterior nunca é reescrita, então todo parecer registra qual versão da régua o julgou.
As três perguntas
As verificações se organizam pelas três perguntas que um analista de cadastro faz:1. Autenticidade
Estrutura, integridade e completude do arquivo. Olha a anatomia antes do conteúdo: seções esperadas do tipo, identificadores no formato certo e coerência interna. É o que impede um arquivo qualquer de passar por outro documento.
2. Titularidade
Confronto com a solicitação e com a fonte oficial. O que foi lido bate com o CNPJ/CPF e o nome da análise, e com o quadro societário oficial?
3. Fé pública
Certificação e vigência. Registro, autenticação, prazo e poderes de quem assina. É o que separa a via registrada da cópia solta que o cliente tem em mãos.
Resultado de cada verificação
Cada verificação volta com
code, result, message, evidence (página e trecho) e a origem (DETERMINISTIC, RECONCILIATION ou LLM).
Catálogo de verificações
1. Autenticidade
2. Titularidade
3. Fé pública
|
ISSUER_UTILITY_ACTIVITY | O CNPJ da fatura tem CNAE de energia, gás, água/esgoto ou telecom | COMPROVANTE_RESIDENCIA |
| REPRESENTATION | Regime de assinatura, alçadas, vedações e mandato de quem representa | societários com cláusula de administração |
A recência do comprovante de residência sai pela verificação de anatomia (
STRUCTURE), que lê a vigência do próprio arquivo, e não por uma verificação separada. O prazo padrão é de 60 dias e se ajusta por tipo.ISSUER_UTILITY_ACTIVITY não é lista de emissores: autarquia municipal de saneamento passa pelo CNAE dela, e imobiliária, banco ou escola não passam por mais que o papel pareça fatura. Quando o CNPJ está ilegível ou a consulta não conclui, o parecer sai INCONCLUSIVO com o motivo, nunca válido.Espécies de certificação
A régua deixa você exigir uma espécie mínima por tipo documental. A ordem é da mais fraca à mais forte:
Sem espécie mínima configurada, a verificação apenas informa a espécie no parecer.
Parâmetros ajustáveis
Interruptores
O que não é configurável por item
A régua é da organização. Um item de solicitação pode declararmaxAgeDays, que vence o prazo da régua para aquele pedido (é o nível mais específico). Todo o resto (o que reprova, o que é ressalva, a espécie mínima) mora na régua e em nenhum outro lugar.
Onde configurar
No toolbox, em Onboarding, Clientes, aba Validações: três abas, uma por pergunta, e navegação por tipo documental (pessoa jurídica, pessoa física e os que servem aos dois). Não há rota pública para publicar régua. É configuração versionada que afeta todo documento que entrar depois, e a tela mostra o efeito antes de salvar. O que a API devolve é o resultado:assessment.ruleSetVersion, em cada parecer, diz qual versão julgou aquele documento.