Contabilium é um sistema de gestão contábil e comercial na nuvem, muito utilizado por empresas atacadistas na Argentina para faturamento eletrônico AFIP, controle de estoque e administração de vendas. Ao conectar sua loja VendasxAtacado com Contabilium, os pedidos atacadistas são enviados automaticamente ao sistema de gestão com formato pronto para faturar, e o estoque e os preços são mantidos atualizados no seu catálogo online.
Como funciona
Em Configuração > ERP selecione Contabilium e insira seu ID, email e API Key. Uma vez conectado, VendasxAtacado se comunica com Contabilium através da sua API REST:
- Os pedidos viajam do VendasxAtacado para o Contabilium cada vez que um comprador atacadista confirma uma ordem. O pedido chega formatado e pronto para gerar a fatura.
- O estoque e os preços viajam do Contabilium para o VendasxAtacado de forma automática, agrupando as atualizações para otimizar o desempenho.
Antes de ativar a integração
Para que a sincronização funcione bem desde o primeiro dia, alinhe os dados entre os dois sistemas:
- Garanta que cada produto no VendasxAtacado tenha o mesmo SKU (código) que no Contabilium. É a única forma de os dois sistemas vincularem produtos entre si.
- Verifique que os valores iniciais de preço e estoque coincidam dos dois lados antes de ligar a sincronização.
- Se você gerencia depósitos ou listas de preços específicas no Contabilium, anote os nomes exatos para usá-los ao configurar a integração.
Campos de configuração
| Campo | Tipo | Descrição |
|---|---|---|
| ID | Texto | Identificador único da sua integração no Contabilium. |
| Texto | Email cadastrado na sua conta do Contabilium. É usado para autenticar contra a API. | |
| API KEY | Texto | Chave API gerada nas configurações da sua conta do Contabilium. |
| Depósito | Texto | Nome exato do depósito criado no Contabilium do qual é consultado o estoque. Se não for preenchido, é utilizado o estoque geral. Útil quando você gerencia múltiplos depósitos. |
| Lista de Preços | Texto | Nome exato da lista de preços a sincronizar. Se não for preenchida, é usada a lista padrão. Ideal para gerenciar diferentes listas atacadistas conforme o canal de venda. |
| Sincronizar preços | Toggle | Sincroniza automaticamente os preços do Contabilium. Se estiver desativado, apenas o estoque é sincronizado e os preços são administrados manualmente no VendasxAtacado. |
| Sem Estoque | Toggle | Não sincroniza os níveis de estoque do Contabilium. Ative se você vende sob encomenda ou fabricação e não quer que o estoque do ERP bloqueie vendas. |
| Sem Imposto | Toggle | Os preços enviados ao ERP não incluem imposto adicional. Ative se seus preços no VendasxAtacado já têm o imposto incluído e você não quer que seja somado outro 21% ao enviar o pedido ao Contabilium. |
| Preço final? | Toggle | Usa o "Preço Final" do Contabilium (com imposto e acréscimos) em vez do "Preço Base" ao trazer preços para o catálogo. |
| Desconto em itens | Toggle | Distribui o desconto do pedido como bonificação em cada produto em vez de uma linha separada de "Desconto". Ative se sua equipe de faturamento precisa ver o desconto aplicado a cada produto individual. |
| Nome do produto na fatura | Toggle | Inclui o nome do produto no campo Conceito da fatura, além do nome da variante. Útil para identificar rapidamente os produtos na visualização de pedidos do ERP. |
Após carregar os dados, você pode usar o botão Verificar configuração para que o VendasxAtacado verifique as credenciais, o depósito e a lista de preços contra a API do Contabilium e mostre erros, alertas e detalhes antes de operar.
O que é sincronizado
Pedidos (VendasxAtacado → Contabilium)
Cada pedido confirmado é enviado ao Contabilium com formato pronto para faturamento:
- Dados do comprador (nome, sobrenome, identificação CUIT/DNI, email, telefone, endereço, cidade, província, país, CEP).
- Lista de produtos com código SKU, quantidade, preço unitário, imposto e bonificação.
- Acréscimos de pagamento e de envio como itens adicionais quando corresponde.
- Observações do pedido e data de emissão.
- O estado é enviado como Aceptada (Aceita) — ou Cancelada se o pedido foi anulado no VendasxAtacado.
- Os descontos são aplicados no nível do item ou como um item separado de "Desconto" conforme a configuração.
- Os códigos de produto são enviados em maiúsculas automaticamente.
Se depois de confirmar o pedido você o editar no VendasxAtacado e o Contabilium ainda não processou a ordem, a edição é reenviada automaticamente. Uma vez que você modifique o estado do pedido no Contabilium (por exemplo, fatura, converte em cotação ou edita a fatura), o Contabilium deixa de aceitar mais alterações do VendasxAtacado para esse pedido. Se você precisar corrigir algo depois desse ponto, terá que aplicar a alteração nos dois sistemas separadamente.
Estoque (Contabilium → VendasxAtacado)
Os níveis de estoque são consultados no Contabilium e atualizados no seu catálogo. Se você configurou um depósito específico, apenas o estoque desse depósito é importado. Os produtos são vinculados por código SKU.
Preços (Contabilium → VendasxAtacado)
Os preços atacadistas são obtidos da lista de preços configurada no Contabilium. Se você não configurou uma lista específica, é usada a padrão. Os preços são ajustados conforme as opções de Sem Imposto e Preço final?.
Comportamento da sincronização
Pedidos
- Modo: Automático ao confirmar o pedido.
- Momento: Imediatamente após o comprador confirmar a ordem.
- Erros: São registrados no histórico de logs ERP do pedido. Da tela de detalhe do pedido você pode tentar reenviar manualmente com o botão de nova tentativa.
Estoque e preços
- Acumulação de mudanças: Quando você salva um produto ou quando o Contabilium notifica alterações, os SKUs afetados são acumulados em uma fila interna. Um processo central consome essa fila a cada 3 minutos e pede ao Contabilium os dados atualizados, em vez de fazer uma requisição por cada alteração.
- Sincronização ao criar ou editar produtos: Quando você cria um produto novo ou edita qualquer campo de um produto ativo, ao salvar é solicitado automaticamente preço e estoque ao Contabilium.
- Sincronização de fundo agendada: Adicionalmente é executada uma sincronização massiva agendada que percorre todos os produtos do catálogo contra o Contabilium, como rede de segurança para alterações que não tenham se propagado.
- Paginação: Os produtos são trazidos do Contabilium em páginas de 100, com uma pequena pausa entre páginas para não sobrecarregar o servidor.
- Limites de taxa: Se o Contabilium responder com erro HTTP 429 (muitas solicitações), o VendasxAtacado tenta novamente automaticamente até 10 vezes com uma pausa de 60 segundos entre cada tentativa.
- Detecção de SKUs não encontrados: Durante uma sincronização massiva, o VendasxAtacado identifica os produtos que existem no seu catálogo mas não no Contabilium e os marca como não coincidentes para que você revise.
Códigos de produto
- Os códigos SKU são convertidos automaticamente para maiúsculas antes de serem enviados ao Contabilium. Se seus produtos têm códigos em minúsculas no VendasxAtacado, chegarão em maiúsculas ao Contabilium.
Forçar uma sincronização manual
Uma vez conectada a integração, na tela de configuração do ERP aparece a seção Suporte de Sincronização. De lá você pode:
- Atualizar todos os produtos: dispara uma sincronização massiva contra o Contabilium. Traz preços, estoque e dados do produto do ERP. A operação pode levar vários minutos e não pode ser interrompida; pode sobrescrever alterações locais.
- Atualizar produto (por SKU): insira um código SKU específico para sincronizar apenas aquele produto.
Antes de executar qualquer das duas ações, o VendasxAtacado pede confirmação porque a sincronização pode sobrescrever alterações feitas na web.
Gestão unificada no Contabilium
Uma vez ativa a integração, administre os preços e o estoque apenas no Contabilium. Qualquer alteração que você fizer diretamente no VendasxAtacado pode ser sobrescrita pela próxima sincronização. A regra prática é: o ERP é a fonte de verdade para preço e estoque; a loja online reflete esses dados.
Dicas
- Defina claramente a Lista de Preços se você gerencia múltiplas listas no Contabilium. A lista incorreta pode fazer com que seus compradores vejam preços que não correspondem ao seu canal atacadista online.
- Se você vende produtos sob encomenda ou fabricação, ative Sem Estoque para evitar que vendas sejam bloqueadas por falta de inventário registrado no ERP.
- Use Desconto em itens se sua equipe de faturamento precisa ver o desconto aplicado a cada produto individual no Contabilium, em vez de uma linha separada.
- Revise a configuração de Sem Imposto e Preço final? cuidadosamente. Uma configuração incorreta pode gerar diferenças entre o preço que o comprador vê e o que é registrado no Contabilium.
- Antes de alterar o estado de um pedido no Contabilium, verifique que você não precisa fazer mais nenhum ajuste na informação do pedido a partir do VendasxAtacado. Uma vez modificado o estado, essas mudanças não são sincronizadas mais.
- Se você vir erros frequentes de limite de taxa (429), pode ser sinal de que está atualizando muitos produtos ao mesmo tempo. Considere fazer atualizações em horários de menor atividade.
- Lembre-se de que os códigos de produto são enviados em maiúsculas. Certifique-se de que os códigos no Contabilium estejam em maiúsculas para que coincidam corretamente.