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

...

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

...

Á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: oQRcode é 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:

...

Efetuar pagamentos pelo SAC WEB

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

...

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:

...

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

...

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

...

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.

...

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:

Image Added

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

...

Busca de pagamentos quando QRcode está com status ATIVO 🆕

Image Added

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

Image Added

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

Image Added

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

...

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

...