O Contabilium é um ERP argentino na nuvem com emissão fiscal eletrônica AFIP. Com a integração ativa, cada pedido de atacado chega ao Contabilium formatado e pronto para faturar, e o preço e o estoque do Contabilium se refletem no seu catálogo.
Passo a passo
- No Contabilium, gere a API Key nas configurações da sua conta e anote o ID de integração.
- Na VentasxMayor, entre em Configuração → ERP e escolha Contabilium.
- Preencha ID, E-mail (o da sua conta do Contabilium) e Chave da API.
- Se você usa depósitos ou tabelas de preços específicas, informe o nome exato em Depósito e Lista de Preços.
- Toque em Verificar Configuração: ele confere as credenciais, o depósito e a tabela contra o Contabilium e mostra erros e avisos antes de você operar.
- Salve. Com E-mail e Chave da API preenchidos, aparece o bloco Suporte de Sincronização.
- Passe ao seu suporte do Contabilium a URL da caixa Dados para configurar o webhook, para que eles avisem as mudanças na hora.
Campos de configuração
| Campo | Descrição |
|---|---|
| ID | Identificador da sua integração no Contabilium. |
| E-mail da sua conta do Contabilium. | |
| Chave da API | Chave gerada nas configurações da sua conta. |
| Depósito | Nome exato do depósito de onde o estoque é lido. Vazio = estoque geral. |
| Lista de Preços | Nome exato da tabela principal. Vazio = a padrão. É a que se aplica aos clientes sem tabela própria. |
| Listas adicionais | Tabelas extras para clientes com tabela atribuída. O código da tabela na VentasxMayor precisa ser exatamente igual ao nome da tabela no Contabilium. Cada tabela extra é mais uma varredura do catálogo em cada sincronização. |
| Sincronizar preços | Desligado: só o estoque é sincronizado e os preços ficam por sua conta na loja. |
| Sem Estoque | Não traz estoque do Contabilium. Para quem vende sob encomenda ou por fabricação. |
| Sem Imposto | Os preços enviados ao pedido não levam IVA somado. Desligado, soma-se 21% no envio. |
| Preço final? | Traz o "Preço Final" do Contabilium em vez do "Preço Base". |
| Desconto em itens | O desconto do pedido é distribuído como bonificação em cada produto, em vez de viajar como linhas de desconto separadas. |
| Nome do produto na fatura | Coloca o nome do produto antes do nome da variante no campo Conceito. |
O que sincroniza e em que direção
| O quê | Direção | Quando |
|---|---|---|
| Pedidos | Loja → Contabilium | Ao ser confirmado, e de novo se você editar e salvar o pedido |
| Preço e estoque | Contabilium → Loja | Ao salvar um produto, quando o webhook avisa, e com Atualizar todos os produtos |
Do pedido viajam os dados do comprador, os itens com código, quantidade, preço unitário, IVA e bonificação, os acréscimos de pagamento e frete como linhas extras, as observações e a data. O status é enviado como Aceita, ou Cancelada se você anulou o pedido.
Do Contabilium para a loja viajam somente preço e estoque. Produtos não são criados nem excluídos, e nome, descrição, categorias e fotos não são tocados.
Como os pedidos de dados são agrupados: quando você salva um produto, ou quando o Contabilium avisa por webhook, o código entra numa fila. Um processo central pega essa fila a cada 60 segundos e pede ao Contabilium os dados atualizados, em vez de fazer uma consulta por mudança. Esse minuto é o atraso máximo entre o aviso e o preço novo na sua loja.
Notificador de mudanças (webhook)
O Contabilium pode avisar a sua loja no momento em que um produto muda. Na tela do ERP aparece a caixa Dados para configurar o webhook com a URL que a equipe deles precisa cadastrar, com botão de copiar. A URL inclui o marcador {CODIGO}, que o notificador substitui pelo código do produto que mudou.
Para confirmar que os avisos chegam, olhe Atividade da integração: o Último push recebido mostra isso de um olhar. Se disser "Nunca", o notificador não está configurado — é o modo de falha mais silencioso desta integração, porque tudo parece funcionar enquanto o estoque fica velho.
Forçar uma sincronização
No bloco Suporte de Sincronização:
- Atualizar todos os produtos: percorre o catálogo inteiro. Demora vários minutos, não pode ser interrompido e pode sobrescrever alterações feitas na mão.
- Atualizar produto: escreva um Código SKU no campo de cima e o botão muda para sincronizar só aquele produto. É a única integração que tem essa opção.
Se algo não aparece ou não sincroniza
- Um produto ficou em 0 e no Contabilium ele tem estoque. Com Depósito configurado, o estoque é lido daquele depósito e de nenhum outro. Se as existências estão em outro depósito, a loja enxerga 0. Deixe o campo vazio para usar o estoque geral.
- "Posso excluir alguns produtos da sincronização?" Não existe exclusão por produto. As alavancas são globais: Sincronizar preços, Sem Estoque, ou tirar o código do produto para que ele deixe de casar com o Contabilium.
- "Como exporto os produtos que ainda não cadastrei no Contabilium?" Na listagem de produtos, filtre a coluna do ERP por Não sincronizado e exporte o resultado. Essa é exatamente a lista de códigos que o Contabilium não reconhece.
- Produtos com o triângulo de aviso. Veja o aviso "Não sincronizado" no artigo de Integração com ERP.
- Um pedido não chegou. O erro fica no registro de comunicações com o ERP do próprio pedido, com o botão Tentar Novamente, e também em Atividade da integração.
- Erros de limite de taxa (429). Quando o Contabilium responde que há solicitações demais, esperamos 60 segundos e tentamos de novo automaticamente. Se acontecer com frequência, pode ser que você esteja atualizando produtos demais de uma vez; tente em horários de menor movimento.
- Editei o pedido e a mudança não chegou. Se você já mudou o status do pedido no Contabilium (faturou, passou para orçamento), é o Contabilium que deixa de aceitar mudanças. Do nosso lado o reenvio é tentado do mesmo jeito. Faça o ajuste nos dois sistemas.
Dicas
- Os nomes de Depósito e Lista de Preços precisam estar exatos. Use Verificar Configuração para confirmar em vez de adivinhar.
- Revise Sem Imposto e Preço final? com cuidado: uma combinação errada faz o comprador ver um preço e o Contabilium registrar outro.
- Somar Listas adicionais multiplica o tempo de cada sincronização. Adicione só as que você usa de verdade.