¶ Integração com boleto Sicoob (756) via API
Este tutorial cobre o processo completo para configurar a emissão de boletos pelo Sicoob (756 - Banco Cooperativo do Brasil S.A. – Bancoob) no EmiteFácil, utilizando a API de Cobrança Bancária V3.
Com essa integração, cada boleto emitido é registrado diretamente na API do Sicoob, sem necessidade de gerar arquivo de remessa. A conciliação de pagamentos é feita por consulta automática ao banco, duas vezes ao dia.
¶ Pré-requisitos
Antes de começar, certifique-se de que:
- Você possui conta corrente no Sicoob com o contrato de cobrança bancária (boleto) contratado.
- Você tem acesso ao Sicoobnet (Internet Banking) da conta, com permissão para aprovar aplicações.
- Você já possui um certificado digital A1 (.pfx) cadastrado nos Parâmetros de Emissão do seu estabelecimento no EmiteFácil (o mesmo certificado usado para emitir notas fiscais). O Sicoob é o único banco em que o EmiteFácil reaproveita esse certificado para autenticar na API — não é necessário obter nem enviar um certificado separado.
Diferencial do EmiteFácil: a maioria dos sistemas exige que você mesmo converta o certificado
.PFXpara.PEMusando ferramentas comoopenssl. No EmiteFácil, essa conversão é feita automaticamente com um clique, direto na tela de integração bancária.
¶ Parte 1 — Obter o Client ID no Sicoob
¶ 1.1 Exportar o certificado .PEM pelo EmiteFácil
O primeiro passo é gerar o arquivo .PEM (chave pública) que será enviado ao Sicoob.
Caminho: Financeiro → Configuração de integração com bancos (/app-integracao-bancaria)
-
Clique em + Nova configuração
-
No campo Banco, selecione 756-BANCO COOPERATIVO DO BRASIL S.A. – BANCOOB
A seção Certificado Sicoob é exibida, com o botão de exportação:
-
Clique em Exportar certificado .PEM
O EmiteFácil gera o arquivo automaticamente a partir do certificado digital já cadastrado no seu estabelecimento e inicia o download. Guarde esse arquivo — ele será enviado ao portal do Sicoob no próximo passo.
Atenção: se aparecer um erro ao exportar, confirme que o certificado A1 (.pfx) e a senha estão corretamente cadastrados nos Parâmetros de Emissão do estabelecimento (mesma tela usada para o certificado da nota fiscal).
Este passo não depende de salvar o cadastro — você pode exportar o certificado antes mesmo de preencher o Client ID.
¶ 1.2 Cadastrar o aplicativo no Portal Sicoob Developers
- Acesse developers.sicoob.com.br e faça login com os dados da sua conta Sicoob (Sicoobnet).
- No menu, acesse Meus aplicativos → Cadastrar novo aplicativo.
- Preencha o formulário:
- Nome do aplicativo: um nome identificador, ex.:
EmiteFacil-Cobranca - Integração: selecione Cobrança Bancária
- Certificado: faça upload do arquivo
.PEMexportado no passo 1.1 - Escopos/Permissões: marque os escopos de cobrança (
boletos_inclusao,boletos_consulta,boletos_alteracao) e, se disponíveis, os de webhook - Ambiente: selecione Produção
- Nome do aplicativo: um nome identificador, ex.:
- Conclua o cadastro do aplicativo.
¶ 1.3 Aprovar o aplicativo no Sicoobnet
Após cadastrado, o aplicativo fica com aprovação pendente até ser autorizado pelo titular da conta:
- Acesse o Sicoobnet (Internet Banking) da conta corrente
- Vá em Conta → Outras opções → Transações → Transações Pendentes
- Localize a solicitação do aplicativo criado e clique em Aprovar
Atenção: em empresas com mais de um usuário autorizado (multi-sócio), pode ser necessário que cada aprovador confirme a transação pendente.
¶ 1.4 Copiar o Client ID
De volta ao Portal Sicoob Developers, acesse Meus aplicativos, abra o aplicativo criado e copie o Client ID gerado. Guarde esse valor — ele será informado no EmiteFácil no próximo passo.
¶ Parte 2 — Configuração no EmiteFácil
¶ 2.1 Salvar a Integração Bancária
Volte à tela Financeiro → Configuração de integração com bancos, com o banco 756 já selecionado (passo 1.1):
- No campo Client ID, cole o valor copiado no passo 1.4
- Os campos Application Key e Client Secret não são usados pelo Sicoob — deixe em branco
- Clique em Salvar
¶ 2.2 Cadastrar a Conta Bancária
Caminho: Financeiro → Contas Bancárias
-
Clique em + Nova Conta Bancária
-
Preencha Apelido, selecione o Banco 756-BANCO COOPERATIVO DO BRASIL S.A. – BANCOOB, e informe Agência e Conta Corrente
-
Marque a opção Esta conta possui emissão de boletos
-
Clique em Salvar
¶ 2.3 Configurar a Carteira de Cobrança
Com a conta salva, abra-a novamente e, na tabela de carteiras, clique para adicionar uma nova (ou na linha vazia).
Preencha os campos:
| Campo | O que preencher |
|---|---|
| Código da carteira | Código da carteira de cobrança informado pelo Sicoob (ex.: 1, RG) |
| Codigo do Cedente/Beneficiário | Código de cedente fornecido pelo Sicoob. Dica: gere um boleto avulso pelo Sicoobnet e consulte o campo "Beneficiário" |
| CNPJ/CPF do cedente | CNPJ (ou CPF) da empresa/pessoa titular da conta |
| Tipo de arquivo | Selecione WEBSERVICE (registro via API) |
| Convênio | Número do contrato de cobrança junto ao Sicoob — é esse valor que a API usa para identificar o cliente. Um número incorreto aqui impede tanto o registro quanto a baixa automática dos boletos |
| Integração bancária | Selecione a integração criada no passo 2.1 (obrigatório quando Tipo de arquivo = WEBSERVICE) |
Configure também as informações padrão dos boletos (opcional — podem ser sobrescritas individualmente):
| Campo | Descrição |
|---|---|
| Gerar Boleto c/ PIX | Marque para incluir QR Code PIX já no registro do boleto. Defina essa opção antes de registrar o boleto — a API do Sicoob (V3) não permite ligar/desligar o PIX em um boleto já registrado |
| Enviar e-mail de confirmação de pagamento ao cliente | Envia notificação automática ao cliente quando o título é baixado |
| Juros diários / Multa / Desconto | Percentuais padrão aplicados aos boletos gerados por esta carteira |
| Limite de dias para pagamento do boleto | Quantos dias após o vencimento o boleto continua aceitando pagamento |
| Protestar o título automaticamente em caso de não pagamento | Envia o título a protesto após o prazo definido |
Clique em Salvar.
¶ Verificação
Emita um boleto de teste em Contas a Receber vinculado à carteira configurada:
- O boleto deve ser registrado na API do Sicoob no momento da emissão
- Se houver erro, confira: Client ID correto, aplicativo aprovado no Sicoobnet (passo 1.3), e o Convênio da carteira preenchido corretamente
¶ Como funciona a baixa automática
Diferente do Itaú e do Sicredi, o Sicoob não possui webhook de confirmação de pagamento no EmiteFácil. A baixa de pagamentos é feita por consulta agendada ao banco, duas vezes ao dia (aproximadamente às 05:30 e às 15:30).
Isso significa que, entre o pagamento do boleto pelo cliente e a baixa automática em Contas a Receber, pode levar algumas horas (em casos extremos, até a rodada seguinte, ~12h depois).
¶ Fluxo resumido
EmiteFácil: Financeiro → Config. integração bancária → Novo, banco 756 → Exportar certificado .PEM
↓
Portal Sicoob Developers: Meus aplicativos → Cadastrar novo aplicativo → upload do .PEM + escopos de cobrança
↓
Sicoobnet: Conta → Outras opções → Transações → Transações Pendentes → Aprovar aplicativo
↓
Portal Sicoob Developers: copiar o Client ID gerado
↓
EmiteFácil: colar o Client ID na integração → Salvar
↓
EmiteFácil: Financeiro → Contas Bancárias → Nova conta (banco 756) → marcar "emissão de boletos"
↓
Nova Carteira de Cobrança: Tipo de arquivo = WEBSERVICE + Convênio + Integração bancária → Salvar
¶ Perguntas frequentes
Preciso de um certificado digital separado para o Sicoob?
Não. O Sicoob é o único banco no EmiteFácil que reutiliza o certificado A1 (.pfx) já cadastrado nos Parâmetros de Emissão do estabelecimento (o mesmo da nota fiscal). Basta exportar o .PEM público pela própria tela de integração bancária.
O botão "Exportar certificado .PEM" deu erro. O que fazer?
Confirme que há um certificado digital A1 (.pfx) válido cadastrado nos Parâmetros de Emissão do estabelecimento, com a senha correta. Sem isso, o EmiteFácil não consegue gerar o arquivo .PEM.
Quanto tempo leva para o boleto pago ser baixado automaticamente?
Não há webhook para o Sicoob — a conciliação roda por consulta automática duas vezes ao dia (madrugada e início da tarde). O prazo típico é de algumas horas, podendo levar até ~12h em casos extremos.
Posso ativar o PIX em um boleto que já foi registrado?
Não. Para o Sicoob, a opção Gerar Boleto c/ PIX precisa estar marcada na carteira antes de registrar o boleto. Ligar ou desligar o PIX em um título já registrado não é suportado pela API V3 do Sicoob.
Posso editar um boleto já registrado no Sicoob (valor, vencimento)?
Não. A alteração de boletos já registrados não está disponível para o Sicoob no momento. Nesse caso, é necessário cancelar o título e emitir um novo.
O que é o campo Convênio da carteira?
É o número do contrato de cobrança bancária que você tem com o Sicoob. Esse valor é usado pela API para identificar sua empresa em toda comunicação — registro, consulta e baixa de boletos. Um valor incorreto aqui derruba tanto o registro quanto a conciliação automática.
Onde encontro o Código do Cedente/Beneficiário?
Ele é informado pelo Sicoob no momento da contratação do serviço de cobrança. Você também pode consultá-lo em qualquer boleto emitido manualmente pelo Sicoobnet, no campo "Beneficiário" ou "Cedente".