For the complete documentation index, see llms.txt. This page is also available as Markdown.

Services (Operations)

Endpoints to create, update, and read operative service jobs.

List linked service jobs

get

This part of the API is in Beta status. For details, see the API release lifecycle documentation. List linked service jobs

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
sizeinteger · min: 1 · max: 500Optional

number of entities to show

Default: 25Example: 25
startAfterIdstring · min: 1Optional

all entities after given Id

Example: 6db6a29b-143d-4ffd-ab8b-45cd299cdb00
facilityIdsstring[] · max: 20Optional

facilities to filter to

Example: ["6027cece-93b8-4628-9314-a3f455af9e46"]
orderBystring · enumOptional

sort order

Example: TARGET_TIME_ASCPossible values:
startTargetTimestring · date-timeOptional

Start target date range for linked service jobs

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

End target date range for linked service jobs

Example: 2020-02-03T08:45:50.525Z
channelstring · enumOptional

type of channel you want to filter for

Example: COLLECTPossible values:
searchTermstring · min: 1Optional

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

Example: John Doe
modifiedByUsernamestring · min: 1Optional

Reference to the username you want to get the corresponding linkedServiceJobs for

Example: john.doe
Responses
200

LinkedServiceJobs can be found in response body.

application/json

LinkedServiceJobsResult

totalintegerRequired

Total number of found entities for this query

Example: 42
get/api/linkedservicejobs

Get linked service jobs

get

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Get linked service jobs by id

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

ID of LinkedServiceJobs you want to get

Responses
200

LinkedServiceJobs can be found in response body.

application/json

LinkedServiceJobs

createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
facilityRefstring · min: 1Required

Id linked Facility from the includes service jobs

Example: cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05
fullIdentifierstring · min: 1Optional

Full identifier of the service job. Using the full name of the customer when created from an order.

Example: 240429_lorem-42
idstring · min: 1Required

Unique ID of this linked service jobs group

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
includedServiceJobLinkIdsstring[] · min: 1 · max: 500Required

searchable field of all included service job link ids

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
includedServiceJobRefsstring[] · min: 1 · max: 500Required

searchable field of all included service job ids

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
operativeProcessRefstring · min: 1Optional

Reference to the operative process this linked service jobs group belongs to

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
processRefstring · min: 1Required

ProcessRef of the added ServiceJobs. All Service Jobs need to be part of the same process

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
statusstring · enumRequired

Current status of this linked service jobs group

Example: OPENPossible values:
targetTimestring · date-timeRequired

Target time by which all linked service jobs are expected to be completed

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/linkedservicejobs/{linkedServiceJobsId}

Create service job link

post

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Add a ServiceJobLink to a LinkedServiceJob on root level.

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

ID of LinkedServiceJobs you want to alter

Body

ServiceJobLinkForAdding

serviceJobRefstring · min: 1Required

ID of the service job to add to this linked service jobs group

Example: 0ed803c2-fa20-48d9-9c1b-0d243937a9ad
Responses
201

The ServiceJobLink was successfully added to the LinkedServiceJobs.

application/json

LinkedServiceJobs

createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
facilityRefstring · min: 1Required

Id linked Facility from the includes service jobs

Example: cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05
fullIdentifierstring · min: 1Optional

Full identifier of the service job. Using the full name of the customer when created from an order.

Example: 240429_lorem-42
idstring · min: 1Required

Unique ID of this linked service jobs group

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
includedServiceJobLinkIdsstring[] · min: 1 · max: 500Required

searchable field of all included service job link ids

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
includedServiceJobRefsstring[] · min: 1 · max: 500Required

searchable field of all included service job ids

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
operativeProcessRefstring · min: 1Optional

Reference to the operative process this linked service jobs group belongs to

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
processRefstring · min: 1Required

ProcessRef of the added ServiceJobs. All Service Jobs need to be part of the same process

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
statusstring · enumRequired

Current status of this linked service jobs group

Example: OPENPossible values:
targetTimestring · date-timeRequired

Target time by which all linked service jobs are expected to be completed

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

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

Example: 42
post/api/linkedservicejobs/{linkedServiceJobsId}/servicejoblinks

Create nested service job link

post

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Add a ServiceJobLink to a ServiceJobLink inside the LinkedServiceJob.

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

ID of LinkedServiceJobs you want to alter

serviceJobLinkIdstringRequired

ID of ServiceJobLink you want to add the new ServiceJobLink underneath

Body

ServiceJobLinkForAdding

serviceJobRefstring · min: 1Required

ID of the service job to add to this linked service jobs group

Example: 0ed803c2-fa20-48d9-9c1b-0d243937a9ad
Responses
201

The ServiceJobLink was successfully added nested inside the LinkedServiceJobs.

application/json

LinkedServiceJobs

createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
facilityRefstring · min: 1Required

Id linked Facility from the includes service jobs

Example: cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05
fullIdentifierstring · min: 1Optional

Full identifier of the service job. Using the full name of the customer when created from an order.

Example: 240429_lorem-42
idstring · min: 1Required

Unique ID of this linked service jobs group

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
includedServiceJobLinkIdsstring[] · min: 1 · max: 500Required

searchable field of all included service job link ids

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
includedServiceJobRefsstring[] · min: 1 · max: 500Required

searchable field of all included service job ids

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
operativeProcessRefstring · min: 1Optional

Reference to the operative process this linked service jobs group belongs to

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
processRefstring · min: 1Required

ProcessRef of the added ServiceJobs. All Service Jobs need to be part of the same process

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
statusstring · enumRequired

Current status of this linked service jobs group

Example: OPENPossible values:
targetTimestring · date-timeRequired

Target time by which all linked service jobs are expected to be completed

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

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

Example: 42
post/api/linkedservicejobs/{linkedServiceJobsId}/servicejoblinks/{serviceJobLinkId}

List linked service jobs (search)

post

Search for LinkedServiceJobs

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

LinkedServiceJobsSearchPayload

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.

Example: 10
startAfterIdstringOptionalDeprecated

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

Responses
200

Your search result

application/json

LinkedServiceJobsPaginatedResult

totalnumberOptional

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

post/api/linkedservicejobs/search

List service containers

get

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Gets service containers filtered

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
sizeinteger · min: 1 · max: 500Required

number of entities to show

Default: 25Example: 25
startAfterIdstring · min: 1Optional

all entities after given Id

Example: 6db6a29b-143d-4ffd-ab8b-45cd299cdb00
orderBystring · enumOptional

sorting for the results

Example: CREATED_DESCPossible values:
facilityRefsstring[] · max: 50Optional

Reference of the facility you want to filter for

Example: ["ba095e30-879f-11ee-b9d1-0242ac120002"]
serviceJobRefstring · min: 1Optional

Reference of the service job you want to filter for

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
Responses
200

Service containers can be found in response body.

application/json

ServiceContainers

totalintegerOptional

Total number of found entities for this query

Example: 42
get/api/servicecontainers

Create service container

post

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Creates a service container

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

ServiceContainerForCreation

customAttributesobjectOptional

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

iconUrlstring · min: 1Optional

URL to an icon representing this container type.

Example: https://example.com/icon.png
operativeContainerTypeRefstring · min: 1Optional

Reference to the operative container type this container is based on.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
scannableCodesstring[] · max: 50Optional

Codes that can be used for scanning this container.

Example: ["AB-123456"]
sequenceNumberintegerOptional

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: 42
serviceJobRefsstring[] · max: 50Required

Ids of the ServiceJobs this container belongs to.

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
stackRefstring · min: 1Optional

Reference to related stack

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
storageLocationRefstring · min: 1Optional

Id of the storage location this container is located at.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
weightLimitInGintegerOptional

Weight limit of the container in grams.

Example: 5000
Responses
201

The service container was successfully created.

application/json

ServiceContainer

createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
customAttributesobjectOptional

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

descriptionstring · min: 1Optional

Translated description, filled on request based on descriptionLocalized.

Example: A medium-sized red box
facilityRefstring · min: 1Required

Id of the facility this container is used in.

Example: ba095e30-879f-11ee-b9d1-0242ac120002
iconUrlstring · min: 1Optional

URL to an icon representing this container type.

Example: https://example.com/icon.png
idstring · min: 1Required

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

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
namestring · min: 1Optional

Translated name, filled on request based on nameLocalized.

Example: Red Box
operativeContainerTypeRefstring · min: 1Optional

Reference to the operative container type this container is based on.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
scannableCodesstring[] · max: 50Optional

Codes that can be used for scanning this container.

Example: ["AB-123456"]
sequenceNumberintegerOptional

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: 42
serviceJobRefsstring[] · max: 50Required

Ids of the ServiceJobs this container belongs to.

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
stackRefstring · min: 1Optional

Reference to related stack

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
statusstring · enumRequired

The status of the service container. It can be AVAILABLE or OBSOLETE. The status cannot be set from outside. When a service container is created, it is automatically set to AVAILABLE. When a service container is deleted, it is automatically set to OBSOLETE.

Default: AVAILABLEExample: AVAILABLEPossible values:
storageLocationRefstring · min: 1Optional

Id of the storage location this container is located at.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
typestring · enumRequired

Type of this service container

Example: DEFAULTPossible values:
versioninteger · int64Required

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

Example: 42
weightLimitInGintegerOptional

Weight limit of the container in grams.

Example: 5000
post/api/servicecontainers

Get service container by id

get

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Gets service container by id

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

ID of the service container to retrieve

Responses
200

Service container for the given id.

application/json

ServiceContainer

createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
customAttributesobjectOptional

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

descriptionstring · min: 1Optional

Translated description, filled on request based on descriptionLocalized.

Example: A medium-sized red box
facilityRefstring · min: 1Required

Id of the facility this container is used in.

Example: ba095e30-879f-11ee-b9d1-0242ac120002
iconUrlstring · min: 1Optional

URL to an icon representing this container type.

Example: https://example.com/icon.png
idstring · min: 1Required

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

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
namestring · min: 1Optional

Translated name, filled on request based on nameLocalized.

Example: Red Box
operativeContainerTypeRefstring · min: 1Optional

Reference to the operative container type this container is based on.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
scannableCodesstring[] · max: 50Optional

Codes that can be used for scanning this container.

Example: ["AB-123456"]
sequenceNumberintegerOptional

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: 42
serviceJobRefsstring[] · max: 50Required

Ids of the ServiceJobs this container belongs to.

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
stackRefstring · min: 1Optional

Reference to related stack

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
statusstring · enumRequired

The status of the service container. It can be AVAILABLE or OBSOLETE. The status cannot be set from outside. When a service container is created, it is automatically set to AVAILABLE. When a service container is deleted, it is automatically set to OBSOLETE.

Default: AVAILABLEExample: AVAILABLEPossible values:
storageLocationRefstring · min: 1Optional

Id of the storage location this container is located at.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
typestring · enumRequired

Type of this service container

Example: DEFAULTPossible values:
versioninteger · int64Required

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

Example: 42
weightLimitInGintegerOptional

Weight limit of the container in grams.

Example: 5000
get/api/servicecontainers/{serviceContainerId}

Soft deletes service container by id by setting them to status OBSOLETE.

delete

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Deletes service container by id

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

ID of the service container to delete

Responses
200

The service container has successfully been set to OBSOLETE.

No content

delete/api/servicecontainers/{serviceContainerId}

No content

List service jobs

get

This part of the API is in Beta status. For details, see the API release lifecycle documentation. List service jobs

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
sizeinteger · min: 1 · max: 500Optional

number of entities to show

Default: 25Example: 25
startAfterIdstring · min: 1Optional

all entities after given Id

Example: 6db6a29b-143d-4ffd-ab8b-45cd299cdb00
facilityRefstring · min: 1Optional

Reference of the facility you want to filter for

Example: 6027cece-93b8-4628-9314-a3f455af9e46
channelstring · enumOptional

Type of channel you want to filter for

Example: COLLECTPossible values:
startTargetTimestring · date-timeOptional

Start target date range for service jobs

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

End target date range for service jobs

Example: 2020-02-03T08:45:50.525Z
orderBystring · enumOptional

Order in which the result should be returned

Example: TARGET_TIME_ASCPossible values:
searchTermstring · min: 1Optional

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

Example: John Doe
assignedUserstring · min: 1Optional

Reference the assigned user on this entity - id or username

Example: USER_ID
Responses
200

Service Jobs can be found in response body.

application/json

ServiceJobs

totalintegerOptional

Total number of found entities for this query

Example: 42
get/api/servicejobs

Create service job

post

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Create service job

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

ServiceJobForCreation

customAttributesobjectOptional

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

customServiceRefstringOptional

ID of the Custom Service, the Service Job should reference. Either this and/or the tenantCustomServiceId must passed.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
facilityRefstringRequired

ID of the Facility, the Service Job is executed in.

Example: ba095e30-879f-11ee-b9d1-0242ac120002
operativeProcessRefstringOptional

Reference to the operative process this service job is part of

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
processRefstringOptional

ID of the Process, the Service Job belongs to.

Example: 550e8400-e29b-41d4-a716-446655440000
serviceJobLinkRefstringOptional

ID of the Service Job Link, the Service Job should reference.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
shortIdstringOptional

Short human-readable identifier for this service job

Example: KD-12-1
targetTimestring · date-timeRequired

At which time the service job is expected to be finished.

Example: 2020-02-03T09:45:51.525Z
tenantCustomServiceIdstringOptional

Tenant ID of the Custom Service, the Service Job should reference. Either this and/or the customServiceRef must passed.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
tenantOrderIdstringOptional

ID of the tenant order, the linked service jobs are part of

Example: ocff-order-100
Responses
201

The service job was successfully created.

application/json

ServiceJob

anonymizedbooleanOptional

Indicates if gdpr related data was anonymized

Example: false
createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
customAttributesobjectOptional

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

customServiceRefstringRequired

Id of the customService this ServiceJob was created from.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
descriptionstringOptional

Translated description of this service job derived from descriptionLocalized

Example: Wrapping 3 gifts for order ocff-order-100
executionTimeInMinintegerOptional

Time in minutes this service job is expected to take to be executed

Example: 60
facilityRefstringRequired

ID of the Facility, the Service Job is executed in.

Example: ba095e30-879f-11ee-b9d1-0242ac120002
idstring · min: 1Required

Unique ID of this service job

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
imageRefsstring[] · max: 50Optional

List of linked images taken from the connected custom service

Example: ["https://my-image-host.com/images/custom-service-1.jpg"]
itemsRequiredstring · enumRequired

Indicates whether items are required for executing this service job

Example: OPTIONALPossible values:
itemsReturnablebooleanOptional

Indicates if the items worked on in this service job are returnable after execution

Example: false
lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
linkedServiceJobsRefstringOptional

ID of the Linked Service Job, the Service Job should reference.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
namestringOptional

Translated name of this service job derived from nameLocalized

Example: Gift Wrapping Job
operativeProcessRefstringOptional

Reference to the operative process this service job is part of

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
processRefstringRequired

ID of the process this service job belongs to

Example: 550e8400-e29b-41d4-a716-446655440000
serviceJobLinkRefstringOptional

ID of the Service Job Link, the Service Job should reference.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
shortIdstringOptional

Short human-readable identifier for this service job

Example: KD-12-1
statusstring · enumRequired

Current status of this service job

Example: OPENPossible values:
subStatusstring · enumOptional

Additional sub-status information about this service job

Example: WAITING_FOR_INPUTPossible values:
targetTimestring · date-timeRequired

At which time the service job is expected to be finished.

Example: 2020-02-03T09:45:51.525Z
tenantCustomServiceIdstringOptional

Tenant ID of the Custom Service, the Service Job should reference. Either this and/or the customServiceRef must passed.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
tenantOrderIdstringOptional

ID of the tenant order, the linked service jobs are part of

Example: ocff-order-100
versioninteger · int64Required

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

Example: 42
post/api/servicejobs

Get service job

get

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Get service job

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

ID of service job you want to get

Responses
200

Service Job can be found in response body.

application/json

ServiceJob

anonymizedbooleanOptional

Indicates if gdpr related data was anonymized

Example: false
createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
customAttributesobjectOptional

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

customServiceRefstringRequired

Id of the customService this ServiceJob was created from.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
descriptionstringOptional

Translated description of this service job derived from descriptionLocalized

Example: Wrapping 3 gifts for order ocff-order-100
executionTimeInMinintegerOptional

Time in minutes this service job is expected to take to be executed

Example: 60
facilityRefstringRequired

ID of the Facility, the Service Job is executed in.

Example: ba095e30-879f-11ee-b9d1-0242ac120002
idstring · min: 1Required

Unique ID of this service job

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
imageRefsstring[] · max: 50Optional

List of linked images taken from the connected custom service

Example: ["https://my-image-host.com/images/custom-service-1.jpg"]
itemsRequiredstring · enumRequired

Indicates whether items are required for executing this service job

Example: OPTIONALPossible values:
itemsReturnablebooleanOptional

Indicates if the items worked on in this service job are returnable after execution

Example: false
lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
linkedServiceJobsRefstringOptional

ID of the Linked Service Job, the Service Job should reference.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
namestringOptional

Translated name of this service job derived from nameLocalized

Example: Gift Wrapping Job
operativeProcessRefstringOptional

Reference to the operative process this service job is part of

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
processRefstringRequired

ID of the process this service job belongs to

Example: 550e8400-e29b-41d4-a716-446655440000
serviceJobLinkRefstringOptional

ID of the Service Job Link, the Service Job should reference.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
shortIdstringOptional

Short human-readable identifier for this service job

Example: KD-12-1
statusstring · enumRequired

Current status of this service job

Example: OPENPossible values:
subStatusstring · enumOptional

Additional sub-status information about this service job

Example: WAITING_FOR_INPUTPossible values:
targetTimestring · date-timeRequired

At which time the service job is expected to be finished.

Example: 2020-02-03T09:45:51.525Z
tenantCustomServiceIdstringOptional

Tenant ID of the Custom Service, the Service Job should reference. Either this and/or the customServiceRef must passed.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
tenantOrderIdstringOptional

ID of the tenant order, the linked service jobs are part of

Example: ocff-order-100
versioninteger · int64Required

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

Example: 42
get/api/servicejobs/{serviceJobId}

Call service job action

post

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Apply an action to a service job.

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

ID of service job you want to update

Body
or
or
or
or
or
or
or
or
or
Responses
200

The service job was successfully updated.

application/json

ServiceJob

anonymizedbooleanOptional

Indicates if gdpr related data was anonymized

Example: false
createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
customAttributesobjectOptional

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

customServiceRefstringRequired

Id of the customService this ServiceJob was created from.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
descriptionstringOptional

Translated description of this service job derived from descriptionLocalized

Example: Wrapping 3 gifts for order ocff-order-100
executionTimeInMinintegerOptional

Time in minutes this service job is expected to take to be executed

Example: 60
facilityRefstringRequired

ID of the Facility, the Service Job is executed in.

Example: ba095e30-879f-11ee-b9d1-0242ac120002
idstring · min: 1Required

Unique ID of this service job

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
imageRefsstring[] · max: 50Optional

List of linked images taken from the connected custom service

Example: ["https://my-image-host.com/images/custom-service-1.jpg"]
itemsRequiredstring · enumRequired

Indicates whether items are required for executing this service job

Example: OPTIONALPossible values:
itemsReturnablebooleanOptional

Indicates if the items worked on in this service job are returnable after execution

Example: false
lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
linkedServiceJobsRefstringOptional

ID of the Linked Service Job, the Service Job should reference.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
namestringOptional

Translated name of this service job derived from nameLocalized

Example: Gift Wrapping Job
operativeProcessRefstringOptional

Reference to the operative process this service job is part of

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
processRefstringRequired

ID of the process this service job belongs to

Example: 550e8400-e29b-41d4-a716-446655440000
serviceJobLinkRefstringOptional

ID of the Service Job Link, the Service Job should reference.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
shortIdstringOptional

Short human-readable identifier for this service job

Example: KD-12-1
statusstring · enumRequired

Current status of this service job

Example: OPENPossible values:
subStatusstring · enumOptional

Additional sub-status information about this service job

Example: WAITING_FOR_INPUTPossible values:
targetTimestring · date-timeRequired

At which time the service job is expected to be finished.

Example: 2020-02-03T09:45:51.525Z
tenantCustomServiceIdstringOptional

Tenant ID of the Custom Service, the Service Job should reference. Either this and/or the customServiceRef must passed.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
tenantOrderIdstringOptional

ID of the tenant order, the linked service jobs are part of

Example: ocff-order-100
versioninteger · int64Required

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

Example: 42
post/api/servicejobs/{serviceJobId}/actions

List service containers for a service job

get

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Lists service containers by the id of the related service job

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

ID of the service job to retrieve containers for

Responses
200

Service containers for the given service job.

application/json

ServiceContainer

createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
customAttributesobjectOptional

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

descriptionstring · min: 1Optional

Translated description, filled on request based on descriptionLocalized.

Example: A medium-sized red box
facilityRefstring · min: 1Required

Id of the facility this container is used in.

Example: ba095e30-879f-11ee-b9d1-0242ac120002
iconUrlstring · min: 1Optional

URL to an icon representing this container type.

Example: https://example.com/icon.png
idstring · min: 1Required

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

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
lastModifiedstring · date-timeRequired

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

Example: 2020-02-03T09:45:51.525Z
namestring · min: 1Optional

Translated name, filled on request based on nameLocalized.

Example: Red Box
operativeContainerTypeRefstring · min: 1Optional

Reference to the operative container type this container is based on.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
scannableCodesstring[] · max: 50Optional

Codes that can be used for scanning this container.

Example: ["AB-123456"]
sequenceNumberintegerOptional

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: 42
serviceJobRefsstring[] · max: 50Required

Ids of the ServiceJobs this container belongs to.

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
stackRefstring · min: 1Optional

Reference to related stack

Example: 9a14e183-ff86-4b6e-a2dc-eb4c7e312ab1
statusstring · enumRequired

The status of the service container. It can be AVAILABLE or OBSOLETE. The status cannot be set from outside. When a service container is created, it is automatically set to AVAILABLE. When a service container is deleted, it is automatically set to OBSOLETE.

Default: AVAILABLEExample: AVAILABLEPossible values:
storageLocationRefstring · min: 1Optional

Id of the storage location this container is located at.

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
typestring · enumRequired

Type of this service container

Example: DEFAULTPossible values:
versioninteger · int64Required

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

Example: 42
weightLimitInGintegerOptional

Weight limit of the container in grams.

Example: 5000
get/api/servicejobs/{serviceJobId}/servicecontainers

Get service data

get

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Get the service data of the referenced service job.

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

ID of service job referenced by the service data you want to get

Responses
200

Service Data can be found in response body.

application/json

ServiceData

createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
idstring · min: 1Required

ID of the Service Data

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
lastModifiedstring · date-timeRequired

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

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

IDs of all serviceJobs connected to this service data

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
versioninteger · int64Required

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

Example: 42
get/api/servicejobs/{serviceJobId}/servicedata

Call service data action

post

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Apply an action to the service data of the referenced service job.

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

ID of service job referenced by the service data you want to update

Body
or
or
or
or
Responses
200

The service data was successfully updated.

application/json

ServiceData

createdstring · date-timeRequired

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

Example: 2020-02-03T08:45:51.525Z
idstring · min: 1Required

ID of the Service Data

Example: 41d43211-g5a1-gg22-a716-ba095e30ds1d
lastModifiedstring · date-timeRequired

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

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

IDs of all serviceJobs connected to this service data

Example: ["cdb1dfc4-8361-4ba9-b3c2-33a6f2fc8d05"]
versioninteger · int64Required

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

Example: 42
post/api/servicejobs/{serviceJobId}/servicedata/actions

Last updated