Manual Para Homologar Cobrança API Sicoob

## Visão Geral

Prepare a conta bancária e subcontas para utilizar os recursos de integração e automatização de movimentações bancárias no sistema Teorema. Este manual descreve a configuração necessária para emissão e impressão de boletos, integração via API, certificados digitais, baixas, despesas bancárias, retorno e WebHook.

### Informações necessárias

Solicitar ao banco Sicoob as seguintes informações:

- CNPJ
- Cooperativa
- Conta
- Convênio
- Contrato
- Client ID

### Preparação de certificados

Converter certificado A1 e chave no formato PEM.

### Instalação do Orion

O Orion está disponível em: Teorema > TP > Google Drive > Público > App Delphi > Servidores > Servidor Orion Horse

Versão utilizada neste chamado: servidor orion horse 1.0.0.120.rar

## Cadastro de Conta Bancária e Subcontas

Nesta tela é realizado o cadastro da conta bancária, com a definição do banco, empresa, agência, número da conta, dígito, tipo de operação e demais informações necessárias.

Na aba **SubContas**, é possível visualizar e cadastrar as subcontas vinculadas à conta bancária, permitindo organizar diferentes contas ou carteiras relacionadas à mesma empresa e instituição financeira.

![Cadastro de conta bancária com lista de subcontas](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/avulsos-ia/homologar-cobranca-api-sicoob/homologar-cobranca-api-sicoob-01.png)

## Configurar Informações Principais da Subconta

Na subconta bancária são configuradas as informações principais para cobrança e emissão de boletos, como empresa, convênio, tipo e espécie de cobrança, juros, multa, carteira, código do cedente, posto cedente, serviço e demais parâmetros bancários.

Na aba **Informações de Integração**, são informados os dados necessários para a comunicação com o banco via API, incluindo Client ID, Client Secret e certificados digitais, permitindo a integração da subconta com os serviços bancários do Sicoob.

![Configuração de informações principais da subconta e dados de integração da API](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/avulsos-ia/homologar-cobranca-api-sicoob/homologar-cobranca-api-sicoob-02.png)

## Configurar Impressão, Baixas e Retorno/WebHook

Na aba **Informações da Impressão**, são definidos os parâmetros utilizados na impressão dos boletos, como posição do código de barras, impressão de observações, endereço da empresa, valor no canhoto e os diretórios utilizados para armazenamento dos arquivos.

Na aba **Retorno/WebHook (API)**, são configuradas as informações necessárias para o processamento automático das movimentações bancárias, incluindo os parâmetros de baixa para recebimentos e pagamentos, contas, operações, centro de custo, plano financeiro, fornecedor e demais informações relacionadas ao processo.

Essas configurações permitem adequar a subconta bancária aos processos de cobrança, retorno e baixa das movimentações financeiras no sistema.

![Configuração de parâmetros de impressão de boletos e retorno automático](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/avulsos-ia/homologar-cobranca-api-sicoob/homologar-cobranca-api-sicoob-03.png)

## Configurar WebHook

Na aba **WebHook**, configure as informações necessárias para o recebimento das notificações da integração bancária.

Preencha os campos a seguir:

- **Código**: identificador único do webhook
- **URL**: `https://orion2.teorema.inf.br/v1/webhook/sicoob/{CNPJ}/{DB_TOKEN}`
- **E-mail**: responsável da empresa

> **Pré-requisito:** Preencha todos os campos para que os retornos automáticos funcionem sem erros nas baixas.

![Configuração de código, URL e e-mail para recebimento de notificações](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/avulsos-ia/homologar-cobranca-api-sicoob/homologar-cobranca-api-sicoob-04.png)

Após o preenchimento, clique em **Salvar** para concluir a configuração.

### Acesso ao Token do Banco

No **Servidor Orion**, acesse:

**Banco de Dados → Registro de Banco → selecione um banco já cadastrado → campo Token**

Ao abrir o registro do banco, o **Token** estará disponível na área **Identificação do Cliente**.

![colado 1790953122744](https://api-geral.teorema.inf.br/integration/v2/api/teorema/assets/teorema/markdown/colado-1790953122744.png)

## Informações do documento

> Autor: Antonio Marcos Zampier

> Setor: Qualidade

> Módulo: Gestão Administrativa

> Chamado: 576308

> Versão do Sistema: 26.06a

> Versão do documento: 01

> Revisão: Paulo Bley

> Aprovado em: Agosto de 2026

---

> 📎 **Arquivos originais:** [Manual*para*Homologar*COBRANÇA*API*SICOOB*576308.docx](https://drive.google.com/uc?export=download&id=1uvbh2p9n1jI-WWG2kRN7JLY_VAlut7l-)