1. REST API Reference for Pricing Design Center TMF 620 API
  2. Tasks
  3. Product Offering Price

Create Pricing for a Product Offering

post

http://host:port/productCatalogManagement/v4/productOfferingPrice

Creates pricing for a product offering with the given name in promoted status.

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/json ()
Root Schema : ProductOfferingPriceOracle
Type: object
Title: ProductOfferingPriceOracle
Match All
Show Source
  • Discriminator: @type
    Discriminator: { "propertyName":"@type", "mapping":{ "ProductOfferingPrice":"#/components/schemas/ProductOfferingPrice", "ProductOfferingPriceOracle":"#/components/schemas/ProductOfferingPriceOracle" } }
    It is based on both the basic cost to develop and produce products and the enterprises policy on revenue targets. This price may be further revised through discounting (a product offering price that reflects an alteration). The price applied for a product offering may also be influenced by factors such as the product offering term, the customer selected etc. For example, a product offering can be offered with multiple terms, like commitment periods for the contract. The price may be influenced by this product offering term. A product offering may be cheaper with a 24 month commitment than with a 12 month commitment.
  • Discriminator: @type
    Discriminator: { "propertyName":"@type", "mapping":{ "ProductOfferingPriceOracle":"#/components/schemas/ProductOfferingPriceOracle" } }
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

It is based on both the basic cost to develop and produce products and the enterprises policy on revenue targets. This price may be further revised through discounting (a product offering price that reflects an alteration). The price applied for a product offering may also be influenced by factors such as the product offering term, the customer selected etc. For example, a product offering can be offered with multiple terms, like commitment periods for the contract. The price may be influenced by this product offering term. A product offering may be cheaper with a 24 month commitment than with a 12 month commitment.
Show Source
  • The immediate base class type of the product offering price.
  • Refers to the hyperlink to the schema describing this resource.
  • The class type of this product offering price.
  • bundledPopRelationship
    Represents a bundle relationship from a bundle product offering price (parent) to a simple product offering price (child). A simple product offering price may participate in more than one bundle relationship.
  • constraint
    Represents a policy or a rule applied to product offering price.
  • Description of the product offering price.
  • EventCandidateRef
    An entity that makes an event specification available to a catalog.
  • The unique resource URL of the product offering price.
  • The unique ID of the resource.
  • A flag that indicates whether the price of a product offering is composite (bundle) or not.
  • The last update time of the product offering price.
  • The lifecycle status of the product offering price.
  • Name of the product offering price.
  • Indicates the percentage to be applied if the product offering price is an alteration (such as a discount).
  • popRelationship
    Contains the product offering prices related to the particular product offering price. For example, a price alteration such as allowance or discount.
  • Money
    A base or value business entity used to represent money.
  • Allowed Values: [ "RECURRING", "ONE_TIME", "USAGE", "USAGE_PREPAID", "USAGE_POSTPAID", "ALTERATION", "ALLOWANCE", "OVERAGE", "OVERAGE_PRICE_PLAN", "PENALTY", "ROLLOVER", "ONE_TIME_PRICE_PLAN", "RECURRING_PRICE_PLAN", "USAGE_PRICE_PLAN", "ALTERATION_PRICE_PLAN" ]
    A category that describes the price. For example, recurring, discount, allowance, penalty etc.
  • pricingLogicAlgorithm
    Represents an instantiation of an interface specification to external rating function (without a modeled behavior in SID). Some of the parameters of the interface definition may be already set (such as price per unit) and some may be gathered during the rating process from the event (such as call duration) or from product characteristic values (such as assigned bandwidth).
  • prodSpecCharValueUse
    Product offering uses the product specification characteristic value to add additional attributes to override properties of similar values contained in the product specification characteristic value. The corresponding characteristics addressed by this object must exist in the corresponding product specification. The available characteristic values for a product specification characteristic in a product specification can be modified at the product offering price level. The list of values in product specification characteristic value use is a strict subset of the list of values as defined in the corresponding product specification characteristics.
  • productOfferingTerm
    A list of conditions under which a product offering price is made available to customers. For instance, a product offering price can be offered with multiple commitment periods.
  • Indicates the period of the recurring charge. It sets to zero if it is not applicable.
  • Allowed Values: [ "MONTHLY", "BI_MONTHLY", "QUARTERLY", "SEMI_ANNUAL", "ANNUAL", "DAILY" ]
    The period to repeat the application of the price.
  • RumCandidateRef
    An entity that makes a RUM details available to a catalog.
  • tax
    An amount of money levied on the price of a product by a legislative body.
  • Quantity
    An amount in a given unit.
  • TimePeriod
    A period of time, either as a deadline (endDateTime only), a startDateTime only, or both.
  • Version of the product offering price.
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

Show Source
Back to Top

Response

Supported Media Types

201 Response

The product offering price was created successfully.
Body ()
Root Schema : ProductOfferingPriceOracle
Type: object
Title: ProductOfferingPriceOracle
Match All
Show Source
  • Discriminator: @type
    Discriminator: { "propertyName":"@type", "mapping":{ "ProductOfferingPrice":"#/components/schemas/ProductOfferingPrice", "ProductOfferingPriceOracle":"#/components/schemas/ProductOfferingPriceOracle" } }
    It is based on both the basic cost to develop and produce products and the enterprises policy on revenue targets. This price may be further revised through discounting (a product offering price that reflects an alteration). The price applied for a product offering may also be influenced by factors such as the product offering term, the customer selected etc. For example, a product offering can be offered with multiple terms, like commitment periods for the contract. The price may be influenced by this product offering term. A product offering may be cheaper with a 24 month commitment than with a 12 month commitment.
  • Discriminator: @type
    Discriminator: { "propertyName":"@type", "mapping":{ "ProductOfferingPriceOracle":"#/components/schemas/ProductOfferingPriceOracle" } }
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

It is based on both the basic cost to develop and produce products and the enterprises policy on revenue targets. This price may be further revised through discounting (a product offering price that reflects an alteration). The price applied for a product offering may also be influenced by factors such as the product offering term, the customer selected etc. For example, a product offering can be offered with multiple terms, like commitment periods for the contract. The price may be influenced by this product offering term. A product offering may be cheaper with a 24 month commitment than with a 12 month commitment.
Show Source
  • The immediate base class type of the product offering price.
  • Refers to the hyperlink to the schema describing this resource.
  • The class type of this product offering price.
  • bundledPopRelationship
    Represents a bundle relationship from a bundle product offering price (parent) to a simple product offering price (child). A simple product offering price may participate in more than one bundle relationship.
  • constraint
    Represents a policy or a rule applied to product offering price.
  • Description of the product offering price.
  • EventCandidateRef
    An entity that makes an event specification available to a catalog.
  • The unique resource URL of the product offering price.
  • The unique ID of the resource.
  • A flag that indicates whether the price of a product offering is composite (bundle) or not.
  • The last update time of the product offering price.
  • The lifecycle status of the product offering price.
  • Name of the product offering price.
  • Indicates the percentage to be applied if the product offering price is an alteration (such as a discount).
  • popRelationship
    Contains the product offering prices related to the particular product offering price. For example, a price alteration such as allowance or discount.
  • Money
    A base or value business entity used to represent money.
  • Allowed Values: [ "RECURRING", "ONE_TIME", "USAGE", "USAGE_PREPAID", "USAGE_POSTPAID", "ALTERATION", "ALLOWANCE", "OVERAGE", "OVERAGE_PRICE_PLAN", "PENALTY", "ROLLOVER", "ONE_TIME_PRICE_PLAN", "RECURRING_PRICE_PLAN", "USAGE_PRICE_PLAN", "ALTERATION_PRICE_PLAN" ]
    A category that describes the price. For example, recurring, discount, allowance, penalty etc.
  • pricingLogicAlgorithm
    Represents an instantiation of an interface specification to external rating function (without a modeled behavior in SID). Some of the parameters of the interface definition may be already set (such as price per unit) and some may be gathered during the rating process from the event (such as call duration) or from product characteristic values (such as assigned bandwidth).
  • prodSpecCharValueUse
    Product offering uses the product specification characteristic value to add additional attributes to override properties of similar values contained in the product specification characteristic value. The corresponding characteristics addressed by this object must exist in the corresponding product specification. The available characteristic values for a product specification characteristic in a product specification can be modified at the product offering price level. The list of values in product specification characteristic value use is a strict subset of the list of values as defined in the corresponding product specification characteristics.
  • productOfferingTerm
    A list of conditions under which a product offering price is made available to customers. For instance, a product offering price can be offered with multiple commitment periods.
  • Indicates the period of the recurring charge. It sets to zero if it is not applicable.
  • Allowed Values: [ "MONTHLY", "BI_MONTHLY", "QUARTERLY", "SEMI_ANNUAL", "ANNUAL", "DAILY" ]
    The period to repeat the application of the price.
  • RumCandidateRef
    An entity that makes a RUM details available to a catalog.
  • tax
    An amount of money levied on the price of a product by a legislative body.
  • Quantity
    An amount in a given unit.
  • TimePeriod
    A period of time, either as a deadline (endDateTime only), a startDateTime only, or both.
  • Version of the product offering price.
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

Show Source

400 Response

The server cannot process the request due to a client error.
Body ()
Root Schema : Error
Type: object
Used when an API throws an error, typically with an HTTP error response-code.
Show Source

401 Response

The user's authentication credentials for the target resource are invalid.
Body ()
Root Schema : Error
Type: object
Used when an API throws an error, typically with an HTTP error response-code.
Show Source

404 Response

The requested resource was not found, but it could be accessible in the future. Subsequent client requests are permitted.
Body ()
Root Schema : Error
Type: object
Used when an API throws an error, typically with an HTTP error response-code.
Show Source

405 Response

The requested resource does not support the particular request method.
Body ()
Root Schema : Error
Type: object
Used when an API throws an error, typically with an HTTP error response-code.
Show Source

500 Response

When an unexpected condition is identified and no specific message is appropriate, this generic error message is displayed.
Body ()
Root Schema : Error
Type: object
Used when an API throws an error, typically with an HTTP error response-code.
Show Source
Back to Top

Examples

Example 1: Create a Product Offering Price using a One Time Charge

The following example shows how to create a product offering price using a one time offer containing a combination of more than one BI with a price tag as an example by submitting a POST request on the REST resource using cURL. For more information about cURL, see Use cURL.

Note:

The @type in the request payload will be "@type": "ProductOfferingPriceOracle".

The -d option specifies the file to attach as the request body.

curl -X POST 'http://host:port/productCatalogManagement/v4/productOfferingPrice' -d @sampleProductOfferingPrice.json

Example of Request Body

The following is an example of the contents of the sampleProductOfferingPrice.json file sent as the request body. 

{
    "@baseType": "ProductOfferingPrice",
    "@type": "ProductOfferingPriceOracle",
    "eventCandidate": {
        "name": "EventBillingProductFeePurchase"
    },
    "href": "productCatalogManagement/v4/productOfferingPrice/OT_MultiBI_charge7126",
    "id": "OT_MultiBI_charge7126",
    "isBundle": false,
    "name": "OT_MultiBI_charge7126",
    "priceType": "ONE_TIME",
    "lastUpdate": "2023-03-28T23:56:21Z",
    "lifecycleStatus": "Active",
    "rumCandidate": {
        "name": "OCCURRENCE"
    },
    "taxOracle": [
        {
            "@type":"TaxItemOracle",
            "id": "ct_direct",
            "taxCategory": "VERTEX_COMMTAX_21",
            "taxTime": "BILLING_TIME"
        }
    ],
    "validFor": {
        "endDateTime": "2023-05-01T00:33:55Z",
        "startDateTime": "2023-04-02T00:33:50Z"
    },
    "version": "1.0",
    "priceAlteration": [
        {
            "@type": "POPAlterationOracle",
            "price": {
                "@type":"ProductPriceValueOracle",
                "dutyFreeAmount": {
                    "unit": "USD",
                    "value": 100.0
                },
                "priceTag": {
                    "@type":"PriceTag",
                    "attributeName": "price",
                    "description": "tag_USD_100",
                    "tagName": "tag_USD_100",
                    "tagScope": "EVENT_PROFILE"
                }
            }
                 
        },
        {
            "@type": "POPAlterationOracle",
            "price": {
                "@type":"ProductPriceValueOracle",
                "dutyFreeAmount": {
                    "unit": "MIN",
                    "value": 110.0
                }
            }
                 
        }
    ]
}

Example of Response Body

The following is an example of the response body in JSON format.

{
    "@baseType": "ProductOfferingPrice",
    "@type": "ProductOfferingPriceOracle",
    "eventCandidate": {
        "name": "EventBillingProductFeePurchase"
    },
    "href": "productCatalogManagement/v4/productOfferingPrice/OT_MultiBI_charge7126",
    "id": "OT_MultiBI_charge7126",
    "isBundle": false,
    "name": "OT_MultiBI_charge7126",
    "priceType": "ONE_TIME",
    "lastUpdate": "2023-03-28T23:56:21Z",
    "lifecycleStatus": "Active",
    "rumCandidate": {
        "name": "OCCURRENCE"
    },
    "taxOracle": [
        {
            "@type":"TaxItemOracle",
            "id": "ct_direct",
            "taxCategory": "VERTEX_COMMTAX_21",
            "taxTime": "BILLING_TIME"
        }
    ],
    "validFor": {
        "endDateTime": "2023-05-01T00:33:55Z",
        "startDateTime": "2023-04-02T00:33:50Z"
    },
    "version": "1.0",
    "priceAlteration": [
        {
            "@type": "POPAlterationOracle",
            "price": {
                "@type":"ProductPriceValueOracle",
                "dutyFreeAmount": {
                    "unit": "USD",
                    "value": 100.0
                },
                "priceTag": {
                    "@type":"PriceTag",
                    "attributeName": "price",
                    "description": "tag_USD_100",
                    "tagName": "tag_USD_100",
                    "tagScope": "EVENT_PROFILE"
                }
            }
                 
        },
        {
            "@type": "POPAlterationOracle",
            "price": {
                "@type":"ProductPriceValueOracle",
                "dutyFreeAmount": {
                    "unit": "MIN",
                    "value": 110.0
                }
            }
                 
        }
    ]
}

Example 2: Create a Product Offering Price using a Charge Selector

The following example shows how to create a product offering price using a charge selector as an example by submitting a POST request on the REST resource using cURL. For more information about cURL, see Use cURL.

Note:

The @type in the request payload will be "@type": "ProductOfferingPriceSelectorOracle".

The -d option specifies the file to attach as the request body.

curl -X POST 'http://host:port/productCatalogManagement/v4/productOfferingPrice' -d @createChargeSelector.json

Example of Request Body

The following is an example of the contents of the createChargeSelector.json file sent as the request body.
{
	"@type": "ProductOfferingPriceSelectorOracle",
	"@baseType": "ProductOfferingPrice",
	"id": "ChargeSelectorPop",
	"name": "ChargeSelectorPop",
	"href": "mobile/custom/catalogManagement/productOfferingPrice/ChargeSelectorPop",
	"description": "Description of  Recurring Monthly Price",
	"lastUpdate": "2023-08-04T06:50:17.017Z",
	"lifecycleStatus": "Active",
	"isBundle": false,
	"priceType": "ONE_TIME_PRICE_PLAN",
	"eventCandidate": {
		"name": "EventBillingProductFeePurchase"
	},
	"serviceCandidate": {
		"@referredType": "ServiceCandidate",
		"@type": "ServiceCandidateRef",
		"id": "TelcoGsm",
		"name": "TelcoGsm"
	},
	"popRelationship": [
		{
			"@type": "ProductOfferingPriceRelationshipOracle",
			"relationshipType": "COMPOSITE",
			"name": "ChargeSelRule_1",
			"id": "ChargeSelRule_1",
			"href": "mobile/custom/catalogManagement/productOfferingPrice/ChargeSelRule_1"
		}
	],
	"constraint": [
		{
			"@type": "ConstraintOracle",
			"constraintRule": [
				{
					"name": "Rule1",
					"productOfferingPrice": [
						{
							"@type": "ProductOfferingPriceOracle",
							"@baseType": "productOfferingPrice",
							"id": "ChargeSelRule_1",
							"name": "ChargeSelRule_1",                                    
							"description": "Description of one time Price",
							"lastUpdate": "2023-08-04T06:50:17.017Z",
							"lifecycleStatus": "Active",
							"isBundle": false,
							"priceType": "ONE_TIME",
							"priceAlteration": [
								{
									"@type": "POPAlterationOracle",
									"unitOfMeasure": {
										"amount": 1,
										"units": "NONE"
									},
									"price": {
										"@type": "ProductPriceValueOracle",
										"dutyFreeAmount": {
											"unit": "USD",
											"value": 10
										}
									}
								}
							],
							"validFor": {
								"startDateTime": "2023-08-04T06:50:17.017Z",
								"endDateTime": "2024-08-04T06:55:17.017Z"
							},
							"rumCandidate": {
								"name": "NONE"
							},
							"eventCandidate": {
								"name": "EventBillingProductFeePurchase"
							}
						}
					],
					"valueRelationship": [
						{
							"fieldKind": "PRODUCT_SPEC_FIELD",
							"fieldName": "TelcoGsm.NAME",
							"fieldValue": "Sam*",
							"operation": "EQUAL_TO",
							"separator": ";"
						}
					]
				}
			],
		
			"version": "1.0",
			"stereoType": "CHARGE_RATE_PLAN_SELECTOR",
			"name": "ChargeSelectorPop",
			"id": "ChargeSelectorPop"
		}
	],
	"validFor": {
		"startDateTime": "2023-08-04T06:50:17.017Z",
		"endDateTime": "2024-08-04T06:55:17.017Z"
	}
}

Example of Response Body

The following is an example of the response body in JSON format.

{
    "atBaseType": "ProductOfferingPrice",
    "atType": "ProductOfferingPriceSelectorOracle",
    "constraint": [
        {
            "atType": "ConstraintOracle",
            "id": "ChargeSelectorPop",
            "name": "ChargeSelectorPop",
            "version": "1.0",
            "constraintRule": [
                {
                    "name": "Rule1",
                    "productOfferingPrice": [
                        {
                            "atBaseType": "productOfferingPrice",
                            "atType": "ProductOfferingPriceOracle",
                            "description": "Description of one time Price",
                            "eventCandidate": {
                                "name": "EventBillingProductFeePurchase"
                            },
                            "id": "ChargeSelRule_1",
                            "isBundle": false,
                            "lastUpdate": "2023-08-04T06:50:17.017Z",
                            "lifecycleStatus": "Active",
                            "name": "ChargeSelRule_1",
                            "priceType": "ONE_TIME",
                            "rumCandidate": {
                                "name": "NONE"
                            },
                            "validFor": {
                                "endDateTime": "2024-08-04T06:55:17.017Z",
                                "startDateTime": "2023-08-04T06:50:17.017Z"
                            },
                            "priceAlteration": [
                                {
                                    "atType": "POPAlterationOracle",
                                    "unitOfMeasure": {
                                        "amount": 1.0,
                                        "units": "NONE"
                                    },
                                    "price": {
                                        "atType": "ProductPriceValueOracle",
                                        "dutyFreeAmount": {
                                            "unit": "USD",
                                            "value": 10.0
                                        }
                                    }
                                }
                            ]
                        }
                    ],
                    "valueRelationship": [
                        {
                            "fieldKind": "PRODUCT_SPEC_FIELD",
                            "fieldName": "TelcoGsm.NAME",
                            "fieldValue": "Sam*",
                            "operation": "EQUAL_TO",
                            "separator": ";"
                        }
                    ]
                }
            ],
            "stereoType": "CHARGE_RATE_PLAN_SELECTOR"
        }
    ],
    "description": "Description of  Recurring Monthly Price",
    "eventCandidate": {
        "name": "EventBillingProductFeePurchase"
    },
    "href": "mobile/custom/catalogManagement/productOfferingPrice/ChargeSelectorPop",
    "id": "ChargeSelectorPop",
    "isBundle": false,
    "lastUpdate": "2023-08-04T06:50:17.017Z",
    "lifecycleStatus": "Active",
    "name": "ChargeSelectorPop",
    "popRelationship": [
        {
            "atType": "ProductOfferingPriceRelationshipOracle",
            "href": "mobile/custom/catalogManagement/productOfferingPrice/ChargeSelRule_1",
            "id": "ChargeSelRule_1",
            "name": "ChargeSelRule_1",
            "relationshipType": "COMPOSITE"
        }
    ],
    "priceType": "ONE_TIME_PRICE_PLAN",
    "validFor": {
        "endDateTime": "2024-08-04T06:55:17.017Z",
        "startDateTime": "2023-08-04T06:50:17.017Z"
    },
    "serviceCandidate": {
        "atReferredType": "ServiceCandidate",
        "atType": "ServiceCandidateRef",
        "id": "TelcoGsm",
        "name": "TelcoGsm"
    }
}
Back to Top