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

patch

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.

Path parameters

facilityIdstringRequired

ID of facility you want to patch the storage locations

storageLocationIdstringRequired

the ID of the storageLocation

Body

versioninteger · int64Required

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

Example: 42

Responses

200

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

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility or Storage location not found

application/json

patch

HTTPcURLJavaScriptPython

PATCH /api/facilities/{facilityId}/storagelocations/{storageLocationId} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 396

{
  "actions": [
    {
      "action": "ModifyStorageLocation",
      "name": "text",
      "tenantLocationId": "text",
      "type": "SINGLE_STORAGE",
      "traitConfig": [
        {
          "trait": "PICKABLE",
          "enabled": true
        }
      ],
      "scannableCodes": [
        "text"
      ],
      "runningSequences": [
        {
          "type": "PICKING_SEQUENCE",
          "previousStorageLocationRef": "text",
          "nextStorageLocationRef": "text"
        }
      ],
      "zoneRef": "Esb20gpHBL94X5NdMp3C",
      "information": "text",
      "customAttributes": {}
    }
  ],
  "version": 42
}

{
  "id": "text",
  "facilityRef": "Esb20gpHBL94X5NdMp3C",
  "traits": [
    "PICKABLE"
  ],
  "traitConfig": [
    {
      "trait": "PICKABLE",
      "enabled": true
    }
  ],
  "schemaVersion": 1,
  "version": 42,
  "name": "text",
  "tenantLocationId": "text",
  "type": "SINGLE_STORAGE",
  "scannableCodes": [
    "text"
  ],
  "runningSequences": [
    {
      "type": "PICKING_SEQUENCE",
      "previousStorageLocationRef": "text",
      "nextStorageLocationRef": "text"
    }
  ],
  "zoneRef": "Esb20gpHBL94X5NdMp3C",
  "zoneName": "text",
  "information": "text",
  "customAttributes": {},
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z"
}

  "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.