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!