# Integração Bancária Safra
Este documento detalha as funcionalidades da integração bancária com a instituição Safra 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 **Safra** 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 240**

### 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
>
> **422 - Banco Safra S.A.**
>
> - 1 - Número da agência com dígito?
> - 2 - Número da conta com dígito?
> - 3 - Número do Convênio / Beneficiário ou Cedente??
> - 4 - Número da carteira?
> - 5 - CNAB 240.
> - 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 Safra é: 
```
422 - Banco Safra 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 Safra".
- **Código cedente:** Insira o código de cedente fornecido pelo banco.
- **Carteira:** Insira o código de carteira fornecido pelo banco.
- Habilite os parâmetros de **Inclusão em Remessa** conforme julgar necessário.
- **Layout remessa:** Selecione a opção "CNAB 240".
- **Layout remessa:** Selecione a opção "CNAB 240 Safra".

> [!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 240, o de retorno também deve ser CNAB 240.

### 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 Safra
 > - [Manual Safra Layout CNAB 240](https://www.safra.com.br/data/files/72/B3/1F/3E/3205F71031A612F7E03EF9C2/Layout%20padrao%20CNAB240%20V%2010%2009%20-%2014_10_21%20_3_.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 Safra 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 #Safra

## 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]]