Docs API Reference Product/bff/product/pricelist-update

postProductAdmin BFF

/bff/product/pricelist-update

Replaces the full array of dynamic pricing rules on a product. Empty array clears all rules (column reset to NULL so most products bypass the resolver cheaply). Validation is server-side; the resolver itself never lets margin go negative, but admin should also warn before save.

ProductpostBffProductPricelist-update

Parameters

JSON body

Request body

application/json

productCodestringRequired

Product code whose pricelist is being replaced.

Examplemy-product

rulesobject[]Required

Full replacement of the rule list. Pass an empty array to clear all rules.

Each array item:

idstringRequired

Stable UUID assigned by the admin form.

Length: 1–∞

namestringRequired

Human label for the rule.

Length: 1–80

enabledbooleanRequired

Disabled rules are kept but ignored by the resolver.

prioritynumberRequired

Higher value wins; ties broken by specificity.

validFromstring | nullRequired

Inclusive lower date bound (YYYY-MM-DD) or null.

One of 2:

Variant 1

string

Variant 2

null

validTostring | nullRequired

Inclusive upper date bound (YYYY-MM-DD) or null.

One of 2:

Variant 1

string

Variant 2

null

weekdaysnumber[] | nullRequired

ISO weekdays (Mon=1 … Sun=7), or null for every day.

One of 2:

Variant 1

number[]

Variant 2

null

timeFromstring | nullRequired

Inclusive lower time-of-day bound (HH:mm) or null.

One of 2:

Variant 1

string

Variant 2

null

timeTostring | nullRequired

Inclusive upper time-of-day bound (HH:mm) or null.

One of 2:

Variant 1

string

Variant 2

null

variantCodestring | nullRequired

Variant code scope, or null for all variants of this product.

One of 2:

Variant 1

string

Variant 2

null

pricenumberRequired

Price applied when this rule wins. Margin is clamped to >= 0 by the resolver.

Range: 0–∞

Response schema

1 status code documented

200Success

successbooleanRequired

Whether the rule list was persisted.

ruleCountnumberRequired

Number of rules now stored on the product.

Response example

application/json

{
  "success": false,
  "ruleCount": 0
}

Request example

POST /bff/product/pricelist-update

post

curl -X POST "https://api.bizkithub.com/bff/product/pricelist-update" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "productCode": "my-product",
  "rules": [
    {
      "id": "example_id",
      "name": "example_name",
      "enabled": false,
      "priority": 0,
      "price": 0
    }
  ]
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key