Picking (Operations)
These endpoints support the management of the picking process.
List load units
all entities after given Id
number of loadUnits to show
25Example: 25query load units with the given pickJobRef
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fProvide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE
de_DELoad units are found
LoadUnits
Total number of found entities for this query
42Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
GET /api/loadunits HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"loadUnits": [
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"codes": [
"text"
],
"created": "2026-06-17T12:00:00.000Z",
"customAttributes": {},
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"iconUrl": "text",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2026-06-17T12:00:00.000Z",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"name": "text",
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"operativeProcessRef": "019f5b8e-d580-767f-a28d-3fe569bd0064",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"status": "AVAILABLE",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"version": 1,
"weightLimitInG": 1
}
],
"total": 42
}Create load units
LoadUnitsForCreation
Load units are successfully created.
LoadUnit
List of codes
Creation timestamp
2026-06-17T12:00:00.000ZAttributes 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.
The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request
Esb20gpHBL94X5NdMp3CUnique identifier for the load unit
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fLast modification timestamp
2026-06-17T12:00:00.000ZUse operativeContainerTypeRef instead.
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fthe reference to the operativeContainerType
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fReference to related operative process
019f5b8e-d580-767f-a28d-3fe569bd0064List of corresponding pickjob Ids
["0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f","0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"]the reference to the stackRef this loadUnit is part of
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fThe status of the load unit. It can be AVAILABLE or OBSOLETE. The status cannot be set from outside. When a load unit is created, it is automatically set to AVAILABLE. When a load unit is deleted, it is automatically set to OBSOLETE.
AVAILABLEExample: AVAILABLEPossible values: the reference to the storage location this load unit as been placed into
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fVersion number for optimistic locking
1Maximal weight in gramm(gr) the loadunit can handle.
Invalid input. See response for details.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
POST /api/loadunits HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1754
{
"loadUnits": [
{
"codes": [
"text"
],
"customAttributes": {},
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"measurementUnitKey": "liter",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
}
]
}[
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"codes": [
"text"
],
"created": "2026-06-17T12:00:00.000Z",
"customAttributes": {},
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"iconUrl": "text",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2026-06-17T12:00:00.000Z",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"name": "text",
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"operativeProcessRef": "019f5b8e-d580-767f-a28d-3fe569bd0064",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"status": "AVAILABLE",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"version": 1,
"weightLimitInG": 1
}
]Soft delete load units
Reference to the pickJob of which you want to delete the loadUnits
Load unit ids
Load units have successfully been set to OBSOLETE.
LoadUnits
Total number of found entities for this query
42Invalid input. See response for details.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
The syntax of the request content was correct, but it was unable to process the contained instructions, possibly due to semantic errors.
DELETE /api/loadunits HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"loadUnits": [
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"codes": [
"text"
],
"created": "2026-06-17T12:00:00.000Z",
"customAttributes": {},
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"iconUrl": "text",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2026-06-17T12:00:00.000Z",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"name": "text",
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"operativeProcessRef": "019f5b8e-d580-767f-a28d-3fe569bd0064",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"status": "AVAILABLE",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"version": 1,
"weightLimitInG": 1
}
],
"total": 42
}Get load unit
Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE
LoadUnit
List of codes
Creation timestamp
2026-06-17T12:00:00.000ZAttributes 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.
The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request
Esb20gpHBL94X5NdMp3CUnique identifier for the load unit
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fLast modification timestamp
2026-06-17T12:00:00.000ZUse operativeContainerTypeRef instead.
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fthe reference to the operativeContainerType
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fReference to related operative process
019f5b8e-d580-767f-a28d-3fe569bd0064List of corresponding pickjob Ids
["0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f","0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"]the reference to the stackRef this loadUnit is part of
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fThe status of the load unit. It can be AVAILABLE or OBSOLETE. The status cannot be set from outside. When a load unit is created, it is automatically set to AVAILABLE. When a load unit is deleted, it is automatically set to OBSOLETE.
AVAILABLEExample: AVAILABLEPossible values: the reference to the storage location this load unit as been placed into
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fVersion number for optimistic locking
1Maximal weight in gramm(gr) the loadunit can handle.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
GET /api/loadunits/{loadUnitId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"codes": [
"text"
],
"created": "2026-06-17T12:00:00.000Z",
"customAttributes": {},
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"iconUrl": "text",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2026-06-17T12:00:00.000Z",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"name": "text",
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"operativeProcessRef": "019f5b8e-d580-767f-a28d-3fe569bd0064",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"status": "AVAILABLE",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"version": 1,
"weightLimitInG": 1
}Soft delete a load unit
Load unit has successfully been set to OBSOLETE.
LoadUnit
List of codes
Creation timestamp
2026-06-17T12:00:00.000ZAttributes 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.
The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request
Esb20gpHBL94X5NdMp3CUnique identifier for the load unit
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fLast modification timestamp
2026-06-17T12:00:00.000ZUse operativeContainerTypeRef instead.
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fthe reference to the operativeContainerType
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fReference to related operative process
019f5b8e-d580-767f-a28d-3fe569bd0064List of corresponding pickjob Ids
["0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f","0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"]the reference to the stackRef this loadUnit is part of
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fThe status of the load unit. It can be AVAILABLE or OBSOLETE. The status cannot be set from outside. When a load unit is created, it is automatically set to AVAILABLE. When a load unit is deleted, it is automatically set to OBSOLETE.
AVAILABLEExample: AVAILABLEPossible values: the reference to the storage location this load unit as been placed into
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fVersion number for optimistic locking
1Maximal weight in gramm(gr) the loadunit can handle.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
DELETE /api/loadunits/{loadUnitId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"codes": [
"text"
],
"created": "2026-06-17T12:00:00.000Z",
"customAttributes": {},
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"iconUrl": "text",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2026-06-17T12:00:00.000Z",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"name": "text",
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"operativeProcessRef": "019f5b8e-d580-767f-a28d-3fe569bd0064",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"status": "AVAILABLE",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"version": 1,
"weightLimitInG": 1
}This part of the API is in Beta status. For details, see the API release lifecycle documentation. LoadUnitPatchActions: Deprecated - For future usage please use the /actions endpoints mentioned in the corresponding - PatchActions LoadUnit: Partial Patch on this entity.
The updated load unit
LoadUnit
List of codes
Creation timestamp
2026-06-17T12:00:00.000ZAttributes 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.
The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request
Esb20gpHBL94X5NdMp3CUnique identifier for the load unit
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fLast modification timestamp
2026-06-17T12:00:00.000ZUse operativeContainerTypeRef instead.
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fthe reference to the operativeContainerType
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fReference to related operative process
019f5b8e-d580-767f-a28d-3fe569bd0064List of corresponding pickjob Ids
["0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f","0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"]the reference to the stackRef this loadUnit is part of
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fThe status of the load unit. It can be AVAILABLE or OBSOLETE. The status cannot be set from outside. When a load unit is created, it is automatically set to AVAILABLE. When a load unit is deleted, it is automatically set to OBSOLETE.
AVAILABLEExample: AVAILABLEPossible values: the reference to the storage location this load unit as been placed into
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fVersion number for optimistic locking
1Maximal weight in gramm(gr) the loadunit can handle.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
PATCH /api/loadunits/{loadUnitId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1705
{
"actions": [
{
"action": "ReplaceLoadUnitLineItems",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
]
}
],
"version": 42
}{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"codes": [
"text"
],
"created": "2026-06-17T12:00:00.000Z",
"customAttributes": {},
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"iconUrl": "text",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2026-06-17T12:00:00.000Z",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"name": "text",
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"operativeProcessRef": "019f5b8e-d580-767f-a28d-3fe569bd0064",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"status": "AVAILABLE",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"version": 1,
"weightLimitInG": 1
}This part of the API is in Beta status. For details, see the API release lifecycle documentation. Applies actions to a load unit. Check LoadUnitActionsParameter for available actions.
Updated Load Unit via actions
LoadUnit
List of codes
Creation timestamp
2026-06-17T12:00:00.000ZAttributes 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.
The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request
Esb20gpHBL94X5NdMp3CUnique identifier for the load unit
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fLast modification timestamp
2026-06-17T12:00:00.000ZUse operativeContainerTypeRef instead.
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fthe reference to the operativeContainerType
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fReference to related operative process
019f5b8e-d580-767f-a28d-3fe569bd0064List of corresponding pickjob Ids
["0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f","0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"]the reference to the stackRef this loadUnit is part of
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fThe status of the load unit. It can be AVAILABLE or OBSOLETE. The status cannot be set from outside. When a load unit is created, it is automatically set to AVAILABLE. When a load unit is deleted, it is automatically set to OBSOLETE.
AVAILABLEExample: AVAILABLEPossible values: the reference to the storage location this load unit as been placed into
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fVersion number for optimistic locking
1Maximal weight in gramm(gr) the loadunit can handle.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
POST /api/loadunits/{loadUnitId}/actions HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 256
{
"name": "text",
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"recordableAttributeId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"version": 1
}{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"codes": [
"text"
],
"created": "2026-06-17T12:00:00.000Z",
"customAttributes": {},
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"iconUrl": "text",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2026-06-17T12:00:00.000Z",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"name": "text",
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"operativeProcessRef": "019f5b8e-d580-767f-a28d-3fe569bd0064",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"status": "AVAILABLE",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"version": 1,
"weightLimitInG": 1
}This part of the API is in Beta status. For details, see the API release lifecycle documentation. Get load unit stack
The found stack for this load unit.
Stack
The date this entity was created by fulfillmenttools. This value is generated by the service.
2020-02-03T08:45:51.525ZLinked Facilities through reference
["0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f","0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"]Unique identifier of the Stack
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fThe date this entity was modified last. This value is generated by the service.
2020-02-03T09:45:51.525ZLinked Processes through reference
["0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f","0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"]The version of the document to be used in optimistic locking mechanisms.
42Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
GET /api/loadunits/{loadUnitId}/stack HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"created": "2020-02-03T08:45:51.525Z",
"facilityRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2020-02-03T09:45:51.525Z",
"processRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"version": 42
}This part of the API is deprecated. For details, see the API release lifecycle documentation. Return all load unit types configured. Deprecated, please use OperativeContainerTypes
Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE
en-USall entities after given Id
number of entities to show
10All load unit types
LoadUnitType
Creation timestamp
2026-06-17T12:00:00.000ZCreation timestamp
2026-06-17T12:00:00.000ZThis value gives the priority in the respective loadUnitType. The lower the value the higher is the priority, e.g. priority 1 is higher than priority 10. The priority can be used to order loadUnityTypes
1001Maximal weight in gramm(gr) the loadunit can handle.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
GET /api/loadunittypes HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"created": "2026-06-17T12:00:00.000Z",
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"iconUrl": "text",
"id": "text",
"lastModified": "2026-06-17T12:00:00.000Z",
"name": "text",
"priority": 100,
"version": 1,
"weightLimitInG": 1
}
]This part of the API is deprecated. For details, see the API release lifecycle documentation. Create load unit type. Deprecated, please use OperativeContainerTypes
Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE
en-USLoadUnitTypeForCreation
This value gives the priority in the respective loadUnitType. The lower the value the higher is the priority, e.g. priority 1 is higher than priority 10. The priority can be used to order loadUnityTypes
100Maximal weight in gramm(gr) the loadunit can handle.
Successfully created resource.
LoadUnitType
Creation timestamp
2026-06-17T12:00:00.000ZCreation timestamp
2026-06-17T12:00:00.000ZThis value gives the priority in the respective loadUnitType. The lower the value the higher is the priority, e.g. priority 1 is higher than priority 10. The priority can be used to order loadUnityTypes
1001Maximal weight in gramm(gr) the loadunit can handle.
Invalid input. See response for details.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
POST /api/loadunittypes HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1305
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"icon": {
"content": "JVBERi0xLjEKJcKlwrHDqwoKMSAwIG9iagogIDw8IC9UeXBlIC9DYXRhbG9nCiAgICAgL1BhZ2VzIDIgMCBSCiAgPj4KZW5kb2JqCgoyIDAgb2JqCiAgPDwgL1R5cGUgL1BhZ2VzCiAgICAgL0tpZHMgWzMgMCBSXQogICAgIC9Db3VudCAxCiAgICAgL01lZGlhQm94IFswIDAgMzAwIDE0NF0KICA+PgplbmRvYmoKCjMgMCBvYmoKICA8PCAgL1R5cGUgL1BhZ2UKICAgICAgL1BhcmVudCAyIDAgUgogICAgICAvUmVzb3VyY2VzCiAgICAgICA8PCAvRm9udAogICAgICAgICAgIDw8IC9GMQogICAgICAgICAgICAgICA8PCAvVHlwZSAvRm9udAogICAgICAgICAgICAgICAgICAvU3VidHlwZSAvVHlwZTEKICAgICAgICAgICAgICAgICAgL0Jhc2VGb250IC9UaW1lcy1Sb21hbgogICAgICAgICAgICAgICA+PgogICAgICAgICAgID4+CiAgICAgICA+PgogICAgICAvQ29udGVudHMgNCAwIFIKICA+PgplbmRvYmoKCjQgMCBvYmoKICA8PCAvTGVuZ3RoIDU1ID4+CnN0cmVhbQogIEJUCiAgICAvRjEgMTggVGYKICAgIDAgMCBUZAogICAgKEhlbGxvIFdvcmxkKSBUagogIEVUCmVuZHN0cmVhbQplbmRvYmoKCnhyZWYKMCA1CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxOCAwMDAwMCBuIAowMDAwMDAwMDc3IDAwMDAwIG4gCjAwMDAwMDAxNzggMDAwMDAgbiAKMDAwMDAwMDQ1NyAwMDAwMCBuIAp0cmFpbGVyCiAgPDwgIC9Sb290IDEgMCBSCiAgICAgIC9TaXplIDUKICA+PgpzdGFydHhyZWYKNTY1CiUlRU9GCg==",
"name": "example.pdf"
},
"priority": 100,
"weightLimitInG": 1
}{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"created": "2026-06-17T12:00:00.000Z",
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"iconUrl": "text",
"id": "text",
"lastModified": "2026-06-17T12:00:00.000Z",
"name": "text",
"priority": 100,
"version": 1,
"weightLimitInG": 1
}This part of the API is deprecated. For details, see the API release lifecycle documentation. Get load unit type. Deprecated, please use OperativeContainerTypes
Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE
en-USThe found load unit type.
LoadUnitType
Creation timestamp
2026-06-17T12:00:00.000ZCreation timestamp
2026-06-17T12:00:00.000ZThis value gives the priority in the respective loadUnitType. The lower the value the higher is the priority, e.g. priority 1 is higher than priority 10. The priority can be used to order loadUnityTypes
1001Maximal weight in gramm(gr) the loadunit can handle.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
GET /api/loadunittypes/{loadUnitTypeId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"created": "2026-06-17T12:00:00.000Z",
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"iconUrl": "text",
"id": "text",
"lastModified": "2026-06-17T12:00:00.000Z",
"name": "text",
"priority": 100,
"version": 1,
"weightLimitInG": 1
}This part of the API is deprecated. For details, see the API release lifecycle documentation. Update load unit type. Deprecated, please use OperativeContainerTypes
Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE
en-USLoadUnitTypePatchActions
The version of the document to be used in optimistic locking mechanisms.
42Load Unit Type updated successfully.
LoadUnitType
Creation timestamp
2026-06-17T12:00:00.000ZCreation timestamp
2026-06-17T12:00:00.000ZThis value gives the priority in the respective loadUnitType. The lower the value the higher is the priority, e.g. priority 1 is higher than priority 10. The priority can be used to order loadUnityTypes
1001Maximal weight in gramm(gr) the loadunit can handle.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
PATCH /api/loadunittypes/{loadUnitTypeId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 331
{
"actions": [
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"action": "ModifyLoadUnitType",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"priority": 100,
"weightLimitInG": 1
}
],
"version": 42
}{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"created": "2026-06-17T12:00:00.000Z",
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"iconUrl": "text",
"id": "text",
"lastModified": "2026-06-17T12:00:00.000Z",
"name": "text",
"priority": 100,
"version": 1,
"weightLimitInG": 1
}This part of the API is deprecated. For details, see the API release lifecycle documentation. Update load unit type icon. Deprecated, please use OperativeContainerTypes
Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE
en-USNamedFile
File content base64 encoded
JVBERi0xLjEKJcKlwrHDqwoKMSAwIG9iagogIDw8IC9UeXBlIC9DYXRhbG9nCiAgICAgL1BhZ2VzIDIgMCBSCiAgPj4KZW5kb2JqCgoyIDAgb2JqCiAgPDwgL1R5cGUgL1BhZ2VzCiAgICAgL0tpZHMgWzMgMCBSXQogICAgIC9Db3VudCAxCiAgICAgL01lZGlhQm94IFswIDAgMzAwIDE0NF0KICA+PgplbmRvYmoKCjMgMCBvYmoKICA8PCAgL1R5cGUgL1BhZ2UKICAgICAgL1BhcmVudCAyIDAgUgogICAgICAvUmVzb3VyY2VzCiAgICAgICA8PCAvRm9udAogICAgICAgICAgIDw8IC9GMQogICAgICAgICAgICAgICA8PCAvVHlwZSAvRm9udAogICAgICAgICAgICAgICAgICAvU3VidHlwZSAvVHlwZTEKICAgICAgICAgICAgICAgICAgL0Jhc2VGb250IC9UaW1lcy1Sb21hbgogICAgICAgICAgICAgICA+PgogICAgICAgICAgID4+CiAgICAgICA+PgogICAgICAvQ29udGVudHMgNCAwIFIKICA+PgplbmRvYmoKCjQgMCBvYmoKICA8PCAvTGVuZ3RoIDU1ID4+CnN0cmVhbQogIEJUCiAgICAvRjEgMTggVGYKICAgIDAgMCBUZAogICAgKEhlbGxvIFdvcmxkKSBUagogIEVUCmVuZHN0cmVhbQplbmRvYmoKCnhyZWYKMCA1CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxOCAwMDAwMCBuIAowMDAwMDAwMDc3IDAwMDAwIG4gCjAwMDAwMDAxNzggMDAwMDAgbiAKMDAwMDAwMDQ1NyAwMDAwMCBuIAp0cmFpbGVyCiAgPDwgIC9Sb290IDEgMCBSCiAgICAgIC9TaXplIDUKICA+PgpzdGFydHhyZWYKNTY1CiUlRU9GCg==File name with extension
example.pdfSuccessfully updated load unit type icon
LoadUnitType
Creation timestamp
2026-06-17T12:00:00.000ZCreation timestamp
2026-06-17T12:00:00.000ZThis value gives the priority in the respective loadUnitType. The lower the value the higher is the priority, e.g. priority 1 is higher than priority 10. The priority can be used to order loadUnityTypes
1001Maximal weight in gramm(gr) the loadunit can handle.
Successfully created load unit type icon.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
PUT /api/loadunittypes/{loadUnitTypeId}/icon HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1023
{
"content": "JVBERi0xLjEKJcKlwrHDqwoKMSAwIG9iagogIDw8IC9UeXBlIC9DYXRhbG9nCiAgICAgL1BhZ2VzIDIgMCBSCiAgPj4KZW5kb2JqCgoyIDAgb2JqCiAgPDwgL1R5cGUgL1BhZ2VzCiAgICAgL0tpZHMgWzMgMCBSXQogICAgIC9Db3VudCAxCiAgICAgL01lZGlhQm94IFswIDAgMzAwIDE0NF0KICA+PgplbmRvYmoKCjMgMCBvYmoKICA8PCAgL1R5cGUgL1BhZ2UKICAgICAgL1BhcmVudCAyIDAgUgogICAgICAvUmVzb3VyY2VzCiAgICAgICA8PCAvRm9udAogICAgICAgICAgIDw8IC9GMQogICAgICAgICAgICAgICA8PCAvVHlwZSAvRm9udAogICAgICAgICAgICAgICAgICAvU3VidHlwZSAvVHlwZTEKICAgICAgICAgICAgICAgICAgL0Jhc2VGb250IC9UaW1lcy1Sb21hbgogICAgICAgICAgICAgICA+PgogICAgICAgICAgID4+CiAgICAgICA+PgogICAgICAvQ29udGVudHMgNCAwIFIKICA+PgplbmRvYmoKCjQgMCBvYmoKICA8PCAvTGVuZ3RoIDU1ID4+CnN0cmVhbQogIEJUCiAgICAvRjEgMTggVGYKICAgIDAgMCBUZAogICAgKEhlbGxvIFdvcmxkKSBUagogIEVUCmVuZHN0cmVhbQplbmRvYmoKCnhyZWYKMCA1CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxOCAwMDAwMCBuIAowMDAwMDAwMDc3IDAwMDAwIG4gCjAwMDAwMDAxNzggMDAwMDAgbiAKMDAwMDAwMDQ1NyAwMDAwMCBuIAp0cmFpbGVyCiAgPDwgIC9Sb290IDEgMCBSCiAgICAgIC9TaXplIDUKICA+PgpzdGFydHhyZWYKNTY1CiUlRU9GCg==",
"name": "example.pdf"
}{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"created": "2026-06-17T12:00:00.000Z",
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"iconUrl": "text",
"id": "text",
"lastModified": "2026-06-17T12:00:00.000Z",
"name": "text",
"priority": 100,
"version": 1,
"weightLimitInG": 1
}Search term you want to get the corresponding pickjobs. Search will be performed on multiple fields, like tenantOrderId, consumerName, tenantArticleId and more
Reference to the carrier you want to get the corresponding pickjobs
Reference to the orderDate you want to get the corresponding pickjobs
Reference to the orderDate you want to get the corresponding pickjobs
Reference to the order you want to get the corresponding pickjobs
Reference to the facility you want to get the corresponding pickjobs
Reference the assigned user on this entity - id or username
Reference to the status you want to get the corresponding pickjobs
Reference to the zones you want to get the corresponding pickjobs
Reference to the tenantOrderId you want to get the corresponding pickjobs
The channel of the pickJob you want to filter by
Reference to the consumer name you want to get the corresponding pickjobs
Reference to the shortId you want to get the corresponding pickjobs
Reference to the articleTitle you want to get the corresponding pickjobs
Reference to the anonymized you want to get the corresponding pickjobs
all entities after given Id
number of entities to show
25query pickjobs orderBy
Start date range for pick jobs
2020-02-03T08:45:50.525ZEnd date range for pick jobs
2020-02-03T08:45:50.525ZReference to pickjobs
Reference to the user ID you want to get the corresponding pickjobs
PickJobs were found. The results are in the body.
StrippedPickJobs
Total number of found entities for this query
42Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
GET /api/pickjobs HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"pickjobs": [
{
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"carrierKey": "DPD",
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"id": "text",
"orderRef": "LGMl2DuvPnfPoSHhYFOm",
"searchPaths": [
"text"
],
"status": "ABORTED",
"targetTime": "2020-02-03T09:45:51.525Z"
}
],
"total": 42
}PickJobForCreation
Attributes that can be added to the pickjob. These attributes cannot be used within fulfillment processes, but it could be useful to have the informations carried here.
The id of the facility reference. The given ID has to be present in the system.
Esb20gpHBL94X5NdMp3CThe date this order was created at the supplying system.
2020-02-03T08:45:50.525ZThe id of the order reference. The given ID has to be present in the system.
LGMl2DuvPnfPoSHhYFOmId of the global process related to this entity. For example used for starting the GDPR process and others.
Reference to the routingplan which created this pickjob
A short identifier that helps assigning a pick job to a customer.
AS12The status of a pickjob.
Field can be used as a reference number in foreign systems, for example as a reference to the source system's identifier for this order.
R456728546The pick job was successfully created. The Location header contains the URL of the pickjob.
VersionedResource
Attributes that can be added to the pickjob. These attributes cannot be used within fulfillment processes, but it could be useful to have the informations carried here.
The id of the facility reference. The given ID has to be present in the system.
Esb20gpHBL94X5NdMp3CThe date this order was created at the supplying system.
2020-02-03T08:45:50.525ZThe id of the order reference. The given ID has to be present in the system.
LGMl2DuvPnfPoSHhYFOmId of the global process related to this entity. For example used for starting the GDPR process and others.
Reference to the routingplan which created this pickjob
A short identifier that helps assigning a pickJob to a customer. This is automatically created during creation.
AS12The status of a pickjob.
Field can be used as a reference number in foreign systems, for example as a reference to the source system's identifier for this order.
R456728546The date this entity was created at the platform. This value is generated by the service.
2020-02-03T08:45:51.525ZThe date this entity was modified last. This value is generated by the service.
2020-02-03T09:45:51.525ZThe version of the document to be used in optimistic locking mechanisms.
42Indicates if gdpr related data was anonymized
falseReference to the documents collection from this entity
The id of this pickjob. It is generated during creation automatically and suits as the primary identifier of the described entity.
Esb20gpHBL94X5NdMp3CPick run id to which the pick job belongs
Indicates if pickJob can still be resetted or restarted
falsedeprecated: Use subStatus instead. Maintained for backward compatibility.
The reason for the current status.
Invalid input. See response for details
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
POST /api/pickjobs HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 4011
{
"assignedUsers": [
{
"username": "text"
}
],
"customAttributes": {},
"deliveryinformation": {
"channel": "COLLECT",
"details": {
"collect": {
"identifier": "text",
"paid": false
},
"shipping": {
"carrierKey": "text",
"carrierProduct": "EXPRESS",
"carrierProductCategory": "STANDARD",
"carrierServices": [
"SIGNATURE"
],
"identifier": "text",
"invoiceAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"postalAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"recipientaddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"serviceLevel": "DELIVERY"
}
},
"targetTime": "2020-02-03T09:45:51.525Z",
"targetTimeBaseDate": "2020-02-03T08:45:50.525Z"
},
"expectedPickLineItems": [],
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"operativeProcessRef": "text",
"orderDate": "2020-02-03T08:45:50.525Z",
"orderRef": "LGMl2DuvPnfPoSHhYFOm",
"paymentInformation": {
"currency": "EUR"
},
"pickingTimes": {
"startLatestAt": "2024-02-03T09:45:51.525Z"
},
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "text",
"measurementUnitKey": "pcs",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 42,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"preferredPickingMethods": [
"SINGLE_ORDER"
],
"processId": "text",
"routingPlanRef": "text",
"shortId": "AS12",
"status": "ABORTED",
"stickers": [],
"tenantOrderId": "R456728546",
"transfers": [
{
"id": "018fe899-80ec-70f8-9bda-f7cc904bc0bf",
"type": "RECEIVER"
}
],
"workflowInformation": {
"instanceRef": "64c13ab08edf48a008793cac",
"isAvailable": true,
"nodeRef": "text"
},
"tags": []
}{
"assignedUsers": [
{
"userId": "text",
"username": "text"
}
],
"customAttributes": {},
"deliveryinformation": {
"channel": "COLLECT",
"details": {
"collect": {
"identifier": "text",
"paid": false
},
"shipping": {
"carrierKey": "text",
"carrierProduct": "EXPRESS",
"carrierProductCategory": "STANDARD",
"carrierServices": [
"SIGNATURE"
],
"identifier": "text",
"invoiceAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"postalAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"recipientaddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"serviceLevel": "DELIVERY"
}
},
"targetTime": "2020-02-03T09:45:51.525Z",
"targetTimeBaseDate": "2020-02-03T08:45:50.525Z"
},
"expectedPickLineItems": [
{
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"quantity": 21,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"stickers": [],
"transferId": "text",
"tags": []
},
{
"id": "climk4dcQFiPdA5ULuhS"
}
],
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"operativeProcessRef": "text",
"orderDate": "2020-02-03T08:45:50.525Z",
"orderRef": "LGMl2DuvPnfPoSHhYFOm",
"paymentInformation": {
"currency": "EUR"
},
"pickingTimes": {
"startLatestAt": "2024-02-03T09:45:51.525Z"
},
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "a81f818e-2405-4570-8cde-b0c80fd3de31",
"id": "climk4dcQFiPdA5ULuhS",
"measurementUnitKey": "liter",
"quantity": 21,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"pickJobLineItemRef": "12345",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"scanningRules": {
"scanningMode": "MUST_SCAN_FIRST",
"scanningType": [
{
"priority": 1,
"scanningRuleType": "ARTICLE"
}
]
},
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": "{ en_US: 'SomeName' }",
"reason": "text"
},
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"customAttributes": {},
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1,
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
]
},
"globalLineItemId": "text",
"id": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"picked": 21,
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text",
"zoneName": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"priority": 1,
"quantity": 21,
"refused": [],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"secondaryPicked": 20,
"secondaryQuantity": 200
}
],
"tags": []
}
],
"preferredPickingMethods": [
"SINGLE_ORDER"
],
"processId": "text",
"routingPlanRef": "text",
"shortId": "AS12",
"status": "ABORTED",
"stickers": [],
"tenantOrderId": "R456728546",
"transfers": [
{
"id": "018fe899-80ec-70f8-9bda-f7cc904bc0bf",
"type": "RECEIVER"
}
],
"workflowInformation": {
"instanceRef": "64c13ab08edf48a008793cac",
"isAvailable": true,
"nodeRef": "text"
},
"tags": [],
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"anonymized": false,
"documentHandling": {
"sendLabel": {
"enabled": false
}
},
"documentsRef": "text",
"editor": {
"userId": "text",
"username": "text"
},
"id": "Esb20gpHBL94X5NdMp3C",
"pickingZones": [
{
"zoneRef": "text"
}
],
"pickRunRef": "text",
"resetBlocked": false,
"subStatus": "SHORT_PICKED",
"usersModificationHistory": [
{
"modificationDate": "2026-01-01T00:00:00.000Z",
"userId": "text",
"username": "text"
}
]
}ID of the pickjob you want to get
PickJob was found & you were allowed to access it. The result is in the body.
VersionedResource
Attributes that can be added to the pickjob. These attributes cannot be used within fulfillment processes, but it could be useful to have the informations carried here.
The id of the facility reference. The given ID has to be present in the system.
Esb20gpHBL94X5NdMp3CThe date this order was created at the supplying system.
2020-02-03T08:45:50.525ZThe id of the order reference. The given ID has to be present in the system.
LGMl2DuvPnfPoSHhYFOmId of the global process related to this entity. For example used for starting the GDPR process and others.
Reference to the routingplan which created this pickjob
A short identifier that helps assigning a pickJob to a customer. This is automatically created during creation.
AS12The status of a pickjob.
Field can be used as a reference number in foreign systems, for example as a reference to the source system's identifier for this order.
R456728546The date this entity was created at the platform. This value is generated by the service.
2020-02-03T08:45:51.525ZThe date this entity was modified last. This value is generated by the service.
2020-02-03T09:45:51.525ZThe version of the document to be used in optimistic locking mechanisms.
42Indicates if gdpr related data was anonymized
falseReference to the documents collection from this entity
The id of this pickjob. It is generated during creation automatically and suits as the primary identifier of the described entity.
Esb20gpHBL94X5NdMp3CPick run id to which the pick job belongs
Indicates if pickJob can still be resetted or restarted
falsedeprecated: Use subStatus instead. Maintained for backward compatibility.
The reason for the current status.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
Entity not found
GET /api/pickjobs/{pickJobId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"assignedUsers": [
{
"userId": "text",
"username": "text"
}
],
"customAttributes": {},
"deliveryinformation": {
"channel": "COLLECT",
"details": {
"collect": {
"identifier": "text",
"paid": false
},
"shipping": {
"carrierKey": "text",
"carrierProduct": "EXPRESS",
"carrierProductCategory": "STANDARD",
"carrierServices": [
"SIGNATURE"
],
"identifier": "text",
"invoiceAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"postalAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"recipientaddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"serviceLevel": "DELIVERY"
}
},
"targetTime": "2020-02-03T09:45:51.525Z",
"targetTimeBaseDate": "2020-02-03T08:45:50.525Z"
},
"expectedPickLineItems": [
{
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"quantity": 21,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"stickers": [],
"transferId": "text",
"tags": []
},
{
"id": "climk4dcQFiPdA5ULuhS"
}
],
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"operativeProcessRef": "text",
"orderDate": "2020-02-03T08:45:50.525Z",
"orderRef": "LGMl2DuvPnfPoSHhYFOm",
"paymentInformation": {
"currency": "EUR"
},
"pickingTimes": {
"startLatestAt": "2024-02-03T09:45:51.525Z"
},
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "a81f818e-2405-4570-8cde-b0c80fd3de31",
"id": "climk4dcQFiPdA5ULuhS",
"measurementUnitKey": "liter",
"quantity": 21,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"pickJobLineItemRef": "12345",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"scanningRules": {
"scanningMode": "MUST_SCAN_FIRST",
"scanningType": [
{
"priority": 1,
"scanningRuleType": "ARTICLE"
}
]
},
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": "{ en_US: 'SomeName' }",
"reason": "text"
},
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"customAttributes": {},
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1,
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
]
},
"globalLineItemId": "text",
"id": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"picked": 21,
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text",
"zoneName": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"priority": 1,
"quantity": 21,
"refused": [],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"secondaryPicked": 20,
"secondaryQuantity": 200
}
],
"tags": []
}
],
"preferredPickingMethods": [
"SINGLE_ORDER"
],
"processId": "text",
"routingPlanRef": "text",
"shortId": "AS12",
"status": "ABORTED",
"stickers": [],
"tenantOrderId": "R456728546",
"transfers": [
{
"id": "018fe899-80ec-70f8-9bda-f7cc904bc0bf",
"type": "RECEIVER"
}
],
"workflowInformation": {
"instanceRef": "64c13ab08edf48a008793cac",
"isAvailable": true,
"nodeRef": "text"
},
"tags": [],
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"anonymized": false,
"documentHandling": {
"sendLabel": {
"enabled": false
}
},
"documentsRef": "text",
"editor": {
"userId": "text",
"username": "text"
},
"id": "Esb20gpHBL94X5NdMp3C",
"pickingZones": [
{
"zoneRef": "text"
}
],
"pickRunRef": "text",
"resetBlocked": false,
"subStatus": "SHORT_PICKED",
"usersModificationHistory": [
{
"modificationDate": "2026-01-01T00:00:00.000Z",
"userId": "text",
"username": "text"
}
]
}This part of the API is deprecated. For details, see the API release lifecycle documentation. @deprecated Use POST /api/pickjobs/{pickJobId}/actions instead.
ID of the pickjob you want to get
PickingPatchActions
The version of the document to be used in optimistic locking mechanisms.
42PickJob was found & patch-set has been applied. The patched pick job is in the body.
VersionedResource
Attributes that can be added to the pickjob. These attributes cannot be used within fulfillment processes, but it could be useful to have the informations carried here.
The id of the facility reference. The given ID has to be present in the system.
Esb20gpHBL94X5NdMp3CThe date this order was created at the supplying system.
2020-02-03T08:45:50.525ZThe id of the order reference. The given ID has to be present in the system.
LGMl2DuvPnfPoSHhYFOmId of the global process related to this entity. For example used for starting the GDPR process and others.
Reference to the routingplan which created this pickjob
A short identifier that helps assigning a pickJob to a customer. This is automatically created during creation.
AS12The status of a pickjob.
Field can be used as a reference number in foreign systems, for example as a reference to the source system's identifier for this order.
R456728546The date this entity was created at the platform. This value is generated by the service.
2020-02-03T08:45:51.525ZThe date this entity was modified last. This value is generated by the service.
2020-02-03T09:45:51.525ZThe version of the document to be used in optimistic locking mechanisms.
42Indicates if gdpr related data was anonymized
falseReference to the documents collection from this entity
The id of this pickjob. It is generated during creation automatically and suits as the primary identifier of the described entity.
Esb20gpHBL94X5NdMp3CPick run id to which the pick job belongs
Indicates if pickJob can still be resetted or restarted
falsedeprecated: Use subStatus instead. Maintained for backward compatibility.
The reason for the current status.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
PickJob not found
PickJob version conflict
PATCH /api/pickjobs/{pickJobId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 641
{
"actions": [
{
"shortPickReasonLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"action": "ModifyPickLineItem",
"customAttributes": {},
"id": "climk4dcQFiPdA5ULuhS",
"partialStockLocations": [
{
"picked": 21,
"stockEmptied": true,
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"secondaryPicked": 1,
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"id": "text",
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"quantity": 21,
"secondaryPicked": 20,
"secondaryQuantity": 21,
"tenantArticleId": "text"
}
]
}
],
"version": 42
}{
"assignedUsers": [
{
"userId": "text",
"username": "text"
}
],
"customAttributes": {},
"deliveryinformation": {
"channel": "COLLECT",
"details": {
"collect": {
"identifier": "text",
"paid": false
},
"shipping": {
"carrierKey": "text",
"carrierProduct": "EXPRESS",
"carrierProductCategory": "STANDARD",
"carrierServices": [
"SIGNATURE"
],
"identifier": "text",
"invoiceAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"postalAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"recipientaddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"serviceLevel": "DELIVERY"
}
},
"targetTime": "2020-02-03T09:45:51.525Z",
"targetTimeBaseDate": "2020-02-03T08:45:50.525Z"
},
"expectedPickLineItems": [
{
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"quantity": 21,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"stickers": [],
"transferId": "text",
"tags": []
},
{
"id": "climk4dcQFiPdA5ULuhS"
}
],
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"operativeProcessRef": "text",
"orderDate": "2020-02-03T08:45:50.525Z",
"orderRef": "LGMl2DuvPnfPoSHhYFOm",
"paymentInformation": {
"currency": "EUR"
},
"pickingTimes": {
"startLatestAt": "2024-02-03T09:45:51.525Z"
},
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "a81f818e-2405-4570-8cde-b0c80fd3de31",
"id": "climk4dcQFiPdA5ULuhS",
"measurementUnitKey": "liter",
"quantity": 21,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"pickJobLineItemRef": "12345",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"scanningRules": {
"scanningMode": "MUST_SCAN_FIRST",
"scanningType": [
{
"priority": 1,
"scanningRuleType": "ARTICLE"
}
]
},
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": "{ en_US: 'SomeName' }",
"reason": "text"
},
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"customAttributes": {},
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1,
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
]
},
"globalLineItemId": "text",
"id": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"picked": 21,
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text",
"zoneName": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"priority": 1,
"quantity": 21,
"refused": [],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"secondaryPicked": 20,
"secondaryQuantity": 200
}
],
"tags": []
}
],
"preferredPickingMethods": [
"SINGLE_ORDER"
],
"processId": "text",
"routingPlanRef": "text",
"shortId": "AS12",
"status": "ABORTED",
"stickers": [],
"tenantOrderId": "R456728546",
"transfers": [
{
"id": "018fe899-80ec-70f8-9bda-f7cc904bc0bf",
"type": "RECEIVER"
}
],
"workflowInformation": {
"instanceRef": "64c13ab08edf48a008793cac",
"isAvailable": true,
"nodeRef": "text"
},
"tags": [],
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"anonymized": false,
"documentHandling": {
"sendLabel": {
"enabled": false
}
},
"documentsRef": "text",
"editor": {
"userId": "text",
"username": "text"
},
"id": "Esb20gpHBL94X5NdMp3C",
"pickingZones": [
{
"zoneRef": "text"
}
],
"pickRunRef": "text",
"resetBlocked": false,
"subStatus": "SHORT_PICKED",
"usersModificationHistory": [
{
"modificationDate": "2026-01-01T00:00:00.000Z",
"userId": "text",
"username": "text"
}
]
}Reference to the pick job you want to call an action for
PickJobActionsParameter
Updated PickJob in the body.
VersionedResource
Attributes that can be added to the pickjob. These attributes cannot be used within fulfillment processes, but it could be useful to have the informations carried here.
The id of the facility reference. The given ID has to be present in the system.
Esb20gpHBL94X5NdMp3CThe date this order was created at the supplying system.
2020-02-03T08:45:50.525ZThe id of the order reference. The given ID has to be present in the system.
LGMl2DuvPnfPoSHhYFOmId of the global process related to this entity. For example used for starting the GDPR process and others.
Reference to the routingplan which created this pickjob
A short identifier that helps assigning a pickJob to a customer. This is automatically created during creation.
AS12The status of a pickjob.
Field can be used as a reference number in foreign systems, for example as a reference to the source system's identifier for this order.
R456728546The date this entity was created at the platform. This value is generated by the service.
2020-02-03T08:45:51.525ZThe date this entity was modified last. This value is generated by the service.
2020-02-03T09:45:51.525ZThe version of the document to be used in optimistic locking mechanisms.
42Indicates if gdpr related data was anonymized
falseReference to the documents collection from this entity
The id of this pickjob. It is generated during creation automatically and suits as the primary identifier of the described entity.
Esb20gpHBL94X5NdMp3CPick run id to which the pick job belongs
Indicates if pickJob can still be resetted or restarted
falsedeprecated: Use subStatus instead. Maintained for backward compatibility.
The reason for the current status.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
POST /api/pickjobs/{pickJobId}/actions HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 28
{
"name": "ABORT",
"version": 1
}{
"assignedUsers": [
{
"userId": "text",
"username": "text"
}
],
"customAttributes": {},
"deliveryinformation": {
"channel": "COLLECT",
"details": {
"collect": {
"identifier": "text",
"paid": false
},
"shipping": {
"carrierKey": "text",
"carrierProduct": "EXPRESS",
"carrierProductCategory": "STANDARD",
"carrierServices": [
"SIGNATURE"
],
"identifier": "text",
"invoiceAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"postalAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"recipientaddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"serviceLevel": "DELIVERY"
}
},
"targetTime": "2020-02-03T09:45:51.525Z",
"targetTimeBaseDate": "2020-02-03T08:45:50.525Z"
},
"expectedPickLineItems": [
{
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"quantity": 21,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"stickers": [],
"transferId": "text",
"tags": []
},
{
"id": "climk4dcQFiPdA5ULuhS"
}
],
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"operativeProcessRef": "text",
"orderDate": "2020-02-03T08:45:50.525Z",
"orderRef": "LGMl2DuvPnfPoSHhYFOm",
"paymentInformation": {
"currency": "EUR"
},
"pickingTimes": {
"startLatestAt": "2024-02-03T09:45:51.525Z"
},
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "a81f818e-2405-4570-8cde-b0c80fd3de31",
"id": "climk4dcQFiPdA5ULuhS",
"measurementUnitKey": "liter",
"quantity": 21,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"pickJobLineItemRef": "12345",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"scanningRules": {
"scanningMode": "MUST_SCAN_FIRST",
"scanningType": [
{
"priority": 1,
"scanningRuleType": "ARTICLE"
}
]
},
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": "{ en_US: 'SomeName' }",
"reason": "text"
},
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"customAttributes": {},
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1,
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
]
},
"globalLineItemId": "text",
"id": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"picked": 21,
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text",
"zoneName": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"priority": 1,
"quantity": 21,
"refused": [],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"secondaryPicked": 20,
"secondaryQuantity": 200
}
],
"tags": []
}
],
"preferredPickingMethods": [
"SINGLE_ORDER"
],
"processId": "text",
"routingPlanRef": "text",
"shortId": "AS12",
"status": "ABORTED",
"stickers": [],
"tenantOrderId": "R456728546",
"transfers": [
{
"id": "018fe899-80ec-70f8-9bda-f7cc904bc0bf",
"type": "RECEIVER"
}
],
"workflowInformation": {
"instanceRef": "64c13ab08edf48a008793cac",
"isAvailable": true,
"nodeRef": "text"
},
"tags": [],
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"anonymized": false,
"documentHandling": {
"sendLabel": {
"enabled": false
}
},
"documentsRef": "text",
"editor": {
"userId": "text",
"username": "text"
},
"id": "Esb20gpHBL94X5NdMp3C",
"pickingZones": [
{
"zoneRef": "text"
}
],
"pickRunRef": "text",
"resetBlocked": false,
"subStatus": "SHORT_PICKED",
"usersModificationHistory": [
{
"modificationDate": "2026-01-01T00:00:00.000Z",
"userId": "text",
"username": "text"
}
]
}ID of the pick job for which you want to get a deliverynote
Provide the localized values for the delivery note. If not provided the default locale is used. For example de_DE
The deliverynote for the given pickjob
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
Entity not found
GET /api/pickjobs/{pickJobId}/deliverynote HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Get all load units for the given pick job
Loadunits were found. The results are in the body.
LoadUnits
Total number of found entities for this query
42Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
GET /api/pickjobs/{pickJobId}/loadunits HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"loadUnits": [
{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"codes": [
"text"
],
"created": "2026-06-17T12:00:00.000Z",
"customAttributes": {},
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"iconUrl": "text",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2026-06-17T12:00:00.000Z",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"name": "text",
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"operativeProcessRef": "019f5b8e-d580-767f-a28d-3fe569bd0064",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"status": "AVAILABLE",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"version": 1,
"weightLimitInG": 1
}
],
"total": 42
}Create new load units for the given pick job
PickingLoadUnitForCreation
List of codes
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.
Use operativeContainerTypeRef instead.
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fthe reference to the operativeContainerType
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fthe reference to the stackRef this loadUnit is part of
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fthe reference to the storage location this load unit as been placed into
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fThe load units was successfully created.
LoadUnit
List of codes
Creation timestamp
2026-06-17T12:00:00.000ZAttributes 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.
The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request
Esb20gpHBL94X5NdMp3CUnique identifier for the load unit
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fLast modification timestamp
2026-06-17T12:00:00.000ZUse operativeContainerTypeRef instead.
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fthe reference to the operativeContainerType
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fReference to related operative process
019f5b8e-d580-767f-a28d-3fe569bd0064List of corresponding pickjob Ids
["0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f","0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"]the reference to the stackRef this loadUnit is part of
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fThe status of the load unit. It can be AVAILABLE or OBSOLETE. The status cannot be set from outside. When a load unit is created, it is automatically set to AVAILABLE. When a load unit is deleted, it is automatically set to OBSOLETE.
AVAILABLEExample: AVAILABLEPossible values: the reference to the storage location this load unit as been placed into
0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2fVersion number for optimistic locking
1Maximal weight in gramm(gr) the loadunit can handle.
Invalid input. See response for details.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
The requested entity was not found
POST /api/pickjobs/{pickJobId}/loadunits HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1644
{
"codes": [
"text"
],
"customAttributes": {},
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"measurementUnitKey": "liter",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
}{
"nameLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"descriptionLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"codes": [
"text"
],
"created": "2026-06-17T12:00:00.000Z",
"customAttributes": {},
"description": "text",
"dimensions": {
"heightInCm": 50,
"lengthInCm": 100,
"weightInG": 1700,
"widthInCm": 25
},
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"iconUrl": "text",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": "2026-06-17T12:00:00.000Z",
"loadUnitLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"customAttributes": {},
"imageUrl": "text",
"tenantArticleId": "text",
"title": "text",
"weight": 1
},
"customAttributes": {},
"globalLineItemIds": [
"text"
],
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"measurementUnitKey": "liter",
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"quantity": 1,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "g",
"secondaryQuantity": 1,
"substituteForOrderedItem": {
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"globalLineItemId": "text"
}
}
],
"name": "text",
"operativeContainerTypeRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"operativeProcessRef": "019f5b8e-d580-767f-a28d-3fe569bd0064",
"pickJobRefs": [
"0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
],
"stackRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"status": "AVAILABLE",
"storageLocationRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"version": 1,
"weightLimitInG": 1
}This part of the API is in Beta status. For details, see the API release lifecycle documentation. Returns all available substitutes for a given pickLineItem.
Reference to the pick job you to get the available substitutes for
Reference to the pickLineItem you to get the available substitutes for
Available substitutes for given pickLineItem
ResolvedSubstitutes
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
GET /api/pickjobs/{pickJobId}/picklineitems/{pickLineItemId}/availablesubstitutes HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"substitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"tenantArticleId": "text"
}ID of the Pickjob
Returns a return note for the pickjob.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
Entity not found
GET /api/pickjobs/{pickjobId}/returnnote HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
ID of the pick job for which you want to get a transfer label
The transfer label for the given pickjob
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
Entity not found
GET /api/pickjobs/{pickJobId}/transferlabel HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Search for PickJob
PickJobSearchPayload
The cursor to start after for forward pagination. The value is provided in the pageInfo.endCursor field of the response. Cannot be used with before or last.
The cursor to start before for backward pagination. The value is provided in the pageInfo.startCursor field of the response. Cannot be used with after or size (first).
Number of items to return for backward pagination. Cannot be used with 'size' (first). Default: 20.
Number of items to return for forward pagination. Cannot be used with 'last'. Default: 20.
10The ID to start after. Deprecated, use after with the value provided in pageInfo.endCursor instead.
Your search result
PickJobPaginatedResult
The total number of items matching the search criteria. Only filled, if withTotal is set to true in the search options.
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
POST /api/pickjobs/search HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 5908
{
"after": "text",
"before": "text",
"last": 1,
"options": {
"withTotal": true
},
"query": {
"and": [
{
"and": [
{
"and": "[Circular Reference]",
"consumerName": {
"eq": "text",
"in": [
"text"
],
"like": "text",
"notEq": "text",
"notIn": [
"text"
]
},
"created": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"or": "[Circular Reference]",
"orderRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"preferredPickingMethods": {
"contains": {
"eq": "SINGLE_ORDER",
"in": [
"SINGLE_ORDER"
],
"notEq": "SINGLE_ORDER"
}
},
"status": {
"eq": "ABORTED",
"in": [
"ABORTED"
],
"notEq": "ABORTED"
},
"targetTime": "2026-06-17T12:00:00.000Z",
"tenantArticleIds": {
"contains": {
"eq": "text",
"notEq": "text"
}
},
"tenantOrderId": "MY_ORDER_ID",
"transfers": {
"contains": {
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
},
"exists": true
}
}
],
"consumerName": {
"eq": "text",
"in": [
"text"
],
"like": "text",
"notEq": "text",
"notIn": [
"text"
]
},
"created": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"or": [
{
"and": "[Circular Reference]",
"consumerName": {
"eq": "text",
"in": [
"text"
],
"like": "text",
"notEq": "text",
"notIn": [
"text"
]
},
"created": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"or": "[Circular Reference]",
"orderRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"preferredPickingMethods": {
"contains": {
"eq": "SINGLE_ORDER",
"in": [
"SINGLE_ORDER"
],
"notEq": "SINGLE_ORDER"
}
},
"status": {
"eq": "ABORTED",
"in": [
"ABORTED"
],
"notEq": "ABORTED"
},
"targetTime": "2026-06-17T12:00:00.000Z",
"tenantArticleIds": {
"contains": {
"eq": "text",
"notEq": "text"
}
},
"tenantOrderId": "MY_ORDER_ID",
"transfers": {
"contains": {
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
},
"exists": true
}
}
],
"orderRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"preferredPickingMethods": {
"contains": {
"eq": "SINGLE_ORDER",
"in": [
"SINGLE_ORDER"
],
"notEq": "SINGLE_ORDER"
}
},
"status": {
"eq": "ABORTED",
"in": [
"ABORTED"
],
"notEq": "ABORTED"
},
"targetTime": "2026-06-17T12:00:00.000Z",
"tenantArticleIds": {
"contains": {
"eq": "text",
"notEq": "text"
}
},
"tenantOrderId": "MY_ORDER_ID",
"transfers": {
"contains": {
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
},
"exists": true
}
}
],
"consumerName": {
"eq": "text",
"in": [
"text"
],
"like": "text",
"notEq": "text",
"notIn": [
"text"
]
},
"created": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"or": [
{
"and": "[Circular Reference]",
"consumerName": {
"eq": "text",
"in": [
"text"
],
"like": "text",
"notEq": "text",
"notIn": [
"text"
]
},
"created": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"lastModified": {
"after": "text",
"before": "text",
"eq": "2026-01-01T00:00:00.000Z",
"gt": "2026-01-01T00:00:00.000Z",
"gte": "2026-01-01T00:00:00.000Z",
"lt": "2026-01-01T00:00:00.000Z",
"lte": "2026-01-01T00:00:00.000Z",
"notEq": "2026-01-01T00:00:00.000Z"
},
"or": "[Circular Reference]",
"orderRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"preferredPickingMethods": {
"contains": {
"eq": "SINGLE_ORDER",
"in": [
"SINGLE_ORDER"
],
"notEq": "SINGLE_ORDER"
}
},
"status": {
"eq": "ABORTED",
"in": [
"ABORTED"
],
"notEq": "ABORTED"
},
"targetTime": "2026-06-17T12:00:00.000Z",
"tenantArticleIds": {
"contains": {
"eq": "text",
"notEq": "text"
}
},
"tenantOrderId": "MY_ORDER_ID",
"transfers": {
"contains": {
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
},
"exists": true
}
}
],
"orderRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
"preferredPickingMethods": {
"contains": {
"eq": "SINGLE_ORDER",
"in": [
"SINGLE_ORDER"
],
"notEq": "SINGLE_ORDER"
}
},
"status": {
"eq": "ABORTED",
"in": [
"ABORTED"
],
"notEq": "ABORTED"
},
"targetTime": "2026-06-17T12:00:00.000Z",
"tenantArticleIds": {
"contains": {
"eq": "text",
"notEq": "text"
}
},
"tenantOrderId": "MY_ORDER_ID",
"transfers": {
"contains": {
"id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
},
"exists": true
}
},
"size": 10,
"sort": [
{
"created": "ASC",
"lastModified": "ASC",
"targetTime": "ASC",
"tenantOrderId": "ASC"
}
]
}{
"pageInfo": {
"endCursor": "text",
"hasNextPage": true,
"hasPreviousPage": true,
"startCursor": "text"
},
"pickJobs": [
{
"assignedUsers": [
{
"userId": "text",
"username": "text"
}
],
"customAttributes": {},
"deliveryinformation": {
"channel": "COLLECT",
"details": {
"collect": {
"identifier": "text",
"paid": false
},
"shipping": {
"carrierKey": "text",
"carrierProduct": "EXPRESS",
"carrierProductCategory": "STANDARD",
"carrierServices": [
"SIGNATURE"
],
"identifier": "text",
"invoiceAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"postalAddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"recipientaddress": {
"addressType": "POSTAL_ADDRESS",
"companyName": "Speedy Boxales Ltd.",
"coordinates": {
"lat": 50.937531,
"lon": 6.960279
},
"email": "test@try.de",
"firstName": "Maxine",
"lastName": "Muller",
"personalTitle": "Dr.",
"salutation": "Frau",
"additionalAddressInfo": "to care of: Mrs. Müller",
"city": "Langenfeld",
"country": "DE",
"customAttributes": {},
"houseNumber": "42a",
"phoneNumbers": [
{
"customAttributes": {},
"label": "text",
"type": "MOBILE",
"value": "text"
}
],
"postalCode": "40764",
"province": "NRW",
"street": "Hauptstr."
},
"serviceLevel": "DELIVERY"
}
},
"targetTime": "2020-02-03T09:45:51.525Z",
"targetTimeBaseDate": "2020-02-03T08:45:50.525Z"
},
"expectedPickLineItems": [
{
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"quantity": 21,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"stickers": [],
"transferId": "text",
"tags": []
},
{
"id": "climk4dcQFiPdA5ULuhS"
}
],
"facilityRef": "Esb20gpHBL94X5NdMp3C",
"operativeProcessRef": "text",
"orderDate": "2020-02-03T08:45:50.525Z",
"orderRef": "LGMl2DuvPnfPoSHhYFOm",
"paymentInformation": {
"currency": "EUR"
},
"pickingTimes": {
"startLatestAt": "2024-02-03T09:45:51.525Z"
},
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "a81f818e-2405-4570-8cde-b0c80fd3de31",
"id": "climk4dcQFiPdA5ULuhS",
"measurementUnitKey": "liter",
"quantity": 21,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"pickJobLineItemRef": "12345",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"scanningRules": {
"scanningMode": "MUST_SCAN_FIRST",
"scanningType": [
{
"priority": 1,
"scanningRuleType": "ARTICLE"
}
]
},
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": "{ en_US: 'SomeName' }",
"reason": "text"
},
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"customAttributes": {},
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1,
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
]
},
"globalLineItemId": "text",
"id": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"picked": 21,
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text",
"zoneName": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"priority": 1,
"quantity": 21,
"refused": [],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"secondaryPicked": 20,
"secondaryQuantity": 200
}
],
"tags": []
}
],
"preferredPickingMethods": [
"SINGLE_ORDER"
],
"processId": "text",
"routingPlanRef": "text",
"shortId": "AS12",
"status": "ABORTED",
"stickers": [],
"tenantOrderId": "R456728546",
"transfers": [
{
"id": "018fe899-80ec-70f8-9bda-f7cc904bc0bf",
"type": "RECEIVER"
}
],
"workflowInformation": {
"instanceRef": "64c13ab08edf48a008793cac",
"isAvailable": true,
"nodeRef": "text"
},
"tags": [],
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"anonymized": false,
"documentHandling": {
"sendLabel": {
"enabled": false
}
},
"documentsRef": "text",
"editor": {
"userId": "text",
"username": "text"
},
"id": "Esb20gpHBL94X5NdMp3C",
"pickingZones": [
{
"zoneRef": "text"
}
],
"pickRunRef": "text",
"resetBlocked": false,
"subStatus": "SHORT_PICKED",
"usersModificationHistory": [
{
"modificationDate": "2026-01-01T00:00:00.000Z",
"userId": "text",
"username": "text"
}
]
}
],
"total": 1
}PickRunForCreation
Deprecated: batchPick, use batch instead Deprecated: multiOrderPick, use multiOrder instead
batchPickPossible values: The state of the PickRun
The PickRun was successfully created. The Location header contains the URL of it.
PickRun
The date this entity was created at the platform. This value is generated by the service.
2020-02-03T08:45:51.525ZThe date this entity was modified last. This value is generated by the service.
2020-02-03T09:45:51.525ZThe version of the document to be used in optimistic locking mechanisms.
42Deprecated: batchPick, use batch instead Deprecated: multiOrderPick, use multiOrder instead
batchPickPossible values: The state of the PickRun
Invalid input. See response for details
Your user is not allowed to operate against this API instance
POST /api/pickruns HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87
{
"facilityRef": "text",
"pickJobRefs": [
"text"
],
"pickRunType": "batchPick",
"status": "OPEN"
}{
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"editor": {
"userId": "text",
"username": "text"
},
"facilityRef": "text",
"id": "text",
"pickJobRefs": [
"text"
],
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "text",
"id": "climk4dcQFiPdA5ULuhS",
"measurementUnitKey": "liter",
"quantity": 21,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"globalLineItemIds": [
"text"
],
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"pickJobLineItemRef": "12345",
"pickJobRef": "text",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"scanningRules": {
"scanningMode": "MUST_SCAN_FIRST",
"scanningType": [
{
"priority": 1,
"scanningRuleType": "ARTICLE"
}
]
},
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": "{ en_US: 'SomeName' }",
"reason": "text"
},
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"customAttributes": {},
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1,
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
]
},
"globalLineItemId": "text",
"id": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"picked": 21,
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text",
"zoneName": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"priority": 1,
"quantity": 21,
"refused": [],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"secondaryPicked": 20,
"secondaryQuantity": 200
}
],
"tags": []
}
],
"pickRunType": "batchPick",
"status": "OPEN"
}id of pickRun
PickRun is found.
PickRun
The date this entity was created at the platform. This value is generated by the service.
2020-02-03T08:45:51.525ZThe date this entity was modified last. This value is generated by the service.
2020-02-03T09:45:51.525ZThe version of the document to be used in optimistic locking mechanisms.
42Deprecated: batchPick, use batch instead Deprecated: multiOrderPick, use multiOrder instead
batchPickPossible values: The state of the PickRun
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
GET /api/pickruns/{pickRunId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"editor": {
"userId": "text",
"username": "text"
},
"facilityRef": "text",
"id": "text",
"pickJobRefs": [
"text"
],
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "text",
"id": "climk4dcQFiPdA5ULuhS",
"measurementUnitKey": "liter",
"quantity": 21,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"globalLineItemIds": [
"text"
],
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"pickJobLineItemRef": "12345",
"pickJobRef": "text",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"scanningRules": {
"scanningMode": "MUST_SCAN_FIRST",
"scanningType": [
{
"priority": 1,
"scanningRuleType": "ARTICLE"
}
]
},
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": "{ en_US: 'SomeName' }",
"reason": "text"
},
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"customAttributes": {},
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1,
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
]
},
"globalLineItemId": "text",
"id": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"picked": 21,
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text",
"zoneName": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"priority": 1,
"quantity": 21,
"refused": [],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"secondaryPicked": 20,
"secondaryQuantity": 200
}
],
"tags": []
}
],
"pickRunType": "batchPick",
"status": "OPEN"
}id of pickRun
PickRunPatchAction
The version of the document to be used in optimistic locking mechanisms.
42The updated PickRun.
PickRun
The date this entity was created at the platform. This value is generated by the service.
2020-02-03T08:45:51.525ZThe date this entity was modified last. This value is generated by the service.
2020-02-03T09:45:51.525ZThe version of the document to be used in optimistic locking mechanisms.
42Deprecated: batchPick, use batch instead Deprecated: multiOrderPick, use multiOrder instead
batchPickPossible values: The state of the PickRun
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
Version conflict
PATCH /api/pickruns/{pickRunId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 344
{
"actions": [
{
"action": "ModifyPickRunLineItem",
"id": "climk4dcQFiPdA5ULuhS",
"partialStockLocations": [
{
"picked": 21,
"stockEmptied": true,
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
}
},
"status": "OPEN"
}
],
"version": 42
}{
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"editor": {
"userId": "text",
"username": "text"
},
"facilityRef": "text",
"id": "text",
"pickJobRefs": [
"text"
],
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "text",
"id": "climk4dcQFiPdA5ULuhS",
"measurementUnitKey": "liter",
"quantity": 21,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"globalLineItemIds": [
"text"
],
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"pickJobLineItemRef": "12345",
"pickJobRef": "text",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"scanningRules": {
"scanningMode": "MUST_SCAN_FIRST",
"scanningType": [
{
"priority": 1,
"scanningRuleType": "ARTICLE"
}
]
},
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": "{ en_US: 'SomeName' }",
"reason": "text"
},
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"customAttributes": {},
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1,
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
]
},
"globalLineItemId": "text",
"id": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"picked": 21,
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text",
"zoneName": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"priority": 1,
"quantity": 21,
"refused": [],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"secondaryPicked": 20,
"secondaryQuantity": 200
}
],
"tags": []
}
],
"pickRunType": "batchPick",
"status": "OPEN"
}Reference to the pick run you want to call the action for
PickRunActionsParameter
Updated Pick Run in the body.
PickRun
The date this entity was created at the platform. This value is generated by the service.
2020-02-03T08:45:51.525ZThe date this entity was modified last. This value is generated by the service.
2020-02-03T09:45:51.525ZThe version of the document to be used in optimistic locking mechanisms.
42Deprecated: batchPick, use batch instead Deprecated: multiOrderPick, use multiOrder instead
batchPickPossible values: The state of the PickRun
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
POST /api/pickruns/{pickRunId}/actions HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 28
{
"name": "START",
"version": 1
}{
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 42,
"editor": {
"userId": "text",
"username": "text"
},
"facilityRef": "text",
"id": "text",
"pickJobRefs": [
"text"
],
"pickLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1
},
"customAttributes": {},
"globalLineItemId": "text",
"id": "climk4dcQFiPdA5ULuhS",
"measurementUnitKey": "liter",
"quantity": 21,
"recordableAttributes": [
{
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"group": "general",
"id": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"key": "country of origin",
"originId": "17ebfdfb-e1b4-4913-9962-3aef2b49f16f",
"recordingRule": "MANDATORY",
"value": "Germany"
}
],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "liter",
"secondaryQuantity": 21,
"allowedSubstitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"globalLineItemIds": [
"text"
],
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"originId": "df671041-10dd-4600-a2ff-e9ffe2556bba",
"partialStockLocations": [
{
"available": 21,
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"pickJobLineItemRef": "12345",
"pickJobRef": "text",
"scannedCodes": [
{
"code": 1245678,
"quantity": 7
}
],
"scanningRules": {
"scanningMode": "MUST_SCAN_FIRST",
"scanningType": [
{
"priority": 1,
"scanningRuleType": "ARTICLE"
}
]
},
"secondaryPicked": 20,
"shortPickReason": {
"reasonLocalized": "{ en_US: 'SomeName' }",
"reason": "text"
},
"status": "OPEN",
"stickers": [],
"stockEmptied": true,
"substituteLineItems": [
{
"article": {
"titleLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"customAttributes": {},
"imageUrl": "https://example.com/resource",
"tenantArticleId": "4711",
"title": "Cologne Water",
"weight": 1,
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
]
},
"globalLineItemId": "text",
"id": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"partialStockLocations": [
{
"location": {
"locationRef": "text",
"scannableCodes": [
"text"
]
},
"picked": 21,
"quantity": 21,
"ratingScore": 1,
"sequenceScore": 1,
"stockProperties": {
"expiry": "text"
},
"stockRef": "text",
"tenantPartialStockId": "text",
"zoneName": "text"
}
],
"picked": 20,
"pickedAt": "2024-02-03T08:45:51.525Z",
"priority": 1,
"quantity": 21,
"refused": [],
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"secondaryPicked": 20,
"secondaryQuantity": 200
}
],
"tags": []
}
],
"pickRunType": "batchPick",
"status": "OPEN"
}id of pickRun
PickRunPickJobsPatchAction
The version of the document to be used in optimistic locking mechanisms.
42Pick job was successfully from pick run removed.
No content
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
PATCH /api/pickruns/{pickRunId}/pickjobs HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 27
{
"actions": [],
"version": 42
}No content
the tenantArticleId substitutes are requested for
There are substitutes for the given tenantArticleId. The result can be found in the body.
Substitutes
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
Facility not found
GET /api/substitutes?tenantArticleId=text HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "text",
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 1,
"substitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"tenantArticleId": "text"
}Get the substitutes for a given tenant article id
The substitutes for the given tenantArticleId can be found in the body.
Substitutes
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
Facility not found
GET /api/substitutes/{tenantArticleId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "text",
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 1,
"substitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"tenantArticleId": "text"
}Tenant article ID of the article the substitutes should be set for
SubstitutesForUpsert
Version field is used in the optimistic locking process. If the Substitute is for the tenantArticleId is not set yet, this field is ignored.
1The substitutes for tenantArticleId were successfully updated
Substitutes
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
Facility listing not found
PUT /api/substitutes/{tenantArticleId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 713
{
"substitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"tenantArticleId": "text",
"version": 1
}{
"id": "text",
"created": "2020-02-03T08:45:51.525Z",
"lastModified": "2020-02-03T09:45:51.525Z",
"version": 1,
"substitutes": [
{
"attributes": [
{
"valueLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"keyLocalized": {
"de_DE": "Wert",
"en_US": "Value",
"ru_RU": "значение"
},
"category": "descriptive",
"context": {
"type": "FACILITY_GROUP",
"value": "text"
},
"key": "%%subtitle%%",
"priority": 100,
"type": "STRING",
"value": "585er Gold"
}
],
"imageUrl": "text",
"measurementUnitKey": "liter",
"measurementValidation": {
"overPickHardTolerancePercentage": 20,
"overPickSoftTolerancePercentage": 15,
"shortPickHardTolerancePercentage": 15,
"shortPickSoftTolerancePercentage": 10
},
"priority": 1,
"scannableCodes": [
"text"
],
"secondaryMeasurementUnitKey": "gram",
"tenantArticleId": "text",
"title": "text"
}
],
"tenantArticleId": "text"
}the tenant article ID the subsitutes should be deleted for
The substitutes for the given tenantArticleId were successfully deleted
No content
Your user is not allowed to operate against this API instance
Your user, although recognized, is not authorized to use this endpoint
Facility listing not found
DELETE /api/substitutes/{tenantArticleId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Last updated
Was this helpful?

