Integrá tu tienda mayorista en VentasxMayor con el ERP Ninox para sincronizar pedidos, stock y precios de forma automática. Ninox ofrece una solución de gestión empresarial con funcionalidades específicas para el mercado mayorista, incluyendo manejo de variantes de producto y condiciones fiscales argentinas.
Cómo funciona
Desde Integraciones API > Ninox seleccionás Ninox y completás los campos de configuración. Una vez conectado, los pedidos realizados en tu tienda mayorista se envían automáticamente al ERP, y los niveles de stock y precios del catálogo de Ninox se reflejan en tu tienda online.
La integración con Ninox es directa: solo necesitás un token de autenticación para comenzar a sincronizar.
Cómo activar la integración
La activación de Ninox no es autoservicio. El flujo es:
- Contactá al sector de ventas de Ninox para dar de alta la integración con VentasxMayor. Su equipo te enviará un token de API.
- Coordiná con tu ejecutivo de cuentas de VentasxMayor y entregale el token. El equipo de soporte realiza la activación inicial y deja la sincronización funcionando automáticamente.
- Antes de activar, alineá tu catálogo: cargá los productos en VentasxMayor con el mismo SKU, precio y stock que tienen en Ninox. Esto evita desajustes al iniciar la sincronización.
Una vez activa, la administración de precios y stock pasa a Ninox. Modificá los precios y stocks únicamente desde Ninox, ya que cualquier cambio que hagas en VentasxMayor será sobreescrito por la próxima sincronización.
Campos de configuración
- Token (texto, obligatorio): token de autenticación de la API de Ninox. Se utiliza para validar cada solicitud enviada al sistema. Lo provee el equipo de Ninox al dar de alta la integración.
Después de pegar el token, usá el botón Verificar Configuración para confirmar que la conexión funciona antes de operar.
Qué se sincroniza
Pedidos (VentasxMayor → Ninox)
Cada pedido confirmado en tu tienda se envía automáticamente a Ninox. El pedido incluye:
- Datos completos del comprador (razón social, CUIT, dirección, condición fiscal)
- Desglose detallado de cada producto con cantidades, precios unitarios y subtotales
- Condición fiscal del comprador mapeada al código correspondiente de Ninox
- Observaciones y condiciones de pago
- Subtotal, descuento total, recargo y costo de envío como campos separados del pedido
Al enviar un pedido exitosamente, Ninox devuelve un identificador de factura que queda almacenado como referencia del ERP en VentasxMayor. Esto permite vincular cada pedido con su registro correspondiente en Ninox para seguimiento y trazabilidad.
Stock (Ninox → VentasxMayor)
Los niveles de inventario se importan desde Ninox hacia tu tienda. La sincronización utiliza dos endpoints especializados:
- GetData: obtiene los datos base de productos y stock
- GetDataCurva: obtiene datos masivos de productos para sincronización de catálogos grandes
Ninox también puede empujar actualizaciones a VentasxMayor mediante un webhook autenticado con el mismo token, lo que permite reflejar cambios de stock y precios casi en tiempo real.
Precios (Ninox → VentasxMayor)
Los precios se importan desde el catálogo de productos de Ninox. Los precios se actualizan junto con la sincronización de stock para mantener la coherencia entre inventario y precios en tu tienda mayorista.
Comportamiento de la sincronización
Envío de pedidos
Los pedidos se envían mediante una solicitud HTTP POST a la API de Ninox. La respuesta incluye un identificador de factura de Ninox que se almacena como referencia del ERP en VentasxMayor. Esta referencia permite rastrear cada pedido en ambos sistemas.
Cancelación de pedidos
Ninox soporta la cancelación de pedidos mediante un endpoint dedicado. Si un pedido necesita ser cancelado después de haber sido enviado al ERP, el sistema comunica la cancelación directamente a Ninox usando la referencia de factura almacenada.
Códigos de producto
Los productos sin variantes se identifican por su SKU numérico. Los productos con variantes utilizan el formato articuloId!talleId!colorId como código identificador. Este formato permite que Ninox identifique correctamente cada combinación de artículo, talle y color con su registro en el ERP.
Mapeo de condiciones fiscales
Las condiciones fiscales de los clientes se mapean a códigos numéricos de Ninox:
- 1 = Consumidor Final (CF)
- 2 = Responsable Inscripto (RI)
- 3 = Monotributo
- 4 = Exento
Para Consumidor Final se envía el DNI del cliente; para el resto se envía el CUIT. Este mapeo asegura que cada pedido llegue a Ninox con la condición fiscal correcta del comprador, lo cual es fundamental para la facturación y el cumplimiento impositivo.
Sincronización de stock masivo
La sincronización de stock utiliza los endpoints GetData y GetDataCurva para obtener datos de productos en bloque. Esto permite procesar catálogos grandes de forma eficiente, actualizando stock y precios de todos los productos en una sola operación.
Consejos
- Antes de activar la integración, verificá que el catálogo de tu tienda y el de Ninox estén alineados en SKU, precio y stock. Diferencias en estos campos generan desajustes apenas se enciende la sincronización.
- Una vez integrado, no edites precios ni stock desde VentasxMayor. Hacelo solo desde Ninox para evitar que tus cambios se pisen en la próxima sincronización.
- Verificá que el token de API sea válido y esté vigente. Un token vencido detendrá toda la sincronización de pedidos, stock y precios. Usá el botón Verificar Configuración después de cualquier cambio.
- Asegurate de que las condiciones fiscales de tus clientes estén correctamente configuradas en VentasxMayor. Un mapeo incorrecto puede generar problemas de facturación en Ninox.
- Si tenés productos con variantes de talle y color, verificá que los códigos en el formato
articuloId!talleId!colorIdcoincidan entre ambos sistemas para evitar desajustes de stock. - Guardá la referencia de factura de Ninox que se almacena en cada pedido. Esta referencia es clave para la trazabilidad y la resolución de problemas entre sistemas.
- Revisá el registro de errores periódicamente. Un pedido que no llega a Ninox puede retrasar la facturación y el despacho de mercadería.
- Antes de cancelar un pedido que ya fue enviado a Ninox, verificá que la cancelación sea posible según las políticas de tu negocio y el estado del pedido en el ERP.