ailos-js-wrapper v1.0.6
Ailos JS Wrapper
Wrapper JS para trabalhar com a API do Sistema Ailos.
Instalação
$ npm install ailos-js-wrapper --saveComo usar
Veja os exemplos na pasta demo
ES6
import AilosWrapper from 'ailos-js-wrapper';
const session = new AilosWrapper({
contaCorrente: 8400000,
senha: '00000000',
fraseSecreta: 'aoinfinitoealem'
});
// usando método
session.account.getStatement('2018-10-03', '2018-11-06')
.then(response => console.log(JSON.stringify(response)));CommonJS
const AilosWrapper = require('ailos-js-wrapper').default;
const session = new AilosWrapper({
contaCorrente: 8400000,
senha: '00000000',
fraseSecreta: 'aoinfinitoealem'
});UMD in Browser
<!-- to import non-minified version -->
<script src="ailos-js-wrapper.umd.js"></script>
<!-- to import minified version -->
<script src="ailos-js-wrapper.umd.min.js"></script>Métodos
auth()
Autentica com as credenciais da sessão e retorna o token JWT.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
Exemplo
const session = new AilosWrapper({
contaCorrente: 8400000,
senha: '00000000',
fraseSecreta: 'aoinfinitoealem'
});
session.auth()
.then(token => {
session.setToken(token);
})
.catch(error => console.error(error));setToken(token)
Define o token JWT que será usado nas requisições.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
| token | string | Token JWT |
Exemplo
session.auth()
.then(token => {
session.setToken(token);
})account.getBalance()
Retorna o saldo da conta.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
Exemplo
session.account.getBalance()
.then(data => {
// ...
})account.getStatement(startDate, endDate)
Retorna o extrato da conta do período informado.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
| startDate | string | Data de início do extrato |
| endDate | string | Data final do extrato |
Exemplo
session.account.getStatement('2018-11-25', '2019-01-06')
.then(data => {
// ...
})transfer.doTransaction(value, recipient, credentials)
Efetua uma transação bancária Sistema Ailos e TED.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
| value | number | Valor a ser transferido |
| recipient | Object | Dados do favorecido |
| credentials | Object | Credenciais de segurança |
recipient (Favorecido Sistema Ailos)
| Argumento | Tipo | Descrição |
|---|---|---|
| bankCode | string | Código do banco (85) |
| agencyCode | string | Código cooperativa |
| accountNumber | string | Número da conta |
| date | string | Data a ser efetuada a transação |
| typeAccount | number | Tipo de conta (1 - Corrente, 2 - Poupança, 3 - Pagamento) |
| typePerson | number | Tipo de pessoa (1 - Física, 2 - Jurídica) |
recipient (Favorecido Outros Bancos)
| Argumento | Tipo | Descrição |
|---|---|---|
| bankCode | string | Código do banco |
| agencyCode | string | Agência do banco |
| accountNumber | string | Número da conta |
| name | string | Nome Completo |
| cpfCnpj | string | CPF ou CNPJ |
| date | string | Data a ser efetuada a transação |
| typeAccount | number | Tipo de conta (1 - Corrente, 2 - Poupança, 3 - Pagamento) |
| typePerson | number | Tipo de pessoa (1 - Física, 2 - Jurídica) |
| finality | string | (Opcional) Finalidade |
| comment | string | (Opcional) Comentário |
| commentCreditor | string | (Opcional) Comentário credor |
credentials
| Argumento | Tipo | Descrição |
|---|---|---|
| securityLetters | string | Letras de segurança de 3 dígitos |
| password | string | Senha de 8 dígitos |
Exemplo (Sistema Ailos)
const ailosRecipient = {
bankCode: '85',
agencyCode: '0101',
accountNumber: '8400000',
date: '2018-12-07',
typeAccount: 1,
typePerson: 1
};
const credentials = {
securityLetters: 'ASD',
password: '00000000'
};
session.transfer.doTransaction(10.50, ailosRecipient, credentials)
.then(data => {
// ...
})Exemplo (Outros Bancos)
const tedRecipient = {
bankCode: '104',
agencyCode: '0852',
accountNumber: '412678',
cpfCnpj: '98992252900',
name: 'WOODY PRIDE',
date: '2018-12-15',
typeAccount: 1,
typePerson: 1
};
const credentials = {
securityLetters: 'ASD',
password: '00000000'
};
session.transfer.doTransaction(10.50, tedRecipient, credentials)
.then(data => {
// ...
})transfer.getListBanks()
Retorna a lista de bancos com o código, nome e código ISPB.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
Exemplo
session.transfer.getListBanks()
.then(data => {
// ...
})transfer.getListCooperatives()
Retorna a lista de cooperativas com o código e nome.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
Exemplo
session.transfer.getListCooperatives()
.then(data => {
// ...
})transfer.getListAilosRecipients()
Retorna lista de favorecidos do Sistema Ailos cadastrados.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
Exemplo
session.transfer.getListAilosRecipients()
.then(data => {
// ...
})transfer.getListTedRecipients()
Retorna lista de favorecidos de outros bancos cadastrados.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
Exemplo
session.transfer.getListTedRecipients()
.then(data => {
// ...
})transfer.getAgencyName(agencyCode, bankCode)
Retorna nome da agência bancária.
Argumentos
| Argumento | Tipo | Descrição |
|---|---|---|
| agencyCode | string | Código da agência |
| bankCode | string | Código do banco |
Exemplo
session.transfer.getAgencyName('0852', '104')
.then(data => {
// ...
})ATENÇÃO!
NÃO utilize essa biblioteca no back-end caso utilize credenciais de outros usuários! Implemente no front-end e transfira apenas os dados necessários para o seu servidor. NÃO envie dados sensíveis de terceiros ao seu servidor sem o devido consentimento!