Visão geral

O MK erp possui integração com a API do Pix Sicoob, o que viabiliza a realização de pagamentos (QRcode e pix copia e cola) pelo SAC WEB e app do SAC Plus+. Nesta modalidade os valores Pix pagos pelos clientes são depositados diretamente na conta corrente do provedor.

Com esta integração será possível: 

• Disponibilizar QRcode para pagamentos dos clientes
• Disponibilizar a linha do QRcode para pagamentos dos clientes
• Receber pagamentos dos clientes automaticamente
• Acompanhar as transações (geração do QRCode, pagamentos efetivados e rejeitados)

Pré Requisitos

• Sistema na versão 109.52 - MK4 (veja informações sobre a migração em nosso canal no YouTube)
• Profile V2 homologada do Sicoob
• Acesso ao sistema e SAC web em https (recomendado)
• Certificado digital
• Extração da chave privada .PEM do certificado
• Extração da chave pública .PEM do certificado

Cadastro Pix Sicoob

A equipe de desenvolvimento do mk erp já fez testes de pagamento com o Sicoob durante a criação da integração, por isso o sistema é considerado como já homologado. Assim basta solicitar para a agência as chaves de produção para inserir na profile. Deve ser utilizada uma conta (profile Sicoob v2) já cadastrada no sistema.

É necessário inserir os dados PIX passados pela agência, entre em contato com o seu gerente para solicitar as informações. Para agilizar o processo já pode enviar para ele as seguintes informações:

Dados do cooperado: (preencha com as informações do provedor e da conta Sicoob)

1. Cooperativa: 
2. Conta:
3. Nome completo do cooperado: 
4. CPF:
5. Razão social: 
6. CNPJ: 
7. E-mail do cooperado:
8. Telefone móvel para envio de SMS do cooperado:
9. IP fixo do seu servidor: (IP do seu sistema mk)

Informações sobre seu aplicativo/website:

1. Finalidade e Endpoints que serão utilizados: PIX copia e cola (QRcode) utilizando endpoints da API 2.2.1 de integração, gerenciamento de cobranças com pagamento imediato (COB) e gerenciamento de Pix recebidos (PIX)
2. IP público: (IP do seu sistema mk)
3. A integração será através de uma software house? Sim
4. Software house: MK Solutions (com API já homologada)
5. CNPJ da software house: 09587408000186
6. Chave pública do certificado: (chave pública .PEM extraída do certificado digital, se tiver dúvidas neste processo pode consultar a sua equipe de TI, o fornecedor do certificado digital, ou seguir o manual Extraindo as chaves do seu certificado digital).
   

A própria agência vai receber os dados da central do Pix e enviar para o e-mail do cooperado. Será enviada uma pasta compactada com senha com senha, para visualizar o conteúdo utilize a senha recebida por SMS.

Assim que tiver as informações cadastre elas no sistema conforme o passo a passo abaixo.

Configuração da profile de pagamento em ambiente de produção

ACESSO: Configurações → Menu Financeiro → Submenu Profile de Pagamento → Boleto MK Ver. 2 - Edição, localize a profile do Sicoob e então vai estar disponível a área PIX para inserir a configuração:

Preencha os seguintes campos:

• Chave PIX: chave Pix da conta Sicoob (gerada pelo Sicoob e enviada para o cooperado por e-mail, pode ser o CNPJ, um e-mail, telefone, chave aleatória... verifique com o seu gerente)
• Credenciais: seleção da credencial utilizada na conta/profile de pagamento. Clique em Cadastrar credenciais PIX para inserir os dados de produção;
• Status: selecione a opção:
  
  • Produção
• Hab. testes:
  • Sim:
  • Não:
• Cliente Homologação: 
• Testar comunicação: teste de comunicação com o Sicoob para confirmar se a chave e credenciais estão corretas (clique para executar somente após inserir os dados conforme instruções abaixo);
• Cadastrar credenciais PIX: ao clicar neste botão será aberta nova janela onde deve ser inserida a configuração com as novas chaves de produção;

• client_id: credencial de produção enviada pelo Sicoob;
• client_secret: credencial de produção enviada pelo Sicoob;
• path_cert_host: certificado digital público do host da api Pix do Sicoob,  de produção gerado pelo Sicoob no formato .CRT (pode fazer o download clicando aqui e após basta fazer o upload no sistema);
• path_cert_client: certificado digital adquirido pelo provedor no formato .CRT (caso tenha um certificado .PFX pode converter ele em .CRT;
• path_key_cliente: chave privada .PEM extraída do certificado digital do provedor, se tiver dúvidas neste processo pode consultar a sua equipe de TI e/ou a documentação

  Extraindo as chaves do seu certificado digital

 Testar comunicação

Para confirmar que as chaves de homologação estão corretas utilize a ferramenta Testar comunicação:

Este teste verifica se as chaves informadas na credencial estão certas e se os certificados tiveram o upload feito corretamente. Como os certificados são obrigatórios para geração do PIX Sicoob observe que se não for realizado o upload o retorno do teste não será OK:

 Ativar ferramentas PIX no SAC WEB

Para gerar o teste de pagamento do cliente selecionado na profile em homologação o PIX deve ser ativo no SAC WEB. Veja na documentação: Habilitar/Desabilitar pagamentos por PIX no SAC WEB

 Testar a linha de pagamento gerada pelo QRcode

Para que o Sicoob faça a análise da linha de pagamento o QRcode para uma fatura do cliente em homologação deve ser gerado no SAC e então a linha pode ser copiada. Veja na documentação: Efetuar pagamentos pelo SAC WEB. Faça a cópia do código e então envie para o gerente da sua conta/agência.

A própria agência vai executar os testes e lhe retornar informando que foram realizadas as liquidações.

Habilitar/Desabilitar pagamentos por PIX no SAC WEB e app novo SAC+

ACESSO: Configurações → SAC → Configuração SAC→ Pagamento PIX:

ACESSO: Configurações → SAC → Configuração SAC→ MOBILE NOVO SAC PLUS → Checkout Pix = Sim

Efetuar pagamentos pelo SAC WEB

Ao acessar o SAC WEB o cliente vai visualizar um novo botão "Pagar com PIX" no menu Pagamentos.

Nesta área temos as seguintes informações:

• Fatura que será paga: código da fatura selecionada;

• Descrição: descrição da fatura selecionada;

• Vencimento: data de vencimento da fatura selecionada;

• Valor (R$): valor original da fatura selecionada;

• Desconto (R$): valor de desconto da fatura (gerado pela tabela de descontos associada ao contrato);

• Multa (R$): valor de multa caso a fatura vencida (gerado pela % definida na configuração do sistema);

• Acréscimo (R$): valor de acréscimo caso a fatura vencida (gerado pela % definida na configuração do sistema);

• Dias de atraso: total de dias em atraso da fatura vencida;

• Valor reajustado: valor atual (caso a fatura tenha desconto ou acréscimo e multa).

Efetuar pagamentos pelo app novo SAC+

A mesma configuração que ativa o pagamento pelo SAC WEB também habilita para os clientes no app novo SAC+. Basta acessar a ferramenta de pagamentos e clicar em PAGAR FATURA:

Selecione a forma de pagamento pelo Pix e clique para efetuar o pagamento:

Ficam disponíveis duas opções:

• COPIAR CÓDIGO PIX - faz a copia da chave para que o cliente possa utilizar no app que desejar para fazer o pagamento;
• COMPARTILHAR CÓDIGO PIX - abre a bandeja de opções do smartphone para que a chave possa ser compartilhada pelo app que o cliente desejar (Whats, Telegram, etc);

Painel de acompanhamento das transações via PIX

ACESSO: módulo Financeiro → Transações via PIX

Para o acompanhamento das transações via PIX temos os seguintes painéis: 

Transações com sucesso dos últimos 7 dias

Neste painel o operador poderá visualizar as transações em que foi gerado o QRCODE no SAC WEB ou app SAC+ e também os pagamentos realizados nos últimos 7 dias.

Para cada transação teremos as seguintes informações: 

• Código: identificação da transação 
• Fatura: código identificativo da fatura 
• Gerado em: data em que o QRCODE foi gerado
• Status: status da operação ATIVA ou CONCLUIDA. ATIVA significa que o QRcode foi gerado pelo cliente no SAC WEB/Apps, CONCLUÍDA significa que o pagamento foi reaalizado.
• Cliente: nome do cliente da operação
• Doc. Cliente: documento do cliente da operação
• Valor da fatura: valor da fatura do cliente (já atualizado em caso de acréscimo por atraso)
• Pago em: data de pagamento (pois o QRcode pode ser gerado em um dia no SAC e pago em outro)
• Pagador: informação sobre o pagante, pois a fatura pode ser liquidada pelo PIX de pessoa diferente do titular
• Doc Pagador: documento do pagante

• Profile: profile de pagamento da fatura

• Operador: onde o QRcode foi gerado (SAC WEB/App)

• Id transação: identificação específica da transação enviada para o BB

• Válido até: data de validade do QRcode (período em que o cliente pode fazer o pagamento utilizando o mesmo código/chave, após ele deve gerar novo no SAC WEB/App)

• Produção: informa se a transação foi feita em produção ou homologação

Transações com erro (últimos 30 dias)

Neste painel o operador poderá visualizar as transações que obtiveram erro nos últimos 30 dias, ou seja, os pagamentos via PIX que não foram efetivados. 

Para cada transação com erro teremos as seguintes informações: 

• Código: identificação da transação 

• Fatura: código identificativo da fatura

• Data da transação: data da tentativa de pagamento ou geração do QRcode

• Operação: pagamento ou geração do QRcode

• Descrição: detalhes sobre a rejeição

• Cliente: nome do cliente

• Doc. Cliente: documento do cliente

• R$ transação: valor

  • Profile: profile de pagamento da fatura

  • Operador: onde o QRcode foi gerado (SAC WEB/App)

  • Status code: detalhamento do código da rejeição enviado pelo Sicoob
  • Status erro: detalhamento do status da rejeição enviado pelo Sicoob

Todas as transações executadas com sucesso

Neste painel o operador poderá visualizar todas as transações em que foi gerado o QRCODE no SAC WEB ou app SAC+ e também os pagamentos realizados.

Todas as transações que geraram erro

Neste painel o operador poderá visualizar todas as transações que obtiveram erro, ou seja, os pagamentos via PIX que não foram efetivados. 

Execução da rotina de pagamentos via PIX

O sistema faz a checagem automática dos pagamentos realizados. Essa análise é executada em uma rotina periódica. 

Então se um cliente realizar o pagamento agora em 5 minutos a transação estará disponível para análise no sistema e, se for efetivada com sucesso, a fatura é imediatamente liquidada. Para a execução correta da rotina é necessário que o servidor tenha comunicação com os webservices do Sicoob. Se por algum motivo a rotina não for executada pode ser feita uma busca por data para análise imediata das transações:

• Data: basta preencher o período de data que deseja consultar as transações.

Conciliando pagamentos feitos via Pix

ACESSO: Financeiro → Gerenciador de fluxo de caixas → Liquidações via Pix

Neste painel o operador poderá visualizar as transações realizadas com sucesso nos últimos 30 dias (pagamentos via PIX que foram efetivados). Neste menu podem ser utilizadas as seguintes ferramentas:

• Alterar intervalo de datas da exibição: por padrão esta tela mostra as transações dos últimos 30 dias, clicando nesta opção é possível escolher se deseja ampliar o filtro ou utilizar um período de data personalizado;

• Gerar conciliação dos registros selecionados: ferramenta para conciliar o valor pago pelo cliente na conta bancária de destino. São abertas as seguintes opções: 
  • Conta para recebimento: em qual conta será creditado o valor;
  • Data recebimento: qual a data do recebimento;

  • Valor recebimento: valor recebido e que será creditado na conta. 

Após finalizar esta conciliação o valor da fatura será visualizado em Movimentações de Contas Bancárias.

Visualizar as transações no painel do cliente

ACESSO: Financeiro → Painel do cliente → Faturas a receber → Duplo clique sobre a fatura:

Analisar o histórico das faturas

• Sucesso ao gerar cobrança PIX - essa operação indica que o QRCode foi gerado no SACWEB ou APP SAC+:

• Sucesso ao atualizar cobrança PIX - essa operação indica que um QRCode foi gerado anteriormente e expirou (não foi pago dentro do prazo) e o cliente fez a geração de um novo código:

• Liquidação - essa operação mostra os detalhes do pagamento efetivado: