Dragonfish es el ERP y punto de venta de Zoo Logic, muy usado en el mayorista argentino de indumentaria. Con la integración activa, los pedidos de tu tienda se registran solos en Dragonfish, y el stock y los precios de Dragonfish actualizan tu catálogo.
Paso a paso
- Pedile a Dragonfish el endpoint de la API, el código de cliente y el token.
- En VentasxMayor entrá a Configuración → ERP y elegí Dragonfish.
- Cargá el Endpoint con protocolo, puerto y barra final. Ejemplo:
http://181.13.215.214:8015/api.Dragonfish/. - Cargá el Cliente y el Token.
- Si usás una lista de precios específica, escribí su nombre exacto en Lista principal. La buscamos por nombre para obtener el código.
- Tocá Verificar Configuración.
- Guardá. Con Endpoint, Cliente y Token completos aparece el bloque Soporte de Sincronización.
Qué va en el campo "Cliente"
La ayuda de la pantalla dice "Código de cliente por defecto para los pedidos", y eso confunde. No es el código de un comprador tuyo. Es el identificador de tu base o empresa dentro de Dragonfish: viaja en cada llamada a la API como la cabecera IdCliente. Son valores cortos, tipo MAYORD o MITO. Si no sabés cuál es el tuyo, pedíselo a tu soporte de Dragonfish junto con el token.
Integración directa o Dragonfish Bridge
Son dos tarjetas distintas y excluyentes en el selector. Elegís una.
- Dragonfish (esta): nos conectamos por la API directamente contra tu instalación. Requiere que el endpoint esté publicado a internet, con el puerto abierto y redireccionado.
- Dragonfish Bridge: una app de escritorio que corre en tu computadora, se autentica con el token genérico de API y hace el trabajo al revés: la app consulta cada tanto qué pedidos hay pendientes, los marca como sincronizados y empuja stock y precios. No necesita exponer nada a internet, y tiene que quedar abierta mientras sincroniza. No es tiempo real ni corre además de la integración directa.
Si tu Dragonfish está detrás de un firewall que no podés abrir, el Bridge es el camino.
Qué sincroniza y en qué dirección
| Qué | Dirección | Cuándo |
|---|---|---|
| Pedidos | Tienda → Dragonfish | Al confirmarse, y de nuevo si editás y guardás el pedido |
| Clientes | Tienda → Dragonfish | Si el comprador no existe, se crea antes de mandar el pedido |
| Precio y stock | Dragonfish → Tienda | Automático una vez por hora, y con Actualizar todos los productos |
No hace falta forzar nada para el uso diario. La pasada horaria recorre el catálogo completo y además recalcula el aviso "No sincronizado" de cada producto.
Precios por lista. Dragonfish devuelve varias listas de precios por artículo y las guardamos todas contra las listas de tu negocio que coincidan por código, no sólo la que pusiste en Lista principal.
La sincronización nunca crea productos. Un artículo que existe en Dragonfish y no en tu catálogo se descarta. Cargalo primero en la tienda.
Códigos de variantes. Los productos con color y talle usan el formato Articulo!Color!Talle. Si tus códigos no siguen ese formato, la asociación no se hace.
Creación de clientes. Cuando un comprador nuevo hace su primer pedido, lo damos de alta en Dragonfish: se le quitan los guiones a la identificación y se le arma un código propio de hasta 10 caracteres. No hay validación fiscal contra AFIP; los datos viajan tal como estén cargados en la tienda, así que cargalos bien.
Si algo no aparece o no sincroniza
- Dejó de sincronizar de golpe. Lo más común es el token vencido o el endpoint inaccesible. Verificá desde afuera de tu red que el puerto responda, y usá Verificar Configuración.
- Un pedido no llegó. Ante un conflicto (error 409) reintentamos hasta 5 veces con un segundo de espera. Si el error persiste, queda registrado en el pedido, con el botón Reintentar, y en Actividad de la integración. No se envía ningún aviso por correo al comerciante: el panel de actividad es el lugar donde mirar.
- Productos con el triángulo "No sincronizado". Ver el artículo de Integración con ERP. Para Dragonfish se recalcula solo en cada pasada horaria.
- Los precios de una lista no llegan. El código de la lista en VentasxMayor tiene que coincidir con el de Dragonfish. Para la lista principal, además, el nombre tiene que estar escrito exacto.
- Uso el Bridge y no sincroniza. La app tiene que estar abierta. Mantenela actualizada.