A intgração Pix Cobrança Sicoob está presente na versão Beta do sistema. Sua disponibilidade na versão Estável será a partir de Fevereiro de 2026.
Sicoob - Pix Cobrança
Introdução
A integração entre o Sistema e a plataforma de pagamentos do Sicoob tem como objetivo simplificar os fluxos financeiros e de vendas, oferecendo soluções de pagamento seguras e eficientes via Pix. Esta documentação apresenta os detalhes do processo de integração, seus benefícios e as configurações necessárias.
Funcionalidade que possibilita a emissão de cobranças avulsas por Pix, com controle de vencimento, cálculo de juros e mora, e confirmação de liquidação em tempo real.
Caminho: Sistema > Cadastros > Financeiro > Carteira de cobrança.
Benefícios da integração
| Benefício | Descrição |
|---|---|
| Cobrança Pix | Permite emitir cobranças diretamente via Pix, com QR Code dinâmico vinculado à fatura. |
| Isenção de Tarifas | Muitas cooperativas Sicoob oferecem isenção de tarifas no Pix para pessoas jurídicas, reduzindo custos operacionais. |
| Automação | Reduz ações manuais e aumenta a eficiência dos processos operacionais através da baixa automática. |
| Flexibilidade de pagamento | Oferece o Pix como alternativa de pagamento adicional para as cobranças dos clientes. |
| Comodidade para clientes | Pagamentos com liquidação imediata agilizam o desbloqueio de clientes inadimplentes. |
Estrutura
Como funciona a integração
- Configuração
- Acesso à Central do Assinante
- Escolha da Opção de Pagamento
- Geração do Pix (QR Code)
- Pagamento
- Liquidação Automática no Sistema
Processo de Integração e Homologação
Para realizar a integração e homologação da Integração de Pix Sicoob no Sistema, siga estes passos:
Homologação
Para iniciar a integração, é necessário possuir as credenciais de API junto ao Sicoob.
Sicoob (API Pix)
- 1 - Número da agênca com dígito?
- 2 - Número da conta com dígito?
- 3 - Pix Client ID?
- 4 - Pix Chave (Aleatória, CNPJ, E-mail ou Telefone).
- 5 - Data limite de Pagamento após vencimento?
- 6 - Este convênio bancário é totalmente novo ou já foi usado para emissão?
Passo a passo para obter o Pix Client ID
Para homologar a carteira da API Pix do Sicoob, é necessário gerar o Client ID, que corresponde à criação de uma aplicação no site Developers do Sicoob:
- Acesse o Developers Sicoob e faça login na sua conta.
- Acesse o menu Meus Aplicativos, clique em Novo Aplicativo, insira um nome (a descrição é opcional), e clique em Prosseguir.
- Em A integração será por uma empresa parceira, marque como Sim.
- Em Empresa parceira, selecione IXC Soft SA e clique em Prosseguir.
- Na tela de APIs, selecione o escopo:
- Pix Recebimentos.
- Clique em Prosseguir.
- O aplicativo será criado com status Pendente. Para alterá-lo para Ativo, será necessário aprovar a criação no seu Internet banking.
- Após ativar, volte ao ambiente developer, acesse seu aplicativo e copie o Client ID.
- Fim.
Por segurança, se a criação não for concluída em menos de 3 minutos, será necessário reiniciar o processo.
Criando a Carteira
- Acesse o menu Sistema.
- Entre na pasta Financeiro.
- Clique em Carteira de Cobrança.
- Clique em Novo.
- Na aba Carteira de cobrança, configure os seguintes campos:
- Descrição: Defina o nome da carteira (ex: Sicoob Pix).
- Conta: Crie a conta responsável por armazenar os dados bancários.
- Tipo de recebimento: Selecione a opção Pix.
- Enviar e-mail para cliente ao gerar: Marque conforme sua preferência.
- Validar filial na venda: Marque Não.
- Ativo: Mantenha Sim.
- Filial: Selecione a filial correspondente.
- Planejamento analítico: Utilize o padrão 240 ou cadastre um novo.
Criando a Conta
- Conta: Defina um nome para a conta.
- Tipo da Conta: Marque Banco.
- Data de abertura: Informe a data de configuração.
- Planejamento analítico: Para mais informações, acesse: Contas Contábeis Analíticas.
- Filial: Selecione o ID da filial correta.
Na aba Banco:
- Banco: Selecione o ID
756 - Banco Cooperativo do Brasil S.A. - BANCOOB. - Agência: Número da sua agência bancária.
- Dígito verificador da agência: Insira o dígito verificador.
- Número da conta: Informe o número da conta bancária.
- Dígito verificador da conta: Informe o dígito verificador.
Configurações Pix
- Pix gateway: Selecione Sicoob.
- Pix ambiente: Escolha Produção.
- Pix chave: Insira sua chave Pix cadastrada no Sicoob.
- Pix Client ID: Insira a credencial gerada no Portal Developers do Sicoob.
- Pix URL callback: Primeiro, clique em Salvar para gravar as alterações da carteira (para criação do registro e ID). Em seguida, clique no botão Gerar URL Pix para permitir a comunicação das notificações de pagamento.
- Utilizar Pix recorrente (Pix Automático): * Sim: Habilita a funcionalidade do Pix Automático para cobranças recorrentes.
- Não: Mantém apenas o Pix Cobrança.
- Repetir tentativa de cobrança para Pix recorrente:
- Sim: Permite novas tentativas de débito automático em caso de falha.
- Não: Tenta debitar apenas uma vez.
Caso deseje utilizar o envio de cobrança Pix pelo Opa! Suite, ative o parâmetro Enviar cobrança Pix pelo WhatsApp e preencha o Tipo da chave PIX correspondente.
Juros/Multas/Desconto
- Juros %: Configure conforme contrato (padrão legal máximo 0.033% ao dia). A API do Sicoob suporta modalidades de valor fixo ou percentual.
- Multa %: Configure conforme contrato (padrão legal máximo 2%).
- Desconto: O sistema suporta descontos condicionais até o vencimento.
Para mais informações, acesse: Juros, Multas e Desconto.
Para concluir a configuração da carteira, clique no botão Salvar.
Layouts de Impressão
A integração Sicoob Pix utiliza os layouts de impressão compatíveis com QR Code. Certifique-se de utilizar layouts que possuam a variável para geração da imagem do Pix ou o código "Copia e Cola".
Logs Carteira de Cobrança
Adicionada a nova aba “Logs da Carteira” para carteiras de cobrança do tipo Pix, permitindo registrar e visualizar requisições de integração com bancos, erros retornados, datas e detalhes das operações. Essa funcionalidade oferece maior controle e capacidade de diagnóstico ao usuário, reduzindo a necessidade de suporte técnico. Com ela, torna-se mais fácil identificar falhas nas operações de integração com a API do banco e consultar informações essenciais para corrigir ou ajustar credenciais e configurações.
- Caminho: menu Sistema > Cadastros > Financeiro > Carteira de Cobrança > Tipo: Pix > aba 'logs carteira de cobrança'
Ativando a Carteira de Cobrança no Sistema
Após configurar sua carteira, vincule-a de uma das seguintes formas:
- Hotsite (Central do Assinante): Configure nos parâmetros gerais para que todos os clientes possam pagar via Pix Sicoob na Central.
- Alternativa de Pagamento: Vincule a carteira Pix Sicoob como uma alternativa dentro das suas carteiras de Boleto atuais.
Configurando a Carteira no Hotsite - Central do Assinante
- Acesse o menu Sistema > Hotsite > Configurações > Configuração Geral.
- Acesse a aba Financeiro.
- Na seção Pix, marque Habilitar Pix e selecione a carteira Carteira de cobrança (Pix) criada.
- Clique em Salvar.
Fluxos de Funcionamento
Tarefa de Ativação de Recorrência
Após a ativação dos parâmetros de recorrência na carteira de cobrança, é fundamental ser configurada a tarefa de recorrência. Esta tarefa será a responsável por realizar a criação da cobrança a partir da recorrência ativa em contratos no Sistema. Ela será executada diariamente, e aplicará a criação da cobrança para todos as cobranças recorrentes com vencimento de até 10 dias, a partir da data de sua execução.
Abaixo, acompanhe o passo a passo de configuração da tarefa:
Vá até o menu Ferramentas.
Clique em Ferramentas.
Acesse Agenda de tarefas.
Clique em Novo.
Em Tarefa, selecione Ativação de recorrência Pix para contratos com ID de recorrência vinculado.
Minuto (0-59):
Tipo: Selecione a opção Valor
Valor: Insira o número 0
Hora (0-23):
Tipo: Selecione a opção Valor
Valor: Insira o número 1
Dia do mes (1-31):
Tipo: Selecione a opção Valor
Valor: Não preencher
Mes (1-12):
Tipo: Selecione a opção Valor
Valor: Não preencher
Dia da semana (0-6) 0=dom, 1=seg...:
Tipo: Selecione a opção Valor
Valor: Não preencher
Finalize clicando no botão Salvar.
Finalizado! Com a configuração acima, a tarefa fica configurada para executar todos os dias às 01:00 da manhã.
Implementada lógica para cancelar automaticamente a recorrência do Pix quando houver alteração da data de vencimento em contratos através da Alteração Wizard ou Assistente de Alteração de Contrato. Este procedimento assegura o cumprimento das regras de funcionamento e registro de cobranças estabelecidas pela integração com o gateway de pagamento.
Perguntas Frequentes (FAQ)
1. Preciso pagar tarifas para emitir Pix pelo Sicoob?
- Muitas cooperativas do Sicoob oferecem isenção de tarifas Pix para contas Pessoa Jurídica (PJ). Recomendamos confirmar essa condição com o gerente da sua conta.
2. Onde consigo o Pix Client ID para configurar no sistema?
- O Pix Client ID é obtido através do Portal Developers do Sicoob. Você deve acessar com sua conta, criar uma aplicação e ativar a API "Pix Recebimentos".
3. Essa integração suporta o Pix Automático?
- Não. A integração foi desenvolvida contemplando o Pix Cobrança (cobrança imediata com vencimento) no primeiro momento, mas é esperado que em breve a funcionalidade do Pix Automático também seja implementada.
4. O que acontece se o meu cliente pagar o Pix após o vencimento?
- Na configuração da carteira, o sistema permite definir a validade da cobrança após o vencimento (padrão de mercado é 30 a 90 dias). O cálculo de juros e multas será aplicado automaticamente conforme configurado na carteira.