Skip to content

Adicionar validador para CNS (Cartão Nacional de Saúde) #774

Description

@laurazimrn

A biblioteca já cobre diversos documentos brasileiros (CPF, CNPJ, PIS, CNH, RENAVAM, Título de Eleitor, Passaporte, etc.), mas não tem suporte ao CNS (Cartão Nacional de Saúde), também conhecido como "Cartão do SUS". É um documento de uso bem comum em sistemas de saúde (públicos e privados) no Brasil, e hoje quem precisa validar esse número tem que implementar a lógica por conta própria.

Proposta: adicionar um novo módulo brutils/cns.py com as funções abaixo, seguindo o padrão dos módulos existentes (ex: pis.py, voter_id.py):

  • is_valid_cns: valida um CNS de 15 dígitos, cobrindo os dois formatos oficiais — definitivo (inicia com 1 ou 2, vinculado ao PIS/PASEP) e provisório (inicia com 7, 8 ou 9) — via dígito verificador módulo 11.
  • generate_cns: gera um CNS válido aleatório (definitivo ou provisório).
  • remove_symbols_cns: remove símbolos de formatação.
  • format_cns: formata um CNS válido para exibição.

Referências do algoritmo:

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions