Integração Bolepix Sicoob

Configuração

Para iniciar a integração com o Sicoob, é necessário gerar os certificados digitais e realizar o cadastro do aplicativo no portal do banco para obtenção das credenciais de acesso.

Normalmente, o cliente realiza esse processo junto ao portal do banco, sendo necessário possuir os dados da conta e acesso ao aplicativo do Sicoob para validação.

As informações necessárias serão obtidas durante o cadastro do aplicativo, como:

  • Client_id
  • Access Token

1. Geração dos Certificados (.pem e .key):

  • Na pasta do sistema existe um executável chamado OpenSSL.exe.
  • Para gerar os arquivos necessários, executar os comandos abaixo separadamente:

Certificado .pem

pkcs12 -in (CAMINHO_DA_PASTA_DO_CERTIFICADO)\\(NOME_DO_CERTIFICADO).pfx -nokeys -out certificado_001.pem

Certificado .key

pkcs12 -in (CAMINHO_DA_PASTA_DO_CERTIFICADO)\\(NOME_DO_CERTIFICADO).pfx -nocerts -nodes -out certificado_001.key

Após a execução, serão gerados os arquivos:

  • certificado_001.pem
  • certificado_001.key

2. Configuração dos Certificados

  • Mover os arquivos gerados para o diretório:{Raiz_Sistema}\Certificado\756
  • Realizar a instalação do certificado digital (.pfx) na máquina
  • Durante a instalação, marcar a opção: “Marcar esta chave como exportável”, permitindo backup e transporte das chaves posteriormente.

3. Cadastro do Aplicativo no Portal do Banco

  • Acesse o portal:
  • https://developers.sicoob.com.br/portal/dashboard
  • Efetue login com o usuário e senha do cliente
  • Acesse o menu Meus Aplicativos
  • Clique em Cadastrar novo aplicativo
  • Selecionar:
    • Tipo: Pessoa Jurídica
  • Informar:
    • Cooperativa
    • Chave de Acesso
    • Senha
  • Após essa etapa, será gerado um código no aplicativo do banco do cliente, que deverá ser informado para validação.

4. Configuração do Aplicativo

  • Na etapa de informações, preencher:
    • Nome do Aplicativo: Excia
    • Conta Corrente
    • Nome do Cooperado
    • Descrição do Aplicativo: Integração BolePix

5. Configuração de Segurança

  • Na aba de segurança:
    • Informar que a integração não será realizada por empresa parceira
    • Importar o certificado .pem gerado anteriormente no campo Certificado Digital

6. Seleção de APIs

  • Selecionar as APIs:
    • Pix
    • Cobrança Bancária
  • Após isso, clicar em Prosseguir
  • O aplicativo será criado com status Pendente, sendo necessário que o cliente solicite a aprovação junto ao banco.

7. Obtenção das Credenciais

  • Após a aprovação do aplicativo:
    • Acessar o aplicativo criado
    • Copiar o Client_id
  • No Portal, realizar a Geração do Access Token, que será utilizado na integração.

Configuração no ERP

  • Após o envio e validações de acesso, configure as credenciais no EXCIA ERP, conforme os passos abaixo:
  • Preencha os campos obrigatórios:
    • Chave Aplicação: informar o Client_id obtido no portal do banco
    • Chave Autorização: informar o Access Token gerado no portal
    • Chave Cliente: informar conforme disponibilizado pelo banco