Este guia orienta a configuração da conta bancária Sicoob no sistema Avante, incluindo a criação das credenciais no Portal Developer Sicoob, o cadastro dos parâmetros de boleto e a realização de testes de emissão. O objetivo é permitir a comunicação direta com o banco, eliminando a necessidade de geração manual de arquivos de remessa e retorno.

1. Configuração da Conta Bancária no Sistema

Para iniciar a integração, acesse o menu de cadastro de conta bancária dentro do sistema e localize o banco Sicoob. Esse banco é homologado para integração direta, o que permite que os boletos sejam enviados automaticamente ao banco no momento da emissão.

Ao selecionar o Sicoob, a opção de integração automática será habilitada. Nessa modalidade, não é necessário preencher todos os campos tradicionais da conta bancária, pois a comunicação será feita por meio das credenciais da API.

Preencha apenas os dados necessários para a integração:

• Número da conta;
• Código do beneficiário;
• Usuário do Portal Developer;
• Senha do Portal Developer;
• Client ID fornecido pelo banco.

Após informar esses dados, salve o cadastro da conta bancária. Os demais campos da conta não precisam ser preenchidos para essa integração específica.

Os boletos emitidos por essa integração podem sair com Pix habilitado. Porém, para que o QR Code funcione corretamente no documento, essa funcionalidade precisa estar previamente ativa junto ao banco.

2. Criação da Aplicação no Portal Developer Sicoob

Com a conta bancária cadastrada no sistema, acesse o Portal Developer oficial do Sicoob e realize o cadastro utilizando o CPF ou CNPJ do correntista. Após concluir o cadastro, faça o login normalmente no portal.

Dentro do Portal Developer, clique na opção para gerar um novo aplicativo. Durante o processo de autenticação, será necessário validar o vínculo da conta corrente com a aplicação. Para isso, utilize o mesmo usuário e senha usados no aplicativo Sicoob Mobile Banking.

Na tela de cadastro da API, informe os dados básicos da aplicação:

• Nome da aplicação;
• Conta corrente;
• Nome do cooperado;
• Descrição de fácil identificação.

Quando o portal perguntar se a integração será realizada por uma empresa parceira, selecione a opção não.

Em seguida, faça o upload de um certificado digital A1 válido. Esse certificado deve estar emitido para o CNPJ do cedente e precisa estar convertido para o formato PEM, conforme exigência do processo de integração.

3. Seleção do Produto da API e Geração das Credenciais

Após preencher os dados da aplicação e enviar o certificado digital, avance para a etapa de seleção do produto da API. Nessa tela, selecione sempre a opção de cobrança bancária, mesmo que o portal apresente a opção de Pix em alguns exemplos ou orientações.

Depois de selecionar o produto correto, revise as informações preenchidas antes de finalizar o cadastro. Confirme se os dados da conta, do cooperado, da aplicação e do certificado estão corretos.

Para concluir:

• Selecione o produto cobrança bancária;
• Revise todas as informações preenchidas;
• Clique em criar aplicativo;
• Aguarde a geração automática das credenciais da API.

Ao finalizar esse processo, o Portal Developer irá gerar as credenciais necessárias para a comunicação entre o sistema e o Sicoob.

4. Configuração dos Parâmetros de Boleto no Sistema

Com as credenciais da API geradas, retorne ao sistema Avante e acesse a tela de parâmetros de boleto. Nessa etapa, será necessário configurar as regras de emissão conforme as exigências da instituição bancária.

Preencha a descrição do parâmetro e defina o modelo do documento obrigatoriamente como duplicata mercantil. Em seguida, informe os campos relacionados às regras financeiras do boleto, conforme orientação do banco.

Configure os principais campos:

• Juros;
• Desconto;
• Multa;
• Protesto;
• Local de pagamento, se necessário;
• Instruções que serão exibidas no PDF do boleto.

Os campos nosso número e convênio devem permanecer em branco.

Depois disso, acesse a tela de formas de pagamento, selecione a conta bancária configurada com integração direta e salve as alterações. Ao utilizar essa modalidade, o campo de convênio ficará desabilitado automaticamente.

5. Teste e Emissão de Boletos

Após concluir as configurações, realize um teste de emissão para validar a comunicação com o banco. Acesse o menu financeiro e selecione a opção de boleto avulso.

Informe os dados do cliente, defina o valor do boleto e clique para emitir. O sistema irá gerar o boleto e enviá-lo instantaneamente ao banco por meio da integração direta.

Essa integração permite a emissão de boletos em diferentes rotinas do sistema, incluindo:

• Boletos avulsos;
• Emissões fiscais;
• Emissões gerenciais;
• Contratos;
• Lançamentos manuais no financeiro;
• Lançamentos recorrentes.

Se o boleto for gerado corretamente e enviado ao banco sem erro, a integração estará pronta para uso operacional.