omnicado-mall-proxy

Update variant pricing

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://mall-api-proxy.documentation.omnicado.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "omnicado-mall-proxy MCP server": {
    "url": "https://mall-api-proxy.documentation.omnicado.com/mcp"
  }
}
Close
PUT /products/{productId}/variants/{variantId}/pricing
Client Application name

⚠ Attention

When updating variant price by more than 30% you will have to use the force token. Please see Product price protection section above.

Headers

  • X-Application-Name string

Path parameters

  • productId string Required

    Partner's product identifier

  • variantId string Required

    Partner's variant identifier

Query parameters

  • client_id string Required

    Client identifier

application/json

Body Required

  • price number

    Price of product (used only if the product is without variants, otherwise it is in the variant data structure)

  • rrp number Deprecated

    Recommended retail price (if the product has variants, use this attribute only in the variant data structure)

  • force_price number

    Price may be overriden by ongoing campaign, if so then force_price field contains forced price, price cannot be updated when force_price is in effect

Responses

  • 200

    OK

  • 400 application/json

    Pricing protection error

    Hide response attributes Show response attributes object
    • errorCodes array[object]
      Hide errorCodes attributes Show errorCodes attributes object
      • message string
      • errorCode string
      • errorAttributes object
    • result object
      Hide result attributes Show result attributes object
      • code integer
      • status string
      • message string
    • data object
      Hide data attributes Show data attributes object
      • key string
      • data object
        Hide data attributes Show data attributes object
        • forceToken string
        • variantIndex integer
PUT /products/{productId}/variants/{variantId}/pricing 
curl \
 --request PUT 'https://mpapi.proxy.omnicado.com/v1/products/F192621/variants/F1926211/pricing?client_id=yourClientId&client_id=api_token_value' \
 --header "Content-Type: application/json" \
 --header "X-Application-Name: myApplicationName" \
 --data '{"price":1933.0,"rrp":2133.0,"force_price":2051.0}'
Request examples 
# Headers
X-Application-Name: myApplicationName

# Payload
{
  "price": 1933.0,
  "rrp": 2133.0,
  "force_price": 2051.0
}
Response examples (400) 
{
  "errorCodes": [
    {
      "message": "Difference between current price ({currentPrice}) and new price ({newPrice}) for product \"{productId}\" is larger than 30% ({real percentage difference}). To confirm this change, use attached force token.",
      "errorCode": "VALIDATION_ERROR",
      "errorAttributes": {}
    }
  ],
  "result": {
    "code": 400,
    "status": "ERROR",
    "message": "Difference between current price ({currentPrice}) and new price ({newPrice}) for product \"{productId}\" is larger than 30% ({real percentage difference}). To confirm this change, use attached force token."
  },
  "data": {
    "key": "product.variants",
    "data": {
      "forceToken": "b3f7d1feca4c649e3493b466cbe0e6795bc6f679",
      "variantIndex": 0
    }
  }
}