marcelotduarte / ie

Biblioteca de validação de inscrições estaduais em JavaScript (browser e node.js)

IE

Validação de inscrições estaduais em JavaScript (browser e node.js)

Validações implementadas de acordo com o manual do Sintegra.

   

Node.js

Instalação:

npm install inscricaoestadual

Utilização:

var ie = require("inscricaoestadual");
ie(inscricaoEstadual, uf);

Browser

Instalação: faça o download aqui ou via bower:

bower install --save inscricao-estadual

Utilização:

<script src="ie.min.js"></script>
<script>
    inscricaoEstadual('suaInscricaoEstadual', 'UF');
</script>

Utilização com AMD (RequireJS e afins):

define(['vendor/inscricao-estadual/ie.min.js'], function(ie){
    ie('suaInscricaoEstadual', 'UF');
});

---

ie(inscricaoEstadual[, uf])

• inscricaEstadual uma string contendo o valor a ser validado ou um array de strings. Pode-se receber uma string com máscara, pois os separadores [".", "-", "/", " "] são desconsiderados para a validação. Caso seja passado o valor "isento" (independente de case maiúsculo ou minúsculo) é retornado true.

• uf é opcional, mas se fornecida pode ser "" (string vazia) ou deve ser uma string entre um dos valores

["ac", "al", "ap", "am",
"ba", "ce", "df", "es",
"go", "ma", "mt", "ms",
"mg", "pa", "pb", "pr",
"pe", "pi", "rj", "rn",
"rs", "ro", "rr", "sc",
"sp", "se", "to"]

No caso de ser string vazia ou não fornecida, a função ie retorna um array de estados nas quais esta inscrição estadual tem um valor válido, útil quando se tem uma inscrição estadual mas não se sabe a qual estado ela pertece, por exemplo:

ie("012345679") === ["se", "pb", "am", "ro", "sc", "pi", "es", "mt", "to"];

Quando o estado é fornecido, a validação é otimizada pois o valor da inscrição estadual é testada apenas contra a regra do estado especificado e a função retorna estritamente true ou false.

Contribuindo

Faça um fork depois um pull request. Contribuições só são aceitas com testes unitários.

Testes

Para rodar os testes:

npm test

Todas as inscrições estaduais nos testes foram obtidas publicamente na internet. Se você obteve uma validação falsa para uma inscrição estadual verdadeira, pesquise no site do Sintegra se de fato esta inscrição estadual existe e é valida, neste caso abra uma notificação aqui no GitHub para apurarmos o caso.

Minificando

Para minificar:

grunt minify

---

Licença MIT