Knowledge Base

API Guide for Price Management (5.0)

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

/api/resellers/{resellerId}/services/{serviceId}/pricelist

Returns all reseller products for a service.

Update Product and Addon Pricing

PUT

/api/resellers/{resellerId}/services/{serviceId}/pricelist

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

/api/resellers/{resellerId}/organizations/{organizationId}/services/{serviceId}/pricelist

Returns all organization products for a service.

Update Product and Addon Pricing

PUT

/api/resellers/{resellerId}/organizations/{organizationId}/services/{serviceId}/pricelist

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

/api/resellers/{resellerId}/organizations/{organizationId}/services/csp/nce/subscriptions

Returns all NCE subscriptions for an organization.

Return NCE subscription details

GET

/api/resellers/{resellerId}/organizations/{organizationId}/services/csp/nce/subscriptions/{id}

Returns details for a specific subscription.

Update NCE Subscription

PUT

/api/resellers/{resellerId}/organizations/{organizationId}/services/csp/nce/subscriptions/{subscriptionId}

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

/api/resellers/{resellerId}/services/{serviceId}/pricerules

Creates new price rules for a broker or organization.

Returns all broker price rules

GET

/api/resellers/{resellerId}/services/{serviceId}/pricerules

Returns all price rules for a broker.

Returns all organization price rules

GET

/api/resellers/{resellerId}/organizations/{organizationId}/services/{serviceId}/pricerules

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.