Ficha técnica da integração
| O quê | Direção | Quando |
|---|---|---|
| Pedidos | Loja → Contabilium | Ao confirmar, e de novo se for editado e salvo; o status viaja como Aceito ou Cancelado |
| Preço e estoque | Contabilium → Loja | Ao salvar um produto, quando o Contabilium avisa por webhook (até um minuto de atraso) e com «Atualizar todos os produtos»; sincronização completa diária de reserva |
| Tabelas de preços | Contabilium → Loja | Uma tabela principal mais tabelas adicionais atribuídas a clientes; o código da tabela na loja precisa ser igual ao nome no Contabilium |
| Descontos e acréscimos | Loja → Contabilium | Desconto por item ou como linha geral; acréscimos de pagamento e frete como linhas extras |
| Produtos | Não são criados nem apagados | Só viajam preço e estoque: nome, descrição, categorias e fotos ficam como estão na loja |
| Requisitos | Plano FULL do Contabilium ativo; ID de integração, e-mail da conta e API Key. Depósito e tabela de preços pelo nome exato (vazio = estoque geral e tabela padrão). | |
| Custo | Inclusa no plano da VendasxAtacado: sem módulo à parte nem cobrança pela integração. | |
| Ativação | Com suporte incluso; resposta no mesmo dia útil. | |
O que você ganha ao integrar o Contabilium com sua loja?
- Pedidos automáticos: Cada venda na sua loja vai direto para o Contabilium. Zero digitação manual.
- Preços sempre atualizados — e por cliente: Altere um preço no Contabilium e ele se reflete automaticamente na sua loja online. Conecte sua lista principal ou múltiplas listas para atribuir preços especiais a distribuidores e atacadistas VIP.
- Estoque em tempo real: O inventário do Contabilium sincroniza com seu site. Nunca mais venda o que não tem.
Como funciona a integração?
Pedidos
- Quando um cliente compra na sua loja, o pedido é enviado automaticamente para o Contabilium (Vendas → Integrações → eCommerce → BUSCAR).
- Se você editar um pedido na sua loja antes de ser processado no Contabilium, as alterações são sincronizadas automaticamente ao salvar.
Estoque
- O estoque é gerenciado exclusivamente no Contabilium. Sua loja atualiza sozinha.
- Qualquer alteração nos níveis de estoque é refletida no seu site em tempo real.
Preços
- Os preços são gerenciados apenas no Contabilium e sincronizam automaticamente com sua loja.
- ⚠️ Não modifique preços diretamente no site após ativar a integração.
Descontos
- Os descontos aplicados pelos seus clientes na loja chegam refletidos no pedido no Contabilium.
- Você pode escolher como são enviados:
- Desconto por item (recomendado): o desconto é detalhado por produto.
- Desconto geral: um único item de "desconto" é enviado com o valor total.
Listas de preços múltiplas: preços diferentes por tipo de cliente
Se você lida com diferentes tipos de clientes (varejistas, distribuidores, grandes atacadistas), pode sincronizar várias listas de preços do Contabilium e atribuí-las a cada cliente na sua loja.
Como funciona
- Uma lista principal sincroniza com o preço que todos os clientes veem por padrão.
- Você ativa listas secundárias (quantas precisar) para clientes especiais.
Como configurar (3 lugares onde o nome deve ser idêntico)
- No Contabilium → suas listas já criadas (ex.:
PRINCIPAL,Distribuidor). - No VxA → Configuração → Produtos → Listas de Preços → cadastre cada lista secundária. O campo Código deve ser idêntico ao nome da lista no Contabilium. O Nome é o que sua equipe de vendas vê e pode ser texto livre.
- No VxA → Configuração → ERP → Integração Contabilium → informe a lista principal com seu nome exato e as listas secundárias separadas por vírgulas. Marque a caixa de cada lista secundária que quiser sincronizar.
Erros comuns a evitar
- Maiúsculas e minúsculas diferentes:
mayorista≠Mayorista. Não bate. - Espaços duplos internos:
Lista Mayorista≠Lista Mayorista. Não bate. - Renomear a lista no Contabilium sem atualizar o código no VxA → quebra a sincronização.
- Espaços no início ou no final: sim, esses são tolerados e removidos automaticamente. ✓
6 coisas que você precisa saber antes de começar
- Use o mesmo SKU, preço e estoque Ao criar produtos na sua loja, use exatamente o mesmo SKU, preço e estoque que você tem no Contabilium. Isso é essencial para a sincronização funcionar desde o primeiro dia.
- Sincronização diária de segurança Além da sincronização em tempo real, uma sincronização massiva diária de preços e estoque é executada para prevenir qualquer erro.
- Sincronização ao criar ou editar produtos Cada vez que você cria ou edita um produto na sua loja, o preço e estoque atualizados são solicitados automaticamente ao Contabilium.
- Contabilium manda: preços e estoque só se editam lá Uma vez ativa a integração, preços e estoque são modificados apenas no Contabilium. As alterações são refletidas automaticamente na sua loja.
- Cuidado ao mudar o status no Contabilium Quando um pedido chega no Contabilium e você muda o status (faturar, editar dados, converter em cotação), ele não poderá mais ser modificado pela sua loja. Certifique-se de revisar tudo antes de mudar o status.
- Você precisa do plano FULL do Contabilium A integração exige que sua conta do Contabilium tenha o plano FULL ativo. Se você tem um plano inferior, podemos te ajudar a fazer o upgrade.
Como ativar?
A ativação inclui suporte especializado. Nós cuidamos de tudo: configuramos a integração conforme suas necessidades e garantimos que funcione perfeitamente desde o primeiro dia. Para saber o custo, consulte-nos pelo WhatsApp.
Opções de configuração
Ao ativar a integração, definimos juntos estes parâmetros:
- DEPÓSITO: O nome exato do depósito no Contabilium do qual serão obtidas as informações de estoque.
- LISTA DE PREÇOS: A lista principal do Contabilium associada ao preço que todos os clientes veem na sua loja. Suporta múltiplas listas para atribuir preços especiais a clientes específicos (distribuidores, atacadistas VIP, etc.). Veja a seção "Listas de preços múltiplas" acima para os detalhes.
- SINCRONIZAR PREÇOS: Sim ou Não. Se escolher Sim, os preços sincronizam automaticamente entre ambos os sistemas.
- SINCRONIZAR ESTOQUE: Sim ou Não. Se escolher Sim, o estoque sincroniza automaticamente.
- PREÇOS COM IVA: Os preços dos pedidos são enviados ao Contabilium com IVA incluso ou sem IVA?
- PREÇO FINAL: Sua loja usa o "Preço Final" (com IVA) ou o "Preço Base" (sem IVA) do Contabilium?
- ENVIAR DESCONTO: Escolha como os descontos são enviados: por item (recomendado) ou como desconto geral no total do pedido.
Ainda não tem o Contabilium?
Cadastre-se com nosso link e ganhe 25% OFF por 3 meses:
Perguntas frequentes
O que sincroniza entre o Contabilium e a loja?+
Os pedidos viajam da loja para o Contabilium assim que são confirmados; o estoque e os preços viajam do Contabilium para a loja em tempo real, com uma sincronização em massa diária como reforço. Os descontos do pedido são enviados por item ou como um item geral.
Posso usar várias listas de preços?+
Sim. Uma lista principal define o preço que todos veem e as listas secundárias são atribuídas a clientes específicos (distribuidores, atacadistas VIP). O código da lista na loja precisa ser idêntico ao nome da lista no Contabilium.
Qual plano do Contabilium é necessário?+
A integração exige o plano FULL do Contabilium ativo. A ativação na loja inclui a configuração de depósito, lista de preços, IVA e descontos com a nossa equipe.
Posso editar preços ou estoque na loja depois de ativar?+
Não convém: o Contabilium é o sistema mestre. Preços e estoque são editados lá e a loja se atualiza sozinha; uma alteração manual no site é sobrescrita na próxima sincronização.
Quanto custa a integração?+
Nada além do plano: a integração com o ERP está inclusa em todos os planos da VendasxAtacado, sem módulo nem cobrança adicional.
Quanto tempo leva a ativação?+
Com as credenciais em mãos, a configuração é feita pelo painel e verificada com «Verificar configuração»; nossa equipe acompanha a ativação e responde no mesmo dia útil.
Funciona com vários depósitos?+
Informa-se o nome exato do depósito de onde o estoque é lido; se ficar vazio, a loja usa o estoque geral. Clientes com tabela própria recebem o preço da sua tabela adicional do Contabilium.
