Try Reallocate on Cancel

Reallocate an order to the nearest warehouse with stock when a fulfillment location cancels.

Overview

The Try Reallocate on Cancel step handles order reallocation when a fulfillment location cancels an order or shipment. It finds the nearest available warehouse based on zip code and transfers the order there, typically restarting the workflow from the beginning.

Identifier

PropertyValue
KeyTryReallocateOnCancel
GroupReallocate
Applicable StatusesNew

Configuration Properties

PropertyTypeRequiredDescription
retryLimitnumberNoMaximum number of reallocation attempts
StoreRolesstringNoFilter eligible warehouses by role

Behavior

What It Does

  1. Checks if reallocation should be skipped (context.SkipReallocation)
  2. Uses zip code proximity to find the nearest warehouse with stock
  3. If successful, logs an event and triggers status change back to "New"
  4. Sets CancelWorkflow = true to stop current workflow and restart

Prerequisites

  • Order must have sufficient inventory somewhere in the network
  • context.SkipReallocation must not be set to true

Side Effects

  • Changes warehouse assignment
  • Records reallocation event with from/to warehouses
  • Triggers status change to "New" to restart order processing
  • Cancels the current workflow to prevent further steps

Business Cases

When to Use

  • Store cancellation: When a store can't fulfill a click-and-collect order
  • Out of stock discovery: When picking reveals inventory discrepancy
  • Capacity issues: When a warehouse can't handle the order in time

Example Scenarios

Scenario 1: Store Cancellation A store cancels a click-and-collect order. The step finds the next closest store with stock and reassigns the order.

Scenario 2: Retry Limit Configure retryLimit = 3 to prevent infinite reallocation loops if multiple locations cancel.

Scenario 3: Skip Reallocation If context.SkipReallocation = true (set by previous logic), the step does nothing.

Error Handling

ConditionResultContinues Workflow?
Reallocation skippedSuccessYes
No alternative warehouseWarningYes
Successful reallocationSuccess (triggers New status)No (cancels workflow)

On this page