> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.gdash.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como realizar a integração com a API do SICOOB para geração de cobranças

## Visão geral
O GDASH permite a integração direta com o **Banco SICOOB **para emissão automática de cobranças e boletos via API.
Antes de gerar cobranças, é necessário configurar as **credenciais de autenticação** do Sicoob no painel do GDASH.

|| **Atenção!** Esta integração possui uma cobrança adicional de **R$2,49 por boleto compensado.** O valor total será apurado no encerramento de cada ciclo de faturamento da sua assinatura e adicionado automaticamente à sua próxima fatura. Outras taxas eventualmente aplicadas deverão ser consultadas diretamente com o banco ou instituição financeira provedora da API de integração.


1. Para realizara integração, clique em ***Integrações*** no menu lateral a esquerda, em seguida em ***Cobranças*** e no cartão do SICOOB:

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_sqklu8.png)
## 🧩 Autenticação com o SICOOB
A autenticação é o primeiro passo do processo de integração.
O SICOOB exige o uso de **certificados digitais e credenciais válidas** para garantir a segurança da comunicação com sua API.

### São necessários cinco elementos principais:

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1ugxjd0.png =328xauto)
1. **Chave privada (`.key`)**
2. **Certificado público (`.cer` ou `.pem`)**
3. **Client ID**
* Identificador único gerado no portal do desenvolvedor do SICOOB.
* Obtido ao criar uma integração no [Portal de Desenvolvedores](https://developers.sicoob.com.br/) SICOOB.
4. **Número da conta corrente**
5. **Número do cliente (Código do Beneficiário)**
* Caso não tenha o número de cliente anotado, essa informação pode ser obtida através do seu gerente SICOOB.
* Nos dados de contrato, é o item Código do Beneficiário

### Como extrair a chave privada e o certificado público

${frame}[](https://www.youtube.com/embed/JqPdDANOoWw)

Para extrair a chave privada e o certificado público através de um certificado digital, o SICOOB disponibiliza um passo a passo no artigo a seguir:

[**Artigo de como exportar o certificado para gerar o aplicativo**](https://developers.sicoob.com.br/portal/documentacao?slugItem=seguranca&slugSubItem=certificado-digital)

Para ajudar no passo a passo do prompt de comando, no exemplo abaixo, o certificado digital foi nomeado como CERTIFICADO.pfx

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_rdhlru.png)

Segue abaixo os prompts de comando para cada arquivo:

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_j0sde.png)

**Certificado público (`.cer` ou `.pem`)**
openssl pkcs12 -in cert\CERTIFICADO.pfx -nokeys -out cert\CERTIFICADO.pem

**Chave privada (`.key`)**
openssl pkcs12 -in cert\CERTIFICADO.pfx -nocerts -nodes -out cert\CERTIFICADO_PRIVADA.key

| O nome do arquivo do certificado digital, deve estar igual nos prompts para que seja criado o arquivo com sucesso.

O resultado será os arquivos abaixo:
![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1hffxt1.png)
### Como criar o client ID
1. Crie uma conta no [Portal de Desenvolvedores](https://developers.sicoob.com.br/) SICOOB.
2. Após a conta criada clique em Meus aplicativos
3. Clique em Cadastrar novo aplicativo

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/blush-sicoob_11jcpe4.png)
4. Faça o login com sua conta do SICOOB
5. Coloque o nome do aplicativo como GDASH e uma breve descrição 
![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/passo-1_1u7zum1.png)
6. Insira o certificado digital de sua empresa e clique em prosseguir

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/passo-2_1v5jxf3.png)
7. Selecione as permissões, de acordo com a imagem abaixo:

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/passo-3_1scnc6w.png)
8. Confirme os dados e clique em criar aplicativo
9. Depois do aplicativo criado, vá em Meus Aplicativos e clique no cartão do GDASH
10. O client id estará disponível:

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_trg6fz.png)


Pronto, com posse de todos os arquivos, basta inseri-los no card do SICOOB no GDASH e finalizar a integração.

| **Dúvidas ou problemas? Fale com nosso suporte clicando** [**aqui**](https://wa.me/553172170619)**!**