Update Order Status
Update the original order's status to reflect the return.
Overview
The Update Order Status step updates the original order's status when a return is processed. It changes the order status to indicate that items have been returned, either partially or fully.
Identifier
| Property | Value |
|---|---|
| Key | UpdateOrderStatus |
| Group | Status |
Configuration Properties
This step has no configurable properties. The target status is determined automatically based on return extent.
Behavior
What It Does
- Retrieves the original order linked to the return
- Analyzes return quantities against original order quantities
- Determines appropriate status:
- Returned - All items have been returned
- PartiallyReturned - Some items have been returned
- Updates the order status
- May trigger order workflow for the new status
Prerequisites
- Return must be linked to an original order
- Original order must exist and be accessible
- Target statuses must be configured in order workflow
Side Effects
- Changes original order's status
- May trigger original order's workflow steps
- Updates order history
- Affects order reporting and filtering
Business Cases
When to Use
- Marking orders as returned after processing
- Tracking partial returns on orders
- Maintaining accurate order status for reporting
- Triggering downstream order workflows
Example Scenarios
Full Return Customer returns all 3 items from order. Step updates order status to "Returned".
Partial Return Customer returns 1 of 3 items. Step updates order status to "PartiallyReturned".
Multiple Returns First return: 1 of 3 items, status becomes "PartiallyReturned". Second return: remaining 2 items, status becomes "Returned".
Error Handling
| Condition | Result | Continues Workflow? |
|---|---|---|
| Status updated | Success | Yes |
| Order not found | Warning | Yes |
| Status unchanged (already set) | Success | Yes |
| Order update failed | Error | Depends on StopOnError |
Related Steps
- Credit Return - Process refund
- Update Inventory - Adjust stock levels
- Update Project Status - Update related projects
