¶ Banco Ailos
Esse manual tem como objetivo orientar sobre a configuração da forma de cobrança, para emissão de boletos bancários através do Banco Ailos.
No Banco Ailos é possível transmitir os boletos para o banco através:
- Remessa CNAB400
- Remessa CNAB240
A liquidação dos títulos pode ser realizada através:
- Remessa CNAB400
- Remessa CNAB240
Todo o procedimento realizado aqui, pode ser acompanhado pela equipe da HubSoft para garantir uma melhor configuração. Em caso de dúvidas basta acionar nosso time.
Obs: Não edite nenhuma forma de cobrança já existente em sua base, sempre para realizar uma nova Homologação é necessário a criação de uma nova forma de cobrança.
¶ Configuração Banco Ailos
Para configurar a forma de cobrança, será necessário ter os seguintes dados em mãos (solicite esses dados ao seu gerente bancário):
- Tipo/Formato do CNAB (
400 ou 240) - Número do Convênio
- Agência
- Dígito da Agência (
DV) - Conta
- Dígito da Conta (
DV) - Carteira (
EX: 17, 19, 35, etc) - Variáção da Carteira (
EX: 027) - Modalidade da Carteira (
EX: caucionada, descontada, simples, vinculada, etc)
Outros dados, que já é bom ter anotado para facilitar a sua configuração
- Empresa (
Razão Social e CNPJ) - Nome do Cedente (
Normalmente será a Razão Social da Empresa) - Mensagem Local de Pagamento (
Normalmente será: Pago em Qualquer Banco mesmo após o Vencimento) - Percentual de Juros após o vencimento
- Multa após o vencimento
Vá até o HubSoft, no menu Lateral > Configuração > Financeiro > Forma de Cobrança, conforme imagem abaixo:
Na tela que abrir, clique no canto superior direito Adicionar para criar uma nova Forma de Cobrança.
Na aba Dados serão preenchidos os dados do Banco Emissão, Caixa Financeiro, Layouts de Impressão, Empresa e Perfil de Suspensão, conforme imagem abaixo. Defina também um bom nome para a sua forma de cobrança, dessa forma, ficará mais fácil e simples para sua equipe, no momento de realizar uma nova venda.
Preencha o Banco = 085 - Coop Central Ailos.
Na aba Configuração, iremos preencher os dados que o gerente bancário passou e também os demais dados como juros, multa, instruções do boleto, espécie do documento, etc.
Preenchido todos os dados clique em salvar e sua forma de cobrança estará configurada.
Importante: Nesse tutorial acima, foi uma descrição dos campos essenciais e básicos da forma de cobrança. Porém o HubSoft possui diversas outras configurações, para saber mais sobre elas, basta clicar no ícone de interrogação (?) que fica a frente de cada campo no HubSoft, nas configuracão da forma de cobrança.
¶ Finalizando a Homologação através de CNAB [240/400]
Uma homologação garante que seu provedor possa de comunicar com o Banco através dos arquivos CNAB de Retorno/Remessa, recomendamos que seja feito os seguintes procedimentos abaixo:
-
Gerar 3 Boletos Bancários: (
Sugestão, os boletos podem ser com valores de 10,00). Passo a passo abaixo: -
Gere uma Remessa: (
Após gerar os boletos, adicione o mesmo na remessa e encaminhe ao banco.). Passo a passo abaixo: -
Efetue o Pagamento do Boleto: (
Para garantir que os boletos foram gerados corretamente, efetue o pagamento dos mesmos.) -
Processe o Retorno: (
Após efetuar o pagamento no próximo dia util o banco vai disponibilizar um arquivo contendo todos os pagamentos do dia.). Passo a passo abaixo:
Após o processamento de Retorno e reconhecimento do pagamento de pelo menos um boleto de testes, sua Forma de Cobrança vai estar homologada com sucesso.
¶ Envios de Cobrança
O HubSoft possui em suas rotinas, o envio automático da cobrança do cliente, através dos canais:
- SMS / Mensageiros (WhatsApp, etc)
- PUSH Notification (Para provedores que possuem o APP para o cliente)
- Ligação Telefônica
Para saber como configurar cada um deles, basta clicar nos links abaixo:
¶ API
Disponível a partir da versão 1.121.
Com o Ailos é possível realizar o envio / transmissão do boleto para o banco, via API. Quando utilizado essa modalidade, não é mais necessário fazer o envio de remessa para registro do boleto. Além disso, os boletos nessa modalidade serão registrados em até 5 minutos no banco após gerados.
Caso seja gerado um volume muito grande de boletos (como por exemplo um faturamento mensal e/ou de carnês), o registro pode demorar mais do que 5 minutos, pois o HubSoft faz o envio em lotes para o Ailos.
¶ Integrando no HubSoft
Para iniciar a integração é necessário solicitar ao Banco os seguintes dados:
- consumer_key: (Obrigatório) Consumer Key disponibilizado pela Ailos no Portal de APIs
- consumer_secret: (Obrigatório) Consumer Secret disponibilizado pela Ailos no Portal de APIs
- uuid_desenvolvedor: (Obrigatório) UUID do desenvolvedor (ailosApiKeyDeveloper) cadastrado no Portal da Ailos
Vamos até o HubSoft, no menu Lateral > Configuração > Financeiro > Forma de Cobranca. Vá em Editar na forma de cobrança que deseja ativar a API.
Em seguida vamos na aba API e marcamos a ativação da API, conforme imagem abaixo:
Muito Importante: Caso o campo Dias antes de vencer não seja preenchido, o HubSoft irá transmitir todos os boletos pendentes via API. Então se o seu provedor trabalha com alguma regra específica, como por exemplo, registrar somente os boletos que irão vencer nos próximos 30, 45 ou 60 dias, lembra de realizar essa configuração com exatidão, para evitar custos desnecessários com baixas / cancelamentos de boletos.
Agora, vamos até a aba Parâmetros e preenchemos os atributos, conforme imagem abaixo:
Se tratando de formas de cobrança que possuem registro por API, ao clicar no ícone “Ajuda”, será exibido os parâmetros disponíveis e quais são obrigatórios ou não na integração.
Sucesso! Feito isso a integração já funcional.
Basta emitir um boleto no HubSoft e verificar se dentro de 5 minutos o mesmo será registrado.
¶ Integração API + PIX
É possível configurar para que durante o registro do Boleto, já seja gerado também um QR Code de PIX, essa modalidade é chamada de Boleto Híbrido. Antes de ativar esse recurso, verifique com seu gerente, se essa opção já está configurada na sua conta.
Para ativar esse recurso é muito simples, basta acessar as configurações da sua forma de cobrança, na aba Parâmetros. Em seguida, adicione o parâmetro bolePix com o valor true, conforme imagem abaixo:
Importante: Apenas os boletos gerados após essa configuração é que terão o QR Code gerado. Os boletos já registrados anteriormente, não possuirão o QR Code, uma vez que o mesmo é gerado pela Ailos, durante o registro do boleto.
Os boletos híbridos poderão ser pagos via PIX utilizando QR Code que o banco irá gerar automaticamente no registro do boleto. Para receber os pagamentos de forma imediata, é necessário fazer a configuração de Webhook / Notificações.
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados ao Banco Ailos. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ O banco Ailos possui integração via API?
Atualmente com o Banco Ailos possuimos somente homologação via CNAB 200/400 comunicação via remessa/retorno, não há integração via API.
¶ O cliente tentou realizar o pagamento de um boleto porém retornou que o mesmo não está registrado, o que pode ser?
Neste caso é necessário analisar se este boleto do cliente foi enviado ao banco via arquivo de remessa e se o memso foi registrado no banco, para que fique disponível para pagamento via código de barras.