Price Update
Any Partner application responsible for handling price data must be permitted to interact with the Price Update endpoint, which requires a valid bearer token in the request headers. This token is obtained by authenticating through the Authentication service.
Overview
The Price Update API allows Brand Partners to update the price of one or more proposals in near real-time, without sending the full product payload.
This API is designed for high-frequency price updates from RMS or ERP systems, where only pricing information changes and the rest of the product data remains unmodified.
Each update targets a specific proposal, identified by the combination of productId, colorId, sku, and storeId. The update is applied exclusively to price fields; all other fields of the proposal remain unchanged.
- Price update
- No change (empty proposals)
A single request can contain multiple products, color variants, and SKUs. Each proposal is processed independently.
[
{
"productId": "O11010351-W01GQ-",
"colorVariants": [
{
"colorId": "PLUM",
"sizeVariants": [
{
"sku": "O11010351-W01GQ-_PLUM_6",
"sizeId": "6",
"proposals": [
{
"storeId": "500",
"price": 5295,
"finalPrice": 4765.5,
"pricesIncludeTax": true,
"taxAmount": 859.35,
"taxRate": 0.22,
"discountAmount": 529.5,
"discountPercentage": 10
}
]
}
]
}
]
}
]Sending an empty proposals array for a SKU has no effect. Existing proposals are not removed or invalidated. This differs from the full product onboarding, where an empty array invalidates all existing proposals.
[
{
"productId": "O11010351-W01GQ-",
"colorVariants": [
{
"colorId": "PLUM",
"sizeVariants": [
{
"sku": "O11010351-W01GQ-_PLUM_6",
"sizeId": "6",
"proposals": []
}
]
}
]
}
]Business Rules
| Condition | Behaviour |
|---|---|
price is null or missing | Proposal rejected (INVALID) |
price ≤ 0 | Proposal rejected (INVALID) |
storeId not in authorized stores | Proposal rejected (INVALID) |
| Proposal not found in production | Proposal rejected (INVALID) |
proposals is empty | No update applied for that SKU |
Each proposal is processed independently. A validation failure on one proposal does not block the others in the same request.
Response
201 Created
The request has been accepted and the price update process has been initiated asynchronously.
Error codes
| Code | Description |
|---|---|
400 Bad Request | Malformed request or missing required fields |
401 Unauthorized | Missing or invalid bearer token |
403 Forbidden | Token does not have permission to update prices for this brand |
Example
curl -X PATCH https://api.manna.com/api/prices \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '[
{
"productId": "O11010351-W01GQ-",
"colorVariants": [
{
"colorId": "PLUM",
"sizeVariants": [
{
"sku": "O11010351-W01GQ-_PLUM_6",
"sizeId": "6",
"proposals": [
{
"storeId": "500",
"price": 5295,
"finalPrice": 4765.5,
"pricesIncludeTax": true,
"taxAmount": 859.35,
"taxRate": 0.22,
"discountAmount": 529.5,
"discountPercentage": 10
}
]
}
]
}
]
}
]'
Rate Limiting
| Environment | Requests / min | Entities / min |
|---|---|---|
| Dev/Quality | ∞ | ∞ |