O Virtual Seller é um sistema de gestão comercial para atacadistas. Com a integração ativa, os pedidos da sua loja são registrados sozinhos no Virtual Seller e o estoque do Virtual Seller atualiza o seu catálogo.
Esta integração NÃO sincroniza preços. Do Virtual Seller para a sua loja viaja apenas o estoque. Os preços do seu catálogo de atacado você administra na VentasxMayor, e eles nunca são sobrescritos. Se você mudar um preço no Virtual Seller, precisa mudá-lo aqui também.
Passo a passo
- No Virtual Seller, crie o aplicativo conectado e anote o Client ID e o Client Secret.
- Combine com o seu administrador do Virtual Seller o valor do Identificador: é a etiqueta pela qual o Virtual Seller vai reconhecer os pedidos que vêm da sua loja online (por exemplo,
PAGINAWEBouWEB). - Na VentasxMayor, entre em Configuração → ERP e escolha Virtual Seller.
- Preencha Usuário, Senha, Client ID, Client Secret e Identificador.
- Se for o caso, preencha Depósito (de qual depósito o estoque é lido) e Empresas (para limitar a sincronização a uma ou várias razões sociais).
- Toque em Verificar Configuração.
- Salve. Com as quatro credenciais preenchidas, aparece o bloco Suporte de Sincronização.
O que sincroniza e em que direção
| O quê | Direção | Quando |
|---|---|---|
| Pedidos | Loja → Virtual Seller | Ao ser confirmado, e de novo se você editar e salvar o pedido |
| Estoque | Virtual Seller → Loja | Automático a cada 10 minutos, e com Atualizar todos os produtos |
| Preços | Não são sincronizados em nenhuma direção de catálogo | — |
Do pedido viajam os dados do comprador (nome, documento, categoria de IVA, telefone, e-mail, endereço de entrega e de cobrança), os itens com código, quantidade, preço unitário e percentual de desconto, e o Identificador configurado. O preço que viaja é o do pedido, não o do seu catálogo: essa é a única forma pela qual um preço chega ao Virtual Seller.
O que NÃO viaja no pedido: as observações e as condições de pagamento não são enviadas.
A sincronização nunca cria produtos. Um item que existe no Virtual Seller e não está no seu catálogo é descartado. Cadastre-o antes na loja, com o mesmo código.
Se algo não aparece ou não sincroniza
- Os preços não são atualizados. É o esperado, não é uma falha: esta integração não traz preços. Administre-os na VentasxMayor.
- O estoque de um produto ficou "congelado". Quando o Virtual Seller devolve uma linha sem dado de estoque, nós a pulamos e mantemos o último valor conhecido, em vez de gravar 0 (um zero inventado esconde o produto nas lojas que ocultam o que está sem estoque). Se a listagem inteira vier sem dados, a passada é abortada sem tocar em nada. Revise o item no Virtual Seller.
- Parou de sincronizar depois de trocar a senha. O token é pedido de novo a cada chamada, com o seu usuário e senha: não há renovação nem token salvo. Se você mudou as credenciais no Virtual Seller, atualize-as aqui ou a sincronização fica interrompida. Desde 2026, uma falha de autenticação é registrada como erro em Atividade da integração, em vez de mostrar a conexão em verde sobre uma sincronização morta.
- Um pedido não chegou. O erro fica no registro de comunicações do próprio pedido, com o botão Tentar Novamente, e em Atividade da integração. Nenhum aviso por e-mail é enviado ao lojista.
- Produtos com o triângulo "Não sincronizado". Veja o artigo de Integração com ERP. No Virtual Seller o aviso é recalculado sozinho a cada passada.
- Vejo estoque de um depósito que eu não quero. Preencha o campo Depósito. Vazio, são usados os valores gerais.
- Quero atualizar um só produto por SKU. Não existe para esta integração. O único botão disponível é Atualizar todos os produtos, na tela de configuração do ERP.