Register Sku

Description

This service registers a new SKU.

---

Request

Restrictions

This service requires an authenticated user.

Endpoint

POST https://<server-url>/api/v4/referencedata/skus

Parameters

Parameter	Location	Description
touchpoint	Query / Header	The identifier for the touchpoint. Use Thalamus-Touchpoint for the header.
token	Query / Header	The authentication token for the API. Use Thalamus-Token for the header.
Content-Type	Header	Specifies the content type of the request body. Must be application/json.

Full URL Example

https://<server-url>/api/v4/referencedata/skus?touchpoint=test&token=...

Request Body

The request body must contain the profile information, credentials, and any communication opt-ins for the new physical location.

Field	Type	Description
name	String	A string representing the SKU name
numberOfUnits	Float	A decimal numerical Value for specifying the number of units in the SKU.
sellingQuantities	Integer	A integer numerical value for defining the quantities in which the SKU can be sold.
active	Boolean	A Boolean value indicating whether the SKU is active or not.
product	Product Object	Object to indicate the product code associated with the SKU
description	String	A string that represents the SKU description
codes	Object	Reference codes associated with the SKU. Opcional
description 1-40	String	A string that represents the SKU additional descriptions. Optionals

Product Object Fields

Field	Type	Description
code	String	The primary identifier for login (e.g., email, username). Must match the corresponding principal field in the profile object.

JSON

{
    "name": "newSku6",
    "numberOfUnits": 10,
    "sellingQuantities": 20,
    "active": true,
    "product": {
        "code": "ProdCode2"
    },
    "description": "description",
    "codes": {
        "CodeRef": "value5",
        "newCode": "123123"
    },
    // description 1-40 optionals. ("description1")
}

---

Response

✅ Successful Response: 201 Created

The SKU was successfully created. The response returns the new SKU data.

JSON

{
    "name": "newSku7",
    "id": 2525,
    "code": "",
    "active": true,
    "numberOfUnits": 10,
    "sellingQuantities": 20,
    "description": "description",
    "description1": "",
    "description2": "",
    "description3": "",
    "description4": "",
    "description5": "",
    "description6": "",
    "description7": "",
    "description8": "",
    "description9": "",
    "description10": "",
    "description11": "",
    "description12": "",
    "description13": "",
    "description14": "",
    "description15": "",
    "description16": "",
    "description17": "",
    "description18": "",
    "description19": "",
    "description20": "desc20",
    "description21": "",
    "description22": "",
    "description23": "",
    "description24": "",
    "description25": "",
    "description26": "",
    "description27": "",
    "description28": "",
    "description29": "",
    "description30": "",
    "description31": "",
    "description32": "",
    "description33": "",
    "description34": "",
    "description35": "",
    "description36": "",
    "description37": "",
    "description38": "",
    "description39": "",
    "description40": "",
    "codes": {
        "CodeRef": "valuetest"
    },
    "relatedSkuIds": []
}

❌ Unsuccessful Response: 400 Bad Request

Returned if the request fails validation. See below for common error examples.

Scenario: Field Validation Error

JSON

{
    "errors": {
        "sku.sellingQuantities": "Selling quantities is required and must be greater than zero.",
        "execution.sku.sellingQuantities": "execution.sku.sellingQuantities: Selling quantities is required and must be greater than zero."
    }
}