Integrá tu tienda mayorista en VentasxMayor con el ERP Ninox para sincronizar catálogo, precios, stock y pedidos de forma automática. Ninox administra tu inventario y facturación; VentasxMayor recibe el catálogo y le envía los pedidos mayoristas para facturar.
Cómo funciona
La integración sincroniza en dos direcciones:
- Ninox → VentasxMayor (catálogo): productos, variantes de talle y color, precio base, listas de precios, stock y categorías. Se actualiza de dos formas: con el botón Importar productos (tu tienda le consulta el catálogo a Ninox) y automáticamente cuando Ninox le envía a la tienda cambios de stock y precios.
- VentasxMayor → Ninox (pedidos): cada pedido mayorista confirmado en la tienda se envía a Ninox para su facturación. Las cancelaciones de pedidos ya enviados también se comunican a Ninox.
Una vez integrado, el catálogo se administra desde Ninox. Cualquier cambio de precio o stock que hagas a mano en VentasxMayor se pisa en la próxima sincronización.
Configuración inicial — checklist
1. Token
El token lo provee Ninox al dar de alta la integración. En el menú lateral andá a Configuración → ERP, seleccioná Ninox, pegá el token y usá el botón Verificar Configuración para confirmar que la conexión funciona antes de operar.
- Hay un solo token válido a la vez. Si Ninox genera un token nuevo, el anterior deja de funcionar. Guardar un token viejo rompe toda la integración: los pedidos rebotan con el error "No se encontró la integración".
- Cuidado con las pestañas viejas del navegador. Si tenés la página de configuración abierta desde antes y guardás cualquier cambio, se vuelve a grabar el token viejo que esa pestaña tenía cargado y se pisa el token bueno. Si dos personas administran la configuración, coordinen quién carga el token.
2. Listas de precios (importante — hacelo ANTES de importar)
Ninox maneja hasta 5 precios por artículo. El mapeo hacia la tienda es fijo:
| Precio en Ninox | Destino en VentasxMayor |
|---|---|
| Precio 1 | Precio base del producto (el que se muestra en la web). No necesita una lista propia. |
| 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 |
Antes de la primera importación, creá en Configuración → Listas de precios una lista por cada precio que uses en Ninox. El código debe ser exactamente L2, L3, L4 o L5; el nombre es libre y conviene ponerle el nombre real (ej. "Premium", "Oferta", "2da selección").
- Si algún artículo en Ninox tiene cargado un precio N y la lista
LNno existe, la importación falla completa con el error "Lista de precios no encontrada LN" y no se actualiza nada. - No borres una lista
LNsi en Ninox siguen cargando ese precio: la próxima importación va a volver a fallar.
3. Compradores con lista asignada
Para que un comprador mayorista vea los precios de su lista (por ejemplo, clientes premium con el Precio 2), asignale la lista en su ficha de cliente. Las listas que no se asignan a nadie no se muestran en la web (útil para precios internos como venta presencial o facturación).
Importación de productos
El botón Importar productos trae el catálogo completo desde Ninox y actualiza: nombre, descripción, precio base, precios por lista, categorías (los tags de Ninox), variantes de talle y color y el stock de cada variante. Las variantes sin stock quedan deshabilitadas automáticamente.
- Códigos de producto: sin variantes se usa el número de artículo de Ninox; con variantes el formato es
articulo!talle!color. No los edites manualmente: son la clave con la que Ninox identifica cada ítem de los pedidos. - Límite de la API de Ninox: 1 consulta cada 10 minutos. Si reintentás antes, la importación no hace nada. Ante cualquier reintento, esperá 10 minutos.
- El catálogo se administra en Ninox. Cualquier cambio de precio o stock hecho a mano en la tienda se pisa en la próxima sincronización.
Pedidos (VentasxMayor → Ninox)
Cada pedido mayorista confirmado se envía a Ninox con:
- Datos del comprador según su condición fiscal: Consumidor Final envía DNI; Responsable Inscripto, Monotributo y Exento envían CUIT.
- Detalle de artículos con talle, color y cantidades.
- Subtotal, descuento total, recargo, envío y total como campos separados.
- Direcciones de envío y facturación, y observaciones del pedido.
Si Ninox acepta el pedido, devuelve el número de factura, que queda guardado en el pedido como referencia del ERP. Esta referencia vincula cada pedido con su registro en Ninox para seguimiento y trazabilidad.
Validación de stock: Ninox valida el stock al recibir el pedido. Si no hay stock suficiente responde "No hay stock suficiente" con el detalle de los artículos faltantes y no genera la factura. El pedido queda en la tienda con el error registrado. Para resolverlo: actualizá el stock (Importar productos), reponé en Ninox o ajustá el pedido con el comprador, y reenvialo desde el panel.
Cancelaciones: las cancelaciones de pedidos ya enviados se comunican a Ninox usando la referencia de factura almacenada.
Mapeo de condiciones fiscales
Las condiciones fiscales de los compradores se mapean a códigos numéricos de Ninox:
- 1 = Consumidor Final (CF) — se envía el DNI
- 2 = Responsable Inscripto (RI) — se envía el CUIT
- 3 = Monotributo — se envía el CUIT
- 4 = Exento — se envía el CUIT
Un mapeo incorrecto genera problemas de facturación en Ninox, así que verificá que la condición fiscal de cada comprador esté bien cargada en VentasxMayor.
Errores comunes y soluciones
| Mensaje / síntoma | Causa | Solución |
|---|---|---|
| "No se encontró la integración" | El token guardado no es el vigente en Ninox (se regeneró o se pisó con uno viejo). | 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 cargado en Ninox y no existe la lista con código LN. | Creá la lista (código exacto LN) y reimportá. Consejo: creá de una vez todas las listas que uses para no descubrirlas de a una (cada reintento espera 10 min). |
| "No hay stock suficiente" al enviar un pedido | El stock real en Ninox es menor al pedido (típico cuando el stock de la tienda quedó desactualizado). | Importá productos para sincronizar stock; reponé o ajustá el pedido; reenvialo. |
| Importar productos "no hace nada" | Límite de la API: 1 consulta cada 10 minutos. | Esperá 10 minutos y reintentá. |
| Precios/stock desactualizados hace días | Token pisado o inválido: Ninox no puede enviarle actualizaciones a la tienda. | Verificá el token; luego importá productos para ponerte al día. |
Campos de configuración
- Token (texto, obligatorio): token de autenticación de la API de Ninox. Valida cada solicitud enviada al sistema y lo provee Ninox al dar de alta la integración. Después de pegarlo, usá Verificar Configuración.
Consejos
- Creá las listas de precios
L2–L5que uses en Ninox antes de la primera importación. Es la causa más común de fallas al arrancar. - Un solo token válido a la vez: coordiná quién lo carga y cerrá las pestañas viejas de configuración para no pisar el token bueno.
- No edites precios ni stock desde VentasxMayor una vez integrado. Hacelo solo desde Ninox; la próxima sincronización pisa tus cambios.
- Respetá el límite de 1 consulta cada 10 minutos al importar productos. Si "no hace nada", esperá y reintentá.
- Ante un pedido que no llega a Ninox, revisá primero el registro de errores del pedido: ahí queda el estado y la respuesta de Ninox.
- Guardá la referencia de factura que queda en cada pedido: es clave para la trazabilidad entre ambos sistemas.