Update the Pricing for a Product Offering

patch

http://host:port/productCatalogManagement/v4/productOfferingPrice/{id}

Partially updates the pricing for a product offering.

Request

Path Parameters
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
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

Show Source
Back to Top

Response

Supported Media Types

200 Response

The product offering price was updated 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
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: Update the Price of a Charge

This example shows how to update the price of a product offering by submitting a PATCH 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".
curl -X PATCH 'http://hostname:port/productCatalogManagement/v4/productOfferingPrice/OT_MultiBI_charge1210'

Example of the Request Body

The following example shows the contents of the request body in JSON format.


{
    "@type": "ProductOfferingPriceOracle",    
    "priceAlteration": [
        {
            "@type": "POPAlterationOracle",
            "price": {
                "@type":"ProductPriceValueOracle",
                "dutyFreeAmount": {
                    "unit": "USD",
                    "value": 200.0
                }
            }
        }
    ]
 }

Example of the Response Body

The following example shows the contents of the response body in JSON format.

{
    "atBaseType": "ProductOfferingPrice",
    "atType": "ProductOfferingPriceOracle",
    "eventCandidate": {
        "name": "EventBillingProductFeePurchase"
    },
    "href": "/productCatalogManagement/v4/productOfferingPrice/OT_MultiBI_charge1210",
    "id": "OT_MultiBI_charge1210",
    "isBundle": false,
    "lastUpdate": "2023-12-01T01:35:06Z",
    "lifecycleStatus": "Active",
    "name": "OT_MultiBI_charge1210",
    "priceType": "ONE_TIME",
    "rumCandidate": {
        "name": "OCCURRENCE"
    },
    "validFor": {
        "endDateTime": "2023-05-01T00:33:55Z",
        "startDateTime": "2023-04-02T00:33:50Z"
    },
    "version": "1.0",
    "priceAlteration": [
        {
            "atType": "POPAlterationOracle",
            "price": {
                "atType": "ProductPriceValueOracle",
                "dutyFreeAmount": {
                    "unit": "USD",
                    "value": 200.0
                }
            }
        }
    ],
    "taxOracle": [
        {
            "atType": "TaxItemOracle",
            "id": "ct_direct",
            "taxCategory": "VERTEX_COMMTAX_21",
            "taxTime": "BILLING_TIME"
        }
    ]
}

Example 2: Update the Price of a Charge Selector

This example shows how to update the price of a charge selector by submitting a PATCH 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 PATCH 'http://hostname:port/productCatalogManagement/v4/productOfferingPrice/ChargeSelectorPop'

Example of the Request Body

The following example shows the contents of the request body in JSON format.

{
    "@type": "ProductOfferingPriceSelectorOracle",
    "constraint": [
        {
            "@type": "ConstraintOracle",
            "constraintRule": [
                {
                    "name": "Rule1",
                    "productOfferingPrice": [
                        {
                            "@type": "ProductOfferingPriceOracle",
                            "@baseType": "productOfferingPrice",
                            "id": "ChargeSelectorRule_1",
                            "name": "ChargeSelectorRule_1",
                            "description": "Description of one time Price",
                            "lastUpdate": "2023-08-04T06:50:17.017Z",
                            "lifecycleStatus": "Active",
                            "isBundle": false,
                            "priceType": "RECURRING",
                            "recurringChargePeriodType": "MONTHLY",
                            "recurringChargePeriodLength": 1,
                            "priceAlteration": [
                                {
                                    "@type": "POPAlterationOracle",
                                    "unitOfMeasure": {
                                        "amount": 1,
                                        "units": "NONE"
                                    },
                                    "price": {
                                        "@type": "ProductPriceValueOracle",
                                        "dutyFreeAmount": {
                                            "unit": "USD",
                                            "value": 20
                                        }
                                    }
                                }
                            ],
                            "validFor": {
                                "startDateTime": "2023-08-04T06:50:17.017Z",
                                "endDateTime": "2024-08-04T06:55:17.017Z"
                            },
                            "rumCandidate": {
                                "name": "NONE"
                            },
                            "eventCandidate": {
                                "name": "EventBillingProductFeeCycleCycle_forward_monthly"
                            }
                        }
                    ],
                    "valueRelationship": [
                        {
                            "fieldKind": "EVENT_SPEC_FIELD",
                            "fieldName": "EventBillingProductFeeCycleCycle_forward_monthly.NAME",
                            "fieldValue": "Sam*",
                            "operation": "EQUAL_TO",
                            "separator": ";"
                        }
                    ]
                }
            ],
            "version": "1.0",
            "stereoType": "CHARGE_RATE_PLAN_SELECTOR",
            "name": "ChargeSelectorPop",
            "id": "ChargeSelectorPop"
        }
    ]
} 

Example of the Response Body

{
    "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": "RECURRING",
                            "recurringChargePeriodLength": 1,
                            "recurringChargePeriodType": "MONTHLY",
                            "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": 20.0
                                        }
                                    }
                                }
                            ]
                        }
                    ],
                    "valueRelationship": [
                        {
                            "fieldKind": "PRODUCT_SPEC_FIELD",
                            "fieldName": "TelcoGsm.NAME",
                            "fieldValue": "Sam*",
                            "operation": "EQUAL_TO",
                            "separator": ";"
                        }
                    ]
                }
            ],
            "stereoType": "CHARGE_RATE_PLAN_SELECTOR"
        }
    ],
    "eventCandidate": {
        "name": "EventBillingProductFeePurchase"
    },
    "href": "/productCatalogManagement/v4/productOfferingPrice/ChargeSelectorPop",
    "id": "ChargeSelectorPop",
    "isBundle": false,
    "lifecycleStatus": "Active",
    "name": "ChargeSelectorPop",
    "popRelationship": [
        {
            "atType": "ProductOfferingPriceRelationship",
            "id": "ChargeSelRule_1",
            "name": "ChargeSelRule_1",
            "relationshipType": "COMPOSITE"
        }
    ],
    "priceType": "ONE_TIME",
    "version": "1.0",
    "serviceCandidate": {
        "atType": "ServiceCandidateRef",
        "id": "TelcoGsm",
        "name": "TelcoGsm"
    }
}
Back to Top