Giter VIP home page Giter VIP logo

boleto-brasileiro-validator's Introduction

boleto-brasileiro-validator

Biblioteca para validar boletos.

Suporta boletos de arrecadação e boletos bancários, tanto a representação do código de barras como a linha digitável.

Todas as validações podem ser feitas com ou sem máscara.

Exemplos de boletos

Arrecadação

Represetação visual do código de barras do boleto de arrecadação

Arrecadação - Código de barras

85890000460 52460179160 60759305086 83148300001

Arrecadação - Linha digitável

85890000460-9 52460179160-5 60759305086-5 83148300001-0

Bancário

Represetação visual do código de barras do boleto bancário

Bancário - Código de barras

84890000000404201622018060519042958603411122

Bancário - Linha digitável

23793.38128 60007.827136 95000.063305 9 75520000370000

Instalação

npm install boleto-brasileiro-validator --save

Como usar

Para validar qualquer tipo de boleto, com ou sem máscara

  import { boleto } from 'boleto-brasileiro-validator';

  boleto('23793.38128 60007.827136 95000.063305 9 75520000370000'); // true
  boleto('23793381286000782713695000063305975520000370000'); // true
  boleto('836200000005 667800481000 180975657313 001589636081'); // true
  boleto('536200000005 667800481000 180975657313 001589636081'); // false
  boleto('001933737000000144816060680935031'); // false

Para validar boletos de arrecadação (luz, água, etc.)

  import {
    boletoArrecadacao, // valida qualquer tipo de boleto de arrecadação
    boletoArrecadacaoCodigoBarras, // valida representação númerica do código de barras
    boletoArrecadacaoLinhaDigitavel, // valida linha digitável do boleto
  } from 'boleto-brasileiro-validator';

  boletoArrecadacao('836200000005 667800481000 180975657313 001589636081'); // true
  boletoArrecadacaoCodigoBarras('84890000000404201622018060519042958603411122'); // true
  boletoArrecadacaoLinhaDigitavel('85890000460-9 52460179160-5 60759305086-5 83148300001-0'); // true

Para validar boletos bancários

  import {
    boletoBancario, // valida qualquer tipo de boleto bancário
    boletoBancarioCodigoBarras, // valida representação númerica do código de barras
    boletoBancarioLinhaDigitavel, // valida linha digitável do boleto
  } from 'boleto-brasileiro-validator';

  boletoBancario('23793.38128 60007.827136 95000.063305 9 75520000370000'); // true
  boletoBancarioCodigoBarras('00193373700000001000500940144816060680935031'); // true
  boletoBancarioLinhaDigitavel('23793381286000782713695000063305975520000370000'); // true

Observação

Por padrão, a validação individual de cada bloco não é realizada.

Caso esse comportamento seja necessário, as seguintes funções aceitam um parâmetro adicional para habilitar a validação:

  boleto('23793.38128 60007.827136 95000.063305 9 75520000370000', true);
  boletoBancario('23793381286000782713695000063305975520000370000', true);
  boletoBancarioLinhaDigitavel('23793381286000782713695000063305975520000370000', true);
  boletoArrecadacao('836200000005667800481000180975657313001589636081', true);
  boletoArrecadacaoLinhaDigitavel('836200000005667800481000180975657313001589636081', true);

Regras de Validação

Regras para validação de boletos bancários: Especificações Técnicas para Confecção de Boleto de Cobrança do Banco do Brasil

Regras para validação de boletos de arrecadação: FEBRABAN - "Layout" Padrão de Arrecadação/Recebimento com Utilização do Código de Barras

Licença

This project is licensed under the MIT License - see the LICENSE.md file for details

boleto-brasileiro-validator's People

Contributors

dependabot[bot] avatar leomaurodesenv avatar mcrvaz avatar renatoagds avatar t-bonatti avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

boleto-brasileiro-validator's Issues

Erro ao validar cobrança do DAS

Olá, parabéns pelo projeto.
Estava analisando o seu código e acho que tem erro na forma que trata o modulo 11, imagino que deveria ter dois tipo de calculo do modulo 11.
A regra que aplicou, se entendi o que andei lendo, se aplica a boleto e não a convenio.
Segue o código do DAS que não valida
85800000007 0 43840328192 2 63072019252 8 30472960052 3

Dados do Boleto

Ola, tudo bem?

Somente para perguntar... existe a possibilidade de extração de dados do boleto?

Python: portabilidade

Olá, gostaria de desenvolver a portabilidade deste código para Python, ou se alguém já tiver feito - gostaria de contribuir com o projeto.

Problema na atualização da versão 1.0.4

Prezado desenvolvedor,

Ao tentar instalar a versão mais nova (1.0.4) do boleto-brasileiro-validator via npm install num projeto angular, percebi que o diretório nome_modules/boleto-brasileiro-validator/dist não é copiado do repositório para a minha máquina. Fiz a instalação com a versão 1.0.3 via comando npm install [email protected] --save e funcionou normalmente. Gostaria de saber se estou fazendo algo errado na instalação do validator?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.