Update Partner SKU

Description

This service updates an existing Partner SKU associated with the logged-in partner. The specific record is identified by the partner_sku_code in the URL path.

---

Request

Restrictions

• Authentication: Requires a successful partner login.

• Immutable Field: The partner SKU code is read-only. Attempting to change the code value in the request body will result in an error.

Endpoint

PUT https://<server-url>/api/v4/partner/skus/{partner_sku_code}

Path Parameters

Parameter	Type	Description
partner_sku_code	String	The current internal partner code assigned to the SKU you wish to update.

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	Read-Only. Must match the code in the URL path.
name	String	The updated 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:

JSON

{  
   "skuCodeKey": "COD_BRA",
   "skuCode": "bra_cafe",
   "code": "pa6_cafe",
   "name": "Café negro",
   "equivalenceType": 1,
   "equivalence": "1.5"
}

---

Response

✅ Successful Response: 200 OK

Returns the fully updated Partner SKU object.

JSON

JSON

{
    "name": "Café negro",
    "equivalenceType": 1,
    "equivalence": "1.5",
    "skuCodes": {
        "COD_BRA": "bra_cafe",
        "COD_COL": "col_cafe"
    },
    "code": "pa6_cafe"
}

---

❌ Unsuccessful Response

400 Bad Request

The following errors may be returned in the errors object:

Error Code	Field	Description
InvalidRoleForLoggedParty	partner	Logged-in user lacks "Partner" privileges.
code.mustNotChange	code	The code in the body does not match the existing record.
code.notFound	partnerSku code	No record exists for the provided path parameter.
field.required	skuCodeKey	The SKU Reference Code is missing.
partnerSku.invalidSkuCode	skuCodeKey+skuCode	Invalid combination of reference code and SKU code.
partnerSku.invalidEquivalenceType	equivalenceType	Invalid integer provided for the mapping type.
equivalenceNaN	equivalence	The equivalence value must be a valid number string.
partnerSku.equivalenceDefault	error.saving	If type is not 1, the equivalence must be exactly 1.0.
InvalidJson	N/A	The request body is not valid JSON.