Office System - Mudanças recentes [pt-br]

Configuração Boletos API

10.20.123.81 — Wed, 28 Oct 2026 19:59:46 GMT

Integra Mercafácil

Vitor — Fri, 23 Oct 2026 18:28:28 GMT

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.

Página principal

Vitor — Fri, 23 Oct 2026 18:26:47 GMT

Integrações

Página principal

10.20.123.81 — Fri, 23 Oct 2026 18:25:08 GMT

Integrações

Smart TEF

10.20.123.81 — Wed, 14 Oct 2026 13:59:45 GMT

PagBank/PagSeguro

@@ Linha 11: / Linha 11: @@
 ===Configurador de Documentos===
-*<small>Selecionar "Tipo do Boleto" a opção "Hibrido" para o tipo de impressão que sai o QRCode.</small>
+*<small>Selecionar "Tipo do Boleto" a opção "Impressão Total pelo Sistema".</small>
 *<small>Selecionar "Documento" na opção "Documento".</small>
 *<small>Observações apesar de não serem obrigatórias, podem ser preenchidas normalmente se desejado (Infomação de Multa e Juros por exemplo).</small>
@@ Linha 55: / Linha 60: @@
 *<small>Código Convênio: Preencher com o Código do Convênio (Na documentação da API BB, diz que deve conter '''sempre 7''' digitos, nos boletos antigo existia de 6 e 7,  a principio convenios de 6 digitos não funciona)</small>
 *<small>Código Cedente: Preencher com o Código do Convênio (7 digitos, mesma regra, afinal só repete os dados por causa do MK)</small>
-*<small>% de Juros Diário se desejado.  (Se desejado, obrigatório marcar "Imprime Juro Diário" na configuração do Documento)</small>
+*<small>% de Juros Diário se desejado.</small>
 *<small>% de Multa se desejado.</small>
 *<small>Dias para Negativação se desejado.</small>
@@ Linha 77: / Linha 82: @@
 *<small>Agencia: XXXX (Acredito que seja sempre 0001).</small>
 *<small>Código Cedente: Conta Corrente sem o digito.</small>
-*<small>% de Juros Diário se desejado.  (Se desejado, obrigatório marcar "Imprime Juro Diário" na configuração do Documento)</small>
+*<small>% de Juros Diário se desejado.</small>
 *<small>% de Multa se desejado.</small>
 *<small>Dias para Negativação se desejado.</small>
@@ Linha 99: / Linha 104: @@
 *<small>Agencia: XXXXX.</small>
 *<small>Código Cedente (Também chamado de Numero do Cliente). *** No campo CÓDIGO DO CEDENTE vai o número do contrato ou o número do cliente (ao todo são 7 dígitos)</small>
-*<small>% de Juros Diário se desejado.  (Se desejado, obrigatório marcar "Imprime Juro Diário" na configuração do Documento)</small>
+*<small>% de Juros Diário se desejado.</small>
 *<small>% de Multa se desejado.</small>
 *<small>Dias para Negativação se desejado.</small>
@@ Linha 122: / Linha 127: @@
 *<small>Agencia: XXXX.XX.</small>
 *<small>Código Cedente (Chamado de código do beneficiário - 13 dígitos).</small>
-*<small>% de Juros Diário se desejado.  (Se desejado, obrigatório marcar "Imprime Juro Diário" na configuração do Documento)</small>
+*<small>% de Juros Diário se desejado.</small>
 *<small>% de Multa se desejado.</small>
 *<small>Dias para Negativação se desejado.</small>
@@ Linha 131: / Linha 136: @@
 *<small>Preencher Banco, Agencia e Conta Corrente.</small>
 *<small>Na aba "API Boleto" preencher o Client ID e Client Secret que deve ser gerado pelo cliente.</small>

@@ Linha 34: / Linha 34: @@
 *[[Omie|Integra Omie]]
 *[[Integra Scanntech]]
-*Integra Mercafácil
+*[[Integra Mercafácil]]
 *[[Integração Best Way]]
 *[[Integração Sites|Integração Sites/eCommerce]]

@@ Linha 34: / Linha 34: @@
 *[[Omie|Integra Omie]]
 *[[Integra Scanntech]]
 *[[Integração Best Way]]
 *[[Integração Sites|Integração Sites/eCommerce]]

@@ Linha 48: / Linha 48: @@
 ===PagBank/PagSeguro===
-Deve ser solicitado a liberação do Número do Serial do POS no [https://dev.pagbank.uol.com.br/v1.0/reference/smart-pos-quero-integrar-suporte#central-de-atendimento Formulario], acessando a opção "vincular terminar ao aplicativo".
+Deve ser solicitado a liberação do Número do Serial do POS no [https://developer.pagbank.com.br/docs/integracao-smartpos Formulario], acessando a opção "vincular terminar ao aplicativo".
 <br />Após a solicitação, será recebido a confirmação de liberação no e-mail informado no formulário. Após isso o app deve estar disponível na loja de apps do POS.