> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linqui.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Mercúrio ERP

> Produtos, variações, estoque e clientes vêm do Mercúrio a cada 5 minutos, e os pedidos do catálogo vão para o Mercúrio.

**Categoria:** Sistemas de estoque e ERP

Integre o ERP Mercúrio ao Linqui para trazer produtos, variações, estoque e clientes, e enviar os pedidos feitos no catálogo de volta para o Mercúrio. A atualização é automática, a cada 5 minutos, e não exige nenhuma configuração do lado do Mercúrio.

<Tip>
  Para receber por Pix e cartão de crédito no catálogo pela conta digital do Mercúrio, veja [Mercúrio Pagamentos](/integracoes/mercurio-pagamentos). As duas integrações podem usar a mesma conta.
</Tip>

## Como conectar

![Tela de conexão do Mercúrio ERP no Linqui: entrada por e-mail e senha ou token da API, escolha do ambiente, ativação e envio de pedidos](https://raw.githubusercontent.com/wellingtonsantos/linqui-docs-media/main/mercurio-erp-conectar.png)

<Steps>
  <Step title="Acesse Integrações → Mercúrio ERP">
    Clique em **Conectar** (ou **Gerenciar**, se já estiver conectado).
  </Step>

  <Step title="Escolha como entrar">
    * **E-mail e senha**: o e-mail e a senha do seu usuário no Mercúrio. A senha só é usada para gerar o acesso, que se renova sozinho. Ela não fica guardada no Linqui.
    * **Token da API**: o token Basic da API e o código da empresa (`empresa_idpk`) fornecidos pelo Mercúrio.

    Ao lado, escolha o ambiente: **Produção** ou **Sandbox (testes)**.
  </Step>

  <Step title="Escolha a empresa">
    Se o seu usuário tem acesso a mais de uma empresa no Mercúrio, escolha qual conectar e clique em **Conectar empresa**.
  </Step>

  <Step title="Faça a primeira sincronização">
    Em **Sincronização completa**, clique em **Sincronizar tudo** para importar os produtos e os clientes.
  </Step>

  <Step title="Ative a integração">
    Ligue **Ativar integração**. Desativada, o Linqui não busca nem envia dados para o Mercúrio.
  </Step>
</Steps>

Com a conta conectada, a tela mostra a empresa, a última atualização, a sincronização completa, as opções do que sincronizar e o envio de pedidos:

![Tela do Mercúrio ERP conectado: conta, atualização automática, sincronização completa, o que sincronizar, ativação e envio de pedidos](https://raw.githubusercontent.com/wellingtonsantos/linqui-docs-media/main/mercurio-erp-config.png)

## Atualização automática

A cada 5 minutos, o Linqui busca no Mercúrio os produtos, o estoque e os clientes que mudaram. A tela da integração mostra quando os produtos e os clientes foram atualizados pela última vez.

## Sincronização completa

Use **Produtos**, **Clientes** ou **Sincronizar tudo** para importar de novo todo o cadastro do Mercúrio. Faça isso na primeira vez ou quando algo ficar diferente entre os dois sistemas.

<Note>
  Em catálogos grandes, a sincronização completa pode levar alguns minutos. Deixe a página aberta até terminar.
</Note>

## O que sincronizar

| Opção | O que faz |
| - | - |
| **Sincronizar produtos e estoque** | Produtos, variações, preço, estoque e fotos vêm do Mercúrio. Ligada por padrão |
| **Sincronizar clientes** | Os clientes do Mercúrio entram em **Contatos**. Quem já existe é reconhecido pelo CPF/CNPJ ou pelo WhatsApp. Ligada por padrão |
| **Só produtos marcados para o catálogo** | Ativa no Linqui só os produtos com **Exibir no catálogo** ligado no Mercúrio. Os demais entram desativados |

<Accordion title="O que é sincronizado, exatamente">
  * **Produtos**: produtos simples, kits, fabricados e produtos com variação, com nome, preço, estoque, fotos, descrição, peso e medidas. Fotos, descrição, peso e medidas só são gravados quando o Mercúrio tem o dado, então o que você preencheu no Linqui não é apagado.
  * **Variações**: cada variação do Mercúrio vira uma variação do produto no Linqui, com preço e estoque próprios.
  * **Categorias**: a categoria do produto no Mercúrio é criada no Linqui e associada ao produto.
  * **Estoque**: produto sem controle de estoque no Mercúrio fica com estoque 999 no Linqui, para não sumir dos catálogos que não vendem sem estoque.
  * **Produtos que já existem no Linqui**: são reconhecidos pelo SKU, quando o produto tem SKU próprio no Mercúrio.
  * **Produtos inativos** no Mercúrio entram desativados no Linqui.
  * **Limite do plano**: produtos acima do limite do seu plano não são importados. O aviso da sincronização mostra quantos ficaram de fora.
  * **Clientes**: nome, documento, contato e endereço entram em **Contatos**.
</Accordion>

## Envio de pedidos

Os pedidos feitos no catálogo entram no Mercúrio como vendas.

| Campo | O que faz |
| - | - |
| **Ativar envio** | Quando ligado, os pedidos são enviados automaticamente ao Mercúrio |
| **Gatilho** | Em que momento do pedido o envio acontece: pedido criado, confirmado, pago ou qualquer mudança de status. Vale para todos os ERPs conectados |

Na tela do pedido, **Sincronizar com o ERP** envia o pedido na hora. Se o pedido mudar depois de enviado, a mesma venda é atualizada no Mercúrio.

<Accordion title="O que vai na venda">
  * **Itens**: os produtos sincronizados do Mercúrio vão vinculados ao cadastro dele (a variação escolhida tem prioridade). Os demais itens vão pelo nome.
  * **Cliente**: nome, CPF/CNPJ, endereço e telefone. Cliente que veio do Mercúrio fica vinculado ao cadastro dele.
  * **Frete**: o valor do frete do pedido.
  * **Descontos e acréscimos do pedido** (cupom, desconto progressivo, desconto ou acréscimo da condição de pagamento): distribuídos entre os itens, proporcionalmente ao valor de cada um, para a soma dos itens bater com o total. A observação da venda registra o valor.
  * **Observação**: número do pedido no Linqui, observações do cliente, cupom e forma de entrega.
</Accordion>

<Warning>
  Sem a exigência de CPF/CNPJ ativada (em **Configurações → Cadastro de clientes**), os pedidos enviados não ficam vinculados ao cadastro do cliente no Mercúrio.
</Warning>

## Problemas comuns

<AccordionGroup>
  <Accordion title="Conectei, mas nenhum produto apareceu">
    A atualização automática traz só o que mudou no Mercúrio. Na primeira vez, clique em **Sincronizar tudo** e espere terminar.
  </Accordion>

  <Accordion title="Um produto do Mercúrio não aparece no catálogo">
    Confira se:

    * o produto está ativo no Mercúrio;
    * a opção **Só produtos marcados para o catálogo** está ligada e o produto não tem **Exibir no catálogo** marcado no Mercúrio;
    * o seu plano não chegou ao limite de produtos (o aviso da sincronização mostra quantos ficaram de fora).
  </Accordion>

  <Accordion title="O pedido não chegou ao Mercúrio">
    Confira se **Ativar integração** e **Ativar envio** estão ligados e se o pedido já atingiu o **Gatilho**. Para enviar na hora e ver a mensagem de erro, se houver, use **Sincronizar com o ERP** na tela do pedido.
  </Accordion>

  <Accordion title="Tenho outro ERP conectado na mesma conta">
    O pedido vai para todos os ERPs com **Ativar envio** ligado. Um produto que só existe no Mercúrio é recusado pelo outro ERP (a vhsys, por exemplo, avisa que há itens sem produto correspondente por SKU). Deixe o envio ligado só no ERP que deve receber os pedidos.
  </Accordion>

  <Accordion title="Apareceu o aviso &#x22;Acesso ao Mercúrio expirou&#x22;">
    O Mercúrio recusou o acesso do Linqui. Clique em **Reconectar** e entre de novo.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.