MÓDULO FINANCEIRO: REGISTRO E GERAÇÃO DE BOLETOS BANCÁRIOS VIA API (BANCO SICREDI)

1. Descrição do Recurso e Conceito Operacional

O recurso de Registro e Geração de Boletos via API do Banco Sicredi permite a comunicação online e em tempo real entre o Atendesmart ERP e a instituição financeira. Com esta integração, a emissão do título não depende do envio manual de arquivos remessa (CNAB), realizando o registro instantâneo do boleto diretamente no banco.

Nota para Implantação/Suporte: Para o cliente Tritan Tecidos, todos os parâmetros de integração e credenciais de API já se encontram devidamente configurados e homologados no ambiente de produção.

Conceito Técnico e Regras do Software

1. Credenciamento via API: A autenticação com os serviços da instituição é estabelecida a partir das credenciais de API (Username e Password) cadastradas nas configurações gerais da empresa.
2. Mapeamento de Parâmetros de Cobrança (Tipo de Documento): O ERP traduz a estrutura bancária do Sicredi mapeando as variáveis da conta nos seguintes campos:
   • Convênio: Armazena o código do beneficiário fornecido pelo banco.
   • Conta Cedente: Armazena o código da cooperativa de crédito.
   • Conta Cedente (DV): Armazena o código do posto de atendimento.
3. Fluxo de Transmissão e Emissão: O título deve obrigatoriamente ser registrado e validado pela API do banco antes de permitir a impressão em PDF. Após a resposta de sucesso com registro de ocorrência, a interface libera o comando de impressão do boleto.

2. Guia de Configuração e Ativação

Siga o procedimento passo a passo para a parametrização de novos clientes ou verificação de ambiente:

Etapa A: Ativação da API nos Dados da Empresa

1. No Atendesmart ERP, navegue até a tela de parâmetros gerais: Cadastros ➡️ Tabelas ➡️ Dados Empresa ➡️ Sistemas
2. Localize a seção Habilitar API p/ boleto do Banco Sicredi.
3. Defina a caixa de seleção para Sim.
4. Preencha os campos com as chaves fornecidas pelo banco:
   • Username(API Sicredi): Informe o código de usuário da API fornecido pela instituição.
   • Password(API Sicredi): Informe a chave/senha de autenticação da API.
5. Salve as alterações.

Etapa B: Parametrização do Tipo de Documento

1. Acesse o cadastro de tipos de documento: Financeiro ➡️ Tabelas ➡️ Tipo de Documento
2. Selecione ou crie o tipo de documento atrelado ao banco SICREDI.
3. Acesse a aba Configuração e preencha rigorosamente os seguintes mapeamentos:
   • Convênio: Digite o Código do Beneficiário.
   • Conta cedente: Digite o Código da Cooperativa.
   • Campo de Dígito da Conta Cedente (DV): Digite o número do Posto.
4. Clique no botão Salvar dados.

Etapa C: Procedimento Operacional na Duplicata/Título (“Clique a Clique”)

1. Acesse a Receita desejada em Financeiro ➡️ Movimentações ➡️ Receitas.
2. Clique no botão Registrar boleto (identificado pelo ícone de raio).
3. Aguarde o processamento do ERP com a API do banco. A confirmação será exibida no campo Ocorrência API com a mensagem: “15/10/2026 – Título registrado com sucesso pela API.”
4. Após o registro com sucesso, o botão Gerar boleto ficará habilitado.
5. Clique no botão Gerar boleto para abrir e visualizar o documento em formato PDF para impressão ou envio ao cliente.

3. Resultado Esperado (Critérios de Sucesso na Implantação)

1. Validação de Credenciais: Ao disparar o registro, a API retorna a mensagem de sucesso na caixa Ocorrência API sem erros de autenticação ou chaves inválidas.
2. Liberação do Botão de Impressão: O botão Gerar boleto torna-se acessível imediatamente após a gravação da ocorrência de registro.
3. Exibição do Documento PDF: O clique em Gerar boleto abre o arquivo PDF formatado com a linha digitável, código de barras e dados do beneficiário/pagador sincronizados.