Fluent Commerce Logo
Docs
Sign In

fc.order.sourcing.reservation.time

Setting

Changed on:

7 Aug 2025

Setting AreaUI component, Workflow, Orders
Supported context levels:ACCOUNT RETAILER

Overview

This setting determines the time when we reserve inventory for an order. It is measured in hours and is set at the account and/or retailer level. The system will create fulfillment based on the `DeliverAfter` value.

Values

Data TypeValues
INTEGER

Example:

  • 48

Detailed technical description

This setting is used by the rule ScheduleFulfilmentCreationForDeliverAfter in the reference multi-order (aka mixed basket) workflow

When a customer makes an order with a future delivery date, most businesses might want to fulfill the order close to the delivery date rather than right away. This setting, along with the proceeding time setting, helps facilitate this use case.

In our reference, mixed basket order model, fulfillment is not created right away for orders that are set to deliver after a certain date. Instead, its fulfillment creation is scheduled to be created a number of hours before the delivery date. This fulfillment creation reserves the stock to be picked and packed for the order, which is thus called reservation time. This setting controls this value.

After that, another event is scheduled to move the fulfillment into the awaiting wave status so that it may start the pick and pack process. This is scheduled some hours before the fulfillment's delivery date and is called the proceeding time.

See the following diagram for a visual representation of this model:

No alt provided

As the reservation time controls the creation of the fulfillment, we recommend setting a greater value for the reservation time than the proceeding time. 

If no value is found for the reservation time (a setting has not been created), then the fulfillment will be created on the delivery date. 

Configuration example

1POST {{fluentApiHost}}/graphql
2
3mutation CreateSetting {
4   createSetting(input: {
5		name: "fc.order.sourcing.reservation.time", 
6		valueType: "INTEGER", 
7		value:  24, 
8		context: "RETAILER", 
9		contextId: 1}) {
10    id
11    name
12  }
13}

Update example

1POST {{fluentApiHost}}/graphql
2
3mutation updateSetting {
4  updateSetting(input: {
5		id: 5001464,
6		name: "fc.order.sourcing.reservation.time", 
7		valueType: "INTEGER", 
8		value:  24, 
9		context: "RETAILER", 
10		contextId: 1}) {
11    id
12    name
13  }
14}
15