Promotions help drive more sales within a brand’s catalog of products by enticing buyers with impactful discounts, encouraging increased cart values, and moving excess inventory.
Note: Promotions can only be configured within the brand’s NuORDER portal. The creation and configuration of Promotions is not supported through either an API or flat file.
Supported Promotion types
Consider these example selections when building Promotions.
| Order Promotions | Examples |
| % off an order |
|
| % off an order on qualifying amount |
|
| $ amount off an order |
|
| $ or % off prebook or ATS products in an order |
|
| Net terms extension |
|
| Free shipping |
|
| Multiple rewards in one promotion |
|
| Tiered discount based on number of units in the order |
|
| Tiered discount based on total value of the order |
|
| Product Promotions | Examples |
| % amount off the subtotal of entries | Buy products from a specific category to get 10% off of the item subtotal. |
| $ amount off the subtotal of entries | Buy products from a specific category to get $10 off of the item subtotal. |
| $ amount off individual entries | Buy products from a specific category to get $10 off of each item. |
| $ or % off prebook or ATS products |
|
| Tiered discount based on number of a units of a specific product(s) or type of product in the order |
|
| Tiered discount based on total value of the order with a specific product(s) or type of product |
|
Promotion eligibility rules
Promotion eligibility rules define which products or order values qualify for a Promotion.
| Order eligibility rules | Available parameters |
| Order amount | Enter an amount for At least (required) and At most (optional). |
| Order delivery date | Select a Start Date and End Date. Only products ordered within the select delivery date range are eligible for the promotional discount. |
| Order level field | Choose an order Field and its required Value. |
| Order quantity | Enter order quantity values for At least (required) and At most (optional). |
| Product eligibility rules | Available parameters |
| Product availability | Choose Prebook or ATS (Immediate and Future). Only Prebook or ATS products in an order qualify for the promotional discount. |
| Select product(s) | Select one or more products that are eligible for the Promotion. |
| Product field(s) | Text-based product field(s) with a required value, including Category, Color, Gender, Season, Style Number, and more. |
Set minimum rules
Both order and product Promotions can be configured with a minimum quantity that is required for the Promotion to be applied.
Include threshold messaging
For order and product amount or quantity rules, you can toggle on Include threshold messaging and enter a message, notifying the buyer that they’re close to being eligible for a discount.
This message is displayed as a banner in the Working Order, encouraging the buyer to add more to their cart.
A banner also appears when the Promotion is applied.
Supported workflows
Workflows denoted with the diamond icon are supported.
| Workflow | Non-integrated brands | Integrated brands | Notes |
| API/VETL integrations | n/a | Bidirectional integrations, which transfer data in both directions, are supported. Brands may retrieve and update quantities, add items, and remove items from an order in their NuORDER brand portal. | |
| Draft Orders | Product and order Promotions are saved in Draft orders, the PDF download of the Draft order, and the XLS file if configured (see Promotions on order exports article). | ||
| Editing a split order with Promotions | For split orders, buyers receive the promotional discount if their submitted order qualifies, and then it splits into multiple orders (based on the brand’s order splitting rules). After a spit order is edited and submitted, the promotional discount(s) remain, depending on the scenario (see Promotions on Split Orders). | ||
| Mobile | NuORDER Mobile (versions 4.26 and higher) supports Promotions applied to orders created within the app. | ||
| Company-level Discounts and Surcharges | When an order qualifies for a Promotion, the price is calculated based on the promotional discount and any company-level discounts and surcharges. | ||
| Manual discounts in the Working Order | When an order qualifies for a Promotion, the price is calculated based on the promotional discount and any manual discounts (at the order or product-level). | ||
| EZ Orders | Promotional discounts appear on placed EZ Orders, so buyers know exactly how much they saved with the brand's tailored recommendations. See EZ Orders (for brands). | ||
| Ability to send product price adjustments or item totals and order totals in VETL and API order updates | n/a | n/a | Changes to pricing must happen at the product-level in NuORDER. When updates are sent via API (or Flat File), the Promotion engine runs against the stored product price in the brand portal. This process evaluates if an order still qualifies for a Promotion, and then recalculates the order based on updated quantities, calculating the new order cost, promotional discount(s), manual Discount(s), and any applicable Surcharges |
| GOA Buyer Experience | n/a | n/a | Promotions are not available in the GOA buyer experience. |
| Custom Pricing Scripts | n/a | n/a | Due to needing to configure Promotions in a brand’s NuORDER portal, the pricing_service_volume_pricing must be used; brands may not use any other custom scripts. |
Split orders with Promotions
Promotions apply to split orders when submitted.
- Product-level Promotions split evenly across split orders that contain the promotional product(s).
- Order-level Promotions split evenly across all split orders.
After a split order is edited and submitted, the promotional discount(s) remain, depending on the scenario (see Promotions on Split Orders).
API order workflows
Brands who want to use APIs to integrate their ERP can use the existing Orders API Collection available to Update and Retrieve order information.
- API documentation: NuORDER API
- Integration documentation: Promotions implementation guide for integrated brands
Retrieve promotional data applied to an order
- To retrieve promotional data and pricing, brand applications will need to call the Get Orders by Number or ID endpoints.
- Promotion data is not currently returned by the Update order by ID or Number APIs.
Update an order
Quantity
- Quantity can be increased or decreased via the Order Update API calls and flat file ingestion via VETL.
- New line sizes can be added to the JSON and are added to the order, which runs through the Promotions engine for price, Promotion, and Surcharge recalculation.
Remove a size
- If multiple sizes are selected and a brand wishes to remove one size from the order, then the brand can send a value of "quantity": 0, to remove the value. Alternatively, the brand can remove the JSON for that item from the API order update.
- When the update is successfully processed, then the order runs through the Promotions engine for price, Promotion, and Surcharge recalculation.
Remove an item from an order
- If there is only one size of an item (or the brand wants to remove an item and all sizes from an order), then the brand must send an API order update without the product in the order update JSON data.
- When the update is successfully processed, then the order runs through the Promotions engine for price, Promotion, and Surcharge recalculation.
Flat file order workflows
Bi-directional order updates are supported for additions and removals of items in an order. Coordinate with our integration team to ensure that the Promotions data being sent with the order details is in a format that your ERP can accept.
Updating orders either by either API or flat file
When an order update is submitted, the Promotion’s engine runs to determine if the order still meets the criteria to qualify for a previously applied Promotion, or if it qualifies for a new Promotion.
If the order update still qualifies for a Promotion, then the order recalculates and all product prices, promotional discounts, manual discounts, and surcharges are recalculated and updated in the order.
If the order update causes the order to drop below a Promotion’s eligibility rules, then the Promotion is removed, and the order prices are recalculated and updated in the order.
Additional resources
The following articles are available in the Promotions section of the Knowledge Base.