VentasxMayor sincroniza cada pedido con el ERP del negocio mayorista para que la operación quede reflejada automáticamente en el sistema de gestión: stock, precios, comprobantes, cuenta corriente. La integración corre por API y mantiene un log detallado de cada intento, con la posibilidad de reintentar manualmente cuando algo falla.
ERPs soportados
La plataforma tiene integración nativa con ocho ERPs, cada uno con su propio doc de configuración:
- Contabilium — sync API directa.
- Dragonfish — vía Dragonfish Bridge (aplicación de escritorio que conecta el ERP local con la plataforma).
- DUX Software — sync API directa.
- Salesforce / Virtual Seller — sync API directa.
- Ninox — sync API directa.
- NonSistemas — sync API directa.
- Acqua — sync API directa.
- SaaS UE — sync API directa.
La elección del ERP se configura en Configuración → Integraciones → ERP y los detalles de cada uno (campos, qué se sincroniza, comportamiento) están en sus secciones específicas.
Estados de sincronización
Cada vez que la plataforma intenta enviar o recibir información al ERP, queda un registro (un "ERP log") con un estado:
- OK (✅ verde) — la operación se completó exitosamente y el ERP la confirmó. En el código corresponde a
:success. - ERROR (❌ rojo) — la operación falló. La plataforma muestra el error en el log y habilita el botón "Reintentar".
- PENDIENTE (🟡 amarillo) — la operación se envió pero todavía no llegó la respuesta del ERP. Se resuelve a OK o ERROR cuando llega la confirmación.
En el listado de pedidos, la columna ERP muestra el estado del último log de cada pedido. En el listado, los pedidos con error suelen subirse al tope con un indicador visual rojo para que el equipo los priorice.
Pantalla de logs ERP del pedido
Desde el detalle de un pedido se accede a Logs ERP, que lista cada intento de sincronización con:
- Estado (Exitoso / Error / Pendiente) con su color correspondiente.
- Tipo de ERP (Contabilium, DUX, etc.).
- Operación que se ejecutó (por ejemplo: crear pedido, actualizar stock).
- ERP id — el identificador que asignó el ERP al recurso, si está disponible.
- Fecha enviada y duración (en milisegundos; si supera los 5000 ms se marca en rojo).
- Request — el payload JSON que la plataforma envió al ERP, expandible y formateado.
- Response — la respuesta que devolvió el ERP, expandible y formateada. En errores se muestra en rojo.
Cada log tiene un toggle para expandir/colapsar el detalle. Los logs con estado Error muestran un botón Reintentar que dispara nuevamente la operación; útil después de corregir un dato en el ERP (un código de producto faltante, un cliente no dado de alta, una credencial vencida).
Acciones disponibles
- Ver logs ERP del pedido: lista cronológica de cada intento de sync con request/response detallado.
- Expandir/colapsar log: muestra el JSON completo del request y la respuesta del ERP.
- Reintentar sincronización: relanza la operación que falló desde un log con error, sin tener que editar el pedido.
- Ver estado en el listado: la columna ERP muestra OK / ERROR / PENDIENTE para identificar de un vistazo qué pedidos requieren atención.
Consejos
- Revisá el listado de pedidos con estado ERROR al menos una vez por día — en operaciones mayoristas con alto volumen, los errores acumulados generan diferencias de stock y problemas de cobranza con el ERP.
- Los errores más comunes son: producto no encontrado en el ERP (revisar SKU/código), comprador no dado de alta (sincronizarlo o darlo de alta primero en el ERP), credenciales vencidas (renovar token en la integración) y campos faltantes en el comprador (CUIT, condición fiscal).
- Antes de reintentar, abrí el log y revisá el response del ERP — el mensaje suele indicar exactamente qué corregir.
- Si una sync demora más de 5 segundos de forma consistente, puede ser un problema de red o un ERP saturado. Coordiná horarios de sincronización masiva para evitar choques con otros procesos del ERP.
- Para integraciones que no tienen API directa (cuando un cliente usa un ERP no soportado), Dragonfish Bridge es el camino habitual: se instala en una PC del negocio y conecta el ERP local con la plataforma.
- Las exportaciones manuales de pedidos a Excel/CSV (que viven en el listado de pedidos) son distintas de la integración ERP — sirven cuando no hay sync automática o como respaldo. Algunas exportaciones a medida (formatos custom como Jesus Fernandez, Decimo Arte, Karina, etc.) están habilitadas solo para negocios específicos por configuración admin de la plataforma.