Create Partner SKU

Description

This service creates a Partner SKU for the authenticated partner. This allows partners to map their own internal codes to a specific SKU within Thalamus using a SKU Reference Code (skuCodeKey).

---

Request

Restrictions

• Authentication: Requires a successful partner login.

• Role Validation: The logged-in user must have the appropriate partner roles to perform this action.

Endpoint

POST https://<server-url>/api/v4/partner/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 partner session. Use Thalamus-Token for the header.
Content-Type	Header	Must be application/json.

Request Body Fields

Field	Type	Description
skuCodeKey	String	Required. The Reference code.
skuCode	String	Required. The Thalamus SKU code.
code	String	Required. The internal code of the partner SKU.
name	String	Required. The display name of the partner SKU.
equivalenceType	Integer	Mapping type: 1 (Equivalence), 2 (Unit), 3 (Package), 4 (Boxes).
equivalence	String	A decimal value. Note: For types 2, 3, and 4, this value must be set to 1.

Example Body:

{  
   "skuCodeKey": "COD-BRA",
   "skuCode": "70010010BP",
   "code": "7797906000250",
   "name": "CORTE TRADICIONAL PACK 1X720G",
   "equivalenceType": 1,
   "equivalence": "12.5"
}

---

Response

✅ Successful Response: 201 Created

The Partner SKU was successfully created and mapped.

JSON

{
	"message": "OK"
}

---

❌ Unsuccessful Response

400 Bad Request

The following errors may be returned in the errors object:

Error Code	Field	Description
InvalidRoleForLoggedParty	partner	The logged-in user does not have the "Partner" role.
field.required	skuCodeKey	The SKU Reference Code is missing.
partnerSku.invalidSkuCode	skuCodeKey+skuCode	The combination of reference code and SKU code is invalid.
partnerSku.duplicatedCode	sku.code	This SKU code has already been assigned to the provided partner.
partnerSku.invalidEquivalenceType	equivalenceType	The integer provided for the type is not valid.
equivalenceNaN	equivalence	The equivalence value must be a valid number string.
partnerSku.equivalenceDefault	error.saving	If type is not 1, the equivalence value must be exactly 1.0.
InvalidJson	N/A	The request body is not valid JSON.