Dados cadastrais entregues

Dados cadastrais entregues

O módulo dados_cadastrais é diferente de todos os anteriores: ele não faz consulta nenhuma. Ele pega o que os tiers cpf_* do mesmo flow já trouxeram e entrega quatro campos, sempre os mesmos quatro, com o registro de finalidade do tratamento ao lado. Sem um tier cpf_* no flow não há o que entregar. É o único módulo desta família com contrato fechado: aqui você pode escrever um parser estrito.

// dados_cadastrais: quatro campos, e o registro de finalidade
{ "module": "dados_cadastrais", "passed": true, "outcome": "approved", "score": 100,
  "data": {
    "delivered": { "name": "JOÃO SILVA",
                   "birth_date": "1992-11-04",        // ISO aqui (DD/MM/AAAA nos tiers cpf_*)
                   "registration_status": "regular",  // valor CRU da fonte, não um enum nosso
                   "deceased": false },               // null = NÃO MEDIDO, nunca "vivo"
    "purpose": { "finalidade": "identity_verification",
                 "controller": "client", "operator": "unifokal",
                 "legal_basis": "controller_art_7", "minimization": "art_6_iii",
                 "delivered_fields": ["name","birth_date","registration_status","deceased"],
                 "withheld_fields": ["filiacao","genero","endereco","contatos","empresas","obito_ano"],
                 "policy_version": "cadastral-delivery@1" },
    // QUAIS tiers sustentaram os campos acima: prova de diligência, nunca dado do titular
    "coverage": ["cpf_receita"] } }

// nenhum tier sustentou nenhum dos quatro campos: NÃO entregue, e o módulo sai do preço
{ "module": "dados_cadastrais", "passed": null, "outcome": "pending", "score": 0,
  "data": { "delivered": null, "purpose": { "…": "idêntico ao acima" }, "coverage": [] } }

Três leituras que evitam erro. Primeira: deceased: null não é false. null quer dizer que o tier comprado não carregava o campo de óbito, ou seja não medimos, e nunca "confirmamos que está vivo". Segunda: registration_status é o valor cru da fonte, com a capitalização dela (Regular, Suspensa, Titular Falecido), e vem null quando o tier comprado não traz situação, que é o caso do cpf_empresas. Terceira: o bloco purpose viaja mesmo quando delivered é null, porque ele é o registro de finalidade e minimização do tratamento, não a prova de que houve entrega. Ele é constante por construção, então não o leia como configuração da sua conta: withheld_fields é a lista do que decidimos não entregar neste módulo, e ela é a mesma para todo mundo.

Cada um dos quatro campos é resolvido independentemente, varrendo os tiers do flow e ficando com o primeiro valor não nulo. Por isso coverage pode listar mais de um módulo: não existe um tier "vencedor" único, existe o primeiro que respondeu por campo. E coverage traz nome de módulo, nunca dado do titular.