Configurar a integração com o Sicoob

Com o Sicoob conectado, o Onooma emite as cobranças direto na conta do escritório e dá baixa sozinho quando o cliente paga. A configuração fica em Financeiro → Configurações, com o provedor Sicoob.

Antes de começar

Confira estes itens antes de abrir o formulário. Se faltar algum deles, a conexão falha.

Contrato de cobrança bancária ativo na cooperativa. Ter só conta corrente não é suficiente: é o contrato de cobrança que gera o número do cliente.
Certificado digital e-CNPJ A1, emitido para o mesmo CNPJ do escritório (arquivo .pfx ou .p12 e a senha). e-CPF e certificado A3 (token ou cartão) não servem. Veja Certificado A1.
CNPJ do escritório cadastrado no Onooma. Sem ele não é possível ativar o Sicoob em produção.
Aplicação cadastrada no portal de desenvolvedores do Sicoob, com o Client ID em mãos. Veja Cadastrar a aplicação no portal Sicoob.
Se for usar Pix puro: uma chave Pix cadastrada na conta Sicoob.

Onde encontrar cada dado

Quase todos os dados estão no Sicoobnet Empresarial ou em qualquer boleto já emitido pelo escritório. Se não encontrar algum, o gerente da cooperativa tem todos.

Campo	O que é	Onde encontrar	Obrigatório
Client ID	Identifica a aplicação do escritório na API Sicoob	Portal de desenvolvedores Sicoob, na aplicação cadastrada	Sim
Número do cliente	Código do beneficiário do contrato de cobrança	Sicoobnet → Cobrança Bancária → dados do beneficiário. No boleto, campo Agência / Código do Beneficiário: é o número depois da barra	Sim
Modalidade	Tipo de carteira de cobrança contratada. Quase sempre 1 — Simples com registro	Contrato de cobrança, ou com o gerente	Sim
Cooperativa	Número da cooperativa, com 4 dígitos	Topo do Sicoobnet, ou no boleto (número antes da barra)	Não
Número da conta corrente	Conta que recebe o crédito dos boletos	Sicoobnet → dados da conta. Somente dígitos	Sim
Cobrança Pix	Como o Pix é oferecido ao cliente (veja abaixo)	Escolha do escritório	Sim
Chave Pix	Chave que recebe os pagamentos Pix	Sicoobnet → Pix → Minhas chaves	Só no Pix puro
E-mail do webhook	Contato técnico que o Sicoob registra no aviso de pagamentos	Qualquer e-mail do escritório	Não

Boleto híbrido ou Pix puro

Boleto híbrido: um boleto com QR Code Pix. O cliente paga pelo código de barras ou pelo Pix, e é uma cobrança só. É a opção padrão.
Pix puro: uma cobrança Pix com vencimento, sem boleto. Exige chave Pix e os escopos Pix habilitados na aplicação do portal.

Cadastrar a aplicação no portal Sicoob

O Client ID vem de uma aplicação que o escritório cadastra no portal de desenvolvedores do Sicoob, entrando com o acesso de cooperado.

Crie uma aplicação para o ambiente de produção.

Habilite as APIs abaixo com estes escopos. O Onooma pede exatamente esses escopos ao Sicoob: se faltar algum, a conexão é recusada.

API	Escopos	Para quê
Cobrança Bancária	`boletos_consulta`, `boletos_inclusao`, `boletos_alteracao`, `webhooks_inclusao`	Emitir, consultar e baixar boletos, e receber o aviso de pagamento
Conta Corrente	`cco_consulta`	Saldo e extrato no financeiro. Também é usada para testar a conexão ao salvar

Se for usar Pix puro, habilite também a API Pix Recebimentos, com os escopos cobv.write, cobv.read e pix.read.
Associe à aplicação o mesmo certificado e-CNPJ A1 que será enviado ao Onooma.
Copie o Client ID gerado.

Configurar no Onooma

Abra Financeiro → Configurações e, em Provedor, escolha Sicoob.
Em Ambiente, selecione Produção.
Cole o Client ID.
Envie o certificado A1: selecione o arquivo, digite a senha e aceite o termo de consentimento. O Onooma valida se o certificado é um e-CNPJ ICP-Brasil do CNPJ do escritório e avisa quando ele estiver perto de vencer.
Preencha Número do cliente, Modalidade, Cooperativa e Número da conta corrente.
Escolha a Cobrança Pix e, se for Pix puro, informe a Chave Pix.
Se quiser, informe o E-mail do webhook. Se ficar vazio, o Onooma usa o seu e-mail.
Clique em Salvar alterações.

Ao salvar, o Onooma consulta o saldo da conta para confirmar que as credenciais funcionam. A configuração só é gravada se essa consulta funcionar.

Baixa automática

Na conexão, o Onooma registra um webhook no Sicoob, que avisa quando um boleto é pago. A cobrança é baixada no Onooma sem ação manual.

Se o registro do webhook falhar, a integração continua conectada e as cobranças continuam sendo emitidas, mas a baixa automática fica parada. Nesse caso, salve a configuração de novo. Se o aviso continuar, fale com o suporte.

No Pix puro, os pagamentos também são conferidos periodicamente com o extrato Pix do Sicoob.

Problemas comuns

Mensagem	Causa	O que fazer
Cadastre o CNPJ do escritório para ativar o Sicoob em produção	O escritório não tem CNPJ cadastrado	Cadastre o CNPJ nos dados do escritório e tente de novo
O CNPJ do certificado não confere com o CNPJ do escritório	O certificado é de outra empresa	Use o e-CNPJ A1 do próprio escritório
Informe a chave Pix para usar o Pix puro	Pix puro sem chave Pix	Preencha a chave ou troque para boleto híbrido
O app Sicoob não tem acesso à API Conta Corrente	A aplicação no portal Sicoob não tem o escopo `cco_consulta`	Habilite a API Conta Corrente com o escopo `cco_consulta` e salve de novo
O app Sicoob não tem acesso à API Pix	A aplicação não tem os escopos Pix	Habilite `cobv.write`, `cobv.read` e `pix.read` no portal Sicoob
Cadeia de certificados inválida	O arquivo não é um certificado ICP-Brasil válido ou está incompleto	Exporte de novo incluindo a cadeia. Veja Certificado A1
Sicoob auth failed: 400	Falta algum escopo da tabela acima na aplicação do portal	Confira se todos os escopos estão habilitados e salve de novo
Erro de comunicação com o Sicoob ao salvar	Client ID, número do cliente ou conta não correspondem ao certificado	Confira os dados com o gerente da cooperativa

Segurança

O escritório envia o certificado e preenche os dados. Não peça nem use a senha do internet banking de ninguém.
A chave privada do certificado é protegida em um cofre de chaves e nunca fica exposta no Onooma.
Quando o certificado vencer, envie um novo para continuar emitindo cobranças.