Recebendo pagamentos com a maquininha Mercado Pago no Gransoft Windows
Série Pagamento integrado · Parte 4 de 4
Como receber pagamentos por cartão diretamente pelo Gransoft
Com a maquininha Mercado Pago Point integrada, a cobrança sai do Gransoft com o valor exato das parcelas, o cliente paga na maquininha e o sistema dá a baixa sozinho. Este tutorial mostra o dia a dia: cobrar, acompanhar, cancelar, estornar e lidar com falhas.
O que você vai aprender
Como iniciar uma cobrança a partir das parcelas do pedido.
Como escolher maquininha, forma de pagamento, parcelas e quem paga os juros.
Como interpretar cada mensagem da janela de cobrança.
O que acontece no financeiro e na nota fiscal depois da aprovação.
Como cancelar, estornar e registrar uma venda em contingência.
1. Pré-requisitos
Filial configurada e modalidades integradas criadas (Parte 3).
Maquininha ligada, com internet e no modo integrado (PDV).
Pedido gerado com as parcelas a receber, como de costume.
2. Visão geral
Figura 1. O fluxo de uma venda com pagamento integrado.
Regras da cobrança integrada
• Só parcelas de um mesmo pedido/documento e pendentes. • A cobrança é a soma exata das parcelas marcadas — não existe cobrança parcial de uma parcela. • Só para recebimentos (contas a receber). • Só a resposta da operadora baixa a parcela: nada é baixado enquanto o pagamento não for aprovado.
3. Passo 1 — Selecionar as parcelas
Figura 2. Menu Financeiro: (1) Financeiro, (2) Parcelas a Receber. Em verde, a lista “Cobranças Maquininha / Pix”, usada mais adiante.
Abra Financeiro › Parcelas a Receber (tela Títulos a Receber).
Localize o pedido. Exemplo: tecle F2 (“Pesquisar por Nº documento”), digite o número do pedido e clique em Pesquisar.
Marque, na última coluna, as parcelas que o cliente vai pagar agora.
Clique em Baixar Parcelas e responda Sim em “Confirma a baixa das parcela(s) selecionada(s)?”.
Figura 3. Pedido 1043 (dados fictícios): (1) pesquisa por nº do documento, (2) duas parcelas marcadas — R$ 17.400,00 selecionados — e (3) Baixar Parcelas.
O mesmo funciona em qualquer tela de baixa do Gransoft que abra a janela Pagamento (por exemplo, o recebimento no caixa): o que aciona a maquininha é a modalidade escolhida no Passo 2.
4. Passo 2 — Escolher a forma de pagamento integrada
Na janela Pagamento, confira o Total a Pagar.
Em Selecione a forma de Pagamento, escolha a modalidade integrada (ex.: Crédito Maquininha MP).
Clique em Registrar.
O Gransoft confirma o valor: “Deseja registrar a baixa de 2 parcela(s) no valor total de R$ 17.400,00 na maquininha? O documento ainda terá R$ 26.100,00 em aberto após esta cobrança.” Clique em Sim.
Figura 4. Escolha da forma integrada. Em verde, as outras modalidades integradas do exemplo (débito e Pix). Nomes de outras empresas foram ocultados.Figura 5. Confirmação do valor e do saldo que continuará em aberto no pedido.
5. Passo 3 — Enviar a cobrança para a maquininha
Abre a janela Cobrança - Mercado Pago Point, com o valor em destaque.
Figura 6. Janela de cobrança preenchida (dados fictícios).
Nº
Campo
Como usar
1
Maquininha
Vem selecionada a maquininha padrão deste computador. Troque se o cliente estiver em outra.
2
Forma
Crédito, Débito ou Pix. Vem com a forma da modalidade escolhida.
3
Parcelas
Só no crédito (de 1 a 18). Pela documentação do Mercado Pago, o número de parcelas enviado pelo sistema é aplicado nas Point Pro 2 e Pro 3; nas Point Smart, confira na tela da maquininha o parcelamento escolhido.
4
Juros
Só no crédito parcelado: Loja (sem juros) — a loja assume o custo do parcelamento — ou Cliente (com juros) — o cliente paga os juros da operadora.
5
Enviar para a maquininha
Envia a cobrança. A partir daqui o Gransoft consulta o Mercado Pago a cada 4 segundos.
Figura 7. Opções de juros do parcelamento.
Juros pagos pelo cliente não mudam a venda
Se o cliente pagar com juros, a maquininha cobra mais do que o valor das parcelas. O Gransoft baixa as parcelas e emite a nota pelo valor da venda; a diferença (juros da operadora) fica registrada como encargo da transação e aparece na coluna “Valor cobrado” da lista de cobranças. Juros não são receita da loja.
6. Passo 4 — O que fazer na maquininha
A cobrança aparece sozinha na tela da maquininha escolhida, com o valor e a forma. Ninguém digita o valor.
O cliente aproxima, insere o cartão ou lê o QR do Pix e digita a senha, se pedida.
A maquininha imprime o comprovante (via do lojista), a menos que o parâmetro ImprimirComprovante=0 esteja configurado na conta.
Aguarde a janela do Gransoft mostrar o resultado.
Uma cobrança por vez
Se a maquininha já tiver uma cobrança pendente, o envio é recusado: “A maquininha já tem uma cobrança pendente. Finalize ou cancele a cobrança anterior na maquininha.”
7. Passo 5 — Identificar o resultado
A linha colorida abaixo dos botões mostra a situação. O quadro amarelo, no rodapé da janela, mostra o histórico com horário.
Figura 8. As mensagens de situação, com o texto exato que o Gransoft exibe (ilustração).
APROVADO: o quadro mostra “Pagamento aprovado. Valor cobrado: R$ …” (e os juros pagos pelo cliente, se houver). A janela fecha sozinha em cerca de 1,5 segundo e a baixa é registrada.
RECUSADA / CANCELADA / EXPIRADA / ERRO: nada é baixado. O botão Enviar para a maquininha volta a ficar disponível para uma nova tentativa (pode trocar a forma ou a maquininha).
A cobrança expira em 15 minutos se o cliente não pagar.
Figura 9. Exemplo real de falha no envio, capturado com um token fictício: a situação fica em vermelho e o motivo aparece no quadro amarelo.
Não feche a janela com a cobrança pendente
Se tentar fechar, o Gransoft pergunta: “A cobrança ainda está pendente na operadora. Deseja cancelá-la e fechar?”. Ao confirmar, ele cancela e confere uma última vez: se o cliente pagou antes do cancelamento, aparece “O pagamento foi APROVADO antes do cancelamento. A baixa será registrada.” Se não conseguir cancelar, a cobrança fica em Cobranças Maquininha / Pix para conferência.
8. O que o Gransoft registra depois da aprovação
Parcelas baixadas com a data do dia e o valor das parcelas (valor da venda).
Cartão (crédito e débito): os recebíveis vão para a Carteira (Financeiro › Carteira › Cartões), como na baixa manual de cartão.
Pix: o valor entra direto na conta de capital da modalidade.
Histórico do lançamento com operadora, forma, parcelas e autorização (ex.: “Mercado Pago Point Crédito 3x Aut. 123456”).
Vínculo transação × parcelas: a parcela paga na maquininha fica protegida — não pode ser excluída, alterada, desmembrada nem renegociada, e o pedido não pode ser excluído. Para desfazer, só pelo estorno.
9. Nota fiscal (NF-e / NFC-e) e ECONF
Nota emitida depois do pagamento
Ao gerar a NF-e ou a NFC-e do pedido, as parcelas pagas na maquininha entram no grupo de pagamento da nota automaticamente: forma (crédito, débito ou Pix), valor, pagamento integrado (tpIntegra = 1), CNPJ da instituição de pagamento, bandeira e código de autorização. Ninguém precisa digitar.
Nota emitida antes do pagamento
Se o pedido já tem NF-e ou NFC-e autorizada e o pagamento integrado acontece depois, o Gransoft envia sozinho o ECONF (Evento de Conciliação Financeira), que informa à SEFAZ o pagamento daquela nota. A mensagem “Conciliação financeira (ECONF)” informa o resultado. Se o envio falhar, a baixa continua valendo e o evento fica em Notas Fiscais › ECONF Pendentes (Conciliação Financeira).
Figura 10. Menu Notas Fiscais › ECONF Pendentes (Conciliação Financeira).Figura 11. ECONF pendentes, com “Mostrar também os enviados desde” marcado (dados fictícios). Use Reenviar pendentes para os que não chegaram à SEFAZ e Enviar selecionado depois de corrigir um rejeitado.
Botão
Uso
Atualizar lista
Recarrega a lista. Marque “Mostrar também os enviados desde” para ver os autorizados.
Enviar selecionado
Envia (ou reenvia) o evento selecionado.
Reenviar pendentes
Tenta de novo todos os que estão “Pendente” (sem internet, certificado, SEFAZ fora).
Cancelar ECONF
Cancela um ECONF autorizado (o estorno confirmado já faz isso automaticamente).
Dispensar
Marca que o evento não será enviado. Use só com orientação do contador.
Ver XML
Mostra o XML do evento.
Venda para entrega futura (pagamento antes da entrega)
No pedido existem os botões NF-e Faturamento e NF-e Remessa:
Figura 12. (1) NF-e Faturamento e (2) NF-e Remessa, na tela do pedido. O nome do vendedor foi ocultado.Figura 13. Quais notas emitir quando o cliente paga antes de receber.
NF-e Faturamento: gera a nota de simples faturamento com todos os itens, ICMS zerado (CST 41 / CSOSN 400), pagamentos recebidos no grupo de pagamento e o saldo como “pagamento posterior” (tPag 91, quando a filial tem integração). O CFOP (5.922/6.922) é informado por você antes de transmitir. Atenção: a cartilha da SEFAZ-CE sobre a IN 87/2025 (item 2.29) cita a NF-e fatura sem destaque com CST 90 / CSOSN 900; confirme com o contador qual código usar e ajuste a nota antes de transmitir, se for o caso.
NF-e Remessa: exige a nota de faturamento autorizada, referencia a chave dela e sai “sem pagamento” (tPag 90). É criada com todos os itens: remova ou ajuste o que não for entregue. O CFOP (5.116/5.117 ou 6.116/6.117) é informado por você.
Confirme com o contador
CFOP, tributação e a necessidade de cancelar notas em caso de estorno são decisões fiscais da empresa. O Gransoft não cancela notas nem pedidos automaticamente.
Pix na maquininha Mercado Pago
Para Pix, a nota precisa do identificador da transação Pix (endToEndId) no código de autorização. Se o Mercado Pago não devolver esse dado, o Gransoft avisa: “Pix aprovado, mas o Mercado Pago não informou o endToEndId. A NF-e sairá sem o cAut.” Confira essa situação antes de adotar o Pix na maquininha como padrão.
10. Acompanhar as cobranças
Abra Financeiro › Cobranças Maquininha / Pix (ou o botão Cobranças… na configuração da filial).
Figura 14. Lista de cobranças (dados fictícios; a coluna Referência foi ocultada). Em verde, a coluna Situação; em vermelho, os botões de ação mais usados.Figura 15. As situações possíveis de uma cobrança.
Item
Para que serve
Desde / Só pendentes / aprovadas sem baixa
Filtra por data (padrão: últimos 30 dias) e mostra só o que precisa de atenção.
Atualizar lista
Recarrega.
Consultar operadora
Pergunta ao Mercado Pago a situação atual da cobrança selecionada.
Reconsultar pendentes
Consulta todas as pendentes (útil depois de queda de energia ou janela fechada): “N cobrança(s) mudaram de situação.”
Cancelar cobrança
Cancela uma cobrança ainda não paga.
Estornar
Devolve um pagamento aprovado (ver abaixo).
Completar contingência
Informa os dados do comprovante de uma contingência registrada sem dados.
Cores da lista: amarelo-claro = aguardando pagamento ou estorno solicitado; rosa = aprovada sem baixa (confira); laranja = contingência sem dados do comprovante. Colunas: Cód, Data, Operadora, Forma, Parc., Valor venda, Valor cobrado, Situação, Baixa, Bandeira, Autorização, NSU, Documento, Referência, Mensagem e Contingência.
11. Cancelar e estornar
Cancelar (antes do pagamento)
Na janela de cobrança, use Cancelar cobrança; na lista, Cancelar cobrança. Se o Mercado Pago não permitir mais o cancelamento pela integração, o Gransoft orienta: “A cobrança não pode mais ser cancelada pela API. Cancele na maquininha (Smart: botão inferior direito; Pro: segure o botão vermelho).”
Estornar (depois da aprovação)
Em Cobranças Maquininha / Pix, selecione a cobrança Aprovada e clique em Estornar.
Leia a confirmação e clique em Sim.
Se o Mercado Pago confirmar na hora: “Estorno confirmado.” Se não: “Estorno solicitado. Conclua na maquininha, se for pedido, e use ‘Consultar operadora’ para confirmar.”
Figura 16. Confirmação do estorno (exemplo).
O que o estorno faz — e o que não faz
Quando a operadora confirma: as parcelas voltam a PENDENTE (nunca são excluídas), os recebíveis daquela transação na Carteira que ainda não foram baixados são cancelados e o ECONF autorizado da transação é cancelado. Nota fiscal e pedido não são alterados: se for o caso, cancele a nota manualmente, conforme orientação do contador.
Limites do Mercado Pago: “Prazo de estorno (90 dias) excedido.” e “Saldo insuficiente na conta Mercado Pago para o estorno.”
12. Contingência: maquininha avulsa ou internet fora do ar
Se a cobrança integrada não for possível, o pagamento pode ser feito numa maquininha avulsa e registrado no Gransoft pelo botão Contingência… da janela de cobrança. Não é preciso permissão especial.
Se houver uma cobrança em andamento, cancele-a antes (o Gransoft avisa).
Cobre na maquininha avulsa e guarde o comprovante.
Clique em Contingência… e preencha Forma, Parcelas, Bandeira, CNPJ da credenciadora, Código de autorização e NSU / DOC com os dados do comprovante.
Sem o comprovante em mãos, marque “Ainda não tenho os dados do comprovante (informar depois)”. A nota sai como “pagamento eletrônico não informado” (tPag 22).
Clique em Confirmar. A baixa é registrada.
Figura 17. Contingência preenchida com dados fictícios do comprovante. Em verde, a opção para informar os dados depois.
Depois, em Cobranças Maquininha / Pix, selecione a cobrança e clique em Completar contingência para informar os dados. Se a nota já tiver saído com tPag 22, o Gransoft envia o ECONF com os dados completos.
Figura 18. Completar pagamento em contingência.
Na contingência com dados digitados, a nota informa pagamento não integrado (tpIntegra = 2). O estorno de uma contingência é feito na própria maquininha avulsa; no Gransoft, o botão Estornar apenas registra (parcelas voltam a pendente e os recebíveis são cancelados).
13. Mensagens e erros comuns na operação
Mensagem
O que fazer
Na maquininha só é possível cobrar parcelas de um mesmo pedido/documento…
Marque apenas parcelas de um pedido.
Há parcelas já baixadas ou canceladas na seleção.
Desmarque as parcelas que não estão pendentes.
A cobrança na maquininha é só para recebimentos.
Use em contas a receber.
A filial não tem a integração Mercado Pago Point configurada…
O Mercado Pago pede conferência na maquininha (action_required)…
Veja na maquininha se o pagamento foi aprovado e use “Consultar operadora”.
Não é possível excluir a parcela: … tem pagamento na maquininha / Pix integrado.
Parcela protegida. Para desfazer, estorne em Financeiro › Cobranças Maquininha / Pix.
Não é possível excluir o pedido: existem parcelas pagas na maquininha / Pix integrado neste documento.
Estorne os pagamentos antes de excluir.
O evento ficou em Notas Fiscais › ECONF Pendentes para reenvio.
Reenvie quando a internet/SEFAZ voltar.
14. Perguntas frequentes
Posso cobrar só uma parte de uma parcela?
Não. A cobrança é sempre a soma exata das parcelas marcadas. Para cobrar outro valor, ajuste as parcelas do pedido antes da cobrança.
O cliente quer pagar em dois cartões. Como faço?
Faça duas cobranças, cada uma com as parcelas correspondentes do pedido. Divisão de uma mesma parcela em dois cartões não está disponível.
Fechei a janela e o cliente pagou. Perdi a baixa?
Não. Abra Financeiro › Cobranças Maquininha / Pix e use Reconsultar pendentes ou Consultar operadora. Uma cobrança aprovada sem baixa aparece em rosa.
A nota fiscal é cancelada quando estorno?
Não. O estorno só devolve as parcelas para pendente, cancela os recebíveis da Carteira e o ECONF da transação. Cancelar nota ou pedido é decisão manual.
Os juros que o cliente pagou entram na nota?
Não. A nota e a baixa usam o valor da venda; os juros ficam com a operadora.
Posso usar Pix na maquininha?
Sim, com a forma Pix. Atenção ao aviso sobre o endToEndId na seção 9.
15. Conclusão
Agora você sabe cobrar pela maquininha a partir das parcelas do pedido, entender cada resposta, acompanhar as cobranças e desfazer um pagamento pelo estorno. Com isso, a baixa e o grupo de pagamento da nota passam a sair sem digitação.
Parte 4: Aprenda a cobrar seus clientes com cartão ou Pix pelo Gransoft, realizar baixas automáticas, acompanhar pagamentos, cancelar cobranças e fazer estornos diretamente pelo sistema.
PARTE I - Entenda a legislação do Ceará sobre integração de pagamentos com NF-e e NFC-e, os prazos, as obrigações fiscais e como o Gransoft automatiza esse processo.
Treinamento Completo Sobre como Parametrizar Regras de Tributação, instalar Certificados Digitais e Configurar o sistema para transmissão de documentos fiscais NF-e e NFC-e.
PARTE 2: Aprenda a preparar sua conta Mercado Pago, configurar lojas e caixas, vincular maquininhas Point e autorizar a integração com o Gransoft para realizar pagamentos automatizados.
Parte 3: Aprenda a configurar a integração do Mercado Pago Point no Gransoft, conectar a conta, cadastrar maquininhas, definir modalidades de recebimento e testar os pagamentos integrados.
