Skip to main content

Price Update

Authentication

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.

Proposal-level granularity

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.


Multiple SKUs in one request

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
              }
            ]
          }
        ]
      }
    ]
  }
]

Business Rules​

ConditionBehaviour
price is null or missingProposal rejected (INVALID)
price ≤ 0Proposal rejected (INVALID)
storeId not in authorized storesProposal rejected (INVALID)
Proposal not found in productionProposal rejected (INVALID)
proposals is emptyNo update applied for that SKU
Isolated processing

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​

CodeDescription
400 Bad RequestMalformed request or missing required fields
401 UnauthorizedMissing or invalid bearer token
403 ForbiddenToken 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​

EnvironmentRequests / minEntities / min
Dev/Quality∞∞