Add and manage facilities
This resource describes facilities of a customer, e.g. stores, micro hubs, warehouses, etc.. In general, a facility is a place where fulfillment processes take place or should be considered.
Last updated
This resource describes facilities of a customer, e.g. stores, micro hubs, warehouses, etc.. In general, a facility is a place where fulfillment processes take place or should be considered.
Last updated
The facilities in fulfillmenttools platform have some basic data to them: an address, provided services, etc.. They are also an important component to the Distributing Order Management System: an Order, which is supplied to the system, is routed to a facility based on configurations and data present at the time of the routing.
In a facility operative processes like Picking, Packing, Handovers, etc. are taking place to fulfill the consumers' order.
To create a facility there is very little data required. Please see the following call which contains only the required fields.
To understand which kind of optional parameters can be used when creating a facility please see the REST API documentation of facilities.
The API offers a delete endpoint for facilities. Handle with care: Issuing a request similar to
DELETE /api/facilities/<Facility ID>
will delete all data related to the facility (such as listings and configurations)!
Right after the creation of a minimal Facility a couple of configurations are added by default. Please refer to the REST API documentation to get information about their respective meaning.
This section only covers attributes & configurations worth mentioning. Please refer to REST API documentation to get a full overview of the attributes and their meaning.
In most cases it makes sense to provide additional information to the facility. We suggest you add the following information to the facility - either when creating or issuing an update request (see below).
The attribute tenantFacilityId might come in handy and we suggest you use it. It is the reference of this facility in potentially existing customer systems - for example the primary key of the according database row in some legacy system.
It also aids in finding a facility by an ID / reference known to connectors, etc..
In order to set the tenantFacilityId the following call has to be issued:
The tenantFacilityId could, as explained above, for example be used to query via the /api/facilities endpoint like this:
| Attribute | Why should I add this? | Example Value |
|---|---|---|
| To give information about holidays or "non operational times" in general, like public holiday or peak days where this facility should not be part of operational business. | |
{ |
}, { "date":"2023-03-10T12:00:00.000Z", "reason":"Renovation", "recurrence":"NONRECURRING" } ] | | pickingTimes |
Adding capacities & picking times per facility allows you to narrow down the operational effort you are willing to invest within a facility. The capacity in this case is the pure number of pickjobs this facility can handle - regardless of their size.
If not provided the platform will assume, that you are willing to fulfill any order at any time (which works in many cases as well!) in this facility.
|
|
Changes to an existing facility is generally applied via a PATCH operation. The above values would be issued as follows:
