Even if the order appears to have been pushed, something prevented it from fully processing.
This guide explains how to:
Identify the error
Understand what it means
Locate the source of the issue
Correct the problem
What “Action Required” Means
A fulfillment order marked Action Required indicates:
Required data is missing
A field exceeds the allowed character limit
The data format does not match what the WMS expects
A channel mapping issue exists
The order must be reviewed and corrected before it can successfully push.
Step-by-Step Troubleshooting
Step 1: Locate Orders with “Action Required”
Option 1: From the Sales Order
Open the Sales Order
Click the Fulfillment Orders tab
Look for the Action Required under column Status
Option 2: From the Fulfillment Orders Page (Recommended)
Navigate to Fulfillment Orders
Filter by Status: Action Required
Review affected orders
This view makes it easier to spot patterns if multiple orders are failing.
Step 2: View the Error Message
To see the specific reason for failure:
Click the column selector (gear icon)
Add the Error Message column
Move it toward the front of the table
The error message typically explains what failed.
Example: Custom Field 3 exceeds maximum length. 149 characters provided. Limit is 100.
Step 3: Identify What the Error Refers To
Error messages may reference:
Custom Field 1, 2, or 3
Address fields
Company name
Order notes
Tags
If the error references a “Custom Field,” the next step is to check the channel mapping.
Step 4: Check the Channel Mapping
Open the affected Sales Order
Locate the related Fulfillment Order
Identify the Channel used
Navigate to Channels
Select and Edit the relevant channel
Review the Field Mapping section
Locate the field mentioned in the error message (for example, Custom Field 3).
This shows what Luminous is sending to the WMS.
Step 5: Compare the Order Data
Return to the Sales Order and review the value being sent.
For example:
If Custom Field 3 is mapped to Order Tags
And the order contains many tags
The total character count may exceed the WMS limit
Some external systems enforce strict character limits. If exceeded, the order will fail.
Common Error Types and Fixes
Error Message Type | Likely Cause | Resolution |
Character limit exceeded | Field contains too much text | Shorten the value or adjust mapping |
Required field missing | Field is blank | Add required data |
Invalid address format | Address not accepted by WMS | Correct formatting |
Mapping mismatch | Field incorrectly mapped | Update channel mapping |
After Making Corrections
Once the issue is resolved:
Save any updates to the Sales Order or Channel
Reprocess or repush the fulfillment order
Confirm the status updates successfully
If the error persists, review the error message again for additional details.
Troubleshooting Multiple Orders at Once
If several orders show Action Required:
Add the Error Message column
Look for repeated error patterns
If multiple orders reference the same field, the issue is likely related to channel mapping or character limits
Correcting the root cause may prevent future failures.
When to Contact Support
If the error message is unclear or the issue cannot be resolved:
Contact the Luminous Support team and include:
Sales Order number
Fulfillment Order number
Channel name
Screenshot of the error message
The support team can help identify the failure point and recommend next steps.