Ficha técnica de la integración
| Qué | Dirección | Cuándo |
|---|---|---|
| Pedidos | Tienda → Dragonfish | Al confirmarse, y de nuevo si se edita y guarda; ante un conflicto se reintenta hasta cinco veces |
| Clientes | Tienda → Dragonfish | Si el comprador no existe, se da de alta antes de mandar el pedido |
| Precio y stock | Dragonfish → Tienda | Una vez por hora y con «Actualizar todos los productos»; en tiempo real con el sincronizador instalado en el servidor de Dragonfish |
| Listas de precios | Dragonfish → Tienda | Todas las listas que coincidan por código con las de la tienda, no solo la principal |
| Recargos y descuentos | Tienda → Dragonfish | Los recargos de Dragonfish viajan en cada pedido; los descuentos, como ítem negativo o prorrateados en el precio |
| Productos | No se crean | Un artículo que existe en Dragonfish y no en la tienda se descarta: se carga primero en la tienda, con códigos Articulo!Color!Talle para las variantes |
| Requisitos | Endpoint de la API publicado a internet, código de cliente y token provistos por Dragonfish; o la app Dragonfish Bridge en una computadora de la empresa si el servidor está detrás de un firewall. | |
| Costo | Incluida en el plan de VentasxMayor: sin módulo aparte ni cargo por la integración. | |
| Activación | Con soporte incluido; respuesta el mismo día hábil. | |
¿Qué ganás al integrar Dragonfish con tu tienda?
- Pedidos automáticos: Cada venta en tu tienda se envía directo a Dragonfish. Cero carga manual.
- Precios desde la Lista Principal: Los precios se sincronizan desde la lista que definas en Dragonfish. Tu tienda siempre refleja los valores correctos.
- Stock actualizado: El inventario se sincroniza cada hora o en tiempo real si instalás el sincronizador en tu servidor Dragonfish.
- Clientes automáticos: Si un comprador no existe en Dragonfish, el sistema lo crea automáticamente con los datos del pedido.
- Recargos soportados: Los recargos configurados en Dragonfish se envían correctamente en cada pedido.
¿Cómo funciona la integración?
Pedidos
- Cuando un cliente compra en tu tienda, el pedido se envía automáticamente a Dragonfish.
- Si el cliente no existe en Dragonfish, se crea automáticamente con los datos ingresados en el pedido.
- Si editás un pedido en tu tienda antes de que sea procesado en Dragonfish, los cambios se sincronizan automáticamente.
Stock
- El stock se gestiona exclusivamente en Dragonfish. Tu tienda se actualiza sola.
- Cada hora se consulta el API de Dragonfish y se actualizan los niveles de stock en tu tienda.
- Opcionalmente, podés instalar un sincronizador en tiempo real en tu servidor Dragonfish para que los cambios impacten al instante.
- No se parametrizan depósitos por defecto: se toma el stock tal cual lo entrega Dragonfish.
Precios
- Los precios se administran solo en Dragonfish y se sincronizan automáticamente con tu tienda desde la "Lista Principal".
- Si un comprador no tiene lista asignada, se le aplica la Lista Principal como referencia general.
- ⚠️ No modifiques precios directamente en la web después de activar la integración.
Descuentos
- El API de Dragonfish no soporta descuentos de forma nativa. Se pueden resolver de dos maneras:
- Ítem negativo: se agrega un ítem de descuento negativo dentro del pedido.
- Prorrateo: el descuento se distribuye proporcionalmente en el precio de cada producto.
Recargos
- Los recargos configurados en Dragonfish son soportados y se envían correctamente en los pedidos.
5 cosas que tenés que saber antes de empezar
- Los SKUs deben coincidir exactamente Al crear productos en tu tienda, usá exactamente el mismo SKU que tenés en Dragonfish. Esto es clave para que la sincronización de precios y stock funcione desde el día uno.
- Sincronización horaria por defecto Cada 1 hora se consulta el API de Dragonfish y se actualizan precios y stock en tu tienda online. Suficiente para la mayoría de los negocios mayoristas.
- Opción de sincronización en tiempo real Si necesitás que los cambios impacten al instante, podés instalar un programa de sincronización en tu servidor Dragonfish. Los cambios en precios y stock se reflejan de inmediato en tu tienda.
- Dragonfish manda: precios y stock solo se editan ahí Una vez activa la integración, los precios y el stock se modifican únicamente en Dragonfish. Los cambios se reflejan automáticamente en tu tienda.
- Sin depósitos parametrizados por defecto El conector toma el stock tal cual lo entrega Dragonfish. Si necesitás manejo por depósito, se evalúa caso por caso con nuestro equipo.
¿Cómo se activa?
La integración incluye soporte especializado: nos encargamos de todo el proceso de conexión, pruebas y puesta en marcha. Para conocer el costo, consultanos por WhatsApp.
Para activar, necesitás solicitar a Dragonfish tus credenciales de API (endpoint, Client ID y token). Nuestro equipo se encarga del resto.
Opciones de configuración
Al activar la integración, definimos junto a vos estos parámetros:
- ENDPOINT: La URL del servidor de Dragonfish.
- CLIENTE / TOKEN: Credenciales de acceso al API que debés solicitar a Dragonfish.
- LISTA DE PRECIOS PRINCIPAL: La lista que se utilizará como referencia general para sincronizar precios con tu tienda.
- SINCRONIZAR PRECIOS: Sí o No. Si elegís Sí, los precios se sincronizan automáticamente desde Dragonfish.
- SINCRONIZAR STOCK: Sí o No. Si elegís Sí, el stock se sincroniza automáticamente.
- MODO DE SINCRONIZACIÓN: Pull (cada hora) o Pull + Real-time (con sincronizador instalado en tu servidor).
- RECARGOS: Sí o No. Si elegís Sí, los recargos configurados en Dragonfish se envían en los pedidos.
- DESCUENTOS: Elegí el modo: ítem negativo, prorrateo en precios, o deshabilitado.
¿Todavía no tenés Dragonfish?
Conocé Dragonfish Color y Talle de Zoologic, el ERP diseñado para mayoristas de indumentaria y calzado:
Preguntas frecuentes
¿Cada cuánto se actualiza el stock desde Dragonfish?+
Cada hora por defecto, consultando la API de Dragonfish. Si hace falta que los cambios impacten al instante, se instala un sincronizador en tiempo real en el servidor de Dragonfish.
¿Qué pasa si el comprador no existe en Dragonfish?+
Se crea automáticamente con los datos del pedido. Los recargos configurados en Dragonfish se envían en cada pedido; los descuentos, que la API no soporta de forma nativa, se resuelven como ítem negativo o prorrateados en el precio de cada producto.
¿Qué credenciales hacen falta?+
El endpoint del servidor, el Client ID y el token de la API, que se solicitan a Dragonfish. Con eso, nuestro equipo define la lista de precios principal, el modo de sincronización y el tratamiento de recargos y descuentos.
¿Cuánto cuesta la integración?+
Nada aparte del plan: la integración con el ERP está incluida en el precio fijo mensual de VentasxMayor, sin módulo ni cargo adicional.
¿Cuánto tarda la activación?+
Con las credenciales a mano, la configuración se hace desde el panel y se verifica con «Verificar configuración»; nuestro equipo acompaña la activación y responde el mismo día hábil.
¿Funciona con varios depósitos?+
Por defecto no se parametrizan depósitos: la tienda toma el stock tal como lo entrega Dragonfish. Las listas de precios sí se sincronizan todas, emparejadas por código con las listas de la tienda.
