Integrá tu tienda mayorista en VentasxMayor con el ERP DUX Software para sincronizar pedidos, stock y precios de forma automática. DUX es un sistema de gestión empresarial que permite administrar múltiples sucursales y depósitos, ideal para operaciones mayoristas con inventario distribuido.
Cómo funciona
Desde Integraciones > ERP seleccioná DUX y completá 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 depósito y lista configurados se reflejan en tu catálogo online.
La integración requiere que configures la empresa, sucursal, depósito y lista de precios específicos que querés utilizar. Esto permite un control granular sobre qué inventario y precios se muestran en tu tienda online.
Requisitos previos
- Plan con Token API en DUX: necesitás un plan de DUX que permita generar un Token API. Lo verificás desde tu cuenta de DUX en Configuración > Empresa > API. Sin un token válido la integración no puede operar.
- Códigos coincidentes: los códigos (SKU) de tus productos en VxM deben coincidir exactamente con los códigos cargados en DUX. Si no coinciden, los pedidos no podrán registrarse en DUX y la sincronización de stock/precios fallará para esos productos.
Campos de configuración
- Token (texto, obligatorio): token de autenticación de la API de DUX. Se utiliza para validar cada solicitud enviada al sistema. Generalo desde el panel de DUX (Configuración > Empresa > API).
- Empresa (selección, obligatorio): empresa dentro de DUX a la que pertenecen los pedidos. Si gestionás múltiples empresas en el mismo sistema DUX, este campo determina cuál se usa para la sincronización. Si tu token es válido el listado se completa automáticamente al hacer clic en Buscar Información.
- Sucursal (selección, obligatorio): sucursal o punto de venta donde se procesan los pedidos. El listado se completa automáticamente al hacer clic en Buscar Información Empresa.
- Depósito (selección, obligatorio): depósito del cual se descuenta el stock. Especifica de qué depósito se toman los niveles de stock para tu tienda. Es fundamental si tu empresa tiene múltiples depósitos y querés mostrar el stock de uno en particular.
- Lista (selección, obligatorio): lista de precios a utilizar para la sincronización. Determina qué lista de precios se usa para importar los precios mayoristas a tu tienda online.
- Código item Recargo (texto, opcional): código de producto en DUX que se utiliza para registrar recargos. Cuando un pedido incluye un recargo (por ejemplo, por pago con tarjeta o financiación), se agrega como un ítem separado en el pedido del ERP usando este código. Si no lo configurás, los recargos no se enviarán como línea adicional.
- Parche IVA (interruptor, por defecto: desactivado): activalo si los precios cargados en DUX incluyen IVA. Cuando está activado, al importar precios desde DUX el sistema los divide por 1,21 para obtener el precio base sin impuesto, y al enviar pedidos a DUX multiplica los precios por 1,21 para que vuelvan a incluir IVA. Dejalo desactivado si los precios en DUX ya están sin IVA.
- Desactivar actualización de stock (interruptor, por defecto: desactivado): cuando está activado, no se sincroniza el stock desde DUX. Útil si querés gestionar el stock manualmente en VxM y solo usar DUX para precios y pedidos.
Buscar Información y Verificar Configuración
Una vez ingresado el token, dispones de dos acciones:
- Buscar Información: consulta a DUX y autocompleta los desplegables de Empresa, Depósito y Lista de precios con los nombres reales de tu cuenta. Repetí la acción Buscar Información Empresa después de elegir empresa para que se carguen las sucursales correspondientes.
- Verificar Configuración: prueba la conexión y revisa que la empresa, depósito y lista seleccionados existan en DUX. Reporta errores o advertencias específicas (token inválido, depósito no encontrado, lista no configurada, etc.) para que puedas corregirlos antes de operar.
Productos con variantes (talles, colores)
La configuración del producto debe ser coherente entre DUX y VxM. Hay dos formas correctas de cargar variantes:
- Producto con variantes en ambos lados: cuando un producto en DUX tiene variantes, DUX asigna un código alfanumérico al producto principal (ej:
ABC-123) y un código numérico a cada variante (ej:10para el talle S). En VxM, ingresá el código alfanumérico del producto principal enproducto/codigoy el código numérico específico de cada variante enopcion/codigo. Solo así DUX podrá identificar la variante exacta de cada línea del pedido. - Cada variante como producto individual: si en DUX cargaste cada combinación de variante como un producto separado, hacé lo mismo en VxM y asegurate de que cada código individual en VxM coincida exactamente con el código en DUX.
No mezcles enfoques: no podés crear un producto con variantes en VxM si en DUX está cargado como producto individual sin variantes. Si los códigos no coinciden, el pedido se rechaza.
Qué se sincroniza
Pedidos (VentasxMayor → DUX)
Cada pedido confirmado en tu tienda se envía automáticamente a DUX. Si editás un pedido y guardás los cambios, el pedido se vuelve a enviar a DUX con la información actualizada. El pedido incluye:
- Datos completos del comprador (razón social, CUIT, dirección, condición fiscal)
- Detalle de cada producto con cantidades, precios unitarios y porcentaje de descuento
- Mapeo de provincia y ciudad a códigos ISO correspondientes
- Recargos como ítem separado (si Código item Recargo está configurado)
Stock (DUX → VentasxMayor)
Los niveles de inventario se importan desde el depósito configurado en DUX. La sincronización incluye:
- Stock por producto, incluyendo variantes de talle y color
- Procesamiento paginado (50 productos por página) para catálogos grandes
- Pausa de 5 segundos entre páginas para respetar los límites de la API
Si el interruptor Desactivar actualización de stock está activado, esta sincronización se omite.
Precios (DUX → VentasxMayor)
Los precios se importan desde la lista de precios configurada. Si el interruptor Parche IVA está activado, los precios se dividen por 1,21 antes de guardarse para obtener el valor base.
Comportamiento de la sincronización
Envío de pedidos
Los pedidos se envían mediante una solicitud POST al endpoint de nuevo pedido de DUX. El sistema mapea automáticamente las provincias y ciudades a sus códigos ISO correspondientes para cumplir con los requisitos de formato del ERP. Este mapeo se mantiene en memoria para optimizar el rendimiento en pedidos sucesivos.
Si el pedido incluye un recargo y el campo Código item Recargo está configurado, el monto del recargo se agrega como una línea de producto adicional en el pedido, usando ese código.
Sincronización de stock y precios
El stock y los precios se obtienen mediante solicitudes GET paginadas, procesando 50 productos por página. Entre cada página hay una pausa de 5 segundos para respetar los límites de velocidad de la API de DUX y evitar bloqueos.
Los productos con variantes de talle y color se sincronizan individualmente, manteniendo el seguimiento de cada combinación disponible.
Cálculo de IVA
El interruptor Parche IVA indica si los precios en DUX incluyen IVA:
- Activado: al importar precios desde DUX se dividen por 1,21 (se quita el 21% para obtener el precio base). Al enviar pedidos a DUX, los precios unitarios y los recargos se multiplican por 1,21 (se vuelve a agregar el IVA al monto enviado).
- Desactivado: los precios se importan y envían sin transformación. Usalo cuando los precios en DUX ya están sin IVA.
Reintentos al enviar pedidos
Si DUX responde con un código 429 (límite de velocidad excedido) al recibir un pedido, el sistema reintenta automáticamente hasta 5 veces con un intervalo de 1 segundo. Si el límite persiste, el pedido queda registrado como fallido y se notifica al equipo de soporte.
Sincronización completa manual
Una vez completados los campos de Token, Depósito y Lista, aparece la acción Actualizar todos los productos dentro del bloque "Soporte de Sincronización". Esta acción dispara una sincronización completa: se actualizan precios, stock y datos de todos los productos desde DUX. El proceso puede tomar varios minutos por la paginación y las pausas entre páginas, y no se puede interrumpir. Pedí confirmación antes de ejecutar porque puede sobrescribir cambios locales.
Conviene ejecutarla después de cambios masivos en el ERP (actualización de lista de precios, ingreso de mercadería, cambio de depósito) para verificar que los datos se reflejan correctamente.
Consejos
- Verificá que el token de API sea válido y esté vigente. Un token vencido detiene toda la sincronización; usá Verificar Configuración ante cualquier duda.
- Una vez activa la integración, gestioná precios y stock únicamente desde DUX. Cualquier cambio manual en VxM será sobrescrito en la próxima sincronización (a menos que Desactivar actualización de stock esté activado para el caso del stock).
- Asegurate de que cada SKU exista en DUX antes de cargar el producto en VxM. Un código inexistente en DUX provoca el rechazo del pedido.
- Configurá el campo Código item Recargo si tu negocio aplica recargos por forma de pago. Sin este código, los recargos no aparecerán como línea separada en el ERP y podrías perder trazabilidad.
- Tené en cuenta el Parche IVA: activalo solo si en DUX los precios están cargados con IVA incluido. Si los cargás sin IVA, dejalo desactivado para evitar dividir por 1,21 erróneamente.
- Elegí cuidadosamente el depósito a sincronizar. Si tenés varios depósitos, solo el stock del depósito configurado se mostrará en tu tienda online. Usá el depósito que corresponda a tu operación de despacho mayorista.
- La sincronización de stock puede tardar más con catálogos grandes debido a la paginación y las pausas entre páginas. Esto es normal y necesario para respetar los límites de la API.
- Si modificás un pedido y lo guardás, se reenvía a DUX con los cambios. Tené esto en cuenta para no generar duplicados o inconsistencias en el ERP.