Configurando a maquininha Mercado Pago no Gransoft Windows - Parte 3
Série Pagamento integrado · Parte 3 de 4
Como configurar a maquininha de cartão no Gransoft: tutorial completo
Neste tutorial você vai deixar o Gransoft Windows pronto para cobrar na maquininha Mercado Pago Point: cadastrar a conta da operadora na filial, buscar e ativar as maquininhas, criar as formas de pagamento “maquininha” e testar tudo antes do primeiro cliente.
Com a integração configurada, o valor vai do Gransoft direto para a maquininha, o pagamento aprovado baixa as parcelas sozinho e a nota fiscal sai com os dados do cartão ou do Pix preenchidos automaticamente.
Antes de tudo: o Mercado Pago precisa estar pronto
Este artigo começa no Gransoft. A conta Mercado Pago, a loja, o caixa e a maquininha são preparados antes, como explicado na Parte 2 — Preparando o Mercado Pago.
O que você vai aprender
Onde fica a configuração de Pagamento Eletrônico (maquininhas / Pix) de cada filial.
Como cadastrar e conectar a conta Mercado Pago Point.
Como buscar as maquininhas, definir a do caixa e ativar o modo integrado.
Como criar as modalidades de recebimento integradas (crédito, débito e Pix).
Como testar a configuração e resolver os erros mais comuns.
1. Pré-requisitos
Gransoft Windows atualizado, com as atualizações de banco de dados aplicadas (o sistema aplica sozinho ao abrir). Se a tela mostrar “Tabelas da integração não encontradas (aplique a atualização do banco)”, feche e abra o sistema novamente ou chame o suporte.
Chave da filial da Central Geper, fornecida pela Gransoft/Geper para o CNPJ da filial. Ela é necessária para conectar a conta Mercado Pago pelo botão “Conectar com Mercado Pago…” e para os avisos de pagamento.
Conta Mercado Pago da empresa e maquininha Point compatível já vinculada a uma loja e a um caixa no Mercado Pago (Parte 2).
Usuário do Gransoft com acesso ao Cadastro de Lojas e às Modalidades de Recebimento.
Internet no computador do caixa: a cobrança é enviada e consultada pela internet.
2. Visão geral da configuração
A configuração tem duas partes, feitas uma única vez:
Onde
O que se configura
Cadastro › Pessoas › Lojas › aba Integração › Pagamento Eletrônico (maquininhas / Pix)
Chave da Central Geper, conta da operadora Mercado Pago Point e as maquininhas da filial. É por filial.
Administra › Parametros › Modalidades Recebimento
As formas de pagamento que o usuário escolhe na baixa (ex.: “Crédito Maquininha MP”), ligadas à operadora e ao tipo (crédito, débito ou Pix).
3. Passo 1 — Abrir o cadastro da loja (filial)
No menu superior, clique em Cadastro › Pessoas › Lojas. Abre a tela Cadastro de Lojas / Filiais.
Na lista inferior, clique no botão … da filial que vai usar a maquininha.
Abra a aba Integração. Na grade Integrações aparece a linha Pagamento Eletrônico (maquininhas / Pix).
Clique no botão … dessa linha.
Figura 1. Caminho do menu: Cadastro › Pessoas › Lojas.Figura 2. (1) escolha a filial, (2) aba Integração, (3) botão … da linha Pagamento Eletrônico. A coluna “Situação” mostra Integração OK quando a filial já tem uma operadora ativa. Dados fictícios; os nomes das demais filiais foram ocultados.
4. Passo 2 — Conhecendo a tela de Pagamento Eletrônico
A janela Pagamento Eletrônico (maquininhas / Pix) mostra o código e o CNPJ da filial no título e tem três áreas:
Figura 3. Tela de Pagamento Eletrônico da filial, já configurada (dados fictícios). Os números correspondem à tabela abaixo.
Nº
Campo / botão
Para que serve
1
Chave da filial + Gravar e testar
Chave da Central Geper, que recebe os avisos das operadoras e faz a conexão segura com o Mercado Pago. “Mostrar” exibe ou oculta a chave.
2
Nova / Editar
Cadastra ou altera a conta da operadora (grade Operadoras configuradas nesta filial: Cód., Operadora, Descrição, Ambiente, Ativa).
3
Testar conexão
Confere se o Gransoft consegue acessar a conta Mercado Pago e quantas maquininhas existem.
4
Buscar na operadora
Traz da conta Mercado Pago as maquininhas e cadastra as novas. (“Adicionar manual” permite digitar a identificação do terminal.)
5
Usar neste computador
Define a maquininha selecionada como padrão do computador em uso (coluna Computador padrão). Ela já vem escolhida na cobrança.
6
Ativar modo PDV
Coloca a maquininha selecionada no modo integrado do Mercado Pago. Só aparece para Mercado Pago.
7
Cobranças…
Abre a lista de cobranças da filial (a mesma de Financeiro › Cobranças Maquininha / Pix).
Uma conta por operadora
Cada filial pode ter uma conta ativa de cada operadora. Se tentar cadastrar outra, o Gransoft avisa: “Já existe uma conta ativa desta operadora nesta filial.”
5. Passo 3 — Informar a chave da Central Geper
Cole a chave recebida da Gransoft no campo Chave da filial.
Clique em Gravar e testar. O Gransoft consulta a Central e confere se a chave pertence ao CNPJ desta filial.
Se estiver tudo certo, aparece em verde: “Chave válida e gravada (CNPJ …)”.
Chave de outra filial
Cada chave vale para um CNPJ. Se aparecer “Esta chave pertence ao CNPJ …, não a esta filial”, você colou a chave de outra loja. Se aparecer “Chave recusada pela central”, confira se copiou a chave inteira ou peça uma nova ao suporte.
6. Passo 4 — Cadastrar a conta Mercado Pago Point
Na grade Operadoras configuradas nesta filial, clique em Nova. Abre a janela Nova conta de operadora.
Em Operadora, escolha Mercado Pago Point. Os rótulos e o texto de ajuda da janela mudam para o Mercado Pago.
Preencha os campos conforme a tabela e conecte a conta (próximo item).
Figura 4. Conta Mercado Pago já conectada (dados fictícios; os tokens aparecem sempre ocultos).
Nº
Campo
Como preencher
1
Operadora e Ativa
Mercado Pago Point. Deixe Ativa marcada. A operadora não pode ser trocada depois de gravar.
2
Descrição
Um nome fácil, ex.: Mercado Pago - Loja Centro. Se ficar vazio, o Gransoft usa o nome da operadora.
3
Ambiente
Produção para cobranças reais. “Teste” só para homologação orientada pelo suporte.
4
Access Token
Preenchido automaticamente pelo botão Conectar com Mercado Pago…. Como alternativa, cole o Access Token de produção da sua conta (ver Parte 2).
5
Refresh token (OAuth)
Preenchido pela conexão. É o que permite ao Gransoft renovar o acesso sozinho. Não digite.
6
CNPJ credenc. / banco
CNPJ da instituição de pagamento que vai na nota. Para Mercado Pago, se ficar vazio, o Gransoft usa 10573521000191 (Mercado Pago Instituição de Pagamento Ltda.).
7
Parâmetros
Um por linha, no formato chave=valor. A conexão grava OAuth, OAuthExpira e OAuthUserId. Opcionais: ImprimirComprovante=0 (não imprime comprovante na maquininha; o padrão imprime a via do lojista), IntegratorId= e PlatformId= (somente se fornecidos pelo Mercado Pago/Gransoft).
8
Conectar com Mercado Pago…
Abre o navegador para autorizar o Gransoft na sua conta (detalhe abaixo).
9
Gravar
Salva a conta. Os tokens são gravados cifrados.
Os campos Chave Pix, Certificado (.pfx) e Senha não são usados pelo Mercado Pago (servem para outras operadoras e para o Pix pela API do banco).
Conectar com Mercado Pago (recomendado)
Confirme que a chave da filial já foi gravada (Passo 3). Sem ela, o Gransoft avisa: “Informe e grave antes a chave da central Geper desta filial (tela anterior).”
Clique em Conectar com Mercado Pago…. O navegador abre a página do Mercado Pago. Se o navegador não abrir, o endereço é copiado e o Gransoft avisa para colá-lo no navegador.
No navegador, entre na conta Mercado Pago da loja e autorize o Gransoft.
Quando aparecer “Conta conectada”, volte ao Gransoft e clique em SIM na pergunta “No navegador, entre na conta Mercado Pago da loja e autorize o Gransoft…”.
O Gransoft mostra “Conta Mercado Pago conectada (usuário …). Clique em Gravar.” Clique em Gravar.
Figura 5. Ilustração do fluxo de conexão. A senha do Mercado Pago é digitada apenas no site do Mercado Pago.
Renovação automática
A conexão tem validade (gravada em OAuthExpira). Quando faltam menos de 15 dias para vencer, o Gransoft renova sozinho na próxima comunicação com o Mercado Pago. Se você colou o Access Token manualmente, não há renovação automática.
7. Passo 5 — Buscar, escolher e ativar as maquininhas
Selecione a linha Mercado Pago Point na grade de operadoras.
Clique em Buscar na operadora. O Gransoft lista as maquininhas da conta e cadastra as novas: “2 maquininha(s) encontrada(s); 2 nova(s) cadastrada(s).”
Selecione a maquininha do caixa e clique em Ativar modo PDV. Mensagem de sucesso: “Modo PDV (integrado) ativado. Reinicie a maquininha e confira em Mais opções › Configurações › Modo de vinculação.”
Reinicie a maquininha e confira o modo de vinculação nela, como indicado na mensagem.
No computador do caixa, selecione a maquininha que fica ao lado dele e clique em Usar neste computador. Ela passa a vir selecionada na cobrança desse computador.
Se a ativação falhar
“O terminal precisa estar vinculado a uma loja e caixa no Mercado Pago.” → vincule a maquininha a uma loja e a um caixa na sua conta (Parte 2). “Este modelo de terminal não aceita o modo PDV (integrado).” → pela documentação do Mercado Pago, a ativação pela integração só é aceita em alguns terminais. Configure o modo na própria maquininha (Mais opções › Configurações › Modo de vinculação › Ponto de Venda (PDV)) e confira se o modelo está na lista de compatíveis da Parte 2.
Remover tira a maquininha da lista (ela fica inativa no Gransoft, sem apagar nada no Mercado Pago). Adicionar manual pede a “Identificação da maquininha na operadora” — para o Mercado Pago, é o id do terminal (ex.: NEWLAND_N950__N950NCB…). Prefira sempre “Buscar na operadora”.
8. Passo 6 — Criar as modalidades de recebimento integradas
A modalidade é o que o usuário escolhe na hora da baixa. Crie uma modalidade para cada forma que será cobrada na maquininha. Sugestão de nomes: Crédito Maquininha MP, Débito Maquininha MP e Pix Maquininha MP.
Figura 6. Caminho: Administra › Parametros › Modalidades Recebimento.
Clique em Add. Novo (F1) (ou abra uma modalidade existente pelo botão … e clique em Alterar).
Preencha os campos, clique no botão de integração (indicador 5) e depois em Salvar (F2).
Figura 7. Modalidade “Crédito Maquininha MP” em edição (exemplo). Nomes de contas de outras empresas foram ocultados.
Nº
Campo
Como preencher
1
Meio de Recebimento
Cartão Crédito para crédito; Cartão Débito para débito. Para Pix, use o meio que sua empresa já usa para Pix (ex.: depósito bancário).
2
Descrição
Nome que aparecerá na baixa, ex.: Crédito Maquininha MP.
3
Nr. Máximo Prest.
Número máximo de parcelas sugerido na cobrança (ex.: 12 no crédito; 1 no débito e no Pix). Na janela de cobrança, o limite é de 18 parcelas.
4
Receber na Conta
Conta de capital onde entra o recebimento. No Pix, o valor entra direto nessa conta; no cartão, os recebíveis vão para a Carteira, como na baixa manual de cartão.
5
Integração: nenhuma → Mercado Pago Point (Crédito)
Clique no botão para abrir Integração da modalidade e escolher a operadora e a forma (figura 8). O texto do botão passa a mostrar a integração escolhida.
6
Salvar (F2)
Grava a modalidade.
Taxa (%), Dias p/ Pgto e os demais campos seguem a mesma regra das modalidades de cartão que você já usa.
Figura 8. (1) Operadora, (2) Forma — Crédito, Débito ou Pix — e (3) Gravar.Figura 9. Operadoras disponíveis no Gransoft. Para voltar a ser uma modalidade comum (sem maquininha), escolha “(nenhuma - modalidade comum)”.
Modalidade comum continua funcionando
As modalidades antigas (“Visa Crédito”, “Dinheiro”…) não mudam. O Gransoft não obriga o uso da maquininha: ela só é acionada quando o usuário escolhe uma modalidade integrada.
9. Passo 7 — Testar a configuração
Na tela de Pagamento Eletrônico, selecione a operadora e clique em Testar conexão. O esperado é: “Conexão com o Mercado Pago OK. Terminais encontrados: N.”
Confira se a filial aparece com Integração OK na aba Integração do cadastro da loja.
Faça uma cobrança real de valor baixo (ex.: R$ 1,00) em um pedido de teste, como na Parte 4, e depois faça o estorno em Financeiro › Cobranças Maquininha / Pix.
Figura 10. Exemplo de teste com erro: “Access Token do Mercado Pago inválido.” (capturado com um token fictício). Refaça a conexão pelo botão “Conectar com Mercado Pago…”.
10. Exemplo prático
A Marmoraria Exemplo (filial 999, Fortaleza-CE) tem duas maquininhas Point: uma no caixa e outra no balcão.
Em Cadastro › Pessoas › Lojas, filial 999, aba Integração, abre Pagamento Eletrônico, cola a chave e clica em Gravar e testar.
Clica em Nova, escolhe Mercado Pago Point, descrição “Mercado Pago - Loja Centro”, ambiente Produção, e usa Conectar com Mercado Pago… com a conta da empresa. Grava.
Clica em Buscar na operadora: aparecem “Caixa 1 - Point Smart” e “Balcão - Point Smart”. Ativa o modo PDV em cada uma e reinicia as maquininhas.
No computador CAIXA-01, seleciona “Caixa 1 - Point Smart” e clica em Usar neste computador.
Cria as modalidades Crédito Maquininha MP (até 12 parcelas), Débito Maquininha MP e Pix Maquininha MP, cada uma com a integração Mercado Pago Point e a forma correspondente.
Testa a conexão, cobra R$ 1,00 num pedido de teste e estorna.
11. Mensagens e erros comuns na configuração
Mensagem
O que fazer
Tabelas da integração não encontradas (aplique a atualização do banco)
O banco ainda não recebeu a atualização. Feche e abra o Gransoft; se continuar, chame o suporte.
Chave recusada pela central: …
Chave incompleta, revogada ou sem internet. Copie de novo ou peça outra chave.
Esta chave pertence ao CNPJ …, não a esta filial (…)
Use a chave emitida para o CNPJ desta filial.
Informe e grave antes a chave da central Geper desta filial (tela anterior).
Grave a chave (Passo 3) antes de “Conectar com Mercado Pago…”.
Conexão não concluída: …
A autorização no site do Mercado Pago não terminou ou foi recusada. Repita a conexão.
Já existe uma conta ativa desta operadora nesta filial.
Edite a conta existente em vez de criar outra.
Access Token do Mercado Pago inválido.
Token errado, de teste ou revogado. Reconecte a conta ou cole o Access Token de produção.
O terminal precisa estar vinculado a uma loja e caixa no Mercado Pago.
Vincule a maquininha a uma loja e a um caixa na conta Mercado Pago.
Este modelo de terminal não aceita o modo PDV (integrado).
Ative o modo PDV na própria maquininha (Mais opções › Configurações › Modo de vinculação) e confirme se o modelo é compatível (Parte 2).
A filial não tem a integração Mercado Pago Point configurada. Configure em Cadastro de Empresas (filial) › Integrações › Pagamento Eletrônico.
Aparece na baixa quando a filial da parcela não tem conta ativa. Configure a filial da venda (cada filial tem a sua configuração).
12. Perguntas frequentes
Preciso configurar em todos os computadores?
Não. A conta e as maquininhas ficam gravadas no banco de dados da filial. Em cada computador de caixa, só use Usar neste computador para escolher a maquininha padrão.
Tenho duas filiais. Uma conta Mercado Pago serve para as duas?
A configuração é por filial: cada filial tem a sua chave da Central (ligada ao CNPJ) e a sua conta de operadora. Conecte em cada filial a conta Mercado Pago que recebe as vendas daquele CNPJ.
Onde vejo se a conta está conectada?
Na aba Integração do cadastro da loja (“Integração OK”) e na conta da operadora: os campos Access Token e Refresh token preenchidos e o parâmetro OAuth=1. Use também Testar conexão.
Posso colar o Access Token em vez de conectar?
Sim, cole o Access Token de produção no campo Access Token. Nesse caso não há renovação automática e o token deve ser mantido em sigilo.
Troquei a maquininha. O que faço?
Vincule a nova a uma loja e caixa no Mercado Pago, clique em Buscar na operadora, Ativar modo PDV, reinicie e use Usar neste computador. Remova a antiga da lista.
A modalidade integrada pode ser usada no caixa (modo caixinha)?
Sim. O caixinha normalmente só aceita Dinheiro, Cheque e Cartão, mas as modalidades integradas também são permitidas.
O Gransoft passa a exigir a maquininha?
Não. O sistema não obriga nem bloqueia. Usar a cobrança integrada é decisão da empresa, que deve observar a legislação do seu estado (Parte 1).
13. Conclusão
Pronto: a filial tem a chave da Central, a conta Mercado Pago conectada, as maquininhas no modo integrado e as modalidades de recebimento criadas. O próximo passo é cobrar de verdade.
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.
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.
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.
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.
