Download the PHP package emcvlt/documents without Composer
On this page you can find all versions of the php package emcvlt/documents. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download emcvlt/documents
More information about emcvlt/documents
Files in emcvlt/documents
Package documents
Short Description Classe responsável pela validação de documentos
License MIT
Informations about the package documents
documents
Um manipulador de documentos (RG, CPF, Inscrição Estadual, etc)
Instalar
Usando Composer
Uso
Para validar um número de inscrição, basta você realizar uma chamada à classe passando como parâmetros o número da inscrição e a UF a qual pertence este número.
UF inválida
Caso o estado informado seja inválido (UF inexistente), a classe irá gerar uma exceção do tipo 'InvalidArgumentException'. Você pode tratar este comportamento facilmente.
Lidando com isenções de inscrição estadual
Nos casos em que ocorrer a isenção da inscrição estadual, você pode simplesmente fornecer no número o valor 'ISENTO' ou 'ISENTA'. A classe lida com letras maiúsculas e minúsculas normalmente, tanto no número da inscrição estadual quanto na UF.
Por exemplo são válidos:
- 'SP', 'Sp' ou 'sp' para o estado de São Paulo
- 'ISENTO', 'Isento' ou 'isento' para isentos
Lidando com números abreviados (sem zeros à esquerda) e formatação
Você precisa lidar antecipadamente com relação à quantidade de algarismos exigidos na inscrição estadual. Algumas UFs não usam dígitos identificadores da UF (os dois primeiros dígitos) e os usuários tendem à representar o número sem os zeros à esquerda. Nestes casos esta classe não saberá lidar com estes valores e poderá indicar um 'falso' resultado.
Também são usados sinais de pontuação na inscrição estadual e até letras. Nestes casos a classe irá lidar corretamente com estes valores, ignorando as pontuações e tratando os demais caracteres (letras e números).
Por exemplo são valores válidos para inscrições de São Paulo (SP):
- 'P-01100424.3/002' ou 'P011004243002'
Em caso de dúvidas, consulte a documentação de cada estado ou o site do Sintegra (http://www.sintegra.gov.br) para esclarecer suas dúvidas.
Testes
Incluí uma rotina de testes com valores válidos de todas as unidades da federação.
Créditos
Licença
A Licença MIT (MIT). Por favor veja License File para maiores informações.