ERP: DUX Software

DUX es un ERP argentino para PyMEs. Con la integración activa, los pedidos de tu tienda mayorista se registran solos en DUX, y el precio y el stock del depósito y la lista que elijas se actualizan solos en tu catálogo.

Paso a paso

1. Generá un Token API desde tu cuenta de DUX.
2. En VentasxMayor entrá a Configuración → ERP y elegí DUX.
3. Pegá el Token y tocá Buscar Información: se completan los desplegables de Empresa, Depósito y Lista con los datos reales de tu cuenta.
4. Elegí la Empresa y tocá Buscar Información Empresa para que se carguen las Sucursales.
5. Elegí Sucursal, Depósito y Lista.
6. Tocá Verificar Configuración. Chequea el token y que la empresa, el depósito y la lista existan en DUX.
7. Guardá. Con Token, Depósito y Lista completos aparece el bloque Soporte de Sincronización.

Empresa y Sucursal son números, no nombres. Los desplegables los completa DUX y guardan el identificador interno; no hay que escribir nada a mano.

Campos de configuración

• Token: token de la API de DUX. Sin él no funciona nada.
• Empresa: empresa de DUX a la que pertenecen los pedidos.
• Sucursal: sucursal o punto de venta donde se registran.
• Depósito: de qué depósito se lee el stock que ve tu tienda.
• Lista: qué lista de precios de DUX se importa.
• Código item Recargo (opcional): código de un artículo de DUX que se usa para mandar el recargo por forma de pago o envío como una línea extra del pedido. Si lo dejás vacío, el recargo no viaja como línea.
• Parche IVA (apagado por defecto): activalo sólo si los precios en DUX ya incluyen IVA. Al importar, los divide por 1,21; al mandar el pedido, multiplica por 1,21 el precio unitario y el recargo.
• Desactivar actualización de stock (apagado por defecto): deja de traer stock de DUX. El precio se sigue sincronizando.
• Agregar transporte y pago a la referencia (apagado por defecto): DUX no tiene campos propios para transporte, forma de pago ni observaciones. Con esta opción, esos tres datos se agregan al campo Referencia del pedido, después del VXM + número que usamos para identificarlo. El límite de DUX es de 200 caracteres: si no entran, se recorta el detalle, nunca el VXM + número.
• Catálogo de DUX sin agrupar (un artículo por variante) (apagado por defecto): activalo si en DUX cada color, talle o aroma es un artículo suelto con su propio código, en vez de una variante de un artículo padre. Ver la sección de variantes.

Qué sincroniza y en qué dirección

No hay que forzar nada para el uso diario. La pasada de cada 10 minutos trae únicamente los artículos que cambiaron en DUX en esa ventana; la pasada nocturna recorre el catálogo entero.

Del pedido viajan los datos del comprador, el detalle de artículos con cantidad, precio unitario y porcentaje de descuento, la provincia traducida a su código, y el recargo como línea extra si configuraste Código item Recargo.

Lo que NO viaja: el mínimo de compra y el bulto se administran en VentasxMayor y no se mandan a DUX. Tampoco los trae el feed de entrada, que sólo contiene precio y stock.

La sincronización nunca crea productos. Si un artículo existe en DUX y no en tu catálogo, se descarta. Cargalo primero en la tienda con el mismo código.

Productos con variantes (talles, colores)

Los códigos tienen que ser coherentes entre los dos sistemas. Hay tres modelos válidos:

1. Variantes en ambos lados. En DUX el artículo padre tiene un código alfanumérico (ABC-123) y cada variante un número interno. En la tienda, cargá el código del padre en el producto y el número de la variante en el código de cada opción.
2. Cada variante como producto individual en los dos lados. Un producto por combinación, con el mismo código de un lado y del otro.
3. Catálogo plano con códigos propios. Si en DUX cada variante es un artículo suelto pero vos las agrupaste como opciones de un producto en la tienda, activá Catálogo de DUX sin agrupar. Con la opción activa, el código que cargaste en cada opción viaja al pedido tal cual, como código de artículo.

El interruptor existe porque un código de opción formado sólo por números es ambiguo: sin él se interpreta como el número interno de una variante de DUX, y DUX rechaza el pedido entero. Si tu catálogo es plano y tus códigos son numéricos, activalo.

Si algo no aparece o no sincroniza

• "No se estan actualizando los precios y el stock salvo cuando fuerzo la actualización." La pasada de cada 10 minutos sólo ve lo que DUX marcó como modificado en esa ventana. Si en DUX el cambio no quedó registrado como modificación reciente, entra recién en la pasada nocturna o cuando tocás Actualizar todos los productos.
• Productos con el triángulo "No sincronizado". Además de las causas generales, DUX tiene una propia: los artículos sin precio en la lista configurada se descartan del listado, así que un artículo que existe en DUX pero no tiene precio cargado en esa lista cuenta como no encontrado. Revisá la lista que elegiste. Ver el detalle del aviso en el artículo de Integración con ERP.
• Medio catálogo se marcó de golpe como no sincronizado. Eso es un listado que DUX devolvió a medias. La pasada completa detecta ese caso: aplica igual los precios y el stock de lo que sí llegó, y después reporta el error en lugar de marcar productos. Volvé a correrla más tarde.
• DUX rechazó el pedido entero. Casi siempre es el modelo de variantes. Revisá la sección de arriba y, si tu catálogo en DUX es plano con códigos numéricos, activá Catálogo de DUX sin agrupar.
• "¿Se pueden crear automáticamente los productos creados en DUX?" No. El producto tiene que existir antes en la tienda con el código correcto.
• El transporte no figura en el remito. Activá Agregar transporte y pago a la referencia.
• Un pedido no llegó. Si DUX respondió que se excedió el límite de pedidos por minuto, reintentamos automáticamente hasta 5 veces, esperando cada vez un poco más (arranca en 5 segundos). DUX exige al menos 5 segundos entre pedidos y reinicia la espera ante cada exceso, por eso los reintentos son lentos a propósito. Si aun así falla, el error queda registrado en el pedido y en Actividad de la integración, con el botón Reintentar. No se envía ningún aviso por mail.
• Los precios llegan con o sin IVA de más. Revisá Parche IVA: activado sólo si en DUX los precios están cargados con IVA incluido.
• Sólo veo el stock de un depósito. Es el depósito que configuraste. Es el único que se lee.

Consejos

• Una vez activa la integración, gestioná precio y stock desde DUX. Cualquier cambio manual en la tienda se pisa en la próxima pasada, salvo el stock si activaste Desactivar actualización de stock.
• La pasada completa tarda: el catálogo se lee de a 50 artículos por página con 5 segundos de pausa entre páginas para respetar el límite de la API. Es normal.
• Si editás un pedido y lo guardás, se reenvía a DUX. Tenelo en cuenta para no duplicar.