1. Product catalogs

Same product, multiple price schedules

Price schedules are essential for product visibility and can be configured in various ways. This guide explains how to set up different prices for the same product based on buyer or user.

Business scenario

Example case

A seller company offers two membership tiers:

  • Enterprise membership (higher cost)
  • Startup membership (lower cost)

Enterprise members receive lower product pricing:

  • CloudTech (Jane Doe): Enterprise pricing
  • ComputerDudes (John Deer): Startup pricing

Implementation considerations

Assignment levels

  • Buyer-level assignments demonstrated
  • User Group-level assignments supported
  • Enhanced visibility control
  • Flexible pricing options

Prerequisites

  • Products created
  • Categories configured
  • Catalogs established
  • Valid assignments
  • Product-catalog verification via GET /v1/catalogs/productassignments

Price schedule creation

Enterprise price schedule

http
POST sandboxapi.ordercloud.io/v1/priceschedules HTTP/1.1
Authorization: Bearer INSERT_ACCESS_TOKEN_HERE
Content-Type: application/json; charset=UTF-8
json
{
  "ID": "enterprise-priceschedule-id",
  "Name": "USB Cord",
  "MinQuantity": 1,
  "PriceBreaks": [
    {
      "Quantity": 1,
      "Price": 3.99
    }
  ]
}

Startup price schedule

http
POST https://sandboxapi.ordercloud.io/v1/priceschedules HTTP/1.1
Authorization: Bearer INSERT_ACCESS_TOKEN_HERE
Content-Type: application/json; charset=UTF-8
json
{
  "ID": "startup-priceschedule-id",
  "Name": "USB Cord",
  "MinQuantity": 1,
  "PriceBreaks": [
    {
      "Quantity": 1,
      "Price": 5.99
    }
  ]
}

Product assignments

Enterprise assignment

Create CloudTech relationship:

http
POST https://sandboxapi.ordercloud.io/v1/products/assignments HTTP/1.1
Authorization: Bearer INSERT_ACCESS_TOKEN_HERE
Content-Type: application/json; charset=UTF-8
json
{
  "ProductID": "usb-product-id",
  "BuyerID": "cloudtech",
  "PriceScheduleID": "enterprise-priceschedule-id"
}

Startup assignment

Create ComputerDudes relationship:

http
POST https://sandboxapi.ordercloud.io/v1/products/assignments HTTP/1.1
Authorization: Bearer INSERT_ACCESS_TOKEN_HERE
Content-Type: application/json; charset=UTF-8
json
{
  "ProductID": "usb-product-id",
  "BuyerID": "computerdudes",
  "PriceScheduleID": "startup-priceschedule-id"
}

Verification steps

Authentication

Use JWT.io to verify tokens.

Enterprise pricing

  1. Authenticate as Jane Doe (CloudTech)
  2. Call GET https://sandboxapi.ordercloud.io/v1/me/products/usb-product-id
  3. Verify price: "Price": 3.99

Startup pricing

  1. Authenticate as John Deer (ComputerDudes)
  2. Call GET https://sandboxapi.ordercloud.io/v1/me/products/usb-product-id
  3. Verify price: "Price": 5.99
If you have suggestions for improving this article, let us know!