inscricaoestadual

    0.0.5 • Public • Published

    IE

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

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

    Build Status   IE - Status das dependencias   IE - Última versão

    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

    Install

    npm i inscricaoestadual

    DownloadsWeekly Downloads

    297

    Version

    0.0.5

    License

    MIT

    Last publish

    Collaborators

    • gammasoft