Try Split Shipment by Category ID
Split shipment and reallocate to another warehouse based on product category.
Overview
The Try Split Shipment by Category ID step splits orders based on product category, moving matching products to a different warehouse. This enables category-specific fulfillment from specialized warehouses.
Identifier
| Property | Value |
|---|---|
| Key | TrySplitShipmentByCategoryId |
| Group | Reallocate |
| Applicable Statuses | New |
Configuration Properties
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
categoryId | String | Yes | - | Category ID(s) to split on (can specify multiple) |
warehouseCode | String | No | - | Target warehouse for split items |
ExcludedWarehouses | String | No | - | Comma-separated warehouses to exclude |
Behavior
What It Does
- Gets
categoryIdvalues from configuration (can have multiple) - Gets optional
warehouseCodefor target warehouse - Gets optional
ExcludedWarehouseslist - Splits the order by product category, moving matching products to a separate shipment
- Target warehouse assigned if specified
Prerequisites
- At least one
categoryIdmust be configured - Products must have category information
Side Effects
- New shipment created for matching products
- Products removed from original shipment
- Warehouse assigned to new shipment
Business Cases
When to Use
- Specialized warehouses: Electronics from tech warehouse, apparel from fashion warehouse
- Hazmat handling: Dangerous goods from certified warehouse
- Cold chain: Refrigerated items from cold storage
- Heavy items: Furniture from freight warehouse
Example Scenarios
Scenario 1: Electronics Split
Configure categoryId=ELECTRONICS and warehouseCode=TECH-WH. Electronics products move to tech warehouse shipment.
Scenario 2: Multiple Categories
Configure multiple categoryId properties. Products in any matching category get split.
Scenario 3: Exclude Warehouses
Configure ExcludedWarehouses=DROP-SHIP,VIRTUAL. Products already in those warehouses won't be split.
Scenario 4: No Matches No products match configured categories. Step returns success with "not applicable" message.
Error Handling
| Condition | Result | Continues Workflow? |
|---|---|---|
| No categoryId configured | Error | No |
| Split successful | Success | Yes |
| No products match | Success (not applicable) | Yes |
| Exception | Error | Depends on StopOnError |
Related Steps
- Split Shipments by Freight Class - Split by freight class
- Try Reallocate by Category ID - Reallocate without new shipment