Integração com Banco Sicoob

O Fácil123 oferece integração via API com o Sicoob, possibilitando comunicação automatizada entre os sistemas. Antes de iniciar, solicite ao seu gerente de contas o Código do Beneficiário.

Passo a Passo: Integração Boleto

No Fácil123

1. Acesse Menu Financeiro → Contas → Incluir → escolha Sicoob → adicione o nome como Conta Sicoob.
2. Selecione as opções desejadas (habilite Permitir cobrança por boleto).
3. Digite banco, agência, conta e DV.
4. Opcionalmente, restrinja acesso para usuário específico → Salvar.
5. Vá em Engrenagem → Conexão com API → Incluir → coloque Nome: Sicoob → Emissor: Sicoob V3.
6. Insira seu certificado digital e senha.
7. Baixe a chave pública (necessária para Portal Developers-Sicoob) → Salvar.

Opções de habilitação disponíveis:

• Participa do fluxo de caixa: Inclua na gestão de capital de giro.
• Permitir cobrança por boleto: Emita boletos via Sicoob.
• Permitir cobrança por Pix com vencimento: Emita Pix com prazo.
• Permitir importação automática de extrato: Sistema importa automaticamente extrato bancário do dia anterior às 9h (também disponível importação manual).

No Portal Developers-Sicoob

IMPORTANTE: Você tem 5 minutos para se conectar no Internet Banking e finalizar a autorização.

1. Acesse o Portal Developers-Sicoob.
2. Faça login ou cadastro conforme necessário.
3. Vá em Meus aplicativos → Cadastrar novo aplicativo → Ok, continuar.
4. Use credenciais do App Sicoob (celular) para login.
5. Após informar Cooperativa, Chave de Acesso e Senha, receberá código de verificação no app → Preencha e Autorize.
6. Nome do aplicativo: "Fácil123 API" | Descrição: "ERP" → Prosseguir.
7. Para integração por empresa parceira, selecione Não → Insira a chave pública do Fácil123 → Prosseguir.
8. Selecione Cobrança Bancária V3 → Prosseguir → Criar aplicativo.
9. Acesse Meus Aplicativos → clique na aplicação API Fácil123 (status: pendente).

No Sicoobnet Empresarial

• Procure por Transações Pendentes / Detalhamento → Autorização para Uso de APIs.
• Insira sua senha e autorize.

De Volta ao Portal Developers-Sicoob

1. Clique na aplicação API Fácil123 (agora ativa).
2. Copie o código Client ID (necessário para próxima etapa).

Retorno ao Fácil123

1. Vá em Engrenagem → Conexão com API → Selecione Sicoob → Alterar → Insira Client ID → Salvar.
2. Menu Financeiro → Contas → Incluir → escolha Sicoob → nome: Boleto Sicoob → habilite Permitir cobrança por boleto → insira dados bancários.
3. Configurações do boleto: Emissor do Boleto = Sicoob (API V3) | Conta de repasse = Sicoob.
4. Configurações do emissor do boleto Sicoob: Conexão com API = Sicoob boleto.
5. Contrato: Insira o Código do Beneficiário.
6. Opcionalmente, adicione Texto livre no boleto → Salvar.
7. Menu Vendas → Meio de pagamento → Boleto → Alterar:
   • Nome: "Boleto Sicoob"
   • Método de Pagto: Boleto
   • Conta: Selecione conta Sicoob
   • NF-e / NFC-e: Boleto Bancário
   • Salvar
8. Menu Financeiro → Lançamentos → Três pontos → Conciliar boletos.

Pronto para emitir boletos Sicoob!

Nota: Reportar erros de emissão ao suporte imediatamente.

Configurando Juros e Multa

1. Vá em Engrenagem → Cobranças.
2. Escolha categorias padrão para tarifa de cobrança e para juros/multa.
3. Adicione Juros ao mês e Multa.

Os juros e multas recebidos via boleto ou Pix são registrados na mesma transação financeira sendo baixada.

Protesto Automático

1. Menu Financeiro → Contas → Localize Boleto Sicoob.
2. Clique nos três pontos → Editar.
3. Habilite Protestar após.
4. Defina quantidade de dias após vencimento → Salvar.

Negativação

1. Menu Financeiro → Contas → Localize Boleto Sicoob.
2. Clique nos três pontos → Editar.
3. Habilite Negativação após.
4. Defina quantidade de dias após vencimento → Salvar.

Passo a Passo: Integração PIX

No Fácil123

1. Acesse Menu Financeiro → Contas → Incluir → escolha Sicoob → nome: Conta Sicoob.
2. Habilite Permitir cobrança por Pix com vencimento → insira dados bancários.
3. Opcionalmente restrinja acesso para usuário específico → Salvar.
4. Engrenagem → Conexão com API → Incluir → Nome: Sicoob | Emissor: Sicoob V3.
5. Insira certificado digital e senha.
6. Baixe a chave pública → Salvar.

No Portal Developers-Sicoob

Siga os mesmos passos da integração boleto, com uma diferença na etapa 8:

1. Selecione Pix recebimentos → Prosseguir → Criar aplicativo.

(Demais passos idênticos ao processo de boleto)

Retorno ao Fácil123

1. Engrenagem → Conexão com API → Sicoob → Alterar → Insira Client ID → Salvar.
2. Menu Financeiro → Contas → Incluir → Sicoob → nome: Pix Sicoob → habilite Permitir cobrança por Pix com vencimento → insira dados bancários.
3. Conta Pix com vencimento:
   • Conexão com API: Sicoob pix
   • Chave Pix: Cole a chave aleatória gerada no Sicoob
4. Salvar.
5. Menu Vendas → Meio de pagamento → Pix → Alterar:
   • Nome: "Pix Sicoob"
   • Método de Pagto: Pix com vencimento
   • Conta: Selecione conta Sicoob
   • NF-e / NFC-e: Pagamento Instantâneo (Pix) – Estático
   • Salvar

Nota: Reportar erros de emissão ao suporte imediatamente.

Perguntas e Respostas

P: Estou recebendo erro "Forbidden" ao emitir boleto. O que fazer?

R: Este erro provém da API do Sicoob. Contacte seu gerente de contas para mais informações sobre instabilidades.

P: Erro "invalid_grant – Provided Authorization Grant is invalid" ao gerar boleto?

R: Verifique se está usando a versão mais atual da API Sicoob. Entre em contato com o suporte.

P: É possível usar o número da NF-e como "Nosso número" do boleto?

R: Não é suportado atualmente.

P: Erro "TRANSFERENCIA: BLOQUEADO PARA BAIXA" ao cancelar boleto?

R: Este é um erro retornado pelo banco. Contacte o Sicoob diretamente.

P: Como adicionar informações de juros, multa, protesto e negativação ao boleto?

R: Se o banco não preencher automaticamente, use o campo Texto livre no boleto.

P: Desativamos protesto/negativação automática mas um cliente foi negativado. Por quê?

R: As cobranças emitidas enquanto essas funções estavam ativas serão protestadas em caso de atraso. Apenas boletos emitidos após a desativação não serão protestados.