Pricing rules

The base price for a SKU lives in Storefront. Channel listings often need a different price — to cover marketplace fees, run a channel-specific promo, or react to competitor pricing. Pricing rules express that translation.

Pricing rules

A pricing rule transforms the base price for a (channel, SKU) pair. Rules can scope by category, brand, or specific SKUs, and they layer — multiple matching rules apply in priority order.

List rules. Filter with ?channel=amazon.

Create or update a rule.

curl -X POST https://appengine.appmint.io/sales-channel/pricing/rules \
  -H "Authorization: Bearer $JWT" -H "orgid: $ORG" \
  -d '{
    "id": "amazon-fee-uplift",
    "name": "Cover Amazon referral fee",
    "channel": "amazon",
    "scope": { "type": "all" },
    "adjustment": { "type": "markup_percent", "value": 15 },
    "priority": 100,
    "active": true
  }'

Delete.

Calculate a price

Resolve what the channel should charge for a product. Useful for previewing rule behavior before pushing.

curl -X POST https://appengine.appmint.io/sales-channel/pricing/calculate/amazon \
  -H "Authorization: Bearer $JWT" -H "orgid: $ORG" \
  -d '{"sku": "SKU-100", "price": 19.99, "cost": 8.00, "categoryId": "electronics"}'

Returns the calculated channel price plus the chain of rules that contributed.

Calculate across every connected channel in one call.

Push prices

Push the calculated prices to the channel listings. Pass skus to target specific products, omit to sync everything.

curl -X POST https://appengine.appmint.io/sales-channel/pricing/sync/shopify \
  -H "Authorization: Bearer $JWT" -H "orgid: $ORG" \
  -d '{"skus": ["SKU-100", "SKU-200"]}'

Promotions per channel

A promotion is a time-bounded pricing rule with startsAt and endsAt:

{
  "id": "black-friday-amazon",
  "name": "Black Friday — Amazon only",
  "channel": "amazon",
  "scope": { "type": "all" },
  "adjustment": { "type": "discount_percent", "value": 20 },
  "priority": 200,
  "active": true,
  "startsAt": "2026-11-27T00:00:00Z",
  "endsAt": "2026-11-30T23:59:59Z"
}

The pricing service activates and deactivates the rule automatically on its boundaries. Pair with POST /sales-channel/pricing/sync/:channelId to push the new prices when the promo opens.

Competitor-driven pricing

Save observed competitor prices and reference them in rules.

Record a competitor price. Read all competitor prices for a SKU. Full comparison across master, channels, and competitors.

A match_competitor adjustment uses the lowest stored competitor price as the target, optionally floored at cost+margin:

{
  "adjustment": {
    "type": "match_competitor",
    "undercutPercent": 1,
    "minMarginPercent": 15
  }
}

The rule undercuts the lowest competitor by 1%, but never drops below 15% margin over cost.

Price history

Audit log of price changes per SKU. Filter by ?channel=amazon&limit=50.