# Integração Bancária Itaú
Este documento detalha as funcionalidades da integração bancária com a instituição Itaú no Sistema, trazendo detalhes sobre seu funcionamento e o processo de integração/homologação.

## Funcionalidades Principais
A integração de **Boleto de Cobrança** com a instituição **Itaú** no IXC Provedor permite que o provedor emita cobranças diretamente de seu Sistema. Com ela, é possível gerar múltiplos boletos e comunicá-los via remessa bancária (Layout CNAB) para solicitações de registro, recebimentos e demais operações.

## Layout CNAB
Esta integração bancária disponibiliza integração no Sistema para os seguintes Layouts de Remessa e Retorno:
- **CNAB 400**

### Melhoria na Integração com o Itaú - Suporte à Liquidação de Pagamentos Via Pix
A integração atual com o Itaú, usando o layout CNAB 400, permite apenas a emissão de boletos sem o Pix diretamente. O banco Itaú, porém, gera um QR Code para o pagamento via Pix ao imprimir os boletos.

## Atualização realizada
O sistema agora reconhece o código de ocorrência "10" no arquivo de retorno, que indica liquidação via Pix. Esse ajuste marca o título como **Recebido via Pix = Sim**, na aba de informações do título.

## Benefício
Isso evita falhas na baixa de pagamentos realizados via Pix, garantindo que o sistema processe corretamente tanto boletos tradicionais quanto pagamentos via QR Code.

### Homologação
Para realizar a integração é recomendado abrir um atendimento com o setor **Suporte Financeiro** do IXC Provedor e você precisará dos seguintes dados:

> [!EXAMPLE] Dados Necessários
>
> **341 - Banco Itaú S.A.**
>
> - 1 - Número da agência com dígito?
> - 2 - Número da conta com dígito?
> - 3 - Número da Carteira?
> - 4 - CNAB 400.
> - Este convênio bancário é totalmente novo ou já foi usado para emissão?
  
> [!TIP] Dica!
> Caso tenha dúvida sobre algum dos dados bancários, consulte o(a) Gerente de sua Conta Bancária.

> [!NOTE] Nota!
> Para validação da primeira remessa de teste, gerar 5 boletos de 20,00 cada.

### 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 **Boleto**.
- **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:** Selecione o ID da instituição, conforme o cadastro nacional de Bancos, no caso para o Itaú é: 
```
341 - Banco Itaú S.A.
```
- **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 Bancárias
- **Espécie de documento:** Preencha com a Espécie de Documento que irá emitir seus boletos.
- **Contador do nosso número:** Acesse o manual para criação do [[contador do nosso numero|Contador do Nosso Número]].
- **Classe das funções:** Insira "Banco Itaú".
- **Carteira:** Insira o número de carteira que deseja utilizar, conforme orientado logo abaixo (109, 112 ou 138).
- Habilite os parâmetros de **Inclusão em Remessa** conforme julgar necessário.
- **Layout remessa:** Selecione a opção "CNAB 400".
- **Layout remessa:** Selecione a opção "CNAB 400 Itaú".

> [!EXAMPLE] Configuração de Distribuição
> 1. **Carteira 109**: O beneficiário imprime e entrega os boletos.
> 2. **Carteira 112 e 138**: O banco é responsável pela impressão e entrega dos boletos ao cliente. Ao usar essa carteira marque no campo **Quem distribui** a opção "Banco". Nessa configuração de carteira 112, o Sistema só permite a impressão dos boletos após ser inserido o arquivo de retorno com status de **Entrada Confirmada**.
> 3. **Campo Código Flash**: É utilizado para as carteiras 112 e 138. Preencha com o código fornecido pelo banco.
> 4. Na opção **carteira 112** também é possível gerar no layout de Cobrança com mensagem, nessa opção as informações que devem ser impressas no boleto pelo banco, irão constar no arquivo de remessa, informações como o plano, se a fatura for proporcional e endereço completo. Para realizar essa configuração, na carteira de cobrança, ainda na aba de **Configurações bancárias**, desça até o menu **Incluir em remessa automaticamente** e marque a opção **Cobrança com mensagem (Itau)** como "sim".

> [!DANGER] Atenção!
> Os layouts de **remessa** e de **retorno** devem estar configurados com o mesmo CNAB. 
> - Exemplo: Se o layout de remessa for CNAB 400, o de retorno também deve ser CNAB 400.

### Juros/Multas/Desconto
- **Juros %:** Valor padrão (máximo permitido por lei, acima é caracterizado juros 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.
- **Desconto parcela proporcional:** Marque esta opção para que sua carteira considere o desconto das faturas com desconto proporcional.

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

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

- **Instrução 2:**
```
Após o vencimento cobrar multa de 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]].

> [!EXAMPLE] Manual CNAB Itaú
 > - [Manual Itaú Layout CNAB 400](https://download.itau.com.br/bankline/layout_cobranca_400bytes_cnab_itau.pdf)

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

## Considerações Finais
A integração da Itaú no Sistema oferece uma solução robusta para gerenciamento de cobranças bancárias. É essencial seguir cuidadosamente o processo de integração e realizar os devidos testes antes de passar para produção.

Para suporte adicional ou dúvidas, entre em contato com a equipe de suporte da IXC Soft.

## Etiquetas
#IntegracaoBancaria #RemessaRetorno #CNAB #Homologacao #Boleto #Itaú

## 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 - remessa e retorno manual|Integrações Bancárias - Remessa e Retorno Manual]]
- [[contas a receber|Contas a Receber]]
- [[como criar arquivos de remessa bancaria|Como Criar Arquivos de Remessa Bancária]]
- [[como processar arquivos de retorno bancario|Como Processar Arquivos de Retorno Bancário]]
- [[verificar informacoes de lotes processados|Verificar Informações de Lotes Processados]]
- [[limite de boletos por lote no retorno|Limite de Boletos por Lote no Retorno]]
- [[situacoes de tipo de movimento nao registrado|Situações de Tipo de Movimento Não Registrado]]
- [[erro, o titulo ja foi recebido|Erro, o Título já foi Recebido]]
- [[titulo nao encontrado|Título Não Encontrado]]
- [[entrada rejeitada - codigo do banco invalido|Entrada Rejeitada - Código do Banco Inválido]]
- [[movimento para titulo nao cadastrado|Movimento para Título Não Cadastrado]]
- [[tipo de movimento nao registrado|Tipo de Movimento Não Registrado]]
- [[relatorios financeiros|Relatórios Financeiros]]