npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

br-bank-account-validator

v0.0.8

Published

rm

Downloads

2,068

Readme

Validador de contas bancárias

Este projeto valida números de agencia e conta bancárias de vários bancos e de forma offline. Compatível com nodejs ou webpack.

A validação da conta bancária é realizada sobre as regras dos seguintes bancos: Itaú, Bradesco, Banco do Brasil, Santander, Citibank e HSBC. Para os outros bancos é realizada uma validação padrão:

  • Agência de 1 até 5 números
  • Dígito da agência de 0 a 2 caracteres
  • Conta corrente de 1 até 12 números
  • Dígito da conta corrente de 0 a 2 caracteres

O número da agência e conta corrente dos bancos Itaú, Bradesco, e Banco do Brasil são validados através do cálculo do dígito verificador (semelhante a validação do CPF).

Como utilizar:

Primeiro instale o pacote

npm install br-bank-account-validator --save

Importe o módulo na sua aplicação

import BankAccountValidator from "br-bank-account-validator";

Depois utilize o método BankAccountValidator.validate com os seguintes objetos:

  • bankNumber
  • agencyNumber
  • agencyCheckNumber
  • accountNumber
  • accountCheckNumber.

Se os dados não forem válidos uma erro será lançada com a descrição do problema

Exemplo de utilização

import BankAccountValidator from "br-bank-account-validator";

try {
    BankAccountValidator.validate({
        bankNumber: "123",
        agencyNumber: "1234",
        agencyCheckNumber: "5",
        accountNumber: "12345",
        accountCheckNumber: "6",
    });
    // Se chegou até aqui, a conta bancária é válida

} catch (e) {
    // se não for válida, lança uma exceção
    console.log(e.message);
}

Comportamento

Se os dados forem válidos, o código segue normalmente.

Se os dados não forem válidos, uma exceção do tipo BankAccountValidatorException é lançada com os seguintes parâmetros:

  • message: Mensagem em português descrevendo todos os errors de por que os dados não são válidos
  • code: Código de error do primeiro erro identificado. este código pode ser:
  • errors: Um array de todos os erros contendo message e code cada um

Códigos internos de erro

O parâmetro code pode assumir as seguintes opções:

  • INVALID_AGENCY_NUMBER: A agência deve conter 4 números. Complete com zeros a esquerda se necessário
  • INVALID_AGENCY_CHECK_NUMBER: Dígito da agência inválido
  • INVALID_ACCOUNT_NUMBER: A conta corrente deve conter 5 números. Complete com zeros a esquerda se necessário
  • INVALID_ACCOUNT_CHECK_NUMBER: Dígito da conta corrente inválido
  • AGENCY_CHECK_NUMBER_DONT_MATCH: Dígito da agência não corresponde ao número da agência preenchido
  • ACCOUNT_CHECK_NUMBER_DONT_MATCH: Dígito da conta não corresponde ao número da conta/agência preenchido
  • INVALID_BANK_NUMBER: Banco inválido (quando o código do banco não possui entre 3 e 5 dígitos)

Este projeto foi baseado no projeto https://github.com/wirecardBrasil/bank-account-validator-js.