Integration data sheet
| What | Direction | When |
|---|---|---|
| Orders | Store → DUX | When the order is confirmed, and again every time it is edited and saved |
| Price and stock | DUX → Store | Every 10 minutes (only what changed) plus a full pass every night |
| Discounts and surcharges | Store → DUX | On every order: the discount per line and the surcharge as an extra line, if configured |
| Products | Not created | The sync never creates items: the product is loaded in the store first, with the same code |
| Minimum order and case | Managed in VentasxMayor | They do not travel to DUX or come from DUX |
| Requirements | A DUX Software account with the API enabled and an active token; company, branch, warehouse and price list chosen in the settings. | |
| 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 DUX Software with your store?
- Automatic orders: Every sale in your store goes straight to DUX Software. Zero manual entry.
- Prices always up to date: Change a price in DUX and it's automatically reflected in your online store every 10 minutes.
- Synced stock: DUX inventory syncs with your site every 10 minutes. Never sell what you don't have.
- Discounts included: Discounts applied by your customers in the store are reflected in the order inside DUX.
How does the integration work?
Orders
- When a customer buys from your store, the order is sent automatically to DUX Software.
- If you edit an order in your store before it's processed in DUX, changes sync automatically when you save.
Stock
- Stock is managed exclusively in DUX Software. Your store updates automatically.
- Stock levels sync every 10 minutes, always reflecting the latest information from DUX.
Prices
- Prices are managed only in DUX Software and automatically sync with your store every 10 minutes.
- ⚠️ Do not modify prices or stock directly on your website after activating the integration.
Discounts & surcharges
- Discounts applied by your customers in the store are reflected in the order in DUX Software.
- Requirement: For discounts and surcharges to work, you must create a product called "DESCUENTO" in DUX Software. The system uses that product to record discount amounts.
5 things you need to know before getting started
- DUX Software is the master system Once the integration is active, prices and stock are modified only in DUX Software. Changes are automatically reflected in your store every 10 minutes.
- SKU codes must match exactly When creating products in your store, use exactly the same SKU you have in DUX Software. If a code doesn't match, the system will reject the order and won't register it.
- Products with options (color/size)
If your product in DUX has variants, option names must match exactly with the DUX format:
{COLOR}-{SIZE}. Leave the "option code" field empty in VXM; the system automatically assigns the DUXid_det_itemas the option code. - Don't edit stock or prices in VXM With the integration active, any manual stock or price change in your store will be overwritten in the next sync (every 10 minutes). Make all changes in DUX.
- You need a DUX account with API enabled Your DUX Software plan must include API access with an active token. Check it at: Settings → Company → API. See DUX API documentation.
How do you activate it?
Activation includes setup, technical support and launch. We take care of everything: we configure the integration to your needs and make sure it works perfectly from day one. To learn about pricing, contact us on WhatsApp.
Configuration options
When activating the integration, we define these parameters together with you:
- BRANCH ID: The identifier of the DUX Software branch your store will connect to.
- WAREHOUSE ID: The identifier of the DUX warehouse from which stock information will be taken.
- PRICE LIST ID: The identifier of the DUX price list that will be linked to your store prices.
- COMPANY ID: Your company identifier in DUX Software.
- VAT INCLUDED: Do the synced prices include VAT or not? We define this based on your tax setup.
- SURCHARGE PRODUCT CODE: The "DESCUENTO" (discount) product code in DUX Software, required for discounts and surcharges to be correctly transmitted in orders.
Products with options (color, size, etc.)
If your products in DUX have variants (sizes, colors, etc.), follow these rules for synchronization to work:
- Option name: Must match the DUX format exactly:
{COLOR}-{SIZE}(for example:RED-M,BLUE-XL). - Option code: Leave it empty in VXM. The system automatically assigns the DUX
id_det_itemas the internal code for each option. - Product without options in DUX = without options in VXM. Don't create variants in VXM for a product that doesn't have them in DUX.
Don't have DUX Software yet?
Learn more about DUX Software, the management ERP for your business:
FAQ
How often do stock and prices update from DUX?+
Every 10 minutes. Stock and prices are pulled from DUX Software and reflected in the store; orders, on the other hand, are sent to DUX the moment the customer confirms them.
What do I need in DUX to activate the integration?+
A DUX Software account with the API enabled and an active token (Settings → Company → API), plus the branch, warehouse, price list and company IDs. For discounts, a product named "DESCUENTO" created in DUX.
How are products with size and color handled?+
Each option name in the store must follow the DUX format ({COLOR}-{SIZE}, e.g. RED-M) and the option code is left empty: the system assigns the DUX id_det_item automatically. A product without options in DUX has no variants in the store.
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?+
You pick one DUX warehouse and the store shows that warehouse's stock. If the business has several, the one that supplies online sales is the one configured; prices come from the DUX price list you choose.
