Picking endpoints

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

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

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

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}

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

Get pick job document handling

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

ID of the pick job you want to get document handling information

Responses
200

Pick job document handling was found & you were allowed to access it. The result is in the body.

application/json

DocumentHandling

get
/api/pickjobs/{pickJobId}/documenthandling

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

Create pick job load unit

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

Reference to the pick job you want to get the corresponding loadunits

Body

PickingLoadUnitForCreation

sequenceNumberinteger · int32 · max: 10000Optional

Incremental number to distinguish containers of the same type. Virtual container's sequenceNumber is always 0, non virtual containers are always greater than 0.

Example: 100
codesstring[] · min: 1Required

List of codes

customAttributesobjectOptional

Attributes that can be added to the PickingLoadUnit. These attributes cannot be used within fulfillment processes, but it could be useful to have the informations carried here.

loadUnitTypeRefstringOptional
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 pick job load units

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

Reference to the pick job you want to get the corresponding loadunits

Responses
200

Loadunits were found. The results are in the body.

application/json

LoadUnits

totalintegerOptional

Total number of found entities for this query

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

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 tag config

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
200

pickjob tag config is in response body.

application/json

PickJobTagConfiguration

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
get
/api/configurations/tags/pickjob

Update pick job tag config

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

PickJobTagConfiguration

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
Responses
200

The packing configuration was successfully updated.

application/json

PickJobTagConfiguration

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
put
/api/configurations/tags/pickjob

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

Last updated