Short Pick Reasons

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

If a picking task cannot be completed because some of the required items are unavailable, it is referred to as a shortpick. To provide clarity on why specific picking tasks cannot be fulfilled entirely, we've incorporated shortpick reasons into the line items of each picking task.

To integrate these reasons into a pickline item, they must be predefined in a configuration file. These reasons are constructed using a multi-language JSON format and are translated accordingly.

The multi language JSON looks like this, with all possible 2-code country codes as valid keys:

{
  "reasonLocalized": {
    "de_DE": "Artikel nicht gefunden",
    "en_US": "Item not found"
  }
}

Add or change configuration

Picking configuration with shortpick reasons

{
  "pickingShortPickConfiguration": {
    "shortPickReasons": [
      {
        "de_DE": "Artikel nicht gefunden",
        "en_US": "Item not found"
      }
    ]
  }
}

Change the tenant wide picking central configuration

patch

Body

Responses

200

The picking central configuration was successfully updated.

application/json

201

The picking central configuration was successfully created.

application/json

400

Invalid input. See response for details

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

patch

HTTPcURLJavaScriptPython

PATCH /api/configurations/picking HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 961

{
  "pickingShortPickConfiguration": {
    "confirmationOnShortPick": true,
    "shortPickReasons": []
  },
  "scanningConfiguration": {
    "scanningType": "MUST_SCAN_FIRST",
    "scanningRule": {
      "values": []
    },
    "rolesWithOverwritingScanningPermission": [
      "FULFILLER"
    ]
  },
  "scanCodeValidationConfiguration": {
    "pickingScanCodeValidationType": "NO_VALIDATION"
  },
  "takeOverPickJobConfiguration": {
    "active": true
  },
  "scheduledPickJobReleaseConfiguration": {
    "openPickJobLeadTimeInMinutes": 1
  },
  "loadUnitAssignmentConfiguration": {
    "pickJob": "AT_END",
    "pickRun": "AT_END"
  },
  "pickingMethodsConfiguration": {
    "defaultPickingMethod": "SINGLE_ORDER"
  },
  "restartPickJobConfiguration": {
    "active": true
  },
  "stockUpdateConfiguration": {
    "active": true
  },
  "backofficePickingConfiguration": {
    "active": true
  },
  "multiOrderPickingConfiguration": {
    "maxAmountOfPickJobsForMultiOrderPick": 1
  },
  "storageLocationAssignmentConfiguration": {
    "storageLocationRequired": "ALL"
  },
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "version": 42
}

{
  "pickingShortPickConfiguration": {
    "confirmationOnShortPick": true,
    "shortPickReasons": []
  },
  "scanningConfiguration": {
    "scanningType": "MUST_SCAN_FIRST",
    "scanningRule": {
      "values": []
    },
    "rolesWithOverwritingScanningPermission": [
      "FULFILLER"
    ]
  },
  "scanCodeValidationConfiguration": {
    "pickingScanCodeValidationType": "NO_VALIDATION"
  },
  "takeOverPickJobConfiguration": {
    "active": true
  },
  "scheduledPickJobReleaseConfiguration": {
    "openPickJobLeadTimeInMinutes": 1
  },
  "loadUnitAssignmentConfiguration": {
    "pickJob": "AT_END",
    "pickRun": "AT_END"
  },
  "pickingMethodsConfiguration": {
    "defaultPickingMethod": "SINGLE_ORDER"
  },
  "restartPickJobConfiguration": {
    "active": true
  },
  "stockUpdateConfiguration": {
    "active": true
  },
  "backofficePickingConfiguration": {
    "active": true
  },
  "multiOrderPickingConfiguration": {
    "maxAmountOfPickJobsForMultiOrderPick": 1
  },
  "storageLocationAssignmentConfiguration": {
    "storageLocationRequired": "ALL"
  },
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "version": 42
}

Add reasons to a picking task.

Adding shortpick reasons is currently under development. It may not be possible to add shortpick reasons to pickline items at this moment.

Shortpick reasons can be added through the API methods of our PickJobs. See:

Headless Order Fulfillment

A lineitem with shortpick reasons can look like this.

{
  "id": "87b6d771-ad00-45cb-a00c-527d182a9f57",
  "status": "CLOSED",
  "article": {
    "title": "Item-Name",
    "tenantArticleId": "daf9e470-23f1-4d99-87e8-f20aafc85e0a"
  },
  "quantity": 5,
  "picked": 4,
  "shortPickReasons": [
    {
      "reasonLocalized": {
        "de_DE": "Artikel nicht gefunden",
        "en_US": "Item not found"
      }
    }
  ]
}

When accessed through the API, shortpick reasons will be translated into the required language. The language is determined either by the requested locale or the user's default locale. If neither is specified, the translation will default to the first available localizedReason, or if unavailable, it will default to the localization for "en_US".

If a picking task is restarted or reseted, the shortpick reasons on the pickline items will be deleted.