Try Split Unreserved Order Lines to Nearest Coordinates

Split unreserved order lines to the nearest warehouse based on geographic coordinates.

Overview

The Try Split Unreserved Order Lines to Nearest Coordinates step handles unreserved order lines by finding the nearest warehouse with available inventory based on geographic coordinates (latitude/longitude). This provides more accurate proximity than zip code-based methods.

Identifier

PropertyValue
KeyTrySplitUnreservedOrderLinesToNearestCoordinates
GroupReallocate
Applicable StatusesNew

Configuration Properties

PropertyTypeRequiredDescription
storeRolesstringNoFilter eligible warehouses by role

Behavior

What It Does

  1. Identifies order lines without inventory reservation at current warehouse
  2. Uses delivery address coordinates to calculate distances to warehouses
  3. For each unreserved line, finds the closest warehouse with stock by coordinate distance
  4. Creates shipments as needed and recalculates prices
  5. Validates all shipments have warehouse assignments

Prerequisites

  • Order delivery address must have valid coordinates
  • Warehouses must have coordinates configured
  • At least one warehouse must have stock for each unreserved item

Side Effects

  • Creates new shipments for reallocated lines
  • Updates line item warehouse assignments
  • Recalculates order prices
  • Adds error to order if any items remain unallocated

Business Cases

When to Use

  • Accurate distance calculation: When zip codes don't reflect true distances
  • Dense store networks: In urban areas with many nearby options
  • Cross-border routing: When geographic proximity crosses postal boundaries

Example Scenarios

Scenario 1: Urban Delivery Customer in downtown area has 5 stores within 10km. Coordinate-based routing picks the truly closest one for each item.

Scenario 2: Border Regions A customer near a country border might be geographically closer to a warehouse across the border than one in the same postal region.

Scenario 3: Store Roles Configure storeRoles = "fulfillment" to only route to locations with fulfillment capability.

Error Handling

ConditionResultContinues Workflow?
All items allocatedSuccessYes
Some items unallocatedWarning (adds order error)Yes
No items to splitSuccessYes
ExceptionErrorDepends on StopOnError

On this page