Repository files navigation

RFB Document é um pacote que te ajuda a lidar com números de cadastro da Receita Federal do Brasil, CPF (cadastro de pessoa física) e CNPJ (cadastro nacional de pessoa jurídica). Através dele é possível gerar números de CPF/CNPJ válidos, validar um número existente e formatá-los. Tudo de maneira simples e prática.

❗ IMPORTANTE: Este pacote não realiza nenhuma consulta na Receita Federal, portanto, não verifica a situação atual do documento ou se o mesmo está atrelado a uma pessoa ou empresa específica. Toda a checagem é baseada no algoritmo utilizado para gerar os números de cadastro.

RequerPHP 8.0+

Se você usa o Laravel, verifique a compatibilidade de versões:

Para instalar o pacote, basta usar ocomposer:

composer require tongedev/rfb-document

Em caso de aplicações Laravel, não é preciso publicar o pacote nos Providers, isso é feito de forma automática pelo auto discovery, durante a instalação.

Uma forma de se usar oRFB Document se dá instanciando a classe correspondente ao documento desejado (CPF ou CNPJ) e então usufruindo dos recursos disponíveis:

// no caso de querer manipular CPF$cpfClass =newTongedev\RfbDocument\CPFDocument();$cpf =$cpfClass->generate();// retorno: xxxxxxxxxxx (um número de CPF aleatório)// no caso de querer manipular CNPJ$cnpjClass =newTongedev\RfbDocument\CNPJDocument();$cnpj =$cnpjClass->generate();// retorno: xxxxxxxxxxx (um número de CNPJ aleatório)

Em aplicações Laravel, é possível tirar proveito do container IoC (inversion of control) presente no framework. Quando o pacote é instalado, suas facades são automaticamente publicadas entre os Providers, permitindo um uso mais rápido dos recursos:

$cpf =CPF::generate();// retorno: xxxxxxxxxxx (um número de CPF aleatório)$cnpj =CNPJ::generate();// retorno: xxxxxxxxxxxxxx (um número de CNPJ aleatório)

Os recursos disponíveis são: geração de um novo documento válido, sanitização, formatação e validação de um dado documento. Destacando que as chamadas dos recursos são as mesmas para CPF e CNPJ.

Todos os exemplos abaixo funcionam paraCPF eCPNJ, bastando apenas alterar a classe utilizada.

$cpf =CPF::generate();// retorno: xxxxxxxxxxx (cpf sanitizado)$cnpj =CNPJ::generate();// retorno: xxxxxxxxxxxxxxx (cnpj sanitizado)

E os demais métodos:

$cpf =CPF::generate(true);// retorno: xxx.xxx.xxx-xx (cpf formatado)$cpf =CPF::sanitize('xxx.xxx.xxx-xx');// retorno: xxxxxxxxxxx (cpf sanitizado)$cpf =CPF::format('xxxxxxxxxxx');//retorno: xxx.xxx.xxx-xx (cpf formatado)$cpf =CPF::validate('xxx.xxx.xxx-xx');// retorno: booleano dependendo do valor passado no parâmetro$cpf =CPF::validate('xxxxxxxxxxx');// é possível passar documento sanitizado também para validação

Caso as funções recebam valores ou cadeias de caracteres que não correspondem a um conjunto de dígitos esperado de um dos documentos, uma exceção é lançada:

$cpf =CPF::format('123456ASasdfas');// esse código irá gerar uma exceção do tipo `RfbDocumentException`.

Obrigado por considerar contribuir para o RFB Document. Tudo sobre contribuições está descritoaqui.

👋 Siga o autor@devatreides no Twitter para saber das últimas novidades e conhecer outros projetos. Diga oi!

RFB Document é um software open source licenciado sob aLicença MIT.