Create Partner Stock

Description

This service allows an authenticated partner to register stock for a specific SKU. Stock can be identified either by the internal partnerSkuCode or by the Thalamus skuCodeKey and skuCode pair.

---

Request

Restrictions

• Authentication: Requires a successful partner login.

• Role Validation: The party must have the "Partner" role.

• Date Validation: stockDate cannot be in the future and must be today or earlier.

Endpoint

POST https://<server-url>/api/v4/partner/stock

Parameters

Parameter	Location	Description
touchpoint	Query / Header	The identifier for the touchpoint.
token	Query / Header	The authentication token for the partner session.
Content-Type	Header	Must be application/json.

Request Body Fields

Field	Type	Description
partnerSkuCode	String	Conditional. The internal code of the partner SKU.
skuCodeKey	String	Conditional. The Reference Code of an SKU.
skuCode	String	Conditional. The value of the Reference Code.
quantity	Number	Required. The quantity of stock to add.
amount	Decimal	The amount associated with this stock entry.
stockDate	String	Required. Date stock is available (yyyy-MM-dd). Cannot be a future date.
expirationDate	String	Date when stock expires (yyyy-MM-dd).
description	String	Primary description for the stock entry.
description2 - description40	String	Optional. Additional description fields (up to 40 total).

⚠️ Identification Logic

You must provide exactly one of the following identification methods. Sending both or neither will result in an error:

1. Way 1: Use only partnerSkuCode.

2. Way 2: Use skuCodeKey AND skuCode together.

Body Examples

Example 1: Using Partner SKU Code

{  
   "partnerSkuCode": "EAN_12345",
   "quantity": 100,
   "amount": 12.10,
   "stockDate": "2026-03-25",
   "description": "Weekly restock",
   "expirationDate": "2026-06-25"
}

Example 2: Using SKU Reference Pair

{  
   "skuCodeKey": "ReferenceCode02",
   "skuCode": "cod2",
   "quantity": 50,
   "amount": 15.00,
   "stockDate": "2026-03-28",
   "description": "Special batch entry"
}

---

Response

✅ Successful Response: 201 Created

JSON

{
	"message": "OK"
}

---

❌ Unsuccessful Response

400 Bad Request

Error Code	Message	Description
InvalidRoleForLoggedParty	The party must have the role of partner.	The user is logged in but lacks partner privileges.
field.required	Field required	A mandatory field (quantity, stockDate, etc.) is missing.
partnerStock.missingPartnerSkuCode	The partnerSkuCode was not found	The provided partnerSkuCode does not exist for this partner.
partnerStock.nowBefore	StockDate must be before current date.	You cannot register stock for a future date.
field.invalid.format	Date type fields must have the format yyyy-MM-dd	The date provided does not follow the required format.
partnerStock.searchByBoth	Cannot search by both SKU and partner SKU simultaneously.	You provided partnerSkuCode AND the skuCode pair.
partnerStock.requiredTogether	Both skuCodeKey and skuCode are required together.	One of the two SKU reference fields is missing.
partnerStock.oneSearchCriterion	At least one search criterion is required.	No SKU identification was provided in the body.
partnerStock.invalidSKUCode	The SkuCode was not found.	The Thalamus skuCode provided does not exist.