# Integração Bancária Asaas  

Este documento apresenta instruções detalhadas sobre a **integração e utilização do Gateway do Asaas**, incluindo a **configuração do Webhook** para notificações em tempo real.  

O **Gateway** facilita a **automação de processos bancários**, enquanto o **Webhook** garante **atualizações instantâneas** sobre **transações e eventos**.

> [!NOTE] Requisitos Importantes
> - **Sistema operacional Debian 10**.
> - Para a homologação de uma carteira Gateway o **indicado** é abrir um novo convênio de conta bancária. Caso deseje utilizar um que já esteja em uso no IXC e/ou que já tenha boletos emitidos por ele, deve estar ciente de que podem ocorrer divergências nos relatórios provenientes de arquivos de retorno.  
Entre as divergências estão: Informação de Título não encontrado nos processamentos de retorno (quem se referem a títulos da carteira de Gateway), liquidações atreladas a boletos divergentes, etc.

## Objetivos da Integração  

- Ampliar a variedade de **integrações disponíveis** no sistema.  
- Atender à demanda dos **clientes da Asaas** que buscam compatibilidade com o sistema.  
- Implementar a **geração automática de boletos híbridos** e otimizar o **processamento de baixas de pagamentos** de forma integrada e eficiente.  
- Oferecer **mais uma opção de integração**, proporcionando **maior flexibilidade** na escolha de soluções financeiras.  

## Benefícios da Integração  

### 1. Automação de Processos  
- **Baixa automática de pagamentos**: Pagamentos realizados serão baixados automaticamente no sistema, garantindo **maior precisão** e **economia de tempo**.  

### 2. Economia e Eficiência  
- **Redução de custos**: Com as **tarifas competitivas** da Asaas, os clientes economizam em **transações financeiras** enquanto utilizam uma solução integrada.  
- **Centralização de operações**: Os clientes poderão **gerenciar boletos e pagamentos** em uma única plataforma, eliminando a necessidade de **múltiplos sistemas e fornecedores**.  

### 3. Melhor Experiência para o Cliente  
- **Solicitação atendida**: Atende à demanda dos clientes que já utilizam a **Asaas** e desejam continuar com seus serviços de forma **integrada ao sistema**.  
- **Facilidade de adoção**: A integração foi desenvolvida para ser **intuitiva e de fácil implementação**, permitindo que os clientes comecem a utilizá-la **imediatamente**.  

### 4. Vantagem Competitiva  
- **Maior atratividade do sistema**: A disponibilização dessa integração torna a plataforma **mais atraente para novos clientes** que possuem ou desejam utilizar contas na **Asaas**.  
- **Retenção de clientes**: Ao oferecer **soluções alinhadas às necessidades dos usuários**, o sistema contribui para **aumento da satisfação e retenção de clientes**.

## Processo de Integração e Homologação
Para realizar a integração e homologação da Gateway Asaas no sistema, siga estes passos:

### Homologação
> [!EXAMPLE] Dados bancários necessários para a integração:
>
> **461 - Asaas (Gateway)**
>
> * 1 - Número da agência com dígito?
> * 2 - Número da conta com dígito?
> * 3 - Wallet ID?
> * 4 - Chave de Gateway?

> [!TIP] Dica!
> Caso tenha dúvida sobre algum dos dados bancários, consulte o(a) Gerente de sua Conta Bancária.

### Passo a passo para obter as Credenciais da Gateway
> [!info] Informação!
> Para a homologação da carteira de Gateway do Asaas, você também precisa gerar o Wallet ID e a Chave da Gateway, que são as credenciais da aplicação da Gateway geradas no Internet Banking da Asaas.

1. Acesse o [Internet Banking Asaas](https://www.asaas.com/login)
2. Faça login com sua Conta
3. No canto superior direito, clique no menu de conta e acesse o botão Integrações
4. Clique em Gerar nova chave de Gateway
5. Logo abaixo, na sessão Wallet ID, copie a chave do identificador de carteira da conta Asaas
6. Anote estas duas credenciais geradas para a criação da carteira

> [!SUCCESS] Credenciais Gateway Finalizadas!
> Feito isso, junto com os seus outros dados bancários, o atendente da IXC Soft poderá prosseguir com a homologação da sua carteira de cobrança de Gateway.

### Criando a Carteira
1. Acesse o menu **Sistema**
2. Pasta **Financeiro**
3. E clique em **Carteira de cobrança**
4. Clique em **Novo**
5. Na primeira aba chamada **Carteira de cobrança**, você fará as seguintes configurações:
	- **Descrição:** Aqui você irá definir a nomeação da carteira.
	- **Conta:** Aqui você irá criar a conta, responsável por armazenar seus dados bancários.  
	- **Tipo de recebimento:** Neste campo você deve selecionar a opção **Gateway
	- **Enviar e-mail para cliente ao gerar:** Marcar como **Não**, pois torna obrigatório o e-mail de cadastro do cliente e envia automaticamente a fatura do cliente, fazendo assim o registro da mesma no banco (sendo assim, não é recomendado o uso)
	- **Validar filial na venda:** Marcar como **Sim**
	- **Planejamento analítico:** utilize o padrão **240**, ou cadastre um novo

### Criando a Conta
- **Conta:** Defina o nome para a conta
- **Tipo da Conta:** Marque a opção **Banco**
- **Data de abertura:** Informe o dia em que está configurando a conta para esta carteira.
- **Planejamento analítico:** Para mais informações, acesse: [[formulario planejamento analitico|Formulário Planejamento Analítico]]
- **Filial:** Selecione o ID da filial para a qual será criada esta **Conta** e a **Carteira** 

Na aba seguinte **Banco:**
- **Banco:** Como a Asaas não é associada ao Banco Central, não precisa preencher este campo
- **Agência:** Número da sua agência bancária
- **Dígito verificador da agência:** Insira o dígito verificador que fica após o número da agência
- **Número da conta:** Número da sua conta bancária
- **Dígito verificador da conta:** Informe o dígito verificador de sua conta bancária

### Configurações Gateway
- **Gateway:** Selecione o **Asaas**
- **Ambiente gateway:** Selecione **Produção**
- **Wallet ID:** Insira o código gerado anteriormente em sua conta Asaas
- **Chave de Gateway:** Insira o código gerado anteriormente em sua conta Asaas
- **Envia e-mail Gateways:** Marque como **Não**
- **Gera pix:** Marque como **Sim**, ser for utilizar o Pix no boleto
- **Tarifas Gateway:** aqui você define o lançamento das tarifas gateway, pois o banco não faz isso de forma automática. Acesse [[tarifas bancarias - gateway, api e pix|Tarifas Bancárias - Gateway, API e Pix]] para mais informações

> [!TIP] Dica!
> Após clicar em **Salvar** a carteira, os campos Webhook ID e Webhook serão preenchidos automaticamente pelo sistema.

### Juros/Multas/Desconto
- **Juros %:** Valor padrão (máximo permitido por lei, acima é caracterizado juro abusivo), configure 0.033%
- **Multa %:** Valor padrão (máximo permitido por lei, acima é caracterizado multa abusiva), configure 2%
- **Desconto até o vencimento R$:** Insira um valor em **Reais** para conceder desconto na fatura, se paga até a data do vencimento
- **Desconto até o vencimento %:** Insira um valor em **Porcentagem** para conceder desconto na fatura, se paga até a data do vencimento

Para mais informações, acesse: [[juros, multas e desconto|Juros, Multas e Desconto]].

> [!WARNING] Aviso!
> A Gateway Asaas não tem valor mínimo para que seja possível registrar uma cobrança.

### Instruções
> [!INFO] Informação!
> * Asaas Gateway permite o uso de no máximo **500 caracteres** totais para serem inseridos como linha de instrução na impressão do boleto.  
> * Não tem limite de linhas.

Remova as aspas antes e depois das hashtags abaixo:
- **Instrução 1:** 
```
Após vencimento juros R$ #juro# ao dia.
```

- **Instrução 2:**
```
Após vencimento multa R$ #multa#.
```

> [!WARNING] Aviso!
> Caso adicione mais linhas, também deve inserir a variável de leitura da linha de instrução, nos parâmetros **Imprimir instruções quando..

Para mais informações, acesse: [[instrucoes da carteira de cobranca|Instruções da Carteira de Cobrança]].

### Impressão
- **Layout de impressão:** Utilize o padrão **3 por página**

Para mais informações, acesse: [[layouts de impressao|Layouts de Impressão]].


## Fluxo de Funcionamento
```mermaid
sequenceDiagram
    participant S as Sistema
    participant Gateway as Gateway Asaas
    participant W as Webhook

    S->>Gateway: Envia requisição (ex: gerar boleto)
    Gateway->>S: Responde com dados do boleto
    Note over Gateway,W: Evento ocorre (ex: pagamento)
    W->>S: Notifica sobre o evento
    S->>Gateway: Confirma recebimento da notificação
```

## Tarefa de Consulta de Retorno
> [!TIP] Dica:
> Caso queira uma garantia adicional de baixa de pagamentos, além do webhook, também é possível configurar uma tarefa que consulta os pagamentos.  
> Esta tarefa deve ser configurada para executar somente 1x no dia, pela manhã, e com isso sempre irá consultar os pagamentos dos títulos que vencem no dia anterior.

Para realizar a configuração, acesse:
1. Menu **Ferramentas**
2. Clique em **Ferramentas**
3. **Agenda de tarefas**
4. Botão **Novo**
5. **Tarefa:** Selecione **Processamento retorno Asaas Gateway***
6. **Minuto (0-59):** Coloque o valor dos minutos, entre 0 e 59 min
7. **Hora (0-23):** Coloque o valor da hora, entre 0 e 23

### Ativação
> [!SUCCESS] Finalizado!
> Concluídos todos os passos anteriores, a carteira e as tarefas de consulta estão finalizadas.  Com isso, o boleto teste já pode ser gerado para efetuar o pagamento e validar a baixa da fatura no Sistema.
Após efetuada a baixa da fatura de forma automática, a homologação estará finalizada.

## Considerações Finais  

A **integração entre a Asaas e o IXC Provedor** representa um avanço significativo na otimização da **gestão financeira** para **provedores de serviço**.  

Com **automação de processos, redução de custos** e suporte às demandas dos clientes, essa parceria fortalece a eficiência financeira, proporcionando um ambiente de negócios **mais ágil e simplificado**.

## Etiquetas
#IntegracaoBancaria #GatewayBancaria #Asaas 

## Leia Também
* [[carteira de cobranca|Carteira de Cobrança]]
* [[integracoes bancarias - carteira de cobranca|Integrações Bancárias - Carteira de Cobrança]]
* [[integracoes bancarias - gateway|Integrações Bancárias - Gateway]]
* [[gateway asaas|Gateway Asaas]]
* [[como solicitar o pix na central do assinante|Como Solicitar o Pix na Central do Assinante]]
* **Manual Gateway Asaas**: https://docs.asaas.com/docs/cobrancas-via-boleto