Ninox administra tu inventario y tu facturación. Es la única integración que trae el catálogo completo desde el ERP: productos, variantes, precios y stock. Los pedidos de la tienda viajan a Ninox para facturarse.
Paso a paso
- Pedile el token a Ninox al dar de alta la integración.
- En VentasxMayor entrá a Configuración → ERP, elegí Ninox y pegá el Token.
- Tocá Verificar Configuración para confirmar la conexión.
- Antes de importar, creá en Configuración → Listas de precios una lista por cada precio que uses en Ninox, con el código exacto
L2,L3,L4oL5. Ver la tabla de abajo. - Pasale a tu soporte de Ninox los tres valores de la caja Datos para configurar el webhook para que activen el envío automático de stock y precios.
- Tocá Importar Productos Ninox para traer el catálogo.
Hay un solo token válido a la vez. Si Ninox genera uno nuevo, el anterior deja de funcionar y los pedidos rebotan con "No se encontró la integración". Cuidado también con las pestañas viejas del navegador: si guardás cualquier cambio desde una pestaña abierta de antes, se vuelve a grabar el token que esa pestaña tenía cargado y se pisa el bueno.
Listas de precios (hacelo antes de importar)
Ninox maneja hasta 5 precios por artículo. El mapeo es fijo:
| Precio en Ninox | Destino en VentasxMayor |
|---|---|
| Precio 1 | Precio del producto (el que ve el comprador) |
| Precio 2 | Lista con código L2 |
| Precio 3 | Lista con código L3 |
| Precio 4 | Lista con código L4 |
| Precio 5 | Lista con código L5 |
El código tiene que ser exactamente LN; el nombre es libre. Si un artículo de Ninox tiene cargado el precio N y la lista LN no existe, la importación falla entera con el error "Lista de precios no encontrada LN" y no se actualiza nada. Creá de una vez todas las que uses.
Qué sincroniza y en qué dirección
| Qué | Dirección | Cuándo |
|---|---|---|
| Catálogo completo: nombre, descripción, precios por lista, variantes y stock | Ninox → Tienda | Al tocar Importar Productos Ninox |
| Precio y stock | Ninox → Tienda | Cuando Ninox envía por webhook |
| Pedidos y cancelaciones | Tienda → Ninox | Al confirmarse y al anularse |
Las categorías no se importan por defecto. Los tags de Ninox sólo traen la categoría raíz, así que importarlas pisaría las subcategorías que cargaste a mano producto por producto. Si de verdad querés que Ninox mande las categorías, marcá Actualizar categorías desde el archivo/ERP antes de importar — te va a avisar que las categorías existentes se reemplazan.
La importación oculta lo que no vino en el listado. Los productos de tu catálogo que Ninox no envía quedan sin stock y ocultos en la tienda. No se borran, y vuelven a mostrarse solos si reaparecen en una importación posterior. Si después de importar te desaparecieron productos, es esto: revisá si siguen cargados en Ninox.
Códigos de producto: sin variantes, el código de la opción es el número de artículo de Ninox seguido de dos signos de admiración (123456!!). Con variantes, el formato es artículo!talle!color usando los identificadores internos de Ninox. No los edites a mano: son la clave con la que Ninox reconoce cada ítem del pedido.
Precios: Ninox no maneja precios por variante, así que el precio completo queda cargado en cada opción del producto y el precio del producto padre queda en cero. Es lo esperado y no cambia lo que ve el comprador.
Pedidos: viajan los datos del comprador según su condición fiscal, el detalle con talle, color y cantidades, el subtotal, el descuento total, el recargo, el envío y el total como campos separados, más las direcciones y las observaciones. Si Ninox lo acepta, devuelve el número de factura, que queda guardado en el pedido como referencia del ERP y es lo que se usa después para cancelarlo.
Condiciones fiscales: 1 Consumidor Final (se envía DNI), 2 Responsable Inscripto, 3 Monotributo y 4 Exento (los tres envían CUIT). Un mapeo mal cargado genera problemas de facturación del lado de Ninox.
Si algo no aparece o no sincroniza
| Mensaje o síntoma | Causa | Solución |
|---|---|---|
| "No se encontró la integración" | El token guardado no es el vigente en Ninox. | Cargá el token actual, usá Verificar Configuración y reenviá los pedidos que rebotaron. |
| "Lista de precios no encontrada LN" | Hay artículos con el precio N y no existe la lista con código LN. | Creá la lista con el código exacto y reimportá. |
| "No hay stock suficiente" al enviar un pedido | Ninox valida el stock al recibir y el real es menor al pedido. | Importá productos para actualizar el stock, reponé en Ninox o ajustá el pedido, y reenvialo. |
| Precios o stock viejos hace días | El webhook nunca se configuró del lado de Ninox, o el token quedó pisado. | Mirá Actividad de la integración: si el Último push recibido dice "Nunca", pasale los Datos para configurar el webhook a Ninox. Si aparece "Push rechazado: el token no coincide", actualizá el token de los dos lados. |
| Productos que desaparecieron de la tienda | No vinieron en la última importación y quedaron ocultos. | Verificá que sigan cargados en Ninox y volvé a importar. |
| Las subcategorías se borraron | Se importó con Actualizar categorías desde el archivo/ERP marcado. | Volvé a cargar las subcategorías y dejá la casilla sin marcar en las próximas importaciones. |
Consejos
- Al dar de alta la integración, no des por hecho que el webhook quedó configurado. Pedile a Ninox que dispare una actualización de prueba y mirá el panel de actividad hasta ver el primer push recibido.
- Un solo token válido a la vez: coordiná quién lo carga y cerrá las pestañas viejas de configuración.
- Una vez integrado, no edites precios ni stock desde la tienda. La próxima sincronización los pisa.
- Guardá la referencia de factura que queda en cada pedido: es el vínculo entre los dos sistemas.