O Ninox administra o seu estoque e o seu faturamento. É a única integração que traz o catálogo completo do ERP: produtos, variantes, preços e estoque. Os pedidos da loja viajam para o Ninox para serem faturados.
Passo a passo
- Peça o token ao Ninox ao contratar a integração.
- Na VentasxMayor, entre em Configuração → ERP, escolha Ninox e cole o Token.
- Toque em Verificar Configuração para confirmar a conexão.
- Antes de importar, crie em Configuração → Listas de preços uma tabela para cada preço que você usa no Ninox, com o código exato
L2,L3,L4ouL5. Veja a tabela abaixo. - Passe ao seu suporte do Ninox os três valores da caixa Dados para configurar o webhook, para que eles ativem o envio automático de estoque e preços.
- Toque em Importar Produtos Ninox para trazer o catálogo.
Existe um único token válido por vez. Se o Ninox gerar um novo, o anterior para de funcionar e os pedidos voltam com "Integração não encontrada". Cuidado também com as abas antigas do navegador: se você salvar qualquer alteração a partir de uma aba aberta antes, o token que aquela aba tinha carregado é gravado de novo e sobrescreve o bom.
Tabelas de preços (faça isso antes de importar)
O Ninox trabalha com até 5 preços por item. O mapeamento é fixo:
| Preço no Ninox | Destino na VentasxMayor |
|---|---|
| Preço 1 | Preço do produto (o que o comprador vê) |
| Preço 2 | Tabela com código L2 |
| Preço 3 | Tabela com código L3 |
| Preço 4 | Tabela com código L4 |
| Preço 5 | Tabela com código L5 |
O código precisa ser exatamente LN; o nome é livre. Se um item do Ninox tiver o preço N preenchido e a tabela LN não existir, a importação falha inteira com o erro "Lista de preços não encontrada LN" e nada é atualizado. Crie de uma vez todas as que você usa.
O que sincroniza e em que direção
| O quê | Direção | Quando |
|---|---|---|
| Catálogo completo: nome, descrição, preços por tabela, variantes e estoque | Ninox → Loja | Ao tocar em Importar Produtos Ninox |
| Preço e estoque | Ninox → Loja | Quando o Ninox envia por webhook |
| Pedidos e cancelamentos | Loja → Ninox | Ao confirmar e ao anular |
As categorias não são importadas por padrão. As tags do Ninox só trazem a categoria raiz, então importá-las sobrescreveria as subcategorias que você cadastrou na mão, produto por produto. Se você realmente quer que o Ninox mande as categorias, marque Atualizar categorias a partir do arquivo/ERP antes de importar — um aviso vai informar que as categorias existentes serão substituídas.
A importação oculta o que não veio na listagem. Os produtos do seu catálogo que o Ninox não envia ficam sem estoque e ocultos na loja. Eles não são excluídos, e voltam a aparecer sozinhos se reaparecerem numa importação posterior. Se depois de importar alguns produtos sumiram, é isso: confira se eles continuam cadastrados no Ninox.
Códigos de produto: sem variantes, o código da opção é o número do item no Ninox seguido de duas exclamações (123456!!). Com variantes, o formato é item!tamanho!cor, usando os identificadores internos do Ninox. Não edite na mão: eles são a chave com que o Ninox reconhece cada item do pedido.
Preços: o Ninox não trabalha com preço por variante, então o preço completo fica cadastrado em cada opção do produto e o preço do produto pai fica zerado. É o esperado e não muda o que o comprador vê.
Pedidos: viajam os dados do comprador conforme a condição fiscal dele, o detalhe com tamanho, cor e quantidades, o subtotal, o desconto total, o acréscimo, o frete e o total como campos separados, mais os endereços e as observações. Se o Ninox aceitar, ele devolve o número da fatura, que fica guardado no pedido como referência do ERP e é o que se usa depois para cancelá-lo.
Condições fiscais: 1 Consumidor Final (envia DNI), 2 Responsável Inscrito, 3 Monotributo e 4 Isento (os três enviam CUIT). Um mapeamento mal preenchido gera problemas de faturamento do lado do Ninox.
Se algo não aparece ou não sincroniza
| Mensagem ou sintoma | Causa | Solução |
|---|---|---|
| "Integração não encontrada" | O token salvo não é o que está válido no Ninox. | Cadastre o token atual, use Verificar Configuração e reenvie os pedidos que voltaram. |
| "Lista de preços não encontrada LN" | Há itens com o preço N e não existe a tabela com código LN. | Crie a tabela com o código exato e importe de novo. |
| "Não há estoque suficiente" ao enviar um pedido | O Ninox valida o estoque no recebimento e o real é menor que o pedido. | Importe produtos para atualizar o estoque, reponha no Ninox ou ajuste o pedido, e reenvie. |
| Preços ou estoque velhos há dias | O webhook nunca foi configurado do lado do Ninox, ou o token foi sobrescrito. | Olhe Atividade da integração: se o Último push recebido disser "Nunca", passe os Dados para configurar o webhook ao Ninox. Se aparecer "Push rejeitado: o token não confere", atualize o token dos dois lados. |
| Produtos que sumiram da loja | Eles não vieram na última importação e ficaram ocultos. | Confira se continuam cadastrados no Ninox e importe de novo. |
| As subcategorias foram apagadas | A importação foi feita com Atualizar categorias a partir do arquivo/ERP marcado. | Cadastre as subcategorias de novo e deixe a caixa desmarcada nas próximas importações. |
Dicas
- Ao contratar a integração, não presuma que o webhook ficou configurado. Peça ao Ninox que dispare uma atualização de teste e acompanhe o painel de atividade até ver o primeiro push recebido.
- Um único token válido por vez: combine quem cadastra e feche as abas antigas de configuração.
- Depois de integrado, não edite preços nem estoque pela loja. A próxima sincronização sobrescreve.
- Guarde a referência de fatura que fica em cada pedido: é o vínculo entre os dois sistemas.