If a fulfillment order shows the status “Action Required”, it means the order did not successfully push to the connected system (such as ShipStation or another WMS).

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

  1. Open the Sales Order
  2. Click the Fulfillment Orders tab
  3. Look for the Action Required under column Status

Option 2: From the Fulfillment Orders Page (Recommended)

  1. Navigate to Operations → Fulfillment Orders
  2. Filter by Status: Action Required
  3. 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:

  1. Open the Columns panel on the right edge of the grid
  2. Add the Error Message column
  3. 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

  1. Open the affected Sales Order
  2. Locate the related Fulfillment Order
  3. Identify the Channel used
  4. Navigate to Manage → Channels
  5. Select and Edit the relevant channel
  6. 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 TypeLikely CauseResolution
Character limit exceededField contains too much textShorten the value or adjust mapping
Required field missingField is blankAdd required data
Invalid address formatAddress not accepted by WMSCorrect formatting
Mapping mismatchField incorrectly mappedUpdate channel mapping

After Making Corrections

Once the issue is resolved:

  1. Save any updates to the Sales Order or Channel
  2. Reprocess or repush the fulfillment order
  3. 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.