Ajuda vhsys

Integração Mercado Pago e vhsys: como lançar seus recebimentos pela Pluga

Publicado em

Requisitos de acesso

Planos elegíveis

  • MEI
  • Essencial
  • Controle
  • Completo
  • Gestão Integrada
Compartilhar:

Quem recebe por Pix, cartão ou link de pagamento do Mercado Pago conhece a rotina: no fim do dia, abrir o extrato, conferir cada pagamento e lançar um por um no financeiro. Basta um recebimento esquecido para o fluxo de caixa deixar de bater com o saldo da conta.

Para tirar esse trabalho da sua rotina, o vhsys se conecta ao Mercado Pago pela Pluga, sem programação. Você ativa o aplicativo gratuito Mercado Pago (por Pluga) na Loja de Integrações e escolhe o que deve acontecer a cada pagamento.

Veja como a integração entre o vhsys e o Mercado Pago transforma o dia a dia da sua empresa:

  • Recebimentos lançados sozinhos: cada pagamento aprovado no Mercado Pago vira uma conta a receber no vhsys, com valor e data.

  • Caixa mais fiel ao saldo: você escolhe lançar quando o cliente paga ou quando o dinheiro é liberado na sua conta.

  • Menos conferência de extrato: o que entrou no Mercado Pago já está no financeiro, pronto para a baixa.

1. Primeiros passos

Antes de começar, confira se você tem:

  • Aplicativo Mercado Pago (por Pluga) instalado no seu vhsys. Ele é gratuito e gera os tokens que a Pluga usa para acessar a sua conta.

  • Conta no Mercado Pago em que você recebe as vendas.

  • Conta na Pluga, criada no site da Pluga.

  • Uma conta bancária "Mercado Pago" cadastrada no financeiro do vhsys, para que os recebimentos fiquem separados dos outros bancos.

2. O que dá para automatizar com o Mercado Pago

Do Mercado Pago para o vhsys, escolha o momento do pagamento que vai disparar a automação:

  • Pagamento aprovado: o cliente pagou. É o gatilho recomendado para lançar a venda no financeiro.

  • Pagamento liberado: o dinheiro ficou disponível na sua conta. Use se você prefere lançar só o que já pode movimentar.

  • Pagamento criado: o pagamento foi gerado, mas ainda não foi pago. Útil para registrar o cliente ou um pedido antes do pagamento.

Para cada gatilho, o vhsys pode criar uma conta a receber, criar um pedido de venda ou criar ou atualizar o cliente.

Do vhsys para o Mercado Pago, a cada nova venda no PDV, a Pluga pode gerar uma cobrança ou criar o cliente no Mercado Pago.

Importante: no vhsys, o único gatilho disponível na Pluga é a “Nova venda de balcão”, disparado pelas vendas feitas no PDV.

Os gatilhos, as ações e o que cada plano da Pluga libera são definidos pela Pluga, variam de uma ferramenta para outra e podem mudar. Antes de montar a automação, confira na Pluga se o gatilho e a ação que você quer usar estão disponíveis no seu plano.

3. Instalando o app e copiando os tokens no vhsys

  1. No menu superior do seu vhsys, clique no ícone de aplicativos (grade) e em “Loja de Integrações”.

  2. Busque por “Mercado Pago” e clique em “Mercado Pago (por Pluga)”.

  3. Clique em “Instalar”. Depois da instalação, clique em “Abrir”.

  4. Em “Token de segurança”, se os campos estiverem vazios, clique em “Gerar novo token”.

  5. Copie o “Seu Access-Token” e o “Seu Secret-Access-Token”.

Ícone de aplicativos no menu superior do vhsys com a opção Loja de Integrações

Busca por Mercado Pago na Loja de Integrações do vhsys com o aplicativo Mercado Pago (por Pluga)

Página do aplicativo Mercado Pago (por Pluga) com o botão Instalar

Token de segurança do aplicativo Mercado Pago (por Pluga) com o botão Gerar novo token

Atenção: os tokens dão acesso aos dados da sua empresa. Não troque um pelo outro e não compartilhe por e-mail ou mensagem.

4. Montando a automação recomendada

A automação mais usada é: a cada pagamento aprovado no Mercado Pago, criar uma conta a receber no vhsys.

  1. Na Pluga, clique em “+ Automatizar” e escolha “Do zero”.

  2. Busque o Mercado Pago e escolha o gatilho “Pagamento aprovado” (ou “Pagamento liberado”, se preferir lançar só o dinheiro disponível).

  3. Em “Conecte sua conta do Mercado Pago”, cole o Access Token da sua conta do Mercado Pago e clique em “Conectar nova conta”. Se não souber onde encontrar o Access Token, clique em “Guia de conexão de conta”, na própria tela da Pluga.

  4. Clique no “+”, busque o vhsys e escolha a ação “Criar conta a receber”.

  5. Cole o Access-Token e o Secret-Access-Token copiados no app Mercado Pago (por Pluga), cada um no seu campo, e clique em “Conectar nova conta”. Mesmo que o rótulo do campo na Pluga cite o app Integração via API, use os tokens do app Mercado Pago (por Pluga). Eles são os tokens do vhsys, diferentes do Access Token do Mercado Pago usado no passo 3.

  6. Em “Ajustes e personalização”, ligue os dados do pagamento aos campos da conta a receber: valor, data, descrição e cliente. Em conta bancária, escolha a conta “Mercado Pago” do vhsys.

  7. Teste a automação e clique em “Publicar”.

Botão Automatizar e opção Do zero na Pluga

Gatilhos do Mercado Pago na Pluga com Pagamento aprovado em destaque

Campo Access Token para conectar a conta do Mercado Pago na Pluga

Ações do vhsys na Pluga com Criar conta a receber em destaque

Atenção: o modelo pronto da Pluga para o Mercado Pago cria uma conta a pagar a cada pagamento aprovado. Para registrar o que você recebeu, monte a automação do zero com a ação “Criar conta a receber”.

5. Cuidados com os pagamentos do Mercado Pago

  • Escolha um gatilho só: usar “Pagamento aprovado” e “Pagamento liberado” ao mesmo tempo cria duas contas a receber para a mesma venda.

  • Reembolso, chargeback e cancelamento não voltam para o vhsys: a conta a receber continua lançada. Quando isso acontecer, ajuste ou exclua o lançamento no financeiro.

  • Valor bruto ou líquido: confira se o valor ligado na conta a receber é o valor da venda ou o valor já descontadas as tarifas do Mercado Pago, e use sempre o mesmo critério.

  • A baixa não é automática: a integração cria a conta a receber, mas não registra o recebimento. Faça a baixa no financeiro do vhsys.

Dica: depois de publicar, faça uma venda de valor baixo no Mercado Pago e confira se a conta a receber apareceu no vhsys com o valor e a data corretos.

Para dúvidas sobre as automações, fale com o suporte da Pluga. Para dúvidas sobre pagamentos, tarifas e liberação de saldo, fale com o Mercado Pago. Se a automação aparecer como executada na Pluga, mas o lançamento não estiver no vhsys, fale com o nosso time de suporte pelo chat.

Compartilhar:

Assuntos relacionados

vhsys — Empresa desorganizada não perde só tempo, perde dinheiro todos os dias. Comece seu teste grátis.

Este artigo foi útil?

Escolha uma opção para avaliar.

Perguntas Frequentes

Qual a diferença entre Pagamento aprovado e Pagamento liberado?

Pagamento aprovado acontece quando o cliente paga. Pagamento liberado acontece quando o dinheiro fica disponível na sua conta do Mercado Pago. Escolha um dos dois para criar a conta a receber, nunca os dois juntos.

Se o cliente pedir reembolso, a conta a receber é cancelada?

Não. Reembolso, chargeback e cancelamento não alteram o vhsys. Ajuste ou exclua o lançamento no financeiro.

Preciso do aplicativo Integração via API?

Não. Os tokens vêm do aplicativo gratuito Mercado Pago (por Pluga), na Loja de Integrações do vhsys.

Por que o modelo pronto da Pluga cria conta a pagar?

O modelo pronto da Pluga para o Mercado Pago usa a ação Criar conta a pagar. Para registrar recebimentos, monte a automação do zero com a ação Criar conta a receber.

Teste grátis