Bearer authentication header of the form Bearer <token>.
Body
ProcessSearchPayload
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
ProcessPaginatedResult
totalnumberOptional
The total number of items matching the search criteria. Only filled, if withTotal is set to true in the search options.
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
Bearer authentication header of the form Bearer <token>.
Body
InboundProcessSearchPayload
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
InboundProcessPaginatedResult
totalnumberOptional
The total number of items matching the search criteria. Only filled, if withTotal is set to true in the search options.
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
application/json
post
/api/inboundprocesses/search
Create inbound process
post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
InboundProcessForCreation
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.
facilityRefstringRequired
Facility in which the inbound process takes place
onHoldbooleanOptional
Indicates if the inbound process is on hold and will not be processed further
scannableCodesstring[]Optional
scannableCodes such as barcodes that are relevant in the inboundProcess, e.g. , barcode of the delivery note
tenantInboundProcessIdstringOptional
Identifier of the process provided by the tenant system. It is recommended to be unique
Responses
200
Created Inbound Process entity
application/json
InboundProcess
anonymizedbooleanRequired
Indicates the inbound process was anonymized acording to configured GDPR retention time.
createdstring · date-timeRequired
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.
facilityRefstringRequired
idstringRequired
inboundDatestring · date-time[]Required
Aggregated dates from sources which advise incoming stock. Currently that is "purchaseOrder"
lastModifiedstring · date-timeRequired
onHoldbooleanRequired
Indicates if the inbound process is on hold and will not be processed further
scannableCodesstring[]Required
scannableCodes such as barcodes that are relevant in the inboundProcess, e.g. , barcode of the delivery note
statusstring · enumRequiredPossible values:
tenantInboundProcessIdstringOptional
versionnumberRequired
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
The document with given id attached to the selected process
Create inbound process receipt
post
This part of the API is in Beta status. For details please check the api-release-life-cycle documentation.
Adds a receipt to an inbound process.
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
inboundProcessIdstringRequired
Body
InboundReceiptForCreation
asnRefstringOptional
enables mapping a receipt to one of the ASNs in this inbound process
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.
receivedDatestring · date-timeRequired
date-time of the arrival of the items in the facility
statusstring · enumOptional
status of this receipt, only receipts with status 'FINISHED' are booked. IN_PROGRESS can be used to save partial receipts.
Possible values:
Responses
201
Receipt was added to the inbound process
application/json
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
Bearer authentication header of the form Bearer <token>.
Path parameters
inboundProcessIdstringRequired
Body
InboundProcessForPatch
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.
onHoldbooleanOptional
Indicates if the inbound process is on hold and will not be processed further
scannableCodesstring[]Optional
scannableCodes such as barcodes that are relevant in the inboundProcess, e.g. , barcode of the delivery note
versionnumberRequired
Responses
200
Inbound Process successfully patched
No content
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
application/json
patch
/api/inboundprocesses/{inboundProcessId}
No content
Get inbound process
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
inboundProcessIdstringRequired
Responses
200
Requested Inbound Process entity
application/json
InboundProcess
anonymizedbooleanRequired
Indicates the inbound process was anonymized acording to configured GDPR retention time.
createdstring · date-timeRequired
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.
facilityRefstringRequired
idstringRequired
inboundDatestring · date-time[]Required
Aggregated dates from sources which advise incoming stock. Currently that is "purchaseOrder"
lastModifiedstring · date-timeRequired
onHoldbooleanRequired
Indicates if the inbound process is on hold and will not be processed further
scannableCodesstring[]Required
scannableCodes such as barcodes that are relevant in the inboundProcess, e.g. , barcode of the delivery note
statusstring · enumRequiredPossible values:
tenantInboundProcessIdstringOptional
versionnumberRequired
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
application/json
get
/api/inboundprocesses/{inboundProcessId}
List inbound processes
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
sizenumber · min: 1 · max: 100OptionalDefault: 25
startAfterIdstringOptional
sortstring · enumOptionalPossible values:
facilityRefstring[]Optional
scannableCodestringOptional
searchTermstringOptional
Matches partial values; The queries terms and therefore the result set of the query can change in the future:
tenantInboundProcessId
scannableCodes
receipts.receivedItems.tenantArticleId
purchaseOrder.requestedItems.tenantArticleId
purchaseOrder.supplier.name
values of related listings
listing.title
listing.scannableCodes
searchTermExactstringOptional
Only matches complete values; The queries terms and therefore the result set of the query can change in the future:
tenantInboundProcessId
scannableCodes
receipts.receivedItems.tenantArticleId
purchaseOrder.requestedItems.tenantArticleId
purchaseOrder.supplier.name
values of related listings
listing.title
listing.scannableCodes
purchaseOrder_cancelledbooleanOptional
Responses
200
Paginated result containing the matching Inbound Process entities
application/json
InboundProcessPaginatedResult
totalnumberOptional
The total number of items matching the search criteria. Only filled, if withTotal is set to true in the search options.
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
application/json
get
/api/inboundprocesses
Delete inbound process
delete
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
inboundProcessIdstringRequired
Responses
200
Inbound Process successfully deleted
No content
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
application/json
delete
/api/inboundprocesses/{inboundProcessId}
No content
Create retry not routable
post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
204
The retry for all not routable proceses has been succesfully triggered
400
The retry task can not be triggered due to a conflicting operation
application/json
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this endpoint
application/json
post
/api/processes/retrynotroutable
No content
Update purchase order
put
This part of the API is in Beta status. For details please check the api-release-life-cycle documentation.
Creates or updates the specific purchase order of an existing inbound process.
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
inboundProcessIdstringRequired
Body
InboundProcessPurchaseOrderForUpsert
cancelledbooleanOptionalDeprecated
This field is deprecated. Set the status to 'CANCELED' Set the purchaseOrder to 'cancelled'. No further deliveries will be expected. Already received goods are unaffected.
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.
orderDatestring · date-timeRequired
Time and date at which the order was placed. Note: This does not refer to the creation date of this entity in the system.
statusstring · enumOptionalPossible values:
versionnumberRequired
Responses
200
Purchase order successfully updated on inbound process
application/json
InboundProcessPurchaseOrder
cancelledbooleanRequiredDeprecated
This field is deprecated. Set the status to 'CANCELED' Set the purchaseOrder to 'cancelled'. No further deliveries will be expected. Already received goods are unaffected.
createdstring · date-timeRequired
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.
idstringRequired
lastModifiedstring · date-timeRequired
orderDatestring · date-timeRequired
Time and date at which the order was placed. Note: This does not refer to the creation date of this entity in the system.
statusstring · enumRequiredPossible values:
201
Purchase order successfully created on inbound process
application/json
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
Bearer authentication header of the form Bearer <token>.
Query parameters
facilityIdstringRequired
facility to filter the results
startAfterIdstringOptional
entity to start after
sizeinteger · min: 1 · max: 500Optional
number of entities to show
Default: 25
Responses
200
All operative processes matching the given parameters
application/json
OperativeProcessPaginatedResult
totalnumberRequired
400
Invalid input. See response for details.
application/json
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this
application/json
404
The requested entity was not found
application/json
get
/api/operativeprocesses
Get operative process
get
This part of the API is in Alpha status. For details please check the api-release-life-cycle documentation.
Get the operative processes for a specific id
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
operativeProcessIdstringRequired
Responses
200
Found operativeProcess by given ID
application/json
OperativeProcess
createdstring · date-timeOptional
The timestamp when the operative process was created.
facilityRefstringRequired
Reference to the facility this operative process is associated with.
flatEntityRefsstring[]Required
Entities involved in this operative process represented as a flat list of entity references.
idstringRequired
auto generated unique identifier
isEditablebooleanOptional
This field indicates if the operative process is editable based on if any of the related pick jobs, service jobs, pack jobs or handover jobs are in progress or have been finished successfully. This field is calculated dynamically on each request.
lastModifiedstring · date-timeOptional
The timestamp when the operative process was last modified.
processRefstringRequired
Reference to the process this operative process is associated with.
routingPlanRefstringOptional
Reference to the routing plan this operative process is associated with.
versionnumberRequired
The version number of the operative process. This number is incremented each time the operative process is modified.
Example: 1
400
Invalid input. See response for details.
application/json
401
Your user is not allowed to operate against this API instance
application/json
403
Your user, although recognized, is not authorized to use this