Central de Ajuda

Leitura de 8 min

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.

Solução Oferecida

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.

Acesso ao Formulário

Caminho: Sistema > Cadastros > Financeiro > Carteira de cobrança.

Benefícios da integração

BenefícioDescrição
Cobrança PixPermite emitir cobranças diretamente via Pix, com QR Code dinâmico vinculado à fatura.
Isenção de TarifasMuitas cooperativas Sicoob oferecem isenção de tarifas no Pix para pessoas jurídicas, reduzindo custos operacionais.
AutomaçãoReduz ações manuais e aumenta a eficiência dos processos operacionais através da baixa automática.
Flexibilidade de pagamentoOferece o Pix como alternativa de pagamento adicional para as cobranças dos clientes.
Comodidade para clientesPagamentos com liquidação imediata agilizam o desbloqueio de clientes inadimplentes.

Estrutura

Como funciona a integração

  1. Configuração
  2. Acesso à Central do Assinante
  3. Escolha da Opção de Pagamento
  4. Geração do Pix (QR Code)
  5. Pagamento
  6. 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.

Dados Necessários

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

Informação!

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:

  1. Acesse o Developers Sicoob e faça login na sua conta.
  2. Acesse o menu Meus Aplicativos, clique em Novo Aplicativo, insira um nome (a descrição é opcional), e clique em Prosseguir.
  3. Em A integração será por uma empresa parceira, marque como Sim.
  4. Em Empresa parceira, selecione IXC Soft SA e clique em Prosseguir.
  5. Na tela de APIs, selecione o escopo:
    • Pix Recebimentos.
  6. Clique em Prosseguir.
  7. O aplicativo será criado com status Pendente. Para alterá-lo para Ativo, será necessário aprovar a criação no seu Internet banking.
  8. Após ativar, volte ao ambiente developer, acesse seu aplicativo e copie o Client ID.
  9. Fim.

Aviso!

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

  1. Acesse o menu Sistema.
  2. Entre na pasta Financeiro.
  3. Clique em Carteira de Cobrança.
  4. Clique em Novo.
  5. 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.

Envio via WhatsApp

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.

Importante!

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

  1. Acesse o menu Sistema > Hotsite > Configurações > Configuração Geral.
  2. Acesse a aba Financeiro.
  3. Na seção Pix, marque Habilitar Pix e selecione a carteira Carteira de cobrança (Pix) criada.
  4. Clique em Salvar.

Fluxos de Funcionamento

sequenceDiagram
    participant S as Sistema
    participant API as API Sicoob
    participant W as Webhook

    S->>API: Envia requisição (ex: gerar fatura)
    API->>S: Responde com dados da fatura
    Note over API,W: Evento ocorre (ex: pagamento)
    W->>S: Notifica sobre o evento
    S->>API: Confirma recebimento da notificação

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:

Tarefa - Ativação de Recorrência

Configurando:

  1. Vá até o menu Ferramentas.

  2. Clique em Ferramentas.

  3. Acesse Agenda de tarefas.

  4. Clique em Novo.

  5. 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

  6. Finalize clicando no botão Salvar.

Sucesso!

Finalizado! Com a configuração acima, a tarefa fica configurada para executar todos os dias às 01:00 da manhã.

Cancelamento de Pix Recorrente

Implementada lógica para cancelar automaticamente a recorrência do Pix quando houver alteração da data de vencimento em contratos através do 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)

Dúvidas comuns sobre o Pix Sicoob

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.

Leia Também

Visão de gráfico

Páginas relacionadas