1) OBJETIVO
Este manual tem como objetivo orientar o usuário no processo de homologação da API do Banco Sicredi. Nele, serão detalhados os passos necessários para integrar e configurar corretamente a API, garantindo que as transações bancárias, como pagamentos e recebimentos, sejam realizadas de forma segura e em conformidade com os requisitos exigidos pelo Banco Sicredi.
2) DADOS NECESSÁRIOS PARA INTEGRAÇÃO COM API DE BOLETOS DO BANCO SICREDI
Para realizar a emissão de boletos via API no Banco Sicredi, é necessário obter os seguintes dados junto à instituição bancária:
– ClienteID
– Client_Secret
– Token de Acesso (x-api-token-password)
– Código de Acesso (Password)
– UserName
– Certificado Digital PFX (A1)
Essas informações são essenciais para iniciar o processo de integração.
Observação: Todos os dados mencionados devem ser encaminhados à equipe do Athenas, que será responsável por inserir as informações no servidor de integração, garantindo que o sistema esteja pronto para operar com a API de boletos.
3) CONFIGURAÇÃO NO SERVIDOR DE INTEGRAÇÃO
Esta etapa é executada exclusivamente por um analista técnico do Athenas.
3.1. Acesso à Ferramenta de Integração
Acesse a ferramenta de software para gerenciamento bancário.
Insira as mesmas credenciais de login e senha utilizadas no Athenas Online.
Clique no botão [Entrar] para acessar o ambiente de configuração.
3.2. Cadastro da Integração com o Banco Sicredi
Após acessar a ferramenta, siga as etapas abaixo para cadastrar o banco na API:
1. Clique em [Adicionar Novo Banco] para iniciar o processo de configuração.
2. Preencha os campos obrigatórios com as informações fornecidas pelo Banco Sicredi:
Banco: nome ou código do banco (por exemplo, 748 – Sicredi)
CNPJ: CNPJ da instituição financeira contratante
Razão Social: razão social da empresa titular da conta
Client ID: informe o UserName fornecido pelo Sicredi
Client Secret: insira o Código de Acesso (Password)
ApiKey: cole o Token de Acesso (x-api-token-password)
Certificado:
– Clique em [Escolher arquivo]
– Localize e selecione o certificado digital PFX (modelo A1)
– Caso o certificado esteja protegido por senha, a ferramenta poderá solicitar o preenchimento
3. Revise cuidadosamente todos os dados preenchidos antes de salvar.
4. Após validar as informações, clique no botão [Salvar] para registrar a configuração.
🔐 Atenção:
Certifique-se de que o certificado digital esteja atualizado e válido no momento da configuração. Certificados vencidos impedirão a comunicação com a API do Sicredi.
4) Configuração no Sistema Athenas – Conta Bancária
Essa etapa consiste no cadastro correto da conta bancária integrada à API do Banco Sicredi para emissão de boletos.
4.1. Configuração da Aba Cadastro
Acesse o menu Cadastros > Financeiro > Contas Bancárias > Aba Cadastro.
Clique em [Incluir] para cadastrar uma nova conta.
Preencha os seguintes campos com atenção às regras de cada item:
Agência / Dígito:
Informe o número da agência e seu dígito verificador.
Exemplo: 1234 / 5
Número da Conta / Dígito:
Preencha com o número completo da conta e o dígito verificador.
Exemplo: 00012345 / 6
Código do Banco:
Use o código padrão do Banco Sicredi: 748
Código da Cooperativa:
Informe o número da agência, sem o dígito verificador.
Exemplo: para agência 1234-5, informe apenas 1234
Nome do Banco:
Digite o nome da instituição bancária – Sicredi.
Tipo de Conta:
Selecione a opção correta de acordo com o tipo de movimentação da conta:
Disponib.: marque esta opção para contas de uso geral, como:
Conta Corrente
Conta de Caixa
Conta Investimento
Ct. Crédito: marque esta opção apenas se a conta for:
Conta de Cartão de Crédito
Conta de Empréstimo/Crédito rotativo
📌 Importante: Os demais campos disponíveis na tela podem ser preenchidos conforme a necessidade da empresa.
4.2. Configuração da Aba “Cobrança” na Conta Bancária
Após cadastrar os dados principais da conta bancária, acesse a aba Cobrança para configurar os parâmetros necessários para emissão de boletos via API do Sicredi.
📋 Preenchimento dos Campos Obrigatórios:
Na aba Cobrança, preencha os seguintes campos:
Código da Empresa no Banco (com registro):
Informe o código fornecido pelo banco, vinculado ao convênio de cobrança com registro.
Carteira (com registro):
Preencha com o código da carteira homologada para emissão de boletos registrados (por exemplo: 1, 101, etc.).
Código da Cooperativa:
Utilize o mesmo número informado anteriormente no cadastro, referente à agência sem o dígito verificador.
Marque a flag “Boletos Padrão Acbr”.
Essas opções garantem que o sistema utilize os formatos corretos de emissão e retorno compatíveis com a estrutura da API do Sicredi.
Na Subaba “Outras Informações”
No quadrante ‘Ambiente API’ marque a opção “Produção”.
Marque a flag “Envio por API Online”.
📌 Essa opção habilita o envio automático dos boletos através da integração online com o Sicredi, sem necessidade de gerar arquivo manual.
Após preencher todos os dados obrigatórios, clique em [OK] para salvar o cadastro da conta bancária.
5) DEFINIR CAMINHO PARA SALVAR OS BOLETOS
Acesse o menu Arquivos > Configurações (Novo).
Vá até a aba Cobrança e localize a opção “Caminho para salvar boletos do banco usando API”.
Informe o diretório onde os boletos gerados em PDF deverão ser salvos.
6) GERAÇÃO DOS BOLETOS
Gere o boleto normalmente pelo sistema.
Após a geração, o sistema exibirá a mensagem ‘Processo Finalizado!’.
7) VERIFICAÇÃO DOS ARQUIVOS GERADOS
Após a emissão, os arquivos PDF dos boletos ficarão salvos no caminho informado no item 5.
Verifique se os arquivos estão disponíveis corretamente na pasta configurada.
