Vitor: Criou página com '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...'

2026-10-23T18:28:28Z

Criou página com '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...'

Página nova

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

#Abra '''Parâmetros do Sistema''', aba '''Configurações do Sistema''', e expanda a seção '''Integrações'''.
#No grupo '''Mercafácil''', marque '''Utiliza Mercafácil'''.
#Informe o '''Token''' da loja (fornecido pela Mercafacil, tem no mínimo 500 caracteres) e confira a '''URL Base''' (o padrão é <code>https://pdv.mercaconnect.com/api</code>).
#Marque '''Imprime comprovante adicional da Mercafácil''' se o cliente quiser o comprovante com o saldo e as mensagens do clube.
#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.
#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===

#Baixe o integrador '''IntegraMercafacil.zip''' e extraia na pasta '''MK4'''.
#Abra o '''IntegraMercafacil.exe''' que está na pasta Sistema/MK4.
#O integrador usa o Token e a URL configurados nos Parâmetros do Sistema de cada filial, não é preciso informá-los nele.
#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.
#Clique em '''Sincronizar'''. Quem clica em Sincronizar envia na hora, sem esperar os minutos de segurança das vendas recentes.
#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:<syntaxhighlight lang="sql">
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
</syntaxhighlight>

*'''VE_MERCAFACIL_ENVIADO:''' <code>S</code> = cupom enviado; <code>C</code> = cupom enviado e cancelamento enviado; vazio ou <code>N</code> = ainda não enviado (o integrador envia no próximo ciclo).
*'''VE_MERCAFACIL_CONFIRMADO:''' <code>S</code> = transação confirmada; <code>C</code> = 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.

Integra Mercafácil - Histórico de revisão

Vitor: Criou página com '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...'