Skip to main content

Biblioteca para validação de CPF e CNPJ brasileiros, incluindo suporte ao novo padrão alfanumérico

Project description

CNPJ/CPF Validator

Biblioteca Python para validação de CPF e CNPJ brasileiros, com suporte ao novo padrão alfanumérico de CNPJ (a partir de julho de 2026).

Instalação

pip install cnpj-cpf-validator

Recursos

  • Validação de CPF
  • Formatação de CPF (adiciona pontuação)
  • Validação de CNPJ (numérico e alfanumérico)
  • Formatação de CNPJ (adiciona pontuação)
  • Suporte ao novo formato alfanumérico de CNPJ (válido a partir de julho de 2026)

Uso

Validação de CPF

from cnpj_cpf_validator import CPF

# Verificar se um CPF é válido
CPF.is_valid("529.982.247-25")  # True
CPF.is_valid("52998224725")     # True
CPF.is_valid("529.982.247-26")  # False (dígito verificador inválido)

# Formatar um CPF
CPF.format("52998224725")       # "529.982.247-25"

Validação de CNPJ

from cnpj_cpf_validator import CNPJ

# Verificar se um CNPJ é válido (formato numérico tradicional)
CNPJ.is_valid("11.222.333/0001-81")  # True
CNPJ.is_valid("11222333000181")      # True
CNPJ.is_valid("11.222.333/0001-80")  # False (dígito verificador inválido)

# Verificar se um CNPJ alfanumérico é válido (novo formato a partir de julho de 2026)
CNPJ.is_valid("A1B2.C3D4.E5F6/G7H8-01")  # True
CNPJ.is_valid("A1B2C3D4E5F6G7H801")      # True

# Formatar um CNPJ
CNPJ.format("11222333000181")              # "11.222.333/0001-81"
CNPJ.format("A1B2C3D4E5F6G7H801")          # "A1B2.C3D4.E5F6/G7H8-01"

Novo formato de CNPJ alfanumérico (a partir de julho de 2026)

A Receita Federal do Brasil anunciou mudanças no formato do CNPJ que começarão a valer a partir de julho de 2026. A principal alteração é a introdução do CNPJ alfanumérico, que incluirá letras, além dos números, na sua composição.

Como funcionará o novo CNPJ:

  • Formato Alfanumérico: O CNPJ continuará tendo 14 caracteres, mas:

    • As oito primeiras posições (raiz do CNPJ) poderão conter tanto letras quanto números.
    • As quatro posições seguintes (ordem do estabelecimento) também serão alfanuméricas.
    • As duas últimas posições (dígitos verificadores) continuarão sendo exclusivamente numéricas.
  • Convivência de formatos: Os CNPJs já existentes (apenas numéricos) permanecerão válidos. O novo formato alfanumérico será implementado apenas para novas inscrições a partir de julho de 2026. Os dois formatos (numérico e alfanumérico) vão coexistir.

Licença

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cnpj_cpf_validator-0.1.0.tar.gz (6.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cnpj_cpf_validator-0.1.0-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file cnpj_cpf_validator-0.1.0.tar.gz.

File metadata

  • Download URL: cnpj_cpf_validator-0.1.0.tar.gz
  • Upload date:
  • Size: 6.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for cnpj_cpf_validator-0.1.0.tar.gz
Algorithm Hash digest
SHA256 ecdb640fca74e4ff20b871e981c2d8f6108ce9bde535ba8fdbbdaf16e4b760ad
MD5 73f6ece02645f9136b065abefdec4ef7
BLAKE2b-256 19060ec653b3df38a620da2ec8cd746f2444f2e496241ab6e210200f0b0961a4

See more details on using hashes here.

File details

Details for the file cnpj_cpf_validator-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for cnpj_cpf_validator-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 978f0e706ff4f387f40c7400637e0a2462ba0e4d4e5009f150e1741366fdfb72
MD5 963da7dd1f2547ddc4d40f5373279f1c
BLAKE2b-256 fbd02fe515d5dfb0ded9b4cba8b637eaeefd21a9e9b1e68c3d1f16ee92c37b88

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page