Retrieves the list of supported pricing macros that can be used when creating reseller plans. Pricing macros define how the selling price of an offer is calculated relative to the partner cost, retail price, or markup. These macros enable automated pricing strategies across all offers assigned to a reseller plan.
Endpoint
{{apiUrl}}/api/common/resellerPlanMacrosEndpoint Parameters
| Parameter | Required | Description |
|---|---|---|
{{apiUrl}} | Yes | C3 Portal API URL. |
Request Headers
| Header | Value |
|---|---|
| Authorization | Bearer <access_token> |
| Content-Type | application/json |
Request Body
No request body is required for this endpoint.
Successful Response
A successful request returns all pricing macros supported by C3 for reseller plan creation. These macros determine how sales prices are calculated for offers assigned to a reseller plan.
Sample Response
{
"OperationType": null,
"Status": "Success",
"RequestCorrelationID": "7cc6756d-3a33-437e-8e59-69422b547889",
"ErrorMessage": null,
"ErrorDetail": null,
"Data": [
{
"ID": 1,
"Name": "Copy Partner Price"
},
{
"ID": 2,
"Name": "Copy Provider Selling Price"
},
{
"ID": 3,
"Name": "Apply X% on Partner Price"
},
{
"ID": 4,
"Name": "Apply X% on Markup"
},
{
"ID": 5,
"Name": "Apply X% on Provider Selling Price"
}
{
"ID": 6,
"Name": "Apply X% Margin on Partner Price"
}
{
"ID": 7,
"Name": "Apply X% ERP on List Price"
}
]
}Response Properties
| Property | Description |
|---|---|
| OperationType | Reserved for internal use. Can be ignored. |
| Status | Indicates the result of the request. Possible values: Success or Error. |
| RequestCorrelationID | Unique identifier generated by C3 for request tracking and troubleshooting. |
| ErrorMessage | Error message returned if request processing fails. |
| ErrorDetail | Additional information related to the error. |
| Data | Collection of supported reseller plan pricing macros. |
Pricing Macro Attributes
| Attribute | Description |
|---|---|
| ID | Unique identifier for the pricing macro. |
| Name | Name of the pricing macro used during reseller plan creation. |
Supported Pricing Macros
| Macro Name | Description |
|---|---|
| Copy Partner Price | Sets the selling price equal to the partner acquisition cost. No markup or margin is applied. Example: Partner price = 10, Provider selling price = 15 Sale price: 10 |
| Copy Provider Selling Price | Sets the selling price equal to the provider's suggested retail price (ERP). Example: Partner price = 10, Provider selling price = 15 Sale price: 15 |
| Apply X% on Partner Price | Applies a positive or negative percentage adjustment to the partner cost. The partner cost is used as the base value. Example: Partner price = 10, Provider selling price = 15, Percentage(X) = 20 Sale price: 10+(10* (20/100)) = 12 |
| Apply X% on Markup | Calculates the markup difference between partner cost and provider selling price, then applies a percentage adjustment on that markup amount. Example: Partner price = 10, Provider selling price = 15, Percentage(X) = 20 Sale price: 10 + ((15 - 10) * (20 / 100)) = 11 |
| Apply X% on Provider Selling Price | Applies a positive or negative percentage adjustment to the provider selling price. The retail price is used as the base value. Example: Partner price = 10, Provider selling price = 15, Percentage(X) = -20 Sale price: 15 + (15 * (-20 / 100)) = 12 |
| Apply X% Margin on Partner Price | Calculates the sale price by applying the specified margin percentage to the partner price. Formula: Sale Price = Partner Price / (1 - (X / 100)) Example: Partner Price = 10, Provider Selling Price = 15, X = 20 |
| Apply X% ERP on List Price | Calculates the sale price as X% of the ERP (Retail Price) added to the Cost to Partner. Formula: Sale Price = ((X × Retail Price) / 100) + Cost to Partner Example: Cost to Partner = 96, ERP Price = 100, X = 3 If the Partner Margin % is less than or equal to X, the calculated sale price is overridden and the Cost to Partner is used as the Sale Price. Partner Margin % Formula: ((Retail Price - Cost To Partner) / Retail Price) × 100 Example: Retail Price = 100, Cost to Partner = 96, |
Error Response
If the request cannot be authenticated or processed, the API returns an error response containing details about the failure.
Example Use Cases
- Retrieve supported pricing macros before creating a reseller plan.