Create Pricing Rule - StateSet API Docs

curl --location --request POST 'https://api.stateset.com/v1/pricing-rules' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "name": "B2B Volume Pricing - Electronics",
    "type": "volume_based",
    "priority": 10,
    "price_adjustment": {
        "method": "percentage_discount",
        "round_to": 99,
        "minimum_margin": 15
    },
    "conditions": {
        "customer_segments": ["wholesale", "distributor"],
        "category_ids": ["cat_electronics"],
        "quantity_breaks": [
            {
                "min_quantity": 10,
                "adjustment": {
                    "method": "percentage_discount",
                    "value": 10
                }
            },
            {
                "min_quantity": 50,
                "adjustment": {
                    "method": "percentage_discount",
                    "value": 15
                }
            },
            {
                "min_quantity": 100,
                "adjustment": {
                    "method": "percentage_discount",
                    "value": 20
                }
            }
        ]
    },
    "validity": {
        "start_date": "2024-01-01T00:00:00Z"
    },
    "status": "active"
}'

{
  "id": "pr_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "pricing_rule",
  "name": "B2B Volume Pricing - Electronics",
  "type": "volume_based",
  "priority": 10,
  "price_adjustment": {
    "method": "percentage_discount",
    "round_to": 99,
    "minimum_margin": 15
  },
  "conditions": {
    "customer_segments": ["wholesale", "distributor"],
    "customer_ids": [],
    "product_ids": [],
    "category_ids": ["cat_electronics"],
    "sku_patterns": [],
    "channels": [],
    "quantity_breaks": [
      {
        "min_quantity": 10,
        "max_quantity": 49,
        "adjustment": {
          "method": "percentage_discount",
          "value": 10
        }
      },
      {
        "min_quantity": 50,
        "max_quantity": 99,
        "adjustment": {
          "method": "percentage_discount",
          "value": 15
        }
      },
      {
        "min_quantity": 100,
        "max_quantity": null,
        "adjustment": {
          "method": "percentage_discount",
          "value": 20
        }
      }
    ]
  },
  "validity": {
    "start_date": "2024-01-01T00:00:00Z",
    "end_date": null,
    "is_active": true,
    "schedule": null
  },
  "currency": "USD",
  "status": "active",
  "created_at": "2024-01-20T13:00:00Z",
  "updated_at": "2024-01-20T13:00:00Z",
  "created_by": "user_123",
  "statistics": {
    "times_applied": 0,
    "total_discount_given": 0,
    "affected_orders": 0,
    "last_applied": null
  }
}

POST

pricing-rules

curl --location --request POST 'https://api.stateset.com/v1/pricing-rules' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "name": "B2B Volume Pricing - Electronics",
    "type": "volume_based",
    "priority": 10,
    "price_adjustment": {
        "method": "percentage_discount",
        "round_to": 99,
        "minimum_margin": 15
    },
    "conditions": {
        "customer_segments": ["wholesale", "distributor"],
        "category_ids": ["cat_electronics"],
        "quantity_breaks": [
            {
                "min_quantity": 10,
                "adjustment": {
                    "method": "percentage_discount",
                    "value": 10
                }
            },
            {
                "min_quantity": 50,
                "adjustment": {
                    "method": "percentage_discount",
                    "value": 15
                }
            },
            {
                "min_quantity": 100,
                "adjustment": {
                    "method": "percentage_discount",
                    "value": 20
                }
            }
        ]
    },
    "validity": {
        "start_date": "2024-01-01T00:00:00Z"
    },
    "status": "active"
}'

{
  "id": "pr_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "pricing_rule",
  "name": "B2B Volume Pricing - Electronics",
  "type": "volume_based",
  "priority": 10,
  "price_adjustment": {
    "method": "percentage_discount",
    "round_to": 99,
    "minimum_margin": 15
  },
  "conditions": {
    "customer_segments": ["wholesale", "distributor"],
    "customer_ids": [],
    "product_ids": [],
    "category_ids": ["cat_electronics"],
    "sku_patterns": [],
    "channels": [],
    "quantity_breaks": [
      {
        "min_quantity": 10,
        "max_quantity": 49,
        "adjustment": {
          "method": "percentage_discount",
          "value": 10
        }
      },
      {
        "min_quantity": 50,
        "max_quantity": 99,
        "adjustment": {
          "method": "percentage_discount",
          "value": 15
        }
      },
      {
        "min_quantity": 100,
        "max_quantity": null,
        "adjustment": {
          "method": "percentage_discount",
          "value": 20
        }
      }
    ]
  },
  "validity": {
    "start_date": "2024-01-01T00:00:00Z",
    "end_date": null,
    "is_active": true,
    "schedule": null
  },
  "currency": "USD",
  "status": "active",
  "created_at": "2024-01-20T13:00:00Z",
  "updated_at": "2024-01-20T13:00:00Z",
  "created_by": "user_123",
  "statistics": {
    "times_applied": 0,
    "total_discount_given": 0,
    "affected_orders": 0,
    "last_applied": null
  }
}

This endpoint creates a new pricing rule that automatically adjusts product prices based on various conditions like customer type, quantity, date ranges, or inventory levels.

Authentication

This endpoint requires a valid API key with pricing:write permissions.

Authorization: Bearer YOUR_API_KEY

Request Body

name

string

required

Pricing rule name

type

string

required

Rule type: “customer_specific”, “volume_based”, “time_based”, “channel_based”, “dynamic”

priority

integer

required

Rule priority (lower numbers take precedence)

price_adjustment

object

required

Price adjustment configuration

Show Price adjustment properties

method

string

required

Adjustment method: “fixed_price”, “percentage_discount”, “fixed_discount”, “markup”, “formula”

value

number

Adjustment value (percentage for percentage methods, cents for fixed methods)

formula

string

Pricing formula (for formula method)

round_to

integer

Round final price to nearest value in cents

minimum_margin

number

Minimum margin percentage to maintain

conditions

object

required

Conditions for rule application

Show Condition properties

customer_segments

array

Applicable customer segment IDs

customer_ids

array

Specific customer IDs

product_ids

array

Applicable product IDs

category_ids

array

Applicable category IDs

sku_patterns

array

SKU patterns (supports wildcards)

channels

array

Sales channels: “web”, “pos”, “b2b”, “marketplace”

quantity_breaks

array

Volume-based pricing tiers

Show Quantity break properties

min_quantity

integer

required

Minimum quantity for this tier

adjustment

object

required

Price adjustment for this tier

inventory_threshold

object

Dynamic pricing based on inventory

Show Inventory threshold properties

low_stock

integer

Low stock threshold

high_stock

integer

High stock threshold

adjustment_curve

string

Price adjustment curve: “linear”, “exponential”, “stepped”

validity

object

required

Rule validity period

Show Validity properties

start_date

string

required

Start date (ISO 8601)

end_date

string

End date (ISO 8601)

schedule

object

Time-based schedule

Show Schedule properties

days_of_week

array

Active days (0-6, Sunday is 0)

time_ranges

array

Active time ranges

currency

string

Currency code (defaults to account currency)

status

string

Rule status: “active”, “scheduled”, “inactive”

metadata

object

Additional custom fields

Response

Returns the created pricing rule object.

curl --location --request POST 'https://api.stateset.com/v1/pricing-rules' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "name": "B2B Volume Pricing - Electronics",
    "type": "volume_based",
    "priority": 10,
    "price_adjustment": {
        "method": "percentage_discount",
        "round_to": 99,
        "minimum_margin": 15
    },
    "conditions": {
        "customer_segments": ["wholesale", "distributor"],
        "category_ids": ["cat_electronics"],
        "quantity_breaks": [
            {
                "min_quantity": 10,
                "adjustment": {
                    "method": "percentage_discount",
                    "value": 10
                }
            },
            {
                "min_quantity": 50,
                "adjustment": {
                    "method": "percentage_discount",
                    "value": 15
                }
            },
            {
                "min_quantity": 100,
                "adjustment": {
                    "method": "percentage_discount",
                    "value": 20
                }
            }
        ]
    },
    "validity": {
        "start_date": "2024-01-01T00:00:00Z"
    },
    "status": "active"
}'

{
  "id": "pr_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "pricing_rule",
  "name": "B2B Volume Pricing - Electronics",
  "type": "volume_based",
  "priority": 10,
  "price_adjustment": {
    "method": "percentage_discount",
    "round_to": 99,
    "minimum_margin": 15
  },
  "conditions": {
    "customer_segments": ["wholesale", "distributor"],
    "customer_ids": [],
    "product_ids": [],
    "category_ids": ["cat_electronics"],
    "sku_patterns": [],
    "channels": [],
    "quantity_breaks": [
      {
        "min_quantity": 10,
        "max_quantity": 49,
        "adjustment": {
          "method": "percentage_discount",
          "value": 10
        }
      },
      {
        "min_quantity": 50,
        "max_quantity": 99,
        "adjustment": {
          "method": "percentage_discount",
          "value": 15
        }
      },
      {
        "min_quantity": 100,
        "max_quantity": null,
        "adjustment": {
          "method": "percentage_discount",
          "value": 20
        }
      }
    ]
  },
  "validity": {
    "start_date": "2024-01-01T00:00:00Z",
    "end_date": null,
    "is_active": true,
    "schedule": null
  },
  "currency": "USD",
  "status": "active",
  "created_at": "2024-01-20T13:00:00Z",
  "updated_at": "2024-01-20T13:00:00Z",
  "created_by": "user_123",
  "statistics": {
    "times_applied": 0,
    "total_discount_given": 0,
    "affected_orders": 0,
    "last_applied": null
  }
}

Get Pricing Rule

Calculate Price

StateSet One

​Authentication

​Request Body

​Response

Authentication

Request Body

Response