Integra tu tienda mayorista en VentasxMayor con el ERP Dragonfish para sincronizar pedidos, stock, precios y clientes de forma automática. Dragonfish es un sistema de gestión ampliamente utilizado en el mercado mayorista argentino, y esta integración permite que tu operación online y tu sistema de gestión trabajen en sincronia sin intervención manual.
Cómo funciona
Desde Integraciones > ERP seleccioná Dragonfish 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 ERP se reflejan en tu catálogo online.
Además de la integración estándar, VentasxMayor ofrece una aplicación de escritorio complementaria llamada Dragonfish Bridge (construida con Tauri) que proporciona sincronización bidireccional en tiempo real. Esta aplicación corre en tu computadora y mantiene una sincronización continua entre Dragonfish y tu tienda mayorista, ideal para operaciones que requieren actualizaciones inmediatas.
Campos de configuración
- Endpoint (texto, obligatorio): URL del endpoint de la API de Dragonfish. Debe incluir el protocolo y el puerto. Ejemplo:
http://181.13.215.214:8015/api.Dragonfish/. Asegurate de incluir la barra final. - Cliente (texto, obligatorio): identificador de cliente proporcionado por Dragonfish. Este código identifica tu empresa dentro del sistema.
- Token (texto, obligatorio): token JWT de autenticación. Se utiliza para validar cada solicitud enviada a la API de Dragonfish. Solicitalo al soporte técnico de Dragonfish o generalo desde su panel de administración.
- Lista (texto, opcional): nombre o código de la lista de precios a utilizar. Si tu empresa maneja múltiples listas de precios mayoristas (por ejemplo, por canal, región o categoría de cliente), indicá aquí cuál querés usar para tu tienda online. El sistema busca la lista por nombre para obtener el código correspondiente.
Qué se sincroniza
Pedidos (VentasxMayor → Dragonfish)
Cada pedido confirmado en tu tienda se envía automáticamente a Dragonfish. El pedido incluye:
- Datos completos del comprador (razón social, CUIT, dirección, condición fiscal)
- Detalle de productos con cantidades, precios unitarios y subtotales
- Condiciones de pago y observaciones
Si el cliente no existe en Dragonfish, se crea automáticamente antes de enviar el pedido (ver sección de clientes más abajo).
Stock (Dragonfish → VentasxMayor)
Los niveles de inventario se importan desde Dragonfish hacia tu tienda. La sincronización consulta el endpoint de stock y precios con paginación para procesar catálogos grandes de forma eficiente.
Precios (Dragonfish → VentasxMayor)
Los precios se importan desde la lista de precios configurada. Si configuraste el campo Lista, el sistema busca el nombre de la lista para obtener el código interno y trae los precios correspondientes. Esto permite mantener precios diferenciados para tu canal mayorista online.
Clientes (VentasxMayor → Dragonfish)
Cuando un cliente realiza un pedido y no existe en Dragonfish, el sistema lo crea automáticamente. El proceso incluye:
- Validación de datos fiscales (CUIT, condición ante AFIP)
- Envío de la información completa del cliente (razón social, dirección, contacto)
- Asociación del cliente creado con el pedido
Comportamiento de la sincronización
Envío de pedidos
Los pedidos se envían mediante una solicitud POST al endpoint /Pedido/ de la API de Dragonfish. El sistema incluye toda la información necesaria para que el pedido quede registrado en el ERP sin necesidad de carga manual.
Sincronización de stock y precios
El stock y los precios se obtienen del endpoint ConsultaStockYPrecios de Dragonfish mediante solicitudes GET con paginación. Esto permite procesar catálogos extensos sin sobrecargar la conexión.
Creación automática de clientes
Los clientes se crean mediante una solicitud POST al endpoint /Cliente/. El sistema valida los datos fiscales antes del envío para asegurar que el registro sea aceptado por Dragonfish.
Códigos de producto
Los productos con variantes (color, talle) utilizan el formato Articulo!Color!Talle como código identificador. Este formato permite que Dragonfish asocie correctamente cada variante del producto con su registro en el ERP.
Reintentos automáticos
Si una sincronización falla con un error de conflicto (código 409), el sistema reintenta automáticamente hasta 5 veces con un intervalo de 1 segundo entre intentos. Esto cubre situaciones temporales de concurrencia en el ERP.
Notificaciones de error
Cuando se producen errores persistentes de sincronización, el sistema envía notificaciones por correo electrónico para que puedas actuar rápidamente.
Búsqueda de lista de precios
El sistema busca la lista de precios por nombre para obtener el código interno correspondiente. Esto facilita la configuración ya que no necesitás conocer el código numérico de la lista.
Consejos
- Verificá que el endpoint de la API sea accesible desde internet. Si tu instalación de Dragonfish está detrás de un firewall, asegurate de que el puerto esté abierto y redireccionado correctamente.
- Mantené el token JWT actualizado. Si el token vence, la sincronización se detendrá y los pedidos no llegarán al ERP.
- Si usás la aplicación Dragonfish Bridge, mantenela actualizada para asegurar compatibilidad con las últimas versiones de la API. La aplicación corre en tu escritorio y debe estar abierta para que la sincronización en tiempo real funcione.
- Realizá una sincronización manual después de cambios masivos en el ERP (como actualización de lista de precios o ingreso de mercadería) para verificar que todo se refleje correctamente en tu tienda.
- Si tenés productos con variantes de color y talle, asegurate de que los códigos en Dragonfish sigan el formato
Articulo!Color!Tallepara que la asociación sea correcta. - Revisá el registro de errores periódicamente. Un pedido que no llega a Dragonfish puede retrasar la preparación y el despacho de mercadería.
- Si configurás una lista de precios, usá el nombre exacto tal como aparece en Dragonfish para evitar errores de búsqueda.