## Introdução  
Com o avanço das integrações bancárias e devido à necessidade de ajustes nos serviços de comunicação, foi realizada uma atualização nas rotas da API associada à Efí Bank. As rotas antigas, baseadas no domínio "gerencianet", serão descontinuadas a partir de 20 de dezembro de 2024. Este documento detalha o processo de configuração necessário para manter suas integrações funcionando corretamente após a alteração.

> [!WARNING] Aviso!
> Essas alterações são fundamentais para garantir a continuidade do serviço e aproveitar as melhorias oferecidas com as novas rotas hospedadas no Efí Bank. A conectividade reformulada assegura maior segurança, estabilidade e compatibilidade com as novas tecnologias.  

## Objetivo  
O objetivo deste documento é instruir, de forma clara e objetiva, os usuários sobre como implementar as alterações necessárias nas rotas de comunicação das APIs associadas ao Efí Bank. Além disso, ele busca explicar os benefícios das mudanças, fornecer instruções práticas para parametrização do ambiente e destacar as principais implicações dessas atualizações.  

## Benefícios  
A atualização traz os seguintes benefícios aos usuários:  
- Maior estabilidade no consumo das APIs com hospedagem na Efí Bank.   
- Melhorias na segurança das conexões API com certificados atualizados.  
- Integração simplificada com suporte contínuo às funcionalidades Pix, Cobranças e Pagamentos.  
- Adoção de padrões mais modernos e compatíveis com melhorias futuras.  

> [!EXAMPLE] Atualização Rota APIs Efí Bank - Gerencianet
>    - Para **API Pix**:
>      - Ambiente de Produção:  
>        Substitua `https://api-pix.gerencianet.com.br` por `https://pix.api.efipay.com.br`.
>      - Ambiente de Homologação:  
>        Substitua `https://api-pix-h.gerencianet.com.br` por `https://pix-h.api.efipay.com.br`.
>    - Para **API Cobranças**:  
>      - Ambiente de Produção:  
>        Substitua `https://api.gerencianet.com.br` por `https://cobrancas.api.efipay.com.br`.
>      - Ambiente de Homologação:  
>        Substitua `https://api-h.gerencianet.com.br` por `https://cobrancas-h.api.efipay.com.br`.
>    - Para **API Pagamentos**:  
>      - Ambiente de Produção:  
>        Substitua `https://apis.gerencianet.com.br` por `https://pagarcontas.api.efipay.com.br`.
>      - Ambiente de Homologação:  
>        Substitua `https://apis-h.gerencianet.com.br` por `https://pagarcontas-h.api.efipay.com.br`.

## Impactos na Mudança
1. **Descontinuidade de rotas antigas**: A partir de 20 de dezembro de 2024, qualquer integração que continue utilizando os domínios `gerencianet` será inutilizada.  
2. **Mudanças na estrutura de código**: As dependências e instâncias de classes relativas à Gerencianet precisarão ser atualizadas.  
3. **Benefícios operacionais**: Além da continuidade no serviço, haverá melhorias em desempenho, segurança e suporte a novos recursos.  

## Ajustes Necessários para Configurações de Rede
**Não será necessário realizar nenhuma alteração** diretamente em suas carteiras de cobrança, utilizadas para emitir cobranças ou faturas através das APIs da Efí Bank. A atualização das rotas da API é **uma alteração interna do sistema** que não impacta a funcionalidade do uso regular das carteiras de cobrança.  

Contudo, **provedores que utilizam regras específicas de bloqueio de rede e firewall**, e configuram manualmente os acessos às rotas das APIs da Efí Bank, **devem ajustar os domínios em suas configurações de rede do servidor**.  

> [!WARNING] Aviso!
> Não é necessário atualizar as rotas de ambiente de Homologação, pois são apenas para testes. Você irá utilizar somente as de ambiente de **Produção**.

> [!EXAMPLE] Novas rotas que precisam ser liberadas:  
> - **API Pix**
> 	- Produção: `https://pix.api.efipay.com.br`  
> - **API Cobranças**
> 	- Produção: `https://cobrancas.api.efipay.com.br`  
> - **API Pagamentos**
> 	- Produção: `https://pagarcontas.api.efipay.com.br`  

Certifique-se de que as novas rotas estejam devidamente configuradas e liberadas para permitir a comunicação entre o servidor e a Efí Bank. Essa adequação é essencial para garantir a continuidade da operação, especialmente no caso de ambientes com restrições de rede.

## Considerações Finais
A alteração nas rotas das APIs Efí Bank é uma mudança essencial para a continuidade e evolução dos serviços financeiros integrados. Ao seguir este passo a passo, os usuários garantirão a funcionalidade de suas integrações, além de desfrutarem dos avanços introduzidos pelas novas rotas e infraestrutura do Efí Bank. Lembre-se de testar todas as alterações antes de aplicá-las em produção.  

## ETIQUETAS  
#API #Pix #Cobrancas #Pagamentos #Integracoes #EfiBank

## LEIA TAMBÉM  
- [[contas a receber|Contas a Receber]]
- [[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 efi|Gateway Efí]]
- [[integracoes bancarias - pix avulso|Integrações Bancárias - Pix Avulso]]
- [[efi - pix avulso|Efí - Pix Avulso]]
- [[integracoes bancarias - cartao de credito|Integrações Bancárias - Cartão de Crédito]]
- [[efi - cartao de credito|Efí - Cartão de Crédito]]
- [[logs gateway|Logs Gateway]]
- [[como reprocessar logs gateway|Como Reprocessar Logs Gateway]]
- [[localizar pagamentos - logs gateway|Localizar Pagamentos - Logs Gateway]]
- [[logs de rotinas de cobranca gateway|Logs de Rotinas de Cobrança Gateway]]
- [[reenvio de notificacoes gateway efi bank|Reenvio de Notificações Gateway Efí Bank]]