Order Items Adder Macro - User Guide

Overview

This Rules Engine macro allows you to automatically add one or more items to selected orders in bulk. You can specify custom quantities and prices for each item, or use retail/channel prices automatically.

How It Works

The macro processes selected orders and adds the specified items to each order. For each item, you can control:

Which SKU to add
How many units to add
What price to use (specific price, retail price, or channel price)

Pricing Priority Order

Specific Price: If you specify a price in the skusList parameter, that exact price will be used
Retail Price: If useRetailPrices is checked and no specific price is provided, the retail price from inventory will be used
Channel Price: If neither of the above applies, the default channel price will be used

Parameters

Parameter Name	Type	Description	Example
`skusList`	String	List of items to add in format: `SKU/Quantity/Price` Separate multiple items with semicolons (`;`) Price is optional - leave blank to use automatic pricing	`ABC-123/2/15.99;DEF-456/3/`
`useRetailPrices`	Boolean	Check this box to use retail prices from your inventory Leave unchecked to use channel prices Note: Specific prices in skusList always take priority	`true` or `false`

SKU List Format

The skusList parameter uses a specific format to define which items to add:

Format Structure

SKU/Quantity/Price

SKU: The product SKU (required)
Quantity: Number of units to add (required)
Price: Custom price per unit (optional, leave blank to use automatic pricing)

Examples

Single item with specific price

ABC-123/2/15.99

Adds 2 units of SKU "ABC-123" at $15.99 each

Single item without price (uses automatic pricing)

ABC-123/2/

Adds 2 units of SKU "ABC-123" using retail or channel price

Multiple items

ABC-123/1/10.50;DEF-456/3/;GHI-789/1/5.00

• Adds 1 unit of "ABC-123" at $10.50
• Adds 3 units of "DEF-456" with automatic pricing
• Adds 1 unit of "GHI-789" at $5.00

Common Use Cases

Adding Free Promotional Items

Scenario: Add a free sample to orders

Configuration:

skusList: SAMPLE-001/1/0.00
useRetailPrices: false

Adding Multiple Items at Discount Prices

Scenario: Add multiple promotional items at special prices

Configuration:

skusList: PROMO-A/1/9.99;PROMO-B/2/14.99
useRetailPrices: false

Adding Items at Standard Retail Price

Scenario: Add items using their standard retail prices

Configuration:

skusList: PROD-001/1/;PROD-002/2/
useRetailPrices: true

Mixed Pricing Strategy

Scenario: Add some items at specific prices and others at retail price

Configuration:

skusList: SPECIAL-001/1/5.00;REGULAR-001/2/
useRetailPrices: false

Result: SPECIAL-001 uses $5.00, REGULAR-001 uses channel price

Important Notes

⚠️ SKU Validation

The macro will fail if any SKU in the list does not exist in your inventory. Make sure all SKUs are valid before running the macro.

ℹ️ Tax Rates

When using retail prices or specific prices, the tax rate from the product's inventory record will be applied automatically.

ℹ️ Fulfillment Location

Items are added using the order's existing fulfillment location. The macro does not change the fulfillment location.