Picking (Operations)

These endpoints support the management of the picking process.

List load units

get

List load units

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startAfterIdstringOptional

all entities after given Id

sizeintegerOptional

number of loadUnits to show

Default: 25
pickJobRefstringOptional

query load units with the given pickJobRef

localestringOptional

Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE

Example: de_DE
Responses
200

Load units are found

application/json

LoadUnits

totalintegerRequired

Total number of found entities for this query

Example: 42
get
/api/loadunits

Create load units

post

Create load units

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

LoadUnitsForCreation

Responses
post
/api/loadunits

Delete load units

delete

Delete load units

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
pickJobRefstringOptional

Reference to the pickJob of which you want to delete the loadUnits

idstring[]Optional

Load unit ids

Responses
200

Load units are successfully deleted.

application/json

LoadUnits

totalintegerRequired

Total number of found entities for this query

Example: 42
delete
/api/loadunits

Get load unit

get

Get load unit

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
loadUnitIdstringRequired
Query parameters
localestringOptional

Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE

Responses
200Success
application/json

LoadUnit

codesstring[] · max: 100Optional

List of codes

createdstring · date-timeRequired

Creation timestamp

customAttributesobject · nullableOptional

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.

descriptionstringOptional
facilityRefstringRequired

The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request

Example: Esb20gpHBL94X5NdMp3C
iconUrlstringOptional
idstringRequired

Unique identifier for the load unit

lastModifiedstring · date-timeRequired

Last modification timestamp

loadUnitTypeRefstringOptionalDeprecated

Use operativeContainerTypeRef instead.

namestringOptional
operativeContainerTypeRefstringOptional

the reference to the operativeContainerType

pickJobRefsstring[] · min: 1 · max: 100Required

List of corresponding pickjob Ids

stackRefstringOptional

the reference to the stackRef this loadUnit is part of

storageLocationRefstringOptional

the reference to the storage location this load unit as been placed into

versionintegerRequired

Version number for optimistic locking

weightLimitInGnumber · min: 1Optional

Maximal weight in gramm(gr) the loadunit can handle.

get
/api/loadunits/{loadUnitId}

Delete load unit

delete

Delete load unit

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
loadUnitIdstringRequired
Responses
200

Successfully deleted load unit.

application/json

LoadUnit

codesstring[] · max: 100Optional

List of codes

createdstring · date-timeRequired

Creation timestamp

customAttributesobject · nullableOptional

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.

descriptionstringOptional
facilityRefstringRequired

The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request

Example: Esb20gpHBL94X5NdMp3C
iconUrlstringOptional
idstringRequired

Unique identifier for the load unit

lastModifiedstring · date-timeRequired

Last modification timestamp

loadUnitTypeRefstringOptionalDeprecated

Use operativeContainerTypeRef instead.

namestringOptional
operativeContainerTypeRefstringOptional

the reference to the operativeContainerType

pickJobRefsstring[] · min: 1 · max: 100Required

List of corresponding pickjob Ids

stackRefstringOptional

the reference to the stackRef this loadUnit is part of

storageLocationRefstringOptional

the reference to the storage location this load unit as been placed into

versionintegerRequired

Version number for optimistic locking

weightLimitInGnumber · min: 1Optional

Maximal weight in gramm(gr) the loadunit can handle.

delete
/api/loadunits/{loadUnitId}

Update load unit.

patch

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. LoadUnitPatchActions: Deprecated - For future usage please use the /actions endpoints mentioned in the corresponding - PatchActions LoadUnit: Partial Patch on this entity.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
loadUnitIdstringRequired
Body
or
Responses
200

The updated load unit

application/json

LoadUnit

codesstring[] · max: 100Optional

List of codes

createdstring · date-timeRequired

Creation timestamp

customAttributesobject · nullableOptional

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.

descriptionstringOptional
facilityRefstringRequired

The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request

Example: Esb20gpHBL94X5NdMp3C
iconUrlstringOptional
idstringRequired

Unique identifier for the load unit

lastModifiedstring · date-timeRequired

Last modification timestamp

loadUnitTypeRefstringOptionalDeprecated

Use operativeContainerTypeRef instead.

namestringOptional
operativeContainerTypeRefstringOptional

the reference to the operativeContainerType

pickJobRefsstring[] · min: 1 · max: 100Required

List of corresponding pickjob Ids

stackRefstringOptional

the reference to the stackRef this loadUnit is part of

storageLocationRefstringOptional

the reference to the storage location this load unit as been placed into

versionintegerRequired

Version number for optimistic locking

weightLimitInGnumber · min: 1Optional

Maximal weight in gramm(gr) the loadunit can handle.

patch
/api/loadunits/{loadUnitId}

Applies actions to a load unit. Check LoadUnitActionsParameter for available actions.

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. Applies actions to a load unit. Check LoadUnitActionsParameter for available actions.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
loadUnitIdstringRequired
Body
Responses
200

Updated Load Unit via actions

application/json

LoadUnit

codesstring[] · max: 100Optional

List of codes

createdstring · date-timeRequired

Creation timestamp

customAttributesobject · nullableOptional

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.

descriptionstringOptional
facilityRefstringRequired

The id of the facility reference. The given ID has to be present in the system. But it is not updatable via PUT request

Example: Esb20gpHBL94X5NdMp3C
iconUrlstringOptional
idstringRequired

Unique identifier for the load unit

lastModifiedstring · date-timeRequired

Last modification timestamp

loadUnitTypeRefstringOptionalDeprecated

Use operativeContainerTypeRef instead.

namestringOptional
operativeContainerTypeRefstringOptional

the reference to the operativeContainerType

pickJobRefsstring[] · min: 1 · max: 100Required

List of corresponding pickjob Ids

stackRefstringOptional

the reference to the stackRef this loadUnit is part of

storageLocationRefstringOptional

the reference to the storage location this load unit as been placed into

versionintegerRequired

Version number for optimistic locking

weightLimitInGnumber · min: 1Optional

Maximal weight in gramm(gr) the loadunit can handle.

post
/api/loadunits/{loadUnitId}/actions

Get load unit stack

get

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. Get load unit stack

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
loadUnitIdstringRequired
Responses
200

The found stack for this load unit.

application/json

Stack

createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
facilityRefsstring[] · max: 50Required

Linked Facilities through reference

idstringRequired

Unique identifier of the Stack

lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
processRefsstring[] · max: 50Required

Linked Processes through reference

versioninteger · int64Required

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

Example: 42
get
/api/loadunits/{loadUnitId}/stack
Deprecated

List load unit types

get

This part of the API is deprecated. For details please check the api-release-life-cycle documentation. Return all load unit types configured. Deprecated, please use OperativeContainerTypes

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
localestringOptional

Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE

startAfterIdstringOptional

all entities after given Id

sizeintegerOptional

number of entities to show

Responses
200

All load unit types

application/json

LoadUnitType

createdstring · date-timeOptional

Creation timestamp

descriptionstringOptional
iconUrlstringOptional
idstringRequired
lastModifiedstring · date-timeOptional

Creation timestamp

namestringOptional
priorityinteger · int64 · min: 1 · max: 10000Optional

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

Example: 100
versionnumberRequired
weightLimitInGnumber · min: 1Optional

Maximal weight in gramm(gr) the loadunit can handle.

get
/api/loadunittypes
Deprecated

Create load unit type

post

This part of the API is deprecated. For details please check the api-release-life-cycle documentation. Create load unit type. Deprecated, please use OperativeContainerTypes

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
localestringOptional

Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE

Body

LoadUnitTypeForCreation

priorityinteger · int64 · min: 1 · max: 10000Optional

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

Example: 100
weightLimitInGnumber · min: 1Optional

Maximal weight in gramm(gr) the loadunit can handle.

Responses
post
/api/loadunittypes
Deprecated

Get load unit type

get

This part of the API is deprecated. For details please check the api-release-life-cycle documentation. Get load unit type. Deprecated, please use OperativeContainerTypes

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
loadUnitTypeIdstringRequired
Query parameters
localestringOptional

Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE

Responses
200

The found load unit type.

application/json

LoadUnitType

createdstring · date-timeOptional

Creation timestamp

descriptionstringOptional
iconUrlstringOptional
idstringRequired
lastModifiedstring · date-timeOptional

Creation timestamp

namestringOptional
priorityinteger · int64 · min: 1 · max: 10000Optional

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

Example: 100
versionnumberRequired
weightLimitInGnumber · min: 1Optional

Maximal weight in gramm(gr) the loadunit can handle.

get
/api/loadunittypes/{loadUnitTypeId}
Deprecated

Update load unit type

patch

This part of the API is deprecated. For details please check the api-release-life-cycle documentation. Update load unit type. Deprecated, please use OperativeContainerTypes

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
loadUnitTypeIdstringRequired
Query parameters
localestringOptional

Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE

Body

LoadUnitTypePatchActions

versionintegerRequired

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

Example: 42
Responses
200

Load Unit Type updated successfully.

application/json

LoadUnitType

createdstring · date-timeOptional

Creation timestamp

descriptionstringOptional
iconUrlstringOptional
idstringRequired
lastModifiedstring · date-timeOptional

Creation timestamp

namestringOptional
priorityinteger · int64 · min: 1 · max: 10000Optional

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

Example: 100
versionnumberRequired
weightLimitInGnumber · min: 1Optional

Maximal weight in gramm(gr) the loadunit can handle.

patch
/api/loadunittypes/{loadUnitTypeId}
Deprecated

Update load unit type icon

put

This part of the API is deprecated. For details please check the api-release-life-cycle documentation. Update load unit type icon. Deprecated, please use OperativeContainerTypes

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
loadUnitTypeIdstringRequired
Query parameters
localestringOptional

Provide the localized names and descriptions if found. If not provided the default locale is used. Example de_DE

Body

NamedFile

contentstringRequired

File content base64 encoded

Example: JVBERi0xLjEKJcKlwrHDqwoKMSAwIG9iagogIDw8IC9UeXBlIC9DYXRhbG9nCiAgICAgL1BhZ2VzIDIgMCBSCiAgPj4KZW5kb2JqCgoyIDAgb2JqCiAgPDwgL1R5cGUgL1BhZ2VzCiAgICAgL0tpZHMgWzMgMCBSXQogICAgIC9Db3VudCAxCiAgICAgL01lZGlhQm94IFswIDAgMzAwIDE0NF0KICA+PgplbmRvYmoKCjMgMCBvYmoKICA8PCAgL1R5cGUgL1BhZ2UKICAgICAgL1BhcmVudCAyIDAgUgogICAgICAvUmVzb3VyY2VzCiAgICAgICA8PCAvRm9udAogICAgICAgICAgIDw8IC9GMQogICAgICAgICAgICAgICA8PCAvVHlwZSAvRm9udAogICAgICAgICAgICAgICAgICAvU3VidHlwZSAvVHlwZTEKICAgICAgICAgICAgICAgICAgL0Jhc2VGb250IC9UaW1lcy1Sb21hbgogICAgICAgICAgICAgICA+PgogICAgICAgICAgID4+CiAgICAgICA+PgogICAgICAvQ29udGVudHMgNCAwIFIKICA+PgplbmRvYmoKCjQgMCBvYmoKICA8PCAvTGVuZ3RoIDU1ID4+CnN0cmVhbQogIEJUCiAgICAvRjEgMTggVGYKICAgIDAgMCBUZAogICAgKEhlbGxvIFdvcmxkKSBUagogIEVUCmVuZHN0cmVhbQplbmRvYmoKCnhyZWYKMCA1CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxOCAwMDAwMCBuIAowMDAwMDAwMDc3IDAwMDAwIG4gCjAwMDAwMDAxNzggMDAwMDAgbiAKMDAwMDAwMDQ1NyAwMDAwMCBuIAp0cmFpbGVyCiAgPDwgIC9Sb290IDEgMCBSCiAgICAgIC9TaXplIDUKICA+PgpzdGFydHhyZWYKNTY1CiUlRU9GCg==
namestringRequired

File name with extension

Example: example.pdf
Responses
200

Successfully updated load unit type icon

application/json

LoadUnitType

createdstring · date-timeOptional

Creation timestamp

descriptionstringOptional
iconUrlstringOptional
idstringRequired
lastModifiedstring · date-timeOptional

Creation timestamp

namestringOptional
priorityinteger · int64 · min: 1 · max: 10000Optional

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

Example: 100
versionnumberRequired
weightLimitInGnumber · min: 1Optional

Maximal weight in gramm(gr) the loadunit can handle.

put
/api/loadunittypes/{loadUnitTypeId}/icon

List pick jobs

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
searchTermstringOptional

Search term you want to get the corresponding pickjobs. Search will be performed on multiple fields, like tenantOrderId, consumerName, tenantArticleId and more

carrierKeysstring[]Optional

Reference to the carrier you want to get the corresponding pickjobs

startOrderDatestringOptional

Reference to the orderDate you want to get the corresponding pickjobs

endOrderDatestringOptional

Reference to the orderDate you want to get the corresponding pickjobs

orderRefstringOptional

Reference to the order you want to get the corresponding pickjobs

facilityRefstringOptional

Reference to the facility you want to get the corresponding pickjobs

assignedUserstringOptional

Reference the assigned user on this entity - id or username

statusstring[]Optional

Reference to the status you want to get the corresponding pickjobs

zoneRefsstring[]Optional

Reference to the zones you want to get the corresponding pickjobs

tenantOrderIdstringOptional

Reference to the tenantOrderId you want to get the corresponding pickjobs

channelstring · enumOptional

The channel of the pickJob you want to filter by

Possible values:
consumerNamestringOptional

Reference to the consumer name you want to get the corresponding pickjobs

shortIdstringOptional

Reference to the shortId you want to get the corresponding pickjobs

articleTitlestringOptional

Reference to the articleTitle you want to get the corresponding pickjobs

anonymizedbooleanOptional

Reference to the anonymized you want to get the corresponding pickjobs

startAfterIdstringOptional

all entities after given Id

sizeintegerOptional

number of entities to show

Default: 25
orderBystringOptional

query pickjobs orderBy

startTargetTimestring · date-timeOptional

Start date range for pick jobs

Example: 2020-02-03T08:45:50.525Z
endTargetTimestring · date-timeOptional

End date range for pick jobs

Example: 2020-02-03T08:45:50.525Z
pickJobRefsstring[]Optional

Reference to pickjobs

modifiedByUsernamestringOptional

Reference to the user ID you want to get the corresponding pickjobs

Responses
200

PickJobs were found. The results are in the body.

application/json

StrippedPickJobs

totalintegerOptional

Total number of found entities for this query

Example: 42
get
/api/pickjobs

Create pick job

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

PickJobForCreation

customAttributesobjectOptional

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.

facilityRefstringRequired

The id of the facility reference. The given ID has to be present in the system.

Example: Esb20gpHBL94X5NdMp3C
operativeProcessRefstringOptional
orderDatestring · date-timeRequired

The date this order was created at the supplying system.

Example: 2020-02-03T08:45:50.525Z
orderRefstringOptional

The id of the order reference. The given ID has to be present in the system.

Example: LGMl2DuvPnfPoSHhYFOm
processIdstringOptional

Id of the global process related to this entity. For example used for starting the GDPR process and others.

routingPlanRefstringOptional

Reference to the routingplan which created this pickjob

shortIdstringOptional

A short identifier that helps assigning a pick job to a customer.

Example: AS12
statusstring · enumOptional

The status of a pickjob.

Possible values:
tenantOrderIdstringOptional

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.

Example: R456728546
workflowInformationone ofOptional
or
Responses
post
/api/pickjobs

Get pick job

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickJobIdstringRequired

ID of the pickjob you want to get

Responses
200

PickJob was found & you were allowed to access it. The result is in the body.

application/json

VersionedResource

customAttributesobjectOptional

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.

facilityRefstringRequired

The id of the facility reference. The given ID has to be present in the system.

Example: Esb20gpHBL94X5NdMp3C
operativeProcessRefstringOptional
orderDatestring · date-timeRequired

The date this order was created at the supplying system.

Example: 2020-02-03T08:45:50.525Z
orderRefstringOptional

The id of the order reference. The given ID has to be present in the system.

Example: LGMl2DuvPnfPoSHhYFOm
processIdstringOptional

Id of the global process related to this entity. For example used for starting the GDPR process and others.

routingPlanRefstringOptional

Reference to the routingplan which created this pickjob

shortIdstringRequired

A short identifier that helps assigning a pickJob to a customer. This is automatically created during creation.

Example: AS12
statusstring · enumRequired

The status of a pickjob.

Possible values:
tenantOrderIdstringOptional

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.

Example: R456728546
workflowInformationone ofRequired
or
createdstring · date-timeOptional

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

Example: 2020-02-03T08:45:51.525Z
lastModifiedstring · date-timeOptional

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

Example: 2020-02-03T09:45:51.525Z
versioninteger · int64Required

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

Example: 42
anonymizedbooleanOptional

Indicates if gdpr related data was anonymized

Example: false
documentsRefstringRequired

Reference to the documents collection from this entity

idstringRequired

The id of this pickjob. It is generated during creation automatically and suits as the primary identifier of the described entity.

Example: Esb20gpHBL94X5NdMp3C
pickRunRefstringOptional

Pick run id to which the pick job belongs

resetBlockedbooleanOptional

Indicates if pickJob can still be resetted or restarted

Default: false
statusReasonstringOptionalDeprecated

deprecated: Use subStatus instead. Maintained for backward compatibility.

subStatusstring · enumOptional

The reason for the current status.

Possible values:
get
/api/pickjobs/{pickJobId}
Deprecated

Update pick job

patch

This part of the API is deprecated. For details please check the api-release-life-cycle documentation. @deprecated Use POST /api/pickjobs/{pickJobId}/actions instead.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickJobIdstringRequired

ID of the pickjob you want to get

Body

PickingPatchActions

versioninteger · int64Required

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

Example: 42
Responses
200

PickJob was found & patch-set has been applied. The patched pick job is in the body.

application/json

VersionedResource

customAttributesobjectOptional

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.

facilityRefstringRequired

The id of the facility reference. The given ID has to be present in the system.

Example: Esb20gpHBL94X5NdMp3C
operativeProcessRefstringOptional
orderDatestring · date-timeRequired

The date this order was created at the supplying system.

Example: 2020-02-03T08:45:50.525Z
orderRefstringOptional

The id of the order reference. The given ID has to be present in the system.

Example: LGMl2DuvPnfPoSHhYFOm
processIdstringOptional

Id of the global process related to this entity. For example used for starting the GDPR process and others.

routingPlanRefstringOptional

Reference to the routingplan which created this pickjob

shortIdstringRequired

A short identifier that helps assigning a pickJob to a customer. This is automatically created during creation.

Example: AS12
statusstring · enumRequired

The status of a pickjob.

Possible values:
tenantOrderIdstringOptional

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.

Example: R456728546
workflowInformationone ofRequired
or
createdstring · date-timeOptional

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

Example: 2020-02-03T08:45:51.525Z
lastModifiedstring · date-timeOptional

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

Example: 2020-02-03T09:45:51.525Z
versioninteger · int64Required

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

Example: 42
anonymizedbooleanOptional

Indicates if gdpr related data was anonymized

Example: false
documentsRefstringRequired

Reference to the documents collection from this entity

idstringRequired

The id of this pickjob. It is generated during creation automatically and suits as the primary identifier of the described entity.

Example: Esb20gpHBL94X5NdMp3C
pickRunRefstringOptional

Pick run id to which the pick job belongs

resetBlockedbooleanOptional

Indicates if pickJob can still be resetted or restarted

Default: false
statusReasonstringOptionalDeprecated

deprecated: Use subStatus instead. Maintained for backward compatibility.

subStatusstring · enumOptional

The reason for the current status.

Possible values:
patch
/api/pickjobs/{pickJobId}

Call pick job action

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickJobIdstringRequired

Reference to the pick job you want to call an action for

Body

PickJobActionsParameter

or
or
or
or
or
or
or
or
or
or
or
Responses
200

Updated PickJob in the body.

application/json

VersionedResource

customAttributesobjectOptional

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.

facilityRefstringRequired

The id of the facility reference. The given ID has to be present in the system.

Example: Esb20gpHBL94X5NdMp3C
operativeProcessRefstringOptional
orderDatestring · date-timeRequired

The date this order was created at the supplying system.

Example: 2020-02-03T08:45:50.525Z
orderRefstringOptional

The id of the order reference. The given ID has to be present in the system.

Example: LGMl2DuvPnfPoSHhYFOm
processIdstringOptional

Id of the global process related to this entity. For example used for starting the GDPR process and others.

routingPlanRefstringOptional

Reference to the routingplan which created this pickjob

shortIdstringRequired

A short identifier that helps assigning a pickJob to a customer. This is automatically created during creation.

Example: AS12
statusstring · enumRequired

The status of a pickjob.

Possible values:
tenantOrderIdstringOptional

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.

Example: R456728546
workflowInformationone ofRequired
or
createdstring · date-timeOptional

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

Example: 2020-02-03T08:45:51.525Z
lastModifiedstring · date-timeOptional

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

Example: 2020-02-03T09:45:51.525Z
versioninteger · int64Required

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

Example: 42
anonymizedbooleanOptional

Indicates if gdpr related data was anonymized

Example: false
documentsRefstringRequired

Reference to the documents collection from this entity

idstringRequired

The id of this pickjob. It is generated during creation automatically and suits as the primary identifier of the described entity.

Example: Esb20gpHBL94X5NdMp3C
pickRunRefstringOptional

Pick run id to which the pick job belongs

resetBlockedbooleanOptional

Indicates if pickJob can still be resetted or restarted

Default: false
statusReasonstringOptionalDeprecated

deprecated: Use subStatus instead. Maintained for backward compatibility.

subStatusstring · enumOptional

The reason for the current status.

Possible values:
post
/api/pickjobs/{pickJobId}/actions

Get pick job delivery note

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickJobIdstringRequired

ID of the pick job for which you want to get a deliverynote

Query parameters
localestringOptional

Provide the localized values for the delivery note. If not provided the default locale is used. For example de_DE

Responses
200

The deliverynote for the given pickjob

application/pdf
get
/api/pickjobs/{pickJobId}/deliverynote

List pick job load units

get

Get all load units for the given pick job

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickJobIdstringRequired
Responses
200

Loadunits were found. The results are in the body.

application/json

LoadUnits

totalintegerRequired

Total number of found entities for this query

Example: 42
get
/api/pickjobs/{pickJobId}/loadunits

Create pick job load unit

post

Create new load units for the given pick job

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickJobIdstringRequired
Body

PickingLoadUnitForCreation

codesstring[] · min: 1 · max: 100Required

List of codes

customAttributesobject · nullableOptional

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.

loadUnitTypeRefstringOptionalDeprecated

Use operativeContainerTypeRef instead.

operativeContainerTypeRefstringOptional

the reference to the operativeContainerType

stackRefstringOptional

the reference to the stackRef this loadUnit is part of

storageLocationRefstringOptional

the reference to the storage location this load unit as been placed into

Responses
post
/api/pickjobs/{pickJobId}/loadunits

List available line item substitutes

get

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. Returns all available substitutes for a given pickLineItem.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickJobIdstringRequired

Reference to the pick job you to get the available substitutes for

pickLineItemIdstringRequired

Reference to the pickLineItem you to get the available substitutes for

Responses
200

Available substitutes for given pickLineItem

application/json

ResolvedSubstitutes

tenantArticleIdstringRequired
get
/api/pickjobs/{pickJobId}/picklineitems/{pickLineItemId}/availablesubstitutes

Get pick job return note

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickjobIdstringRequired

ID of the Pickjob

Responses
200

Returns a return note for the pickjob.

application/pdf
get
/api/pickjobs/{pickjobId}/returnnote

Get pick job transfer label

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickJobIdstringRequired

ID of the pick job for which you want to get a transfer label

Responses
200

The transfer label for the given pickjob

application/pdf
get
/api/pickjobs/{pickJobId}/transferlabel

List pick jobs (search)

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. Search for PickJob

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

PickJobSearchPayload

afterstringOptional

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.

beforestringOptional

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

lastnumber · min: 1 · max: 250Optional

Number of items to return for backward pagination. Cannot be used with 'size' (first). Default: 20.

sizenumber · min: 1 · max: 250Optional

Number of items to return for forward pagination. Cannot be used with 'last'. Default: 20.

startAfterIdstringOptionalDeprecated

The ID to start after. Deprecated, use after with the value provided in pageInfo.endCursor instead.

Responses
200

Your search result

application/json

PickJobPaginatedResult

totalnumberOptional

The total number of items matching the search criteria. Only filled, if withTotal is set to true in the search options.

post
/api/pickjobs/search

Create pick run

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

PickRunForCreation

facilityRefstringRequired
pickJobRefsstring[] · min: 1Required
pickRunTypestring · enumOptional

Deprecated: batchPick, use batch instead Deprecated: multiOrderPick, use multiOrder instead

Default: batchPickPossible values:
statusstring · enumOptional

The state of the PickRun

Possible values:
Responses
post
/api/pickruns

Get pick run

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickRunIdstringRequired

id of pickRun

Responses
200

PickRun is found.

application/json

PickRun

createdstring · date-timeOptional

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

Example: 2020-02-03T08:45:51.525Z
lastModifiedstring · date-timeOptional

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

Example: 2020-02-03T09:45:51.525Z
versioninteger · int64Required

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

Example: 42
facilityRefstringRequired
idstringRequired
pickJobRefsstring[]Required
pickRunTypestring · enumOptional

Deprecated: batchPick, use batch instead Deprecated: multiOrderPick, use multiOrder instead

Default: batchPickPossible values:
statusstring · enumRequired

The state of the PickRun

Possible values:
get
/api/pickruns/{pickRunId}

Update pick run

patch
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickRunIdstringRequired

id of pickRun

Body

PickRunPatchAction

versioninteger · int64Required

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

Example: 42
Responses
200

The updated PickRun.

application/json

PickRun

createdstring · date-timeOptional

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

Example: 2020-02-03T08:45:51.525Z
lastModifiedstring · date-timeOptional

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

Example: 2020-02-03T09:45:51.525Z
versioninteger · int64Required

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

Example: 42
facilityRefstringRequired
idstringRequired
pickJobRefsstring[]Required
pickRunTypestring · enumOptional

Deprecated: batchPick, use batch instead Deprecated: multiOrderPick, use multiOrder instead

Default: batchPickPossible values:
statusstring · enumRequired

The state of the PickRun

Possible values:
patch
/api/pickruns/{pickRunId}

Call pick run action

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickRunIdstringRequired

Reference to the pick run you want to call the action for

Body

PickRunActionsParameter

or
or
or
or
or
or
or
Responses
200

Updated Pick Run in the body.

application/json

PickRun

createdstring · date-timeOptional

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

Example: 2020-02-03T08:45:51.525Z
lastModifiedstring · date-timeOptional

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

Example: 2020-02-03T09:45:51.525Z
versioninteger · int64Required

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

Example: 42
facilityRefstringRequired
idstringRequired
pickJobRefsstring[]Required
pickRunTypestring · enumOptional

Deprecated: batchPick, use batch instead Deprecated: multiOrderPick, use multiOrder instead

Default: batchPickPossible values:
statusstring · enumRequired

The state of the PickRun

Possible values:
post
/api/pickruns/{pickRunId}/actions

Update pick run pick jobs

patch
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
pickRunIdstringRequired

id of pickRun

Body

PickRunPickJobsPatchAction

versioninteger · int64Required

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

Example: 42
Responses
200

Pick job was successfully from pick run removed.

No content

patch
/api/pickruns/{pickRunId}/pickjobs

No content

List substitutes

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
tenantArticleIdstringRequired

the tenantArticleId substitutes are requested for

Responses
200

There are substitutes for the given tenantArticleId. The result can be found in the body.

application/json

Substitutes

and
get
/api/substitutes

Get substitutes

get

Get the substitutes for a given tenant article id

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
tenantArticleIdstringRequired
Responses
200

The substitutes for the given tenantArticleId can be found in the body.

application/json

Substitutes

and
get
/api/substitutes/{tenantArticleId}

Set substitutes

put
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
tenantArticleIdstringRequired

Tenant article ID of the article the substitutes should be set for

Body

SubstitutesForUpsert

tenantArticleIdstringRequired
versionnumberRequired

Version field is used in the optimistic locking process. If the Substitute is for the tenantArticleId is not set yet, this field is ignored.

Example: 1
Responses
200

The substitutes for tenantArticleId were successfully updated

application/json

Substitutes

and
put
/api/substitutes/{tenantArticleId}

Delete substitutes

delete
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
tenantArticleIdstringRequired

the tenant article ID the subsitutes should be deleted for

Responses
200

The substitutes for the given tenantArticleId were successfully deleted

No content

delete
/api/substitutes/{tenantArticleId}

No content

Last updated