Customer defined IDs in requests

fulfillmenttools allows specifying a customer-defined ID for certain entities. The ID format follows the pattern tenant<entity>Id. This field allows for transferring IDs from external systems to the fulfillmenttools. If this ID is unambiguous, it enables reading and writing the entity using HTTP.

Currently, this functionality applies only to stock entities.

For information on retrieving entities by their tenant<entity>Id using a path parameter, refer to the Uniform Resource Name (URN) pattern in path parameters documentation.

Examples for stocks

Get stocks with a user-defined ID

GET https://{projectId}.api.fulfillmenttools.com/api/stocks?tenantFacilityId=CGN-01

Search for stocks with a user-defined ID

POST https://{projectId}.api.fulfillmenttools.com/api/stocks/search

Request body (JSON)

{
    "query": {
        "tenantFacilityId": {
            "eq": "CGN-01"
        }
    }
}

Create a stock with a user-defined ID via PUT

PUT https://{projectId}.api.fulfillmenttools.com/api/stocks

Request body (JSON)

{
    "stocks": [
        {
            "facility": {
                "tenantFacilityId": "CGN-01"
            },
            "tenantArticleId": "0188104",
            "value": 100
        }
    ]
}

Create a stock with a user-defined ID via POST

POST https://{projectId}.api.fulfillmenttools.com/api/stocks

Request body (JSON)

{
    "facility": {
        "tenantFacilityId": "CGN-01"
    },
    "tenantArticleId": "0188104",
    "value": 101
}