Future Shipment Rules

Future Shipment Rules determine the priority order in which impacted future shipments are evaluated when the Allocation Rebalancer detects a supply decrease event. When a purchase order backing future inventory is delayed, short-shipped, or cancelled, the Allocation Rebalancer identifies all future shipments allocated against that inventory record and runs the Future Shipment Rules to rank them. Shipments that match higher-priority rules receive inventory first during reallocation; lower-priority shipments are de-allocated first if inventory cannot be preserved for all. Future Shipment Rules follow the same composable rule structure used across Kibo for other rule types, using expression-based conditions across Account, Product, and Shipment dimensions. In addition to the UI detailed here, you can create and manage Future Shipment Rules using the Future Shipment Rules API endpoints. The Product Rules , Customer Rules and Shipment Rules APIs can also be used to manage supporting product, customer and Shipment rules.

​

Prerequisites

Before configuring Future Shipment Rules, ensure the following:

• The B2B Wholesale OMS feature is enabled for your tenant. Contact Kibo Support to enable this capability.
• You have Admin or SuperAdmin role permissions, or a role with the following behaviors assigned:
  • Product Rule: Read, Create, Update, Delete
  • Customer Rule: Read, Create, Update, Delete
  • Future Shipment Rule: Read, Create, Update, Delete

​

How Future Shipment Rules Work

​

Rule Evaluation

When the Allocation Rebalancer’s rebalancing flow reaches the future shipment prioritization step, all enabled Future Shipment Rules run together against the impacted shipments. Each shipment is evaluated in ascending rank order — Rule 1 runs first, followed by Rule 2, and so on. When a shipment matches a rule’s criteria, that rule assigns a priority rank to the shipment. A shipment is only evaluated once — once it matches a rule, it is not re-evaluated against subsequent rules. Shipments that do not match any enabled rule will be considered by Catch All Rule, which is treated as the lowest possible priority during reallocation.

​

Criteria Matching

A shipment must satisfy all defined criteria types on a rule (AND logic across types) to match. Within a single criteria type, conditions can be combined using AND or OR logic as configured in the expression editor.

​

Sort

Each Future Shipment Rule includes a primary and optional secondary sort criterion. For shipments that match the same rule, the sort determines their relative order within that priority tier. You can sort on any numeric or date field available on the shipment — for example, sort by earliest requestedShipDate to protect shipments with the most imminent delivery commitments, or sort by earliest lastCancellationDate to protect shipments approaching their cancellation deadline.

​

De-Allocation Order

When supply decreases and not all future shipments can retain their allocation, de-allocation follows reverse priority order — shipments with the lowest priority (highest rank number ) lose their allocation first. This protects higher-priority commitments from losing inventory to lower-priority ones.

​

Rule Criteria

A Future Shipment Rule supports up to three criteria types:

​

Rule Attributes

​

Configure Future Shipment Rules

To create a new Future Shipment Rule:

1. Go to Main > Fulfillment > Rules > Future Shipment Rules.
   
2. Click Create Future Shipment Rule.
3. Enter a Code. If left blank, the system generates one automatically.
4. Enter a Name and an optional Description.
5. Enter a Rank value. The lower the number, the higher the priority. Default takes the last rank.
6. Enter a Time Fence Days value. The rebalancer searches for alternate inventory within this symmetric window around the shipment’s requested ship date.
7. Toggle the rule Enabled to activate it.
   
8. Configure Sort Criteria:
   • Under Primary Sort, select a numeric or date field (for example, estimatedDeliveryDate or lastCancellationDate) and choose Ascending or Descending.
9. Optionally, add Account / Customer Criteria:
   • Click Add Customer Rule and use the expression editor to define account-level conditions.
10. Optionally, add Product Criteria:
    • Click Add Product Rule and use the expression editor to define product-level conditions.
11. Optionally, add Shipment Criteria:
    • Click Add Shipment Rule and use the expression editor to define shipment-level conditions.
12. Click Save.

​

Manage Future Shipment Rules

Access the Future Shipment Rules dashboard at Main > Fulfillment > Rules >Future Shipment Rules to manage your configured rules:

• Toggle the Status icon on a rule to activate or deactivate it without deleting it.
• Expand the actions menu on a rule to Edit or Delete it.
• Check multiple rules and use the Actions menu to enable, disable, or delete in bulk.
• Edit the Rank of a rule directly in the table, or click and drag to reorder.

​

Example Rule Configurations

​

Protect Strategic Account Shipments

Ensure shipments for strategic accounts are last to lose allocation when supply decreases:

​

Protect Shipments by Product Category and Urgency