Live Exchanges
Overview
Live Exchanges feature allows customers to instantly request a new item in exchange for returning the original product.
How does it work
Customers can select from available products listed in a predefined stock feed, displayed within the branded returns portal.
When requesting an exchange, customers will be guided to choose an alternative item based on one or more of the following:
- Alternate size or color of the same product
- Alternate product within an agreed category and/or price range
- Alternate product from available stock, based on matching rules
Product Matching Rules
When requesting an exchange, the system applies predefined matching rules to determine eligible products. The following criteria are used:
- Same Google Product Category - The replacement item must belong to the same category as the original product.
- Same Price and Currency - The alternate product should match the original price and currency.
- Price Discrepancy by Percentage - A price variation within an agreed percentage range is allowed.
- Variation of Price or Google Category - Products may differ in price or category if permitted by the retailer’s exchange policy.
Matching attributes if the same or discrepancy percentage price of product to be exchanged is selected:
| Return Item | Replacement Item | Required for Flat File Feed | Required for API Payload |
|---|---|---|---|
| Master/Parent SKU | Master/Parent SKU | Compulsory in Product feed | "Create Order" and "Bulk Load Products" payloads |
| Price | Selling Price | Compulsory in Order and Price | "Create Order" and "Bulk Load Products" payloads |
| Warehouse DC Code | Stock Warehouse DC Code | Compulsory in Order and Stock Feeds | "Create Order" and "Update stock levels" payloads |
Matching attributes if the same category of product to be exchanged is selected:
| Return Item (Order Item) | Replacement Item (Stock Item) | Required for Flat File Feed | Required for API Payload |
|---|---|---|---|
| Master/Parent SKU | Master/Parent SKU | Compulsory in Product feed | "Create Order" and "Bulk Load Products" payloads |
| Google Product Category | Google Product Category | Compulsory in Product feed | "Create Order" and "Bulk Load Products" payloads |
| Price | Selling Price | Compulsory in Order and Price Feed | "Create Order" and "Bulk Load Products" payloads |
| Warehouse DC Code | Stock Warehouse DC Code | Compulsory in Order and Stock Feeds | "Create Order" and "Update stock levels" payloads |
Live Exchanges Integration Specifications
Integration Options for Live Exchanges ZigZag offers two integration methods for enabling Live Exchanges:
Flat File Feeds - Retailers can upload files to the ZigZag SFTP Retailer Directory for processing.
If using this method, the following additional feeds are required:
Important Notes
To enable Live Exchanges in multiple countries:
- Upload Product Feed to the CountryIso2Code folder under feeds/inventory.
- Upload Price Feed to the CountryIso2Code folder under feeds/price.
- Ensure Order Feed Currency matches the Default Country Currency.
API Integration - Retailers can integrate directly via ZigZag’s REST API for real-time interaction.
Required API Payloads
Important Notes To enable Live Exchanges in multiple countries:
- For Product Bulk Upload, include full details for the required countryCode in the productInformation object.
- Ensure Create Order Currency equals the default CurrencyIso3Code.
Live Exchanges Reporting
To receive status updates for Live Exchanges:
- Webhook Notifications - Subscribe to ZigZag Webhooks for instant, event-driven updates - Live Exchanged Webhook
- Flat File Reports - Access the Live Exchange Requested Report via your ZigZag-hosted SFTP directory.