Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
broleto
Advanced tools
Readme
npm install broleto --save
ou
yarn add broleto
import { Boleto } from "broleto"
const boleto = new Boleto('34191091070000013555851122200002157810000115300');
boleto.valid();
// output
true
Caso o boleto seja de arrecadação ou o banco não esteja mapeado na biblioteca será retornado uma string Unknown
boleto.banks();
// output
'Itaú Unibanco S.A'
Essa função irá retornar se o boleto é LINHA DIGITAVEL
, CODIGO DE BARRAS
ou INVALIDO
.
boleto.codeType();
// output
'LINHA DIGITAVEL'
Essa função irá retornar se o boleto é ARRECADACAO
ou BANCO
.
Em caso de ARRECADACAO
é retornado um subtipo que podem ser os seguintes valores:
ARRECADACAO_PREFEITURA
, CONVENIO_SANEAMENTO
, CONVENIO_ENERGIA_ELETRICA_E_GAS
,
CONVENIO_TELECOMUNICACOES
, ARRECADACAO_ORGAOS_GOVERNAMENTAIS
, OUTROS
,
ARRECADACAO_TAXAS_DE_TRANSITO
ou ''
(string vazia)
boleto.type();
// output
{
type: 'BANCO',
subtype: '',
}
boleto.expirationDate();
// output
2013-08-05T00:00:00.000Z
boleto.expired();
// output
true
Caso o boleto não esteja é retornado o valor 0
boleto.expiredDays();
// output
2434
boleto.amount();
// output
1153
Disponibilizamos também a possibilidade de calcular juros do boleto. O método pode receber até 4 parâmetros.
Exemplo:
boleto.interest(interestValue, expiredDays = false, percent = true, month = true)
interestValue
- é um valor numérico que corresponde a porcentagem ou valor cobrado como juros.expiredDays
- pode receber ou um valor numerico que se refere a quantidade de dias vencidos do boleto ou um valor booleano (false) caso queira que a quantidade de dias vencidos usado no cálculo do juros seja obtido de forma automática, por padrão esse valor é false
.percent
- é um valor booleano que por padrão é true
refere-se ao tipo do valor informado. Em caso de true isso quer dizer que o valor informado para interestValue
no calculo é em porcentagem. Caso informe false o interestValue
passa a ser compreendido como valor em reais.month
- Informa como o juros é calculado, se é ao mês ou ao dia. Por padrão o valor é true
, ou seja, no calculo o juros cobrado será ao mês. Caso queria informar que o juros é calculado ao dia, informe false
para este parâmetro.boleto.interest(1, false, true, true);
// ou somente
boleto.interest(1);
// output
935.46
Disponibilizamos também a possibilidade de calcular multa do boleto. O método pode receber até 2 parâmetros.
Exemplo:
boleto.fines(finesValue, percent = true)
finesValue
- é um valor numérico que corresponde a porcentagem ou valor cobrado como multa.percent
- é um valor booleano que por padrão é true
refere-se ao tipo do valor informado. Em caso de true
isso quer dizer que o valor informado para finesValue
no calculo é em porcentagem. Caso informe false
o finesValue
passa a ser compreendido como valor em reais.boleto.fines(17, false);
// output (nesse caso o boleto possui 17 reais de multa)
17
// ou
boleto.fines(1);
// output (1% de multa)
11.53
Existe um método que agrupa as demais informações sobre um boleto.
boleto.toJSON();
// output
{
barcode: '34191578100001153001091000000135555112220000',
codeType: 'LINHA DIGITAVEL',
type: 'BANCO',
expirationDate: 2013-08-05T00:00:00.000Z,
expired: true,
expiredDays: 2434,
banks: 'Itaú Unibanco S.A',
amount: 1153,
prettyAmount: 'R$ 1.153,00',
valid: true
}
git clone https://github.com/<seu username>/broleto.git
git checkout -b feat/minha-feature-de-examplo
git commit -m "feat: Minha nova feature"
(Ver regras para commits)git push origin feat/minha-feature-de-examplo
Jardel Gonçalves |
Diego Gaspar |
MIT © Jardel Gonçalves
FAQs
Valide e/ou obtenha dados de boletos bancário ou arrecadação de forma fácil.
The npm package broleto receives a total of 712 weekly downloads. As such, broleto popularity was classified as not popular.
We found that broleto demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.