Integre sua loja atacadista no VendasxAtacado com o ERP Ninox para sincronizar pedidos, estoque e preços de forma automática. Ninox oferece uma solução de gestão empresarial com funcionalidades específicas para o mercado atacadista, incluindo gerenciamento de variantes de produto e condições fiscais argentinas.
Como funciona
Em Integrações API > Ninox selecione Ninox e preencha os campos de configuração. Uma vez conectado, os pedidos realizados na sua loja atacadista são enviados automaticamente ao ERP, e os níveis de estoque e preços do catálogo do Ninox são refletidos na sua loja online.
A integração com Ninox é direta: você só precisa de um token de autenticação para começar a sincronizar.
Como ativar a integração
A ativação do Ninox não é self-service. O fluxo é:
- Entre em contato com a área de vendas do Ninox para cadastrar a integração com VendasxAtacado. A equipe deles enviará um token de API.
- Coordene com seu executivo de contas do VendasxAtacado e entregue o token. O suporte realiza a ativação inicial e deixa a sincronização rodando automaticamente.
- Antes de ativar, alinhe seu catálogo: cadastre os produtos no VendasxAtacado com o mesmo SKU, preço e estoque que possuem no Ninox. Isso evita divergências no momento em que a sincronização é ligada.
Uma vez ativa, preços e estoque passam a ser administrados pelo Ninox. Atualize preços e estoque apenas no Ninox; qualquer alteração feita no VendasxAtacado será sobrescrita pela próxima sincronização.
Campos de configuração
- Token (texto, obrigatório): token de autenticação da API do Ninox. É utilizado para validar cada solicitação enviada ao sistema. É fornecido pela equipe do Ninox no momento do cadastro da integração.
Depois de colar o token, utilize o botão Verificar Configuração para confirmar que a conexão funciona antes de operar.
O que é sincronizado
Pedidos (VendasxAtacado → Ninox)
Cada pedido confirmado na sua loja é enviado automaticamente ao Ninox. O pedido inclui:
- Dados completos do comprador (razão social, CUIT, endereço, condição fiscal)
- Detalhamento de cada produto com quantidades, preços unitários e subtotais
- Condição fiscal do comprador mapeada para o código correspondente do Ninox
- Observações e condições de pagamento
- Subtotal, desconto total, acréscimo e custo de envio como campos separados do pedido
Ao enviar um pedido com sucesso, Ninox retorna um identificador de fatura que fica armazenado como referência do ERP no VendasxAtacado. Isso permite vincular cada pedido com seu registro correspondente no Ninox para acompanhamento e rastreabilidade.
Estoque (Ninox → VendasxAtacado)
Os níveis de inventário são importados do Ninox para sua loja. A sincronização utiliza dois endpoints especializados:
- GetData: obtém os dados base de produtos e estoque
- GetDataCurva: obtém dados massivos de produtos para sincronização de catálogos grandes
O Ninox também pode enviar atualizações ao VendasxAtacado por meio de um webhook autenticado com o mesmo token, permitindo refletir mudanças de estoque e preços quase em tempo real.
Preços (Ninox → VendasxAtacado)
Os preços são importados do catálogo de produtos do Ninox. Os preços são atualizados junto com a sincronização de estoque para manter a coerência entre inventário e preços na sua loja atacadista.
Comportamento da sincronização
Envio de pedidos
Os pedidos são enviados mediante uma solicitação HTTP POST à API do Ninox. A resposta inclui um identificador de fatura do Ninox que é armazenado como referência do ERP no VendasxAtacado. Esta referência permite rastrear cada pedido em ambos os sistemas.
Cancelamento de pedidos
Ninox suporta o cancelamento de pedidos mediante um endpoint dedicado. Se um pedido precisar ser cancelado após ter sido enviado ao ERP, o sistema comunica o cancelamento diretamente ao Ninox usando a referência de fatura armazenada.
Códigos de produto
Produtos sem variantes são identificados pelo seu SKU numérico. Produtos com variantes utilizam o formato articuloId!talleId!colorId como código identificador. Este formato permite que o Ninox identifique corretamente cada combinação de artigo, tamanho e cor com seu registro no ERP.
Mapeamento de condições fiscais
As condições fiscais dos clientes são mapeadas para códigos numéricos do Ninox:
- 1 = Consumidor Final (CF)
- 2 = Responsável Inscrito (RI)
- 3 = Monotributo
- 4 = Isento
Para Consumidor Final é enviado o DNI do cliente; para os demais é enviado o CUIT. Este mapeamento garante que cada pedido chegue ao Ninox com a condição fiscal correta do comprador, o que é fundamental para a faturação e o cumprimento tributário.
Sincronização de estoque massivo
A sincronização de estoque utiliza os endpoints GetData e GetDataCurva para obter dados de produtos em bloco. Isso permite processar catálogos grandes de forma eficiente, atualizando estoque e preços de todos os produtos em uma única operação.
Dicas
- Antes de ativar a integração, confirme que o catálogo da sua loja e o do Ninox estão alinhados em SKU, preço e estoque. Diferenças nesses campos geram divergências assim que a sincronização é ligada.
- Uma vez integrado, não edite preços nem estoque pelo VendasxAtacado. Faça as alterações apenas no Ninox para que suas edições não sejam sobrescritas pela próxima sincronização.
- Verifique se o token da API é válido e está vigente. Um token vencido interromperá toda a sincronização de pedidos, estoque e preços. Use o botão Verificar Configuração após qualquer alteração.
- Certifique-se de que as condições fiscais dos seus clientes estejam corretamente configuradas no VendasxAtacado. Um mapeamento incorreto pode gerar problemas de faturação no Ninox.
- Se você tem produtos com variantes de tamanho e cor, verifique que os códigos no formato
articuloId!talleId!colorIdcoincidam entre ambos os sistemas para evitar desajustes de estoque. - Guarde a referência de fatura do Ninox que é armazenada em cada pedido. Esta referência é fundamental para a rastreabilidade e a resolução de problemas entre sistemas.
- Revise o registro de erros periodicamente. Um pedido que não chega ao Ninox pode atrasar a faturação e o despacho de mercadoria.
- Antes de cancelar um pedido que já foi enviado ao Ninox, verifique se o cancelamento é possível conforme as políticas do seu negócio e o estado do pedido no ERP.