Overview
This document explains how Cloudmore APIs can be used to automatically update global or customer-specific prices. By integrating these APIs into your pricing workflow, you can ensure that pricing adjustments are timely and accurate, helping you maintain profitability and avoid unexpected margin erosion.
Broker Level Price Actions
Use these APIs to manage global prices that apply to all customers under a broker. Use this when you want to set a standard price for all customers, adjust prices across the board due to vendor cost changes, or update pricing regularly based on market trends.
|
Operation |
Method |
API |
Description |
|---|---|---|---|
|
Returns product price |
GET |
|
Returns all reseller products for a service. |
|
Update Product and Addon Pricing |
PUT |
|
Updates product or addon prices for the broker. |
Refer to the Swagger Documentation collection ResellerPriceList for full details.
Organization Level Price Actions
Use these APIs for customer-specific pricing. Use this when a customer has a special contract or negotiated rate, you want to offer discounts based on usage or loyalty, or you need to reflect pricing differences by region.
|
Operation |
Method |
API |
Description |
|---|---|---|---|
|
Returns product price |
GET |
|
Returns all organization products for a service. |
|
Update Product and Addon Pricing |
PUT |
|
Updates the product or addon price for the organization. |
Refer to the Swagger Documentation collection OrganizationPriceList for full details.
Subscription Level Price Actions (Microsoft 365 CSP Direct)
Use these APIs to view current pricing, apply promotions, and update subscription prices for seat-based Microsoft 365 offers under CSP Direct.
|
Operation |
Method |
API |
Description |
|---|---|---|---|
|
Returns all NCE Subscriptions |
GET |
|
Returns all NCE subscriptions for an organization. |
|
Return NCE subscription details |
GET |
|
Returns details for a specific subscription. |
|
Update NCE Subscription |
PUT |
|
Updates a Microsoft NCE subscription, including price. |
Refer to the Swagger Documentation collection OrganizationCspSubscriptionsNce for full details.
Price Rules API
Use the Price Rules APIs to programmatically create, retrieve, and manage fixed margin and discount-based pricing rules for products at both broker and organization levels. This enables bulk price rule application across multiple products and organizations.
Key Business Rules
-
Price rule start dates must be set to today or a future date.
-
When specified, end dates must be after the start date.
-
Percentage values must be numerical with decimal values separated by "." (precision: 2 decimal points).
-
Price rules are only supported for Microsoft 365 CSP Direct service.
-
Only NCE (New Commerce Experience) products are allowed.
-
Fixed Margin Rule: Uses the product's cost price for calculation. When cost prices change, sales prices are automatically recalculated. Formula: Fixed Sales Price = cost_price / (1 - percentage/100).
-
Discount MSRP Rule: Maintains a constant discount percentage off the recommended price. Formula: Fixed Sales Price = recommended_price * (1 - percentage/100).
API Details
|
Operation |
Method |
API |
Description |
|---|---|---|---|
|
Creates a new price rule |
POST |
|
Creates new price rules for a broker or organization. |
|
Returns all broker price rules |
GET |
|
Returns all price rules for a broker. |
|
Returns all organization price rules |
GET |
|
Returns all organization-level price rules. |
If organizationId is null, the rule applies at broker level. If organizationId has a value, the rule applies specifically to that organization. Refer to Swagger collections BrokerPriceRules and OrganizationPriceRules for full details.