Storage Location

This page is outdated. Please go to our new documentation under https://docs.fulfillmenttools.com/documentation.

Summary

A storage location is a physical location where stock can be located. Since there might be more than one product located on the same location, more than one stock can be connected to a single storage location.

Depending on the facility type, a storage location can represent different concepts, e.g., the showcase area or the supply room in stores, or a compartment on the shelf or a pallet space in warehouses.

Description

Storage locations represent the available storage space in a facility. A given stock can either be generically assigned to a facility, or it can be assigned to a specific storage location by linking the stock to the storage location.

• Storage locations can be grouped in zones.

• Storage locations can be assigned traits, which they in turn inherit to all stocks linked to them.

Running Sequence

• Storage locations can be ordered in a (running) sequence by defining the previous and next location via API.

• Depending on the sequence type that was defined, the sequence is considered in picking or restowing.

Patches the storage locations of a facility with the given ID

Adds new storage locations, updates existing ones and keeps the previously present ones in the database.

1. If a storage location exists in the patch action but not in the database it is added.
2. If a storage location exists both in the patch action and in the database it is updated and the contents merged.
3. If a storage location exists only in the database, it is left untouched.

PATCH/api/facilities/{facilityId}/storagelocations/{storageLocationId}

Path parameters

facilityId*string

ID of facility you want to patch the storage locations

storageLocationId*string

the ID of the storageLocation

Body

application/json

Patch set

actions*array of ModifyStorageLocationAction (all of)

version*integer (int64)

The version of the facility where we want to patch the storage locations to be used in optimistic locking mechanisms.

Example: 42

Response

200401403404

Storage location was found & you were allowed to update it.

Body

application/json

customAttributesnullable object

Attributes that can be added to this entity. These attributes cannot be used within fulfillment processes, but enable you to attach custom data from your systems to fulfillmenttools entities.

createdstring (date-time)

The date this entity was created at the platform. This value is generated by the service.

Example: "2020-02-03T08:45:51.525Z"

lastModifiedstring (date-time)

The date this entity was modified last. This value is generated by the service.

Example: "2020-02-03T09:45:51.525Z"

version*integer (int64)

The version of the document to be used in optimistic locking mechanisms.

Example: 42

Request

JavaScriptCurlPython

const response = await fetch('/api/facilities/{facilityId}/storagelocations/{storageLocationId}', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "version": 42,
      "actions": [
        {
          "action": "ModifyStorageLocation"
        }
      ]
    }),
});
const data = await response.json();

Response

200

{
  "id": "text",
  "facilityRef": "Esb20gpHBL94X5NdMp3C",
  "traits": [
    "PICKABLE"
  ],
  "traitConfig": [
    {
      "trait": "PICKABLE",
      "enabled": false
    }
  ],
  "schemaVersion": 0
}

  "runningSequences": [
    {
      "type": "PICKING_SEQUENCE",
      "previousStorageLocationRef": "string",
      "nextStorageLocationRef": "string"
    }
  ],

The running sequence defined for a storage location is prioritized over the running sequence that can be set on listing or order line item level.

Storage Location Types

Storage locations can either have the type "single storage" or the type "bulk storage".

• On locations with type "single storage", several items of the same product can be stored, e.g., 100 apples. If a product is already placed on a single-storage location, stowing of a different product on the same location is forbidden.

• On locations with type "bulk storage", different products can be stored, e.g., 100 apples and 100 bananas.

Custom Attributes

The customAttributes field is a JSON object that carries information that might be relevant to the Storage Location. The form and content of this object is completely free, but its JSON serialized size is limited. Check out the Custom Attributes section for more details.