Integra Mercafácil

A Mercafacil é uma plataforma de fidelidade e cashback. Com a integração, o PDV consulta durante a venda os descontos e o cashback do cliente no clube, e o integrador envia à Mercafacil os produtos, os operadores e os cupons das vendas.

Como funciona

• No PDV (tempo real): ao lançar os itens, o PDV envia o carrinho à Mercafacil, que devolve os descontos do clube e o cashback disponível do cliente. Se o cliente não foi identificado na venda, a Mercafacil pede o CPF/CNPJ na tela. Ao finalizar a venda a transação é confirmada; se a venda for cancelada ou abandonada, a transação é cancelada.
• No integrador (Integração Mercafacil): envia os produtos, os operadores (usuários) e os cupons das vendas, e reenvia a confirmação ou o cancelamento das transações que o PDV não conseguiu enviar na hora.
• Se a Mercafacil não responder, a venda não trava: o PDV segue sem os descontos do clube e o integrador reenvia o que ficou pendente.

Configuração no Master Key

1. Abra Parâmetros do Sistema, aba Configurações do Sistema, e expanda a seção Integrações.
2. No grupo Mercafácil, marque Utiliza Mercafácil.
3. Informe o Token da loja (fornecido pela Mercafacil, tem no mínimo 500 caracteres) e confira a URL Base (o padrão é https://pdv.mercaconnect.com/api).
4. Marque Imprime comprovante adicional da Mercafácil se o cliente quiser o comprovante com o saldo e as mensagens do clube.
5. Marque Enviar vendas somente pelo integrador se o PDV não deve enviar o cupom na hora. Desmarcada, o PDV envia o cupom ao finalizar a venda e o integrador reenvia os pendentes.
6. Clique em Gravar.

A configuração é por filial: repita o procedimento em cada filial que usa a Mercafacil.

Usuários: em Parâmetros do Sistema, aba Usuários e Permissões, existe o campo CPF no cadastro do usuário. Ele é enviado à Mercafacil como documento do operador. Preencha o CPF dos usuários que operam o caixa.

Tipo de pagamento CASHBACK: ao utilizar a integração o sistema cria o tipo de pagamento CASHBACK, usado para lançar o cashback do cliente na venda. Ele herda a categoria e a subcategoria do tipo VALE (ou do DINHEIRO se o VALE não existir). Se o cliente já tiver um tipo chamado CASHBACK, o cadastro dele é mantido.

Instalação do integrador

1. Baixe o integrador IntegraMercafacil.zip e extraia na pasta MK4.
2. Abra o IntegraMercafacil.exe que está na pasta Sistema/MK4.
3. O integrador usa o Token e a URL configurados nos Parâmetros do Sistema de cada filial, não é preciso informá-los nele.
4. No campo Dias de histórico dos cupons o padrão é 180 dias (a Mercafacil pede cerca de 6 meses). Esse histórico é enviado na primeira carga de cupons.
5. Clique em Sincronizar. Quem clica em Sincronizar envia na hora, sem esperar os minutos de segurança das vendas recentes.
6. Confira na lista de eventos se não houve erro.

O integrador roda automaticamente a cada 10 minutos. As vendas com menos de 5 minutos ficam para o próximo ciclo, pois o PDV ainda pode estar confirmando a transação.

Observações

• Produtos e operadores são enviados em lotes de 500 e os cupons em lotes de 50.
• Na primeira carga os produtos inativos não vão; nas cargas seguintes eles vão para a Mercafacil saber da inativação.
• Produtos de serviço não são enviados.
• O usuário OFFICE (suporte) não é enviado como operador.

Problemas comuns

Venda não aparece na Mercafacil

Verifique a situação do cupom da venda:

SELECT VE_CONTROLE, VE_DTEMISS, VE_STATUS, VE_MERCAFACIL_TRANSACTIONID,
       VE_MERCAFACIL_ENVIADO, VE_MERCAFACIL_CONFIRMADO
FROM VENDAS
WHERE VE_MERCAFACIL_TRANSACTIONID IS NOT NULL
ORDER BY VE_DTEMISS DESC

• VE_MERCAFACIL_ENVIADO: S = cupom enviado; C = cupom enviado e cancelamento enviado; vazio ou N = ainda não enviado (o integrador envia no próximo ciclo).
• VE_MERCAFACIL_CONFIRMADO: S = transação confirmada; C = transação cancelada (venda abandonada); vazio = pendente.
• A Mercafacil expira a transação pendente após 3 dias. Confirmações mais antigas que isso não são mais reenviadas.

Para reenviar um cupom, deixe o campo VE_MERCAFACIL_ENVIADO vazio e clique em Sincronizar no integrador.

PDV mostra "Mercafácil indisponível"

A Mercafacil não respondeu (o PDV espera até 5 segundos). A venda segue sem os descontos do clube. Depois disso o PDV não tenta a Mercafacil por 2 minutos, para não atrasar o caixa. Verifique a internet do caixa e o Token/URL nos Parâmetros do Sistema. O detalhe do erro fica no log da integração.