Integre sua loja atacadista na VendasxAtacado com o ERP Ninox para sincronizar catálogo, preços, estoque e pedidos de forma automática. O Ninox administra seu estoque e faturamento; a VendasxAtacado recebe o catálogo e envia os pedidos atacadistas para faturar.
Como funciona
A integração sincroniza em duas direções:
- Ninox → VendasxAtacado (catálogo): produtos, variantes de tamanho e cor, preço base, listas de preços, estoque e categorias. Atualiza de duas formas: com o botão Importar produtos (sua loja consulta o catálogo do Ninox) e automaticamente quando o Ninox envia para a loja mudanças de estoque e preços.
- VendasxAtacado → Ninox (pedidos): cada pedido atacadista confirmado na loja é enviado ao Ninox para faturamento. Os cancelamentos de pedidos já enviados também são comunicados ao Ninox.
Uma vez integrado, o catálogo é administrado pelo Ninox. Qualquer mudança de preço ou estoque feita à mão na VendasxAtacado é sobrescrita na próxima sincronização.
Configuração inicial — checklist
1. Token
O token é fornecido pelo Ninox ao ativar a integração. No menu lateral vá em Configuração → ERP, selecione Ninox, cole o token e use o botão Verificar Configuração para confirmar que a conexão funciona antes de operar.
- Há um único token válido por vez. Se o Ninox gerar um token novo, o anterior deixa de funcionar. Salvar um token antigo quebra toda a integração: os pedidos voltam com o erro "No se encontró la integración" (integração não encontrada).
- Cuidado com as abas antigas do navegador. Se você tiver a página de configuração aberta de antes e salvar qualquer mudança, o token antigo que essa aba tinha carregado é gravado de novo e sobrescreve o token bom. Se duas pessoas administram a configuração, combinem quem carrega o token.
2. Listas de preços (importante — faça ANTES de importar)
O Ninox trabalha com até 5 preços por artigo. O mapeamento para a loja é fixo:
| Preço no Ninox | Destino na VendasxAtacado |
|---|---|
| Preço 1 | Preço base do produto (o que aparece no site). Não precisa de lista própria. |
| Preço 2 | Lista com código L2 |
| Preço 3 | Lista com código L3 |
| Preço 4 | Lista com código L4 |
| Preço 5 | Lista com código L5 |
Antes da primeira importação, crie em Configuração → Listas de preços uma lista para cada preço que você usa no Ninox. O código deve ser exatamente L2, L3, L4 ou L5; o nome é livre e convém colocar o nome real (ex.: "Premium", "Oferta", "2ª seleção").
- Se algum artigo no Ninox tiver o preço N carregado e a lista
LNnão existir, a importação falha por completo com o erro "Lista de precios no encontrada LN" (lista de preços não encontrada) e nada é atualizado. - Não apague uma lista
LNse no Ninox continuarem carregando esse preço: a próxima importação vai falhar de novo.
3. Compradores com lista atribuída
Para que um comprador atacadista veja os preços da sua lista (por exemplo, clientes premium com o Preço 2), atribua a lista na ficha do cliente. As listas que não são atribuídas a ninguém não aparecem no site (útil para preços internos como venda presencial ou faturamento).
Importação de produtos
O botão Importar produtos traz o catálogo completo do Ninox e atualiza: nome, descrição, preço base, preços por lista, categorias (as tags do Ninox), variantes de tamanho e cor e o estoque de cada variante. As variantes sem estoque ficam desabilitadas automaticamente.
- Códigos de produto: sem variantes usa-se o número do artigo do Ninox; com variantes o formato é
artigo!tamanho!cor. Não edite manualmente: são a chave com a qual o Ninox identifica cada item dos pedidos. - Limite da API do Ninox: 1 consulta a cada 10 minutos. Se você tentar de novo antes, a importação não faz nada. Diante de qualquer nova tentativa, espere 10 minutos.
- O catálogo é administrado no Ninox. Qualquer mudança de preço ou estoque feita à mão na loja é sobrescrita na próxima sincronização.
Pedidos (VendasxAtacado → Ninox)
Cada pedido atacadista confirmado é enviado ao Ninox com:
- Dados do comprador conforme sua condição fiscal: Consumidor Final envia DNI; Responsável Inscrito, Monotributo e Isento enviam CUIT.
- Detalhe dos artigos com tamanho, cor e quantidades.
- Subtotal, desconto total, acréscimo, frete e total como campos separados.
- Endereços de entrega e faturamento, e observações do pedido.
Se o Ninox aceitar o pedido, ele devolve o número da nota fiscal, que fica salvo no pedido como referência do ERP. Essa referência vincula cada pedido ao seu registro no Ninox para acompanhamento e rastreabilidade.
Validação de estoque: o Ninox valida o estoque ao receber o pedido. Se não houver estoque suficiente, responde "No hay stock suficiente" (sem estoque suficiente) com o detalhe dos artigos em falta e não gera a nota. O pedido fica na loja com o erro registrado. Para resolver: atualize o estoque (Importar produtos), reponha no Ninox ou ajuste o pedido com o comprador, e reenvie pelo painel.
Cancelamentos: os cancelamentos de pedidos já enviados são comunicados ao Ninox usando a referência de nota fiscal armazenada.
Mapeamento de condições fiscais
As condições fiscais dos compradores são mapeadas para códigos numéricos do Ninox:
- 1 = Consumidor Final (CF) — envia o DNI
- 2 = Responsável Inscrito (RI) — envia o CUIT
- 3 = Monotributo — envia o CUIT
- 4 = Isento — envia o CUIT
Um mapeamento incorreto gera problemas de faturamento no Ninox, então verifique se a condição fiscal de cada comprador está bem cadastrada na VendasxAtacado.
Erros comuns e soluções
| Mensagem / sintoma | Causa | Solução |
|---|---|---|
| "No se encontró la integración" | O token salvo não é o vigente no Ninox (foi regerado ou sobrescrito por um antigo). | Carregue o token atual, use Verificar Configuração e reenvie os pedidos que voltaram. |
| "Lista de precios no encontrada LN" | Há artigos com o preço N carregado no Ninox e não existe a lista com código LN. | Crie a lista (código exato LN) e reimporte. Dica: crie de uma vez todas as listas que usar para não descobri-las uma a uma (cada tentativa espera 10 min). |
| "No hay stock suficiente" ao enviar um pedido | O estoque real no Ninox é menor que o pedido (típico quando o estoque da loja ficou desatualizado). | Importe produtos para sincronizar o estoque; reponha ou ajuste o pedido; reenvie. |
| Importar produtos "não faz nada" | Limite da API: 1 consulta a cada 10 minutos. | Espere 10 minutos e tente de novo. |
| Preços/estoque desatualizados há dias | Token sobrescrito ou inválido: o Ninox não consegue enviar atualizações para a loja. | Verifique o token; depois importe produtos para se atualizar. |
Campos de configuração
- Token (texto, obrigatório): token de autenticação da API do Ninox. Valida cada solicitação enviada ao sistema e é fornecido pelo Ninox ao ativar a integração. Depois de colar, use Verificar Configuração.
Dicas
- Crie as listas de preços
L2–L5que você usa no Ninox antes da primeira importação. É a causa mais comum de falhas no início. - Um único token válido por vez: combine quem o carrega e feche as abas antigas de configuração para não sobrescrever o token bom.
- Não edite preços nem estoque pela VendasxAtacado depois de integrado. Faça só pelo Ninox; a próxima sincronização sobrescreve suas mudanças.
- Respeite o limite de 1 consulta a cada 10 minutos ao importar produtos. Se "não fizer nada", espere e tente de novo.
- Diante de um pedido que não chega ao Ninox, verifique primeiro o registro de erros do pedido: ali fica o status e a resposta do Ninox.
- Guarde a referência de nota fiscal que fica em cada pedido: é a chave para a rastreabilidade entre os dois sistemas.