Um ERP é o sistema de gestão onde você controla estoque, preços e faturamento. Se você tem um, esta integração manda para ele os pedidos da sua loja de atacado e traz de volta o preço e o estoque de cada produto. Ter um ERP é opcional: sem ERP, você administra o catálogo na mão ou com o importador de arquivos da tela Ferramentas, e a loja funciona do mesmo jeito.
Passo a passo
- No menu lateral, entre em Configuração → ERP.
- Escolha o seu sistema na lista de cartões.
- Se a tela mostrar o aviso Este serviço tem um custo adicional, toque em Ativar serviço e confirme o preço. As integrações são um recurso pago que entra na sua fatura mensal; se o seu plano já inclui, o aviso não aparece.
- Preencha os campos de conexão que aquele ERP pede e salve.
- Toque em Verificar Configuração. Ele diz se as credenciais, o depósito e a tabela existem do outro lado antes de você começar a operar.
- Acompanhe o painel Atividade da integração até ver o primeiro movimento. É a única confirmação real de que a conexão está viva.
Cada artigo de ERP traz o detalhe dos seus campos.
Quais sistemas você pode escolher
Sistemas com integração própria:
- Virtual Seller (Salesforce)
- Contabilium
- SAAS (SaaS UE)
- Ninox
- Acqua
- Dragonfish
- DUX
- Bling
Além disso, há dois cartões que não são um ERP em si:
- Dragonfish Bridge: o app de desktop para o Dragonfish. É uma alternativa à integração direta do Dragonfish, não um complemento.
- API Token: um token para que qualquer sistema externo se conecte à nossa API REST. O mesmo token serve para o app Dragonfish Bridge.
Se o seu ERP não está na lista, a tela tem um link para solicitar uma integração personalizada.
A lista é filtrada pelo país do seu negócio. Todas as integrações acima são para a Argentina, com exceção do Bling, que é só para o Brasil. Se o seu negócio está em outro país, a tela mostra o estado vazio: não é um erro, ainda não há integrações para aquele país.
O que sincroniza e em que direção
Este é o modelo geral. Vale para todos os ERPs, exceto onde o artigo de cada um disser outra coisa.
| O quê | Direção | Quando |
|---|---|---|
| Pedidos | Loja → ERP | Ao confirmar o pedido, e de novo cada vez que você edita e salva o pedido |
| Preço | ERP → Loja | Automático conforme a cadência de cada ERP, e com Atualizar todos os produtos |
| Estoque | ERP → Loja | Igual ao preço |
A sincronização ERP → loja grava somente preço e estoque. Ela não cria produtos, não os exclui e não mexe em nome, descrição, categorias nem fotos. O vínculo entre os dois sistemas é o código (SKU): um código que chega do ERP e não existe no seu catálogo é descartado em silêncio.
Três exceções, cada uma explicada no seu artigo:
- A importação do Ninox cria e atualiza produtos completos.
- O interruptor opcional Sincronizar produtos do Bling também cria produtos.
- O Virtual Seller (Salesforce) não sincroniza preços: desse ERP viaja apenas o estoque.
Consequência prática: o produto precisa existir primeiro na loja, com o mesmo código que tem no ERP. Criar um item novo no ERP não faz ele aparecer no seu catálogo.
Forçar uma sincronização
Com os campos-chave preenchidos, aparece o bloco Suporte de Sincronização com o botão Atualizar todos os produtos. Ele percorre o catálogo inteiro contra o ERP e aplica preços e estoque.
- Pede confirmação porque pode sobrescrever alterações feitas na mão na loja.
- Pode demorar vários minutos e não pode ser interrompido. Não existe botão para parar uma sincronização em andamento.
- É a passada que recalcula o aviso "Não sincronizado" (veja abaixo).
Para desligar a sincronização, é preciso apagar as credenciais do ERP ou cancelar o serviço pelo próprio painel.
O aviso "Não sincronizado"
É o triângulo de aviso que aparece na linha do produto e em cada uma das suas opções, com o texto "Este produto não está sincronizado com o ERP. Os pedidos podem falhar ao exportar."
O que significa: na última passada completa, aquele código do seu catálogo não veio na listagem que o ERP mandou. Não é um erro da loja nem um problema da conexão: é que o ERP não reconhece aquele código.
Por que costuma acontecer:
- O produto ainda não está cadastrado no ERP, ou está com outro código.
- O código tem uma diferença mínima (um espaço, um hífen, maiúsculas onde o ERP usa minúsculas).
- O item existe no ERP mas sem preço na tabela que você configurou. Várias integrações descartam da listagem os itens sem preço, então eles contam como não encontrados.
- O produto está inativo ou baixado no ERP.
Como se limpa: o aviso some sozinho assim que o código volta a aparecer na listagem do ERP, mas só uma passada completa o recalcula. Corrija o código (ou cadastre o produto no ERP) e depois toque em Atualizar todos os produtos em Configuração → ERP.
Nos ERPs cuja sincronização automática já percorre o catálogo inteiro (Virtual Seller, Acqua, Dragonfish), o aviso é recalculado sozinho a cada passada. No DUX não: a passada de 10 em 10 minutos traz apenas o que mudou naqueles minutos e não mexe nos avisos. Ali é preciso esperar a passada noturna ou forçá-la na mão.
Para ver a lista completa de produtos com o aviso: na listagem de produtos, a coluna do ERP tem um filtro com a opção Não sincronizado. Ele deixa só esses produtos, e dali você pode exportá-los com a exportação normal da listagem — é a forma mais rápida de montar a lista do que falta cadastrar no ERP.
Se algo não aparece ou não sincroniza
- Não vejo nenhuma integração na tela. O país do seu negócio não tem integrações disponíveis. O país que conta é o do endereço cadastrado na configuração do negócio; se ele estiver vazio ou mal preenchido, a lista aparece incompleta.
- Não me deixa configurar, pede para ativar. É um recurso pago. Toque em Ativar serviço. O custo entra na sua fatura da VentasxMayor; o que você paga ao seu fornecedor de ERP é à parte e corre por conta dele.
- Um pedido não chegou ao ERP. Abra o pedido e olhe o registro de comunicações com o ERP. Nas entradas com erro aparece o botão Tentar Novamente. Você precisa da permissão de pedidos.
- O estoque ou os preços ficaram velhos. Olhe Atividade da integração: o Último push recebido mostra de um olhar se a conexão de entrada está viva. Se disser "Nunca" num ERP que envia por webhook (Ninox, Contabilium), falta o seu fornecedor cadastrar o endereço que a caixa Dados para configurar o webhook mostra.
- Um produto mostra o triângulo de aviso. Veja a seção acima.
- Cancelei o serviço e ele parou de sincronizar. É o esperado: o cancelamento desliga a sincronização automática, não só a cobrança.
Se o seu ERP ainda não está integrado
- Importador de arquivo. Na tela Ferramentas você pode enviar um arquivo exportado pelo seu ERP (código, preço, estoque, tabelas) para atualizar o catálogo. É o caminho mais rápido quando você não precisa de tempo real. Se ainda não tem o formato configurado, escreva para o suporte.
- API Token. Se o seu ERP tem API e você quer automatizar, gere um token em Configuração → ERP → API Token e passe-o a quem for desenvolver a conexão. A API permite registrar o sistema, ler pedidos pendentes, marcá-los como sincronizados, atualizar preço e estoque por código e ler clientes e SKU. Como o resto, ela não cria produtos.
- Migrar para um ERP integrado. Fica funcionando assim que você preenche as credenciais, sem desenvolvimento.