logo

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.

Se voce utiliza o Gransoftweb: Clique Aqui para ler o tutorial referente a versão web do sistema.

Recebendo pagamentos com a maquininha Mercado Pago no Gransoft Windows

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

Infográfico do fluxo: pedido, parcelas a receber, cobrança enviada, cliente paga, confirmação, baixa no financeiro e nota fiscal ou ECONF
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

Menu Financeiro com Parcelas a Receber e Cobranças Maquininha / Pix destacados
Figura 2. Menu Financeiro: (1) Financeiro, (2) Parcelas a Receber. Em verde, a lista “Cobranças Maquininha / Pix”, usada mais adiante.
  1. Abra Financeiro › Parcelas a Receber (tela Títulos a Receber).
  2. Localize o pedido. Exemplo: tecle F2 (“Pesquisar por Nº documento”), digite o número do pedido e clique em Pesquisar.
  3. Marque, na última coluna, as parcelas que o cliente vai pagar agora.
  4. Clique em Baixar Parcelas e responda Sim em “Confirma a baixa das parcela(s) selecionada(s)?”.
Títulos a Receber com as parcelas 1043/1 e 1043/2 marcadas, totalizando 17.400,00 selecionados
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

  1. Na janela Pagamento, confira o Total a Pagar.
  2. Em Selecione a forma de Pagamento, escolha a modalidade integrada (ex.: Crédito Maquininha MP).
  3. Clique em Registrar.
  4. 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.
Janela Pagamento com a lista de formas de pagamento aberta e Crédito Maquininha MP destacado
Figura 4. Escolha da forma integrada. Em verde, as outras modalidades integradas do exemplo (débito e Pix). Nomes de outras empresas foram ocultados.
Pergunta Pagamento integrado: deseja registrar a baixa de 2 parcelas no valor total de R$ 17.400,00 na maquininha
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.

Janela Cobrança Mercado Pago Point com valor R$ 17.400,00, maquininha, forma Crédito, 3 parcelas e juros Loja
Figura 6. Janela de cobrança preenchida (dados fictícios).
NºCampoComo usar
1MaquininhaVem selecionada a maquininha padrão deste computador. Troque se o cliente estiver em outra.
2FormaCrédito, Débito ou Pix. Vem com a forma da modalidade escolhida.
3ParcelasSó 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.
4JurosSó 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.
5Enviar para a maquininhaEnvia a cobrança. A partir daqui o Gransoft consulta o Mercado Pago a cada 4 segundos.
Lista Juros aberta com as opções Loja (sem juros) e Cliente (com juros)
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

  1. A cobrança aparece sozinha na tela da maquininha escolhida, com o valor e a forma. Ninguém digita o valor.
  2. O cliente aproxima, insere o cartão ou lê o QR do Pix e digita a senha, se pedida.
  3. A maquininha imprime o comprovante (via do lojista), a menos que o parâmetro ImprimirComprovante=0 esteja configurado na conta.
  4. 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.

Quadro com as mensagens de situação da janela de cobrança e o significado de cada uma
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.
Janela de cobrança com Não foi possível enviar a cobrança e o motivo Access Token do Mercado Pago inválido ou expirado
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).

Menu Notas Fiscais com o item ECONF Pendentes (Conciliação Financeira)
Figura 10. Menu Notas Fiscais › ECONF Pendentes (Conciliação Financeira).
Tela ECONF pendentes com um evento autorizado e um pendente
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ãoUso
Atualizar listaRecarrega a lista. Marque “Mostrar também os enviados desde” para ver os autorizados.
Enviar selecionadoEnvia (ou reenvia) o evento selecionado.
Reenviar pendentesTenta de novo todos os que estão “Pendente” (sem internet, certificado, SEFAZ fora).
Cancelar ECONFCancela um ECONF autorizado (o estorno confirmado já faz isso automaticamente).
DispensarMarca que o evento não será enviado. Use só com orientação do contador.
Ver XMLMostra 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:

Tela do pedido com os botões NF-e Faturamento e NF-e Remessa destacados
Figura 12. (1) NF-e Faturamento e (2) NF-e Remessa, na tela do pedido. O nome do vendedor foi ocultado.
Infográfico da venda para entrega futura: NF-e de faturamento, pagamentos seguintes com ECONF e NF-e de remessa
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).

Lista Cobranças de maquininha / Pix com cobranças aprovadas, recusada, estornada, aguardando pagamento e com erro
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.
Infográfico das situações de uma cobrança: Criada, Aguardando pagamento, Aprovada, Recusada, Estorno solicitado e Estornada
Figura 15. As situações possíveis de uma cobrança.
ItemPara que serve
Desde / Só pendentes / aprovadas sem baixaFiltra por data (padrão: últimos 30 dias) e mostra só o que precisa de atenção.
Atualizar listaRecarrega.
Consultar operadoraPergunta ao Mercado Pago a situação atual da cobrança selecionada.
Reconsultar pendentesConsulta todas as pendentes (útil depois de queda de energia ou janela fechada): “N cobrança(s) mudaram de situação.”
Cancelar cobrançaCancela uma cobrança ainda não paga.
EstornarDevolve um pagamento aprovado (ver abaixo).
Completar contingênciaInforma 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)

  1. Em Cobranças Maquininha / Pix, selecione a cobrança Aprovada e clique em Estornar.
  2. Leia a confirmação e clique em Sim.
  3. 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.”
Pergunta Estornar pagamento: estornar R$ 8.700,00 na Mercado Pago Point, parcelas voltarão a PENDENTE
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.

  1. Se houver uma cobrança em andamento, cancele-a antes (o Gransoft avisa).
  2. Cobre na maquininha avulsa e guarde o comprovante.
  3. 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.
  4. 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).
  5. Clique em Confirmar. A baixa é registrada.
Janela Pagamento em contingência preenchida com crédito 3x, Mastercard, CNPJ da credenciadora, autorização e NSU fictícios
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.

Janela Completar pagamento em contingência
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

MensagemO 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…Configure a filial da venda (Parte 3).
Cadastre/selecione a maquininha na configuração da filial.Busque as maquininhas na configuração da filial.
A maquininha já tem uma cobrança pendente…Finalize ou cancele a anterior na maquininha.
O terminal não pertence à conta Mercado Pago configurada.A maquininha é de outra conta. Use “Buscar na operadora” na conta certa.
Valor abaixo do mínimo permitido para este parcelamento.Reduza o número de parcelas.
Parcelamento não habilitado na conta Mercado Pago para este número de parcelas.Ajuste o parcelamento ou as configurações da conta Mercado Pago.
Access Token do Mercado Pago inválido ou expirado.Reconecte a conta (Parte 3).
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 1 — LegislaçãoPor que vincular o pagamento à nota Parte 2 — Mercado PagoConta, loja, caixa e maquininha Parte 3 — ConfiguraçãoFilial, conta e modalidades

#gransoft#maquininha#mercadopago#cobranca#estorno#econf#nfce#nfe#contingencia

Resumo

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.

Suporte via Chat Atendimento WhatsApp

Outros Artigos

Recebendo pagamentos com a maquininha Mercado Pago no GransoftWeb - Parte 4

Recebendo pagamentos com a maquininha Mercado Pago no GransoftWeb - Parte 4

Parte 4: Aprenda a cobrar seus clientes com cartão ou Pix pelo Gransoftweb, realizar baixas automáticas, acompanhar pagamentos, cancelar cobranças e fazer estornos diretamente pelo sistema.

Integração de pagamentos com notas fiscais - Parte I

Integração de pagamentos com notas fiscais - Parte I

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.

Emitindo Notas Fiscais Eletrônicas (NF-e)

Emitindo Notas Fiscais Eletrônicas (NF-e)

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.

Integração com Mercado Pago - Gransoft Windows - Parte 2

Integração com Mercado Pago - Gransoft Windows - Parte 2

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.

Configurando a maquininha Mercado Pago no Gransoft Windows - Parte 3

Configurando a maquininha Mercado Pago no Gransoft Windows - Parte 3

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.

Configurando a maquininha Mercado Pago no Gransoftweb - Parte 3

Configurando a maquininha Mercado Pago no Gransoftweb - Parte 3

Parte 3: Aprenda a configurar a integração do Mercado Pago Point no Gransoftweb, conectar a conta, cadastrar maquininhas, definir modalidades de recebimento e testar os pagamentos integrados.