Visão geral

O MK erp possui integrações com as APIs PIX, 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 (na modalidade/opção de pagamento PIX COPIA E COLA);
• Receber pagamentos dos clientes automaticamente;
• Acompanhar as transações (geração do QRCode, pagamentos efetivados e rejeitados);

Pré Requisitos

• Sistema na versão 109 - MK4 (veja informações sobre a migração em nosso canal no YouTube)
• Profile V2 homologada com os bancos que o mk erp tem integração:
  • Banco do Brasil
  • Sicredi
  • Sicoob
  • Bradesco (a partir da versão 109.57)
• Acesso ao sistema e SAC web em https (recomendado)

Seleção de conta PIX padrão para geração de QRcode

ACESSO: Configurações → Financeiro → Configuração Básica → COBRANÇAS

• Profile de pgto padrão para geração do QRcode - neste campo são listadas somente as profiles de pagamento que tem chaves PIX em produção, dessa forma a que for selecionada é a que vai gerar o QRcode para todas as faturas;
• Profiles de pagamento que não estão habilitadas para geração do QRcode - caso deseje que alguma fatura em específico não gere QRcode para pagamento PIX selecione nesta listagem.

Regras de negócio

Fique atento às regras de negócio desta configuração caso trabalhe com múltiplas faturas com credenciais PIX:

• Se a fatura estiver vinculada a uma profile com PIX ativo ela deve ter o QRcode gerado pela profile da fatura;

• Se a fatura estiver vinculada a uma profile que não tiver o PIX ativo então o QRcode deve ser gerado pela profile selecionada nesta nova configuração.

Exemplo:

Provedor tem profiles BB, Bradesco e Sicredi.

Somente Bradesco e Sicredi tem credenciais PIX em produção.

Se na configuração for selecionada a profile Sicredi como padrão o comportamento será o seguinte:

1. Fatura com profile BB vai ter o QRcode gerado com os dados PIX do Sicredi (porque o Sicredi está selecionado como padrão e a profile BB não tem credenciais PIX);
2. Fatura com profile Bradesco vai ter o QRcode gerado com os dados PIX do Bradesco (porque a prioridade é a profile da fatura, como ela tem configuração mesmo que o Sicredi esteja selecionado como padrão neste cenário o QRcode será gerado pelo Bradesco);

No gerenciador de transações via PIX estas informações ficam registradas, veja mais detalhes em Transações com sucesso dos últimos 7 dias.

Área de configuração para validade do QRcode

ACESSO: Configurações → Financeiro → Configuração Básica → COBRANÇAS

• Quantidade de dias limite para validade do QRcode - o comportamento é definido de acordo com o preenchimento deste campo:
  • Nulo: o QRcode é válido até às 23:59h do dia do vencimento da fatura e em caso de geração para fatura vencida até às 23:59h do dia da geração
  • 1 ou mais dias: o QRcode é válido até às 23:59h conforme os dias informados. Exemplo: para QRcode gerado no dia 19/07 para fatura com vencimento em 31/07 e com campo configurado em 2 dias o QRcode será válido até às 23:59h do dia 21/07. Observe que com o campo ativo a data de vencimento da fatura não interfere na validade do QRcode. Caso seja gerado para fatura vencida se mantém o padrão de validade até às 23:59h do dia da geração. 

Seleção de conta PIX padrão por multiempresa para geração de QRcode

ACESSO: Configurações → Provedor - Empresas → PIX

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);

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):

Gerar chave de pagamento pix copia e cola por API

A partir da release 109.53 foi disponibilizada uma API que gera a linha de pagamento PIX disponibilizando ela para uso em integrações. Para mais informações acesse a documentação específica sobre APIs e converse com o setor comercial!

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

• Profile da fatura: profile de pagamento da fatura do cliente
• Profile do QRcode: profile que fez a geração do QRcode

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

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. 

Analisando códigos de erros

As rejeições são enviadas pelo BB com códigos de erros que facilitam a identificação. Todas estão listadas no manual abaixo:

• Tabela de Listagem de Erros

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/APIs bancárias. 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.

Busca de pagamentos quando QRcode está com status ATIVO 🆕

• Disponível a partir da release 64.6 ou superior

Eventualmente ocorrem inconsistências entre a data de pagamento do Pix e a data informada pela API bancária (normalmente ocorre quando o cliente agenda o pagamento) e as rotinas automáticas que buscam os pagamentos a cada 5min e a cada 6h acabam não encontrando estas faturas.

Para que as liquidações sejam feitas corretamente nestes casos, ou caso queira buscar/verificar um pagamento específico antes da próxima execução da rotina, é possível selecionar uma fatura que teve o QRcode gerado (ela vai estar com o Status informado como Ativo) e então buscar o pagamento somente dela (independente da data). A pesquisa será feita com base no TXID da fatura selecionada:

Após a mensagem de confirmação então o sistema vai buscar na API do banco atualização de pagamento para a fatura/TXID e caso tenha sido paga o status já será atualizado.

Seleção de conta bancária para conciliação automática

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

🆕 Recurso disponível a partir da subrelease nº 64.10

• Conta para conciliação - seleção da conta bancária para conciliação automática de todos os pagamentos realizados via Pix utilizando a configuração desta profile. Assim o passo a passo abaixo (para conciliação de pagamentos pelo gerenciador de fluxo de caixas) será realizado automaticamente.

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: