Visão geral

O MK erp possui integração com a API do Pix Sicredi, 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 Sicredi
• Acesso ao sistema e SAC web em https (recomendado)
• Processo de onboarding e geração dos certificados com a equipe de integrações do Sicredi

Configurações

O primeiro passo é iniciar a jornada de adesão junto com o a equipe do Sicredi. Entre em contato com a cooperativa (o gerente da sua conta pode lhe encaminhar para o setor responsável) e solicite a adesão com a integração API Pix.

Informações sobre o mk erp que serão solicitadas pelo Sicredi (em destaque as respostas que devem ser enviadas):

• Possui provedor para integração: Sim
• Se sim, qual? MK Solutions (software house já homologada)
• Nome do responsável pela integração: (informe o nome do responsável no provedor que vai realizar o contato com o Sicredi)
• E-mail: (informe o e-mail em que deseja receber a cartilha de integração)
• Telefone comercial: (número comercial do provedor)
• Finalidade: Gerar Cobrança Imediata - Cob

A equipe de onboarding vai passar algumas instruções para preenchimento de formulários e assinatura do termo de adesão e após vai instruir o passo a passo para geração dos certificados no internet banking.

Antes de iniciar as configurações no mk as seguintes informações/arquivos devem ser gerados com o banco:

1. certificado digital .CER assinado pelo Sicredi - disponibilizado pelo banco após a geração de um certificado CSR (requisição vazia de certificado). Siga o passo a passo disponível nesta documentação Pix Sicredi: gerando o certificado .CSR
2. chave privada (aplicação key) do certificado - chave privada .PEM extraída do certificado digital. Siga o passo a passo disponível nesta documentação Pix Sicredi: gerando o certificado .CSR
3. credenciais de acesso - client_id e client_secret gerados no internet banking;

 Configuração da profile de pagamento

ACESSO: Configurações → Menu Financeiro → Submenu Profile de Pagamento → Boleto MK Ver. 2 - Edição, localize a profile do Sicredi 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 Sicredi;
• client_secret: credencial de produção enviada pelo Sicredi;
• path_cert_host: certificado digital público do host da api Pix do Sicredi (pode fazer o download clicando aqui e após basta fazer o upload no sistema);
• path_cert_client: certificado .CER disponibilizado pelo Sicredi no internet banking;
• path_key_cliente: chave privada extraída do certificado digital (se foi seguido o passo a passo da documentação Pix Sicredi: gerando o certificado .CSR vai estar salvo no computador com o nome mkSicrediFinal.key).

 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. 

 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 Sicredi 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

Gerar/enviar pix copia e cola pelo painel do cliente

Além do SAC WEB e app novo SAC+ a partir da release 108.52 é possível gerar o QRcode e obter ou enviar por e-mail a linha de pagamento do pix copia e cola pelo painel do cliente.

ACESSO: módulo Financeiro → Painel do cliente → duplo clique sobre o cliente → Faturas a receber

Selecione a fatura e clique na ferramenta Pix no canto inferior da tela. Caso a fatura ainda não tenha chave gerada uma mensagem vai informar:

Basta confirmar que então o QRcode será gerado. Nesta tela então serão habilitadas duas opções:

Copiar código Pix

O código Pix será copiado para a área de transferência do operador, para que seja enviado como desejar.

Enviar código Pix por email

Será enviado para o cliente um email com o código Pix para que seja efetuado o pagamento. O email vai seguir o seguinte padrão:

• será enviado pela conta default da empresa/multiempresa;
• será considerado o(s) email(s) definido(s) no cadastro do cliente;
• o corpo do email é padrão e contém as informações do nome do cliente, número da fatura, data de vencimento da fatura, código pix e data de expiração (validade) do código de pagamento (às 23:59h do dia de vencimento da fatura):

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 Sicredi
  • Status erro: detalhamento do status da rejeição enviado pelo Sicredi

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 Sicredi. 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: