Integration data sheet
| What | Direction | When |
|---|---|---|
| Orders | Store → Dragonfish | When confirmed, and again if edited and saved; on a conflict it retries up to five times |
| Customers | Store → Dragonfish | If the buyer does not exist, it is created before the order is sent |
| Price and stock | Dragonfish → Store | Once an hour and with "Update all products"; in real time with the synchronizer installed on the Dragonfish server |
| Price lists | Dragonfish → Store | Every list whose code matches one in the store, not only the main one |
| Surcharges and discounts | Store → Dragonfish | Dragonfish surcharges travel on every order; discounts as a negative line or prorated into prices |
| Products | Not created | An item that exists in Dragonfish but not in the store is skipped: load it in the store first, with Item!Color!Size codes for variants |
| Requirements | The API endpoint published to the internet, the client code and the token provided by Dragonfish; or the Dragonfish Bridge app on a company computer if the server sits behind a firewall. | |
| Cost | Included in the VentasxMayor plan: no separate module or integration fee. | |
| Activation | With support included; same business day reply. | |
What do you gain by integrating Dragonfish with your store?
- Automatic orders: Every sale in your store goes straight to Dragonfish. Zero manual entry.
- Prices from the Main List: Prices sync from the list you define in Dragonfish. Your store always reflects the correct values.
- Up-to-date stock: Inventory syncs every hour or in real time if you install the synchronizer on your Dragonfish server.
- Auto client creation: If a buyer doesn't exist in Dragonfish, the system creates them automatically with the order data.
- Surcharges supported: Surcharges configured in Dragonfish are correctly sent with each order.
How does the integration work?
Orders
- When a customer buys from your store, the order is sent automatically to Dragonfish.
- If the customer doesn't exist in Dragonfish, they are automatically created with the data from the order.
- If you edit an order in your store before it's processed in Dragonfish, changes sync automatically.
Stock
- Stock is managed exclusively in Dragonfish. Your store updates automatically.
- The Dragonfish API is checked every hour and stock levels in your store are updated.
- Optionally, you can install a real-time synchronizer on your Dragonfish server so changes take effect instantly.
- No warehouse parameterization by default: stock is taken as-is from Dragonfish.
Prices
- Prices are managed only in Dragonfish and automatically sync with your store from the "Main List".
- If a buyer has no assigned list, the Main List is applied as the general reference.
- ⚠️ Do not modify prices directly on your website after activating the integration.
Discounts
- The Dragonfish API does not support discounts natively. They can be handled in two ways:
- Negative item: a negative discount item is added within the order.
- Proration: the discount is distributed proportionally across each product's price.
Surcharges
- Surcharges configured in Dragonfish are supported and correctly sent with orders.
5 things you need to know before getting started
- SKUs must match exactly When creating products in your store, use exactly the same SKU you have in Dragonfish. This is key for price and stock synchronization to work from day one.
- Hourly sync by default Every hour the Dragonfish API is checked and prices and stock are updated in your online store. Enough for most wholesale businesses.
- Real-time sync option If you need changes to take effect instantly, you can install a synchronization program on your Dragonfish server. Price and stock changes are reflected immediately in your store.
- Dragonfish rules: prices and stock are only edited there Once the integration is active, prices and stock are modified only in Dragonfish. Changes are automatically reflected in your store.
- No warehouse parameterization by default The connector takes stock as-is from Dragonfish. If you need warehouse-level handling, it's evaluated case by case with our team.
How do you activate it?
The integration includes dedicated support: we handle the entire connection, testing and launch process. To learn about pricing, contact us on WhatsApp.
To activate, you need to request your API credentials (endpoint, Client ID and token) from Dragonfish. Our team handles the rest.
Configuration options
When activating the integration, we define these parameters together with you:
- ENDPOINT: The Dragonfish server URL.
- CLIENT / TOKEN: API access credentials that you must request from Dragonfish.
- MAIN PRICE LIST: The list that will be used as the general reference for syncing prices with your store.
- SYNC PRICES: Yes or No. If you choose Yes, prices sync automatically from Dragonfish.
- SYNC STOCK: Yes or No. If you choose Yes, stock syncs automatically.
- SYNC MODE: Pull (every hour) or Pull + Real-time (with synchronizer installed on your server).
- SURCHARGES: Yes or No. If you choose Yes, surcharges configured in Dragonfish are sent with orders.
- DISCOUNTS: Choose the mode: negative item, price proration, or disabled.
Don't have Dragonfish yet?
Discover Dragonfish Color y Talle by Zoologic, the ERP designed for apparel and footwear wholesalers:
FAQ
How often does stock update from Dragonfish?+
Hourly by default, by polling the Dragonfish API. If changes need to land instantly, a real-time sync agent is installed on the Dragonfish server.
What if the buyer does not exist in Dragonfish?+
It is created automatically with the order data. Surcharges configured in Dragonfish are sent with every order; discounts, which the API does not support natively, are handled as a negative line or prorated into each product price.
What credentials are needed?+
The server endpoint, the Client ID and the API token, requested from Dragonfish. With those, our team sets the main price list, the sync mode and how surcharges and discounts are handled.
How much does the integration cost?+
Nothing beyond the plan: the ERP integration is included in VentasxMayor's fixed monthly price, with no module or extra charge.
How long does activation take?+
With the credentials at hand, the setup is done from the admin and checked with "Verify configuration"; our team walks you through the activation and replies the same business day.
Does it work with several warehouses?+
By default no warehouses are parameterized: the store takes the stock as Dragonfish reports it. Price lists, however, all sync, matched by code with the store's lists.
