Volumetric Package Validation
Automatically check selected Linnworks orders against parcel weight and size limits, then assign an identifier when an item exceeds the configured parcel limits.
Checking parcel limits manually can be time-consuming, especially when orders contain items with different weights, quantities, and dimensions. The Parcel Size Limit Check macro helps automate this process by reviewing selected Linnworks orders and identifying items that exceed parcel weight or size limits.
This macro uses Linnworks packaging calculation data to check each item’s weight and dimensions. If an item’s total weight exceeds 15 kg, or the calculated parcel size exceeds 245 cm, the macro assigns the parcel size limits exceeds identifier to the order so it can be reviewed before dispatch.
With this automated approach, your team can reduce manual parcel checks, identify oversized or overweight orders earlier, and prevent problematic orders from moving too far through the fulfilment process.
Keep parcel compliance visible by automatically flagging selected orders that exceed weight or size limits.
Configure the Macro
Once the app is installed, you need to create a macro configuration so the system knows which macro to run when the rule is triggered.
This setup can be adjusted anytime based on your operational requirements.
Steps to Configure
Go to Apps > Macro Configuration and click + Add new configuration.
Select the ParcelSizeLimitCheck macro and click Create Configuration
This creates a new configuration where the selected order IDs are passed to the macro when it runs from the rule.
In the Macro Configuration screen, add the configuration name.
Example configuration name:
Parcel Size Limit Check
This macro does not require additional user-entered parameter values. The OrderIds value is provided automatically by the selected orders or rule context.
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.
Key Benefits
Enter the rule name and click Create.
Click Add new, select Condition, set the condition as required, and save it.
Add the macro action and click Save.
In the Add action window, enter the Action name, for example:
ParcelSizeLimitCheck
-
Set Action type to:
Execute a macro -
In Action value, select:
ParcelSizeLimitCheck -
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
Oversized or overweight parcels can cause courier validation issues, dispatch delays, or manual intervention during fulfilment. This macro helps reduce those issues by automatically checking selected orders and assigning a review identifier when parcel limits are exceeded.
Reduce Manual Parcel Checks
Eliminates the need to manually calculate item weight and parcel size for each selected order.
Improve Dispatch Readiness
Helps identify orders that may need review before shipping labels or courier services are applied.
Flag Limit Exceptions
Assigns an identifier to orders where item weight or calculated parcel size exceeds the defined limits.
Use Packaging Data
Uses Linnworks packaging calculation data to check item weight, quantity, width, height, and depth.
Save Operational Time
Allows teams to check multiple selected orders in one macro run instead of calculating parcel limits manually.
Review Only Exceptions
Orders that exceed the parcel limits are marked for review, while valid packages are logged as good to go.
How It Works
The macro checks each selected order’s packaging calculation, reviews item weight and dimensions, and assigns the parcel size limits exceeds identifier when the order exceeds the defined parcel limits.
Step 1
The macro loops through each order ID provided in the OrderIds parameter.
Step 2
For each selected order, the macro retrieves the order details using the Linnworks Orders API.
Step 3
The macro retrieves the order packaging calculation for the selected order.
Step 4
It loops through each calculated packaging item and reads the item quantity, item weight, width, height, and depth.
Step 5
The item weight is converted from grams to kilograms and multiplied by the item quantity.
Step 6
If the total item weight is greater than 15 kg, the macro creates and assigns the parcel size limits exceeds identifier to the order.
Step 7
If the weight is within the allowed limit, the macro converts the item dimensions into centimetres.
Step 8
The macro calculates parcel size using the item dimensions and multiplies the result by the item quantity.
Step 9
If the calculated parcel size is less than or equal to 245 cm, the item is logged as Good to Go.
Step 10
If the calculated parcel size is greater than 245 cm, the macro creates and assigns the parcel size limits exceeds identifier to the order.
Step 11
The macro logs item weight, quantity-adjusted weight, dimensions, parcel size results, and warning messages for exceptions.
Usage of App
This macro is designed to check selected orders automatically once it is configured and triggered from the Rule Engine. It is useful before label generation, dispatch processing, or any workflow where oversized or overweight parcels need to be flagged for review.
OrderIds
Defines the Linnworks order IDs that should be processed. Only these selected orders are checked.
Packaging Calculation
The macro uses Linnworks order packaging calculation data to retrieve item weight, quantity, and dimensions.
Weight Limit Check
The macro checks whether the item weight multiplied by quantity is greater than 15 kg.
Size Limit Check
The macro checks whether the calculated parcel size multiplied by quantity is greater than 245 cm.
Review Identifier
Orders that exceed the weight or size limit are assigned the parcel size limits exceeds identifier.
Good to Go Logging
Items within the configured parcel size limit are logged as Good to Go.
Execution Logging
The macro records order number, item SKU, converted weight, quantity-adjusted weight, dimensions, parcel limit results, and warning messages.
Key Points to Remember
-
The macro processes only the order IDs provided in OrderIds
-
The macro uses Linnworks packaging calculation data
-
Item weight is converted from grams to kilograms
-
Item weight is multiplied by item quantity before checking the 15 kg limit
-
Item dimensions are converted to centimetres
-
The calculated parcel size is multiplied by item quantity before checking the 245 cm limit
-
If the weight exceeds 15 kg, the order is assigned the parcel size limits exceeds identifier
-
If the calculated parcel size exceeds 245 cm, the order is assigned the parcel size limits exceeds identifier
-
Orders within the parcel limits are not assigned the identifier
-
The macro logs warnings for items that exceed limits
Once the macro is running, it helps identify selected orders that may need manual review before dispatch.
What You Can Expect
-
Selected orders are checked automatically
The macro reviews each order passed into the OrderIds parameter -
Packaging data is reviewed
The macro reads packaging calculation data for each selected order -
Weight limits are checked
Items with total weight greater than 15 kg are flagged -
Size limits are checked
Items with calculated parcel size greater than 245 cm are flagged -
Exceptions are identified
Orders that exceed the limits receive the parcel size limits exceeds identifier -
Valid packages are logged
Items within the size limit are logged as Good to Go -
Execution is logged
The macro records weight, dimensions, SKU, order number, and warning messages
Overall Impact
This macro improves parcel compliance visibility, reduces manual weight and size checks, and helps teams identify orders that may need review before shipping or dispatch.
What To Do After the Macro Runs
After the macro has completed, review orders marked with the parcel size limits exceeds identifier and decide whether they need different packaging, a different shipping service, or manual handling.
Steps to Follow
Step 1
Open Linnworks and locate the orders included in the OrderIds parameter.
Step 2
Run the macro through the configured rule action.
Step 3
Review macro logs to confirm item weight, dimensions, and any warning messages.
Step 4
Filter or review orders with the parcel size limits exceeds identifier.
Step 5
Check whether the flagged order needs a different packaging option, courier service, or manual review.
Step 6
Continue with normal label generation, packing, or dispatch once the parcel issue has been resolved.
Why This Matters
Checking parcel limits before dispatch helps:
-
Reduce courier validation issues
-
Prevent overweight or oversized parcels from progressing unnoticed
-
Improve shipping preparation
-
Reduce manual calculation work
-
Make parcel exceptions easier to identify
-
Support better fulfilment decision-making
Best Practices
To get the most value from this macro, make sure item weights and dimensions are accurate before running it.
Recommended Guidelines
-
Keep item weights accurate
Make sure item weights are maintained correctly in Linnworks so the macro can calculate parcel weight reliably -
Keep item dimensions accurate
Confirm item width, height, and depth values are populated correctly for packaging calculation -
Run before label generation
Use the macro before generating labels so oversized or overweight parcels can be reviewed first -
Review flagged orders promptly
Check orders with the parcel size limits exceeds identifier before dispatch -
Use a clear rule condition
Configure the Rule Engine condition so only the intended orders are passed to the macro -
Check logs after execution
Review macro logs to confirm which SKUs exceeded weight or size limits
Accurate item weight and dimension data is important because the macro relies on packaging calculation values to decide whether an order should be flagged.
Example Scenario
To better understand how this works, here’s a simple example:
Selected orders:
-
Order A contains SKU-001 with total item weight 12 kg and calculated parcel size 180 cm → The item is logged as Good to Go
-
Order B contains SKU-002 with total item weight 18 kg → The order receives the parcel size limits exceeds identifier
-
Order C contains SKU-003 with total item weight 8 kg but calculated parcel size 260 cm → The order receives the parcel size limits exceeds identifier
-
Order D contains multiple quantities of the same item, and quantity-adjusted parcel size exceeds 245 cm → The order receives the parcel size limits exceeds identifier
What This Means
-
Orders within the parcel limits continue without the identifier
-
Orders over 15 kg are flagged for review
-
Orders over 245 cm calculated parcel size are flagged for review
-
Warehouse or dispatch teams can focus on the flagged exceptions instead of manually checking every order
Final Summary
The Parcel Size Limit Check macro helps identify selected Linnworks orders that may exceed parcel weight or size limits.
By using packaging calculation data, checking total item weight and calculated parcel size, assigning the parcel size limits exceeds identifier, and logging detailed warnings, this macro supports better dispatch preparation and reduces manual parcel compliance checks.