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

PropertyValue
KeyUpdateOrderStatus
GroupStatus

Configuration Properties

This step has no configurable properties. The target status is determined automatically based on return extent.

Behavior

What It Does

  1. Retrieves the original order linked to the return
  2. Analyzes return quantities against original order quantities
  3. Determines appropriate status:
    • Returned - All items have been returned
    • PartiallyReturned - Some items have been returned
  4. Updates the order status
  5. 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

ConditionResultContinues Workflow?
Status updatedSuccessYes
Order not foundWarningYes
Status unchanged (already set)SuccessYes
Order update failedErrorDepends on StopOnError

On this page