Custom services
A custom service is an entity that contains all the information about an offered service. It must be bound to a facility and serves as a blueprint for creating service jobs.
An example of a custom service is the adjustment of a shirt by adding embroidery to the collar and sleeves, as shown in the example below. Upon creation, the custom service is available for use at the tenant level.
A custom service can also reference another custom service (for instance, when one service requires another to be performed first), forming a chain of up to 15 dependent services.
Because custom services might have varying availability or execution times across different facilities, a facility custom service connection must be established before the service can be employed. This process is described in the Facility custom service connection section.
The maximum amount of allowed custom services in status ACTIVE is 100.
Images can be added to a custom service to help operational staff quickly identify what a service involves. When a service job is created from a custom service, the images are automatically included. Up to 50 images can be linked per custom service.
Working with custom services
Create a custom service
To create a custom service, execute the following POST request with the JSON body:
POST https://{YOUR_TENANT_NAME}.api.fulfillmenttools.com/api/customservices{
"status": "ACTIVE",
"nameLocalized": {
"en_US": "Shirt initials embroidery",
"de_DE": "Hemd Initialien Bestickung"
},
"descriptionLocalized": {
"en_US": "The desired initials are embroidered on the collar and sleeve.",
"de_DE": "Die gewünschten Initialien werden am Kragen und Ärmel eingestickt."
},
"executionTimeInMin": 60,
"imageRefs": [
"https://my-image-host.com/images/custom-service-1.jpg"
],
"itemsReturnable": false,
"itemsRequired": "MANDATORY",
"additionalInformation": [
{
"nameLocalized": {
"en_US": "Number of threads",
"de_DE": "Anzahl der Fäden"
},
"descriptionLocalized": {
"en_US": "This value indicates how many threads should be used for the embroidery",
"de_DE": "Dieser Wert gibt an, wie viele Fäden bei der Stickerei genutzt werden sollen"
},
"valueType": "NUMBER",
"isMandatory": true
},
{
"nameLocalized": {
"en_US": "Color",
"de_DE": "Farbe"
},
"descriptionLocalized": {
"en_US": "Color of the embroidery",
"de_DE": "Die Farbe der Stickerei"
},
"valueType": "NUMBER",
"isMandatory": true
}
],
"customAttributes": {
"actionId": "b1eef2b0-1d5c-4819-bddc-b562beb14838"
}
}Update a custom service
To update a custom service, send a PATCH request with the fields to be changed in the request body:
Custom service additional information
A custom service can contain additional information, which is managed through dedicated API endpoints.
You can only add up to maximum 15 additional information to a custom service.
Add or change additional information
To add or change additional information for a custom service, use the following POST and PUT requests with the relevant data in the body:
Delete additional information
To delete additional information from a custom service, execute the following DELETE request:
Facility custom service connection
To employ a custom service, it must be bound to a specific facility. This binding is established by creating a facility custom service connection.
Create or update a facility custom service connection
To create a connection that enables a custom service in a facility, execute a POST request. To update an existing connection, use a PATCH request.
Delete a facility custom service connection
Last updated
Was this helpful?