Split Every Macro

Large quantity orders can require item quantities to be split into smaller child orders for easier fulfilment, packaging, or operational handling. Manually splitting these orders can take time and may lead to inconsistent split quantities or missed items.

The Order Splitter by Split Every macro helps automate this process by checking selected Linnworks orders and splitting eligible order items based on each SKU's inventory extended property named Split every.

The macro also handles composite items separately, ignores service lines, records split details in order notes, and marks processed orders with an order extended property to prevent the same order from being processed again.

Split order quantities automatically using each SKU's Split every extended property while keeping parent and child order notes traceable.

Configure the Macro

Once the app is installed, you need to create a macro configuration so the system knows which macro to run and allows it to be selected in the Rule Engine.

This setup can be adjusted anytime based on your operational requirements.

Steps to Configure

Step 1Step 2Step 3Step 4Step 5Step 6Step 7Step 8Step 9

Go to Apps > Macro Configuration and click + Add new configuration.

Select the SplitEveryMacro macro and click Create Configuration.

This creates a new configuration where the macro can be enabled and used by the Rule Engine.

In the Macro Configuration screen, add the configuration name.

This macro uses the selected order IDs provided by the Rule Engine. No additional custom parameter values are required.

Make sure to enable the macro to continue with the Rule Engine configuration.

Note: If the macro is not enabled, it will not appear in the Action value list when setting up the rule.

Go to Orders > Rules engine and click + Add new rule.

Enter the rule name and click Create.

Click Add new, select Condition, set the condition as required, and save it.

Use conditions that target orders requiring quantity-based splitting.

Add the macro action and click Save.

In the Add action window, enter the Action name, for example:

SplitEveryMacro

• Set Action type to:

  Execute a macro

• In Action value, select:

  SplitEveryMacro

• Click Save

Note: If the macro is not enabled, it will not appear in the Action value list when setting up the rule.

Review the saved rule setup.

• Verify the condition and action are connected correctly

• Click Save in the bottom-right corner to save the rule

Order splitting can be useful when high quantities need to be broken into smaller fulfilment groups. This macro helps apply a consistent split rule per SKU using the Split every inventory extended property.

How It Works

The macro checks each selected order, handles composite items first, then applies split rules to normal non-service items using the Split every extended property.

Usage of App

This macro is designed to run against selected orders through the Rule Engine. It is useful when order quantities need to be split into smaller child orders based on SKU-level configuration.

Split Group Example

If an item has quantity 10 and the inventory extended property Split every is set to 3, the macro calculates the split groups as:

[3, 3, 3, 1]

The first group remains on the parent order, and the remaining groups are used to create child orders.

Key Points to Remember

• The macro processes the order IDs provided in OrderIds

• The macro is intended to run from the Rule Engine

• Orders already marked with OrderSplitMacro = Yes are skipped

• Service lines are ignored

• The macro checks only non-service items for splitting

• Composite items are processed before normal items

• A single composite-only order is not split

• In composite and normal item orders, all composite items are split out first

• In multiple-composite-only orders, the first composite remains on the parent order

• Normal items use the inventory extended property Split every

• Missing Split every values cause the item to be skipped

• Invalid or non-positive Split every values cause the item to be skipped and noted

• If item quantity is lower than the Split every value, the item is skipped and noted

• The macro creates internal notes using OrderSplitMacro as the note creator

• Child orders are marked as processed after creation

• Parent orders are marked as processed after completion

• Processed tracking is done through an order extended property, not an identifier

What You Can Expect

• Eligible item quantities are split into child orders
  Items with valid Split every values are grouped and split into child orders where needed.

• Composite items are separated first
  Composite item behaviour is handled before the normal SKU split logic.

• Orders without eligible items are marked processed
  If no items qualify for splitting, the macro marks the order as processed to avoid repeated runs.

• Parent order receives a split summary note
  The parent note lists created child orders and the item quantities moved.

• Child orders receive parent reference notes
  Each child order receives a note showing which parent order it came from and which items were moved.

• Duplicate processing is avoided
  The macro marks parent and child orders with OrderSplitMacro = Yes.

Overall Impact

This macro improves order splitting consistency by using SKU-level split rules, reducing manual splitting work, and keeping parent-child order relationships visible through internal notes.

What To Do After the Macro Runs

After the macro has completed, review the parent and child orders to confirm the split results.

Steps to Follow

Why This Matters

Automated order splitting helps:

• Reduce manual order splitting

• Apply SKU-level quantity rules consistently

• Keep child order creation traceable

• Avoid duplicate macro processing

• Separate composite items where required

• Improve fulfilment handling for large quantity orders

Best Practices

To get the most value from this macro, maintain the Split every extended property carefully and test the split behaviour before using it widely.

Recommended Guidelines

• Set Split every on relevant SKUs
  Add the inventory extended property Split every to SKUs that should be split.

• Use numeric values only
  The Split every value must be a positive whole number.

• Avoid running repeatedly on the same order
  The macro adds OrderSplitMacro = Yes, but rule conditions should still be configured carefully.

• Review composite behaviour
  Confirm that composite splitting rules match your operational process.

• Check parent and child notes
  Use the internal notes to confirm how items were split.

• Test with sample orders
  Test orders with normal items, composite items, service lines, and mixed quantities before live use.

Troubleshooting

Summary

The Order Splitter by Split Every macro processes selected Linnworks orders and splits eligible item quantities into child orders based on each SKU's Split every inventory extended property.

It handles composite items first, ignores service lines, validates split values, adds traceable internal notes, and marks processed orders with OrderSplitMacro = Yes to prevent duplicate processing.