REST API Reference for Pricing Design Center TMF 620 API

Update a Product Offering by ID

patch

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

Partially updates the product offering by ID.

Request

Path Parameters

id(required): string

A unique ID that identifies resources.

Supported Media Types

application/json

Root Schema : ProductOfferingOracle

Type: object

Title: ProductOfferingOracle

Match All

Show Source

object Discriminator: @type

Discriminator: { "propertyName":"@type", "mapping":{ "ProductOffering":"#/components/schemas/ProductOffering", "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle" } }

Represents entities that are orderable from the provider of the catalog. This resource includes pricing information.
object Discriminator: @type

Discriminator: { "propertyName":"@type", "mapping":{ "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle" } }


{
    "type":"object",
    "title":"ProductOfferingOracle",
    "allOf":[
        {
            "$ref":"#/components/schemas/ProductOffering"
        },
        {
            "properties":{
                "priceTag":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/PriceTag"
                    }
                },
                "productSpecCharacteristic":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/ProductSpecificationCharacteristicOracle"
                    }
                },
                "popEventMap":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/PopEventMapRef"
                    }
                },
                "validityRounding":{
                    "type":"string",
                    "description":"A string providing complementary information on the value of the validity rounding attribute.",
                    "enum":[
                        "NOT_SET",
                        "ON",
                        "OFF"
                    ]
                },
                "scaleRounding":{
                    "type":"string",
                    "description":"A string providing complementary information on the value of the scale rounding attribute.",
                    "enum":[
                        "NOT_SET",
                        "ON",
                        "OFF"
                    ]
                }
            },
            "discriminator":{
                "propertyName":"@type",
                "mapping":{
                    "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
                }
            }
        }
    ]
}

Nested Schema : Discriminator: @type

Type: object

Discriminator: @type


{
    "type":"object",
    "description":"Represents entities that are orderable from the provider of the catalog. This resource includes pricing information.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique ID of the product offering."
        },
        "href":{
            "type":"string",
            "description":"The unique resource URL of the product offering."
        },
        "description":{
            "type":"string",
            "description":"Description of the product offering."
        },
        "isBundle":{
            "type":"boolean",
            "description":"Whether a product specification represents a single offering (<b>true</b>) or multiple offerings (<b>false</b>)."
        },
        "isSellable":{
            "type":"boolean",
            "description":"A flag that indicates if the product offer can be sold stand-alone for sale or not. If this flag is false it indicates that the offer can only be sold within a bundle."
        },
        "lastUpdate":{
            "type":"string",
            "format":"date-time",
            "description":"Date and time of the last update."
        },
        "lifecycleStatus":{
            "type":"string",
            "description":"Indicates the current lifecycle status."
        },
        "name":{
            "type":"string",
            "description":"Name of the product offering."
        },
        "statusReason":{
            "type":"string",
            "description":"A string that provides complementary information on the value of the lifecycle status attribute."
        },
        "version":{
            "type":"string",
            "description":"Version of the product offering."
        },
        "bundledProductOffering":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/BundledProductOffering"
            },
            "description":"A type of product offering that belongs to a grouping of product offerings made available to the market. It inherits the attributes of a product offering."
        },
        "prodSpecCharValueUse":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationCharacteristicValueUse"
            },
            "description":"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 level. For example, <b>a characteristic 'Color' might have values White, Blue, Green and Red. The list of values can be restricted to White and Blue in an associated product offering.</b> The list of values in 'ProductSpecificationCharacteristicValueUse' is a strict subset of the list of values as defined in the corresponding product specification characteristics."
        },
        "productOfferingPrice":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingPriceRefOrValue"
            },
            "description":"An amount, usually of money, that is asked for or allowed when a product offering is bought, rented or leased. The price is valid for a defined period of time and may not represent the actual price paid by a customer."
        },
        "productOfferingRelationship":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingRelationship"
            },
            "description":"Relates between the product offering and other product offerings."
        },
        "productOfferingTerm":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingTerm"
            },
            "description":"A condition which makes the product offering available to customers. For instance, a product offering can be offered with multiple commitment periods."
        },
        "productSpecification":{
            "$ref":"#/components/schemas/ProductSpecificationRef",
            "description":"Describes a tangible or intangible object made available externally in the form of a product offering to customers or other parties playing a party role."
        },
        "serviceCandidate":{
            "$ref":"#/components/schemas/ServiceCandidateRef",
            "description":"An entity that makes a service specification available to a catalog."
        },
        "eventCandidate":{
            "$ref":"#/components/schemas/EventCandidateRef",
            "description":"An entity that makes an event specification available to a catalog."
        },
        "serviceLevelAgreement":{
            "$ref":"#/components/schemas/SLARef",
            "description":"A type of agreement that represents a formal negotiated agreement between two parties designed to create a common understanding about products, services, priorities, responsibilities, etc. The service level agreement is a set of appropriate procedures and targets formally or informally agreed between parties to achieve and maintain specified quality of service."
        },
        "validFor":{
            "$ref":"#/components/schemas/TimePeriod",
            "description":"The period for which the product offering is valid."
        },
        "@baseType":{
            "type":"string",
            "description":"Defines the super-class while sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"Defines the sub-class extensible name while sub-classing."
        }
    },
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductOffering":"#/components/schemas/ProductOffering",
            "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
        }
    }
}

Represents entities that are orderable from the provider of the catalog. This resource includes pricing information.

Show Source

@baseType: string

Defines the super-class while sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Defines the sub-class extensible name while sub-classing.
bundledProductOffering: array bundledProductOffering

A type of product offering that belongs to a grouping of product offerings made available to the market. It inherits the attributes of a product offering.
description: string

Description of the product offering.
eventCandidate: object EventCandidateRef

An entity that makes an event specification available to a catalog.
href: string

The unique resource URL of the product offering.
id: string

The unique ID of the product offering.
isBundle: boolean

Whether a product specification represents a single offering (true) or multiple offerings (false).
isSellable: boolean

A flag that indicates if the product offer can be sold stand-alone for sale or not. If this flag is false it indicates that the offer can only be sold within a bundle.
lastUpdate: string (date-time)

Date and time of the last update.
lifecycleStatus: string

Indicates the current lifecycle status.
name: string

Name of the product offering.
prodSpecCharValueUse: array 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 level. For example, a characteristic 'Color' might have values White, Blue, Green and Red. The list of values can be restricted to White and Blue in an associated product offering. The list of values in 'ProductSpecificationCharacteristicValueUse' is a strict subset of the list of values as defined in the corresponding product specification characteristics.
productOfferingPrice: array productOfferingPrice

An amount, usually of money, that is asked for or allowed when a product offering is bought, rented or leased. The price is valid for a defined period of time and may not represent the actual price paid by a customer.
productOfferingRelationship: array productOfferingRelationship

Relates between the product offering and other product offerings.
productOfferingTerm: array productOfferingTerm

A condition which makes the product offering available to customers. For instance, a product offering can be offered with multiple commitment periods.
productSpecification: object ProductSpecificationRef

A detailed description of a tangible or intangible object made available externally in the form of a product offering to customers or other parties playing a party role.
serviceCandidate: object ServiceCandidateRef

An entity that makes a service specification available to a catalog.
serviceLevelAgreement: object SLARef

A type of agreement that represents a formal negotiated agreement between two parties designed to create a common understanding about products, services, priorities, responsibilities, and so forth. The SLA is a set of appropriate procedures and targets formally or informally agreed between parties in order to achieve and maintain specified quality of service.
statusReason: string

A string that provides complementary information on the value of the lifecycle status attribute.
validFor: object TimePeriod

A period of time, either as a deadline (endDateTime only), a startDateTime only, or both.
version: string

Version of the product offering.


{
    "type":"object",
    "description":"Represents entities that are orderable from the provider of the catalog. This resource includes pricing information.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique ID of the product offering."
        },
        "href":{
            "type":"string",
            "description":"The unique resource URL of the product offering."
        },
        "description":{
            "type":"string",
            "description":"Description of the product offering."
        },
        "isBundle":{
            "type":"boolean",
            "description":"Whether a product specification represents a single offering (<b>true</b>) or multiple offerings (<b>false</b>)."
        },
        "isSellable":{
            "type":"boolean",
            "description":"A flag that indicates if the product offer can be sold stand-alone for sale or not. If this flag is false it indicates that the offer can only be sold within a bundle."
        },
        "lastUpdate":{
            "type":"string",
            "format":"date-time",
            "description":"Date and time of the last update."
        },
        "lifecycleStatus":{
            "type":"string",
            "description":"Indicates the current lifecycle status."
        },
        "name":{
            "type":"string",
            "description":"Name of the product offering."
        },
        "statusReason":{
            "type":"string",
            "description":"A string that provides complementary information on the value of the lifecycle status attribute."
        },
        "version":{
            "type":"string",
            "description":"Version of the product offering."
        },
        "bundledProductOffering":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/BundledProductOffering"
            },
            "description":"A type of product offering that belongs to a grouping of product offerings made available to the market. It inherits the attributes of a product offering."
        },
        "prodSpecCharValueUse":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationCharacteristicValueUse"
            },
            "description":"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 level. For example, <b>a characteristic 'Color' might have values White, Blue, Green and Red. The list of values can be restricted to White and Blue in an associated product offering.</b> The list of values in 'ProductSpecificationCharacteristicValueUse' is a strict subset of the list of values as defined in the corresponding product specification characteristics."
        },
        "productOfferingPrice":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingPriceRefOrValue"
            },
            "description":"An amount, usually of money, that is asked for or allowed when a product offering is bought, rented or leased. The price is valid for a defined period of time and may not represent the actual price paid by a customer."
        },
        "productOfferingRelationship":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingRelationship"
            },
            "description":"Relates between the product offering and other product offerings."
        },
        "productOfferingTerm":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingTerm"
            },
            "description":"A condition which makes the product offering available to customers. For instance, a product offering can be offered with multiple commitment periods."
        },
        "productSpecification":{
            "$ref":"#/components/schemas/ProductSpecificationRef",
            "description":"Describes a tangible or intangible object made available externally in the form of a product offering to customers or other parties playing a party role."
        },
        "serviceCandidate":{
            "$ref":"#/components/schemas/ServiceCandidateRef",
            "description":"An entity that makes a service specification available to a catalog."
        },
        "eventCandidate":{
            "$ref":"#/components/schemas/EventCandidateRef",
            "description":"An entity that makes an event specification available to a catalog."
        },
        "serviceLevelAgreement":{
            "$ref":"#/components/schemas/SLARef",
            "description":"A type of agreement that represents a formal negotiated agreement between two parties designed to create a common understanding about products, services, priorities, responsibilities, etc. The service level agreement is a set of appropriate procedures and targets formally or informally agreed between parties to achieve and maintain specified quality of service."
        },
        "validFor":{
            "$ref":"#/components/schemas/TimePeriod",
            "description":"The period for which the product offering is valid."
        },
        "@baseType":{
            "type":"string",
            "description":"Defines the super-class while sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"Defines the sub-class extensible name while sub-classing."
        }
    },
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductOffering":"#/components/schemas/ProductOffering",
            "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
        }
    }
}

Nested Schema : Discriminator: @type

Type: object

Discriminator: @type

Discriminator Values

ProductOfferingOracle


{
    "properties":{
        "priceTag":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/PriceTag"
            }
        },
        "productSpecCharacteristic":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationCharacteristicOracle"
            }
        },
        "popEventMap":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/PopEventMapRef"
            }
        },
        "validityRounding":{
            "type":"string",
            "description":"A string providing complementary information on the value of the validity rounding attribute.",
            "enum":[
                "NOT_SET",
                "ON",
                "OFF"
            ]
        },
        "scaleRounding":{
            "type":"string",
            "description":"A string providing complementary information on the value of the scale rounding attribute.",
            "enum":[
                "NOT_SET",
                "ON",
                "OFF"
            ]
        }
    },
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
        }
    }
}

Show Source

popEventMap: array popEventMap
priceTag: array priceTag
productSpecCharacteristic: array productSpecCharacteristic
scaleRounding: string

Allowed Values: [ "NOT_SET", "ON", "OFF" ]

A string providing complementary information on the value of the scale rounding attribute.
validityRounding: string

Allowed Values: [ "NOT_SET", "ON", "OFF" ]

A string providing complementary information on the value of the validity rounding attribute.


{
    "properties":{
        "priceTag":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/PriceTag"
            }
        },
        "productSpecCharacteristic":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationCharacteristicOracle"
            }
        },
        "popEventMap":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/PopEventMapRef"
            }
        },
        "validityRounding":{
            "type":"string",
            "description":"A string providing complementary information on the value of the validity rounding attribute.",
            "enum":[
                "NOT_SET",
                "ON",
                "OFF"
            ]
        },
        "scaleRounding":{
            "type":"string",
            "description":"A string providing complementary information on the value of the scale rounding attribute.",
            "enum":[
                "NOT_SET",
                "ON",
                "OFF"
            ]
        }
    },
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

The product offering was updated successfully.

Root Schema : ProductOfferingOracle

Type: object

Title: ProductOfferingOracle

Match All

Show Source

object Discriminator: @type

Discriminator: { "propertyName":"@type", "mapping":{ "ProductOffering":"#/components/schemas/ProductOffering", "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle" } }

Represents entities that are orderable from the provider of the catalog. This resource includes pricing information.
object Discriminator: @type

Discriminator: { "propertyName":"@type", "mapping":{ "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle" } }


{
    "type":"object",
    "title":"ProductOfferingOracle",
    "allOf":[
        {
            "$ref":"#/components/schemas/ProductOffering"
        },
        {
            "properties":{
                "priceTag":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/PriceTag"
                    }
                },
                "productSpecCharacteristic":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/ProductSpecificationCharacteristicOracle"
                    }
                },
                "popEventMap":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/PopEventMapRef"
                    }
                },
                "validityRounding":{
                    "type":"string",
                    "description":"A string providing complementary information on the value of the validity rounding attribute.",
                    "enum":[
                        "NOT_SET",
                        "ON",
                        "OFF"
                    ]
                },
                "scaleRounding":{
                    "type":"string",
                    "description":"A string providing complementary information on the value of the scale rounding attribute.",
                    "enum":[
                        "NOT_SET",
                        "ON",
                        "OFF"
                    ]
                }
            },
            "discriminator":{
                "propertyName":"@type",
                "mapping":{
                    "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
                }
            }
        }
    ]
}

Nested Schema : Discriminator: @type

Type: object

Discriminator: @type

Discriminator Values

ProductOffering
ProductOfferingOracle


{
    "type":"object",
    "description":"Represents entities that are orderable from the provider of the catalog. This resource includes pricing information.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique ID of the product offering."
        },
        "href":{
            "type":"string",
            "description":"The unique resource URL of the product offering."
        },
        "description":{
            "type":"string",
            "description":"Description of the product offering."
        },
        "isBundle":{
            "type":"boolean",
            "description":"Whether a product specification represents a single offering (<b>true</b>) or multiple offerings (<b>false</b>)."
        },
        "isSellable":{
            "type":"boolean",
            "description":"A flag that indicates if the product offer can be sold stand-alone for sale or not. If this flag is false it indicates that the offer can only be sold within a bundle."
        },
        "lastUpdate":{
            "type":"string",
            "format":"date-time",
            "description":"Date and time of the last update."
        },
        "lifecycleStatus":{
            "type":"string",
            "description":"Indicates the current lifecycle status."
        },
        "name":{
            "type":"string",
            "description":"Name of the product offering."
        },
        "statusReason":{
            "type":"string",
            "description":"A string that provides complementary information on the value of the lifecycle status attribute."
        },
        "version":{
            "type":"string",
            "description":"Version of the product offering."
        },
        "bundledProductOffering":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/BundledProductOffering"
            },
            "description":"A type of product offering that belongs to a grouping of product offerings made available to the market. It inherits the attributes of a product offering."
        },
        "prodSpecCharValueUse":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationCharacteristicValueUse"
            },
            "description":"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 level. For example, <b>a characteristic 'Color' might have values White, Blue, Green and Red. The list of values can be restricted to White and Blue in an associated product offering.</b> The list of values in 'ProductSpecificationCharacteristicValueUse' is a strict subset of the list of values as defined in the corresponding product specification characteristics."
        },
        "productOfferingPrice":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingPriceRefOrValue"
            },
            "description":"An amount, usually of money, that is asked for or allowed when a product offering is bought, rented or leased. The price is valid for a defined period of time and may not represent the actual price paid by a customer."
        },
        "productOfferingRelationship":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingRelationship"
            },
            "description":"Relates between the product offering and other product offerings."
        },
        "productOfferingTerm":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingTerm"
            },
            "description":"A condition which makes the product offering available to customers. For instance, a product offering can be offered with multiple commitment periods."
        },
        "productSpecification":{
            "$ref":"#/components/schemas/ProductSpecificationRef",
            "description":"Describes a tangible or intangible object made available externally in the form of a product offering to customers or other parties playing a party role."
        },
        "serviceCandidate":{
            "$ref":"#/components/schemas/ServiceCandidateRef",
            "description":"An entity that makes a service specification available to a catalog."
        },
        "eventCandidate":{
            "$ref":"#/components/schemas/EventCandidateRef",
            "description":"An entity that makes an event specification available to a catalog."
        },
        "serviceLevelAgreement":{
            "$ref":"#/components/schemas/SLARef",
            "description":"A type of agreement that represents a formal negotiated agreement between two parties designed to create a common understanding about products, services, priorities, responsibilities, etc. The service level agreement is a set of appropriate procedures and targets formally or informally agreed between parties to achieve and maintain specified quality of service."
        },
        "validFor":{
            "$ref":"#/components/schemas/TimePeriod",
            "description":"The period for which the product offering is valid."
        },
        "@baseType":{
            "type":"string",
            "description":"Defines the super-class while sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"Defines the sub-class extensible name while sub-classing."
        }
    },
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductOffering":"#/components/schemas/ProductOffering",
            "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
        }
    }
}

Represents entities that are orderable from the provider of the catalog. This resource includes pricing information.

Show Source

@baseType: string

Defines the super-class while sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Defines the sub-class extensible name while sub-classing.
bundledProductOffering: array bundledProductOffering

A type of product offering that belongs to a grouping of product offerings made available to the market. It inherits the attributes of a product offering.
description: string

Description of the product offering.
eventCandidate: object EventCandidateRef

An entity that makes an event specification available to a catalog.
href: string

The unique resource URL of the product offering.
id: string

The unique ID of the product offering.
isBundle: boolean

Whether a product specification represents a single offering (true) or multiple offerings (false).
isSellable: boolean

A flag that indicates if the product offer can be sold stand-alone for sale or not. If this flag is false it indicates that the offer can only be sold within a bundle.
lastUpdate: string (date-time)

Date and time of the last update.
lifecycleStatus: string

Indicates the current lifecycle status.
name: string

Name of the product offering.
prodSpecCharValueUse: array 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 level. For example, a characteristic 'Color' might have values White, Blue, Green and Red. The list of values can be restricted to White and Blue in an associated product offering. The list of values in 'ProductSpecificationCharacteristicValueUse' is a strict subset of the list of values as defined in the corresponding product specification characteristics.
productOfferingPrice: array productOfferingPrice

An amount, usually of money, that is asked for or allowed when a product offering is bought, rented or leased. The price is valid for a defined period of time and may not represent the actual price paid by a customer.
productOfferingRelationship: array productOfferingRelationship

Relates between the product offering and other product offerings.
productOfferingTerm: array productOfferingTerm

A condition which makes the product offering available to customers. For instance, a product offering can be offered with multiple commitment periods.
productSpecification: object ProductSpecificationRef

A detailed description of a tangible or intangible object made available externally in the form of a product offering to customers or other parties playing a party role.
serviceCandidate: object ServiceCandidateRef

An entity that makes a service specification available to a catalog.
serviceLevelAgreement: object SLARef

A type of agreement that represents a formal negotiated agreement between two parties designed to create a common understanding about products, services, priorities, responsibilities, and so forth. The SLA is a set of appropriate procedures and targets formally or informally agreed between parties in order to achieve and maintain specified quality of service.
statusReason: string

A string that provides complementary information on the value of the lifecycle status attribute.
validFor: object TimePeriod

A period of time, either as a deadline (endDateTime only), a startDateTime only, or both.
version: string

Version of the product offering.


{
    "type":"object",
    "description":"Represents entities that are orderable from the provider of the catalog. This resource includes pricing information.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique ID of the product offering."
        },
        "href":{
            "type":"string",
            "description":"The unique resource URL of the product offering."
        },
        "description":{
            "type":"string",
            "description":"Description of the product offering."
        },
        "isBundle":{
            "type":"boolean",
            "description":"Whether a product specification represents a single offering (<b>true</b>) or multiple offerings (<b>false</b>)."
        },
        "isSellable":{
            "type":"boolean",
            "description":"A flag that indicates if the product offer can be sold stand-alone for sale or not. If this flag is false it indicates that the offer can only be sold within a bundle."
        },
        "lastUpdate":{
            "type":"string",
            "format":"date-time",
            "description":"Date and time of the last update."
        },
        "lifecycleStatus":{
            "type":"string",
            "description":"Indicates the current lifecycle status."
        },
        "name":{
            "type":"string",
            "description":"Name of the product offering."
        },
        "statusReason":{
            "type":"string",
            "description":"A string that provides complementary information on the value of the lifecycle status attribute."
        },
        "version":{
            "type":"string",
            "description":"Version of the product offering."
        },
        "bundledProductOffering":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/BundledProductOffering"
            },
            "description":"A type of product offering that belongs to a grouping of product offerings made available to the market. It inherits the attributes of a product offering."
        },
        "prodSpecCharValueUse":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationCharacteristicValueUse"
            },
            "description":"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 level. For example, <b>a characteristic 'Color' might have values White, Blue, Green and Red. The list of values can be restricted to White and Blue in an associated product offering.</b> The list of values in 'ProductSpecificationCharacteristicValueUse' is a strict subset of the list of values as defined in the corresponding product specification characteristics."
        },
        "productOfferingPrice":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingPriceRefOrValue"
            },
            "description":"An amount, usually of money, that is asked for or allowed when a product offering is bought, rented or leased. The price is valid for a defined period of time and may not represent the actual price paid by a customer."
        },
        "productOfferingRelationship":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingRelationship"
            },
            "description":"Relates between the product offering and other product offerings."
        },
        "productOfferingTerm":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductOfferingTerm"
            },
            "description":"A condition which makes the product offering available to customers. For instance, a product offering can be offered with multiple commitment periods."
        },
        "productSpecification":{
            "$ref":"#/components/schemas/ProductSpecificationRef",
            "description":"Describes a tangible or intangible object made available externally in the form of a product offering to customers or other parties playing a party role."
        },
        "serviceCandidate":{
            "$ref":"#/components/schemas/ServiceCandidateRef",
            "description":"An entity that makes a service specification available to a catalog."
        },
        "eventCandidate":{
            "$ref":"#/components/schemas/EventCandidateRef",
            "description":"An entity that makes an event specification available to a catalog."
        },
        "serviceLevelAgreement":{
            "$ref":"#/components/schemas/SLARef",
            "description":"A type of agreement that represents a formal negotiated agreement between two parties designed to create a common understanding about products, services, priorities, responsibilities, etc. The service level agreement is a set of appropriate procedures and targets formally or informally agreed between parties to achieve and maintain specified quality of service."
        },
        "validFor":{
            "$ref":"#/components/schemas/TimePeriod",
            "description":"The period for which the product offering is valid."
        },
        "@baseType":{
            "type":"string",
            "description":"Defines the super-class while sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"Defines the sub-class extensible name while sub-classing."
        }
    },
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductOffering":"#/components/schemas/ProductOffering",
            "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
        }
    }
}

Nested Schema : Discriminator: @type

Type: object

Discriminator: @type

Discriminator Values

ProductOfferingOracle


{
    "properties":{
        "priceTag":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/PriceTag"
            }
        },
        "productSpecCharacteristic":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationCharacteristicOracle"
            }
        },
        "popEventMap":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/PopEventMapRef"
            }
        },
        "validityRounding":{
            "type":"string",
            "description":"A string providing complementary information on the value of the validity rounding attribute.",
            "enum":[
                "NOT_SET",
                "ON",
                "OFF"
            ]
        },
        "scaleRounding":{
            "type":"string",
            "description":"A string providing complementary information on the value of the scale rounding attribute.",
            "enum":[
                "NOT_SET",
                "ON",
                "OFF"
            ]
        }
    },
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
        }
    }
}

Show Source

popEventMap: array popEventMap
priceTag: array priceTag
productSpecCharacteristic: array productSpecCharacteristic
scaleRounding: string

Allowed Values: [ "NOT_SET", "ON", "OFF" ]

A string providing complementary information on the value of the scale rounding attribute.
validityRounding: string

Allowed Values: [ "NOT_SET", "ON", "OFF" ]

A string providing complementary information on the value of the validity rounding attribute.


{
    "properties":{
        "priceTag":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/PriceTag"
            }
        },
        "productSpecCharacteristic":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationCharacteristicOracle"
            }
        },
        "popEventMap":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/PopEventMapRef"
            }
        },
        "validityRounding":{
            "type":"string",
            "description":"A string providing complementary information on the value of the validity rounding attribute.",
            "enum":[
                "NOT_SET",
                "ON",
                "OFF"
            ]
        },
        "scaleRounding":{
            "type":"string",
            "description":"A string providing complementary information on the value of the scale rounding attribute.",
            "enum":[
                "NOT_SET",
                "ON",
                "OFF"
            ]
        }
    },
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductOfferingOracle":"#/components/schemas/ProductOfferingOracle"
        }
    }
}

400 Response

The server cannot process the request due to a client error.

Root Schema : Error

Type: object

Used when an API throws an error, typically with an HTTP error response-code.

Show Source

@baseType: string

Defines the super-class while sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Defines the sub-class entity name while sub-classing.
code(required): string

Application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

HTTP error code extension.


{
    "description":"Used when an API throws an error, typically with an HTTP error response-code.",
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "format":"uri",
            "description":"URI of documentation describing the error."
        },
        "@baseType":{
            "type":"string",
            "description":"Defines the super-class while sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"Defines the sub-class entity name while sub-classing."
        }
    }
}

401 Response

The user's authentication credentials for the target resource are invalid.

Root Schema : Error

Type: object

Used when an API throws an error, typically with an HTTP error response-code.

Show Source

@baseType: string

Defines the super-class while sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Defines the sub-class entity name while sub-classing.
code(required): string

Application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

HTTP error code extension.


{
    "description":"Used when an API throws an error, typically with an HTTP error response-code.",
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "format":"uri",
            "description":"URI of documentation describing the error."
        },
        "@baseType":{
            "type":"string",
            "description":"Defines the super-class while sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"Defines the sub-class entity name while sub-classing."
        }
    }
}

404 Response

The requested resource was not found, but it could be accessible in the future. Subsequent client requests are permitted.

Root Schema : Error

Type: object

Used when an API throws an error, typically with an HTTP error response-code.

Show Source

@baseType: string

Defines the super-class while sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Defines the sub-class entity name while sub-classing.
code(required): string

Application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

HTTP error code extension.


{
    "description":"Used when an API throws an error, typically with an HTTP error response-code.",
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "format":"uri",
            "description":"URI of documentation describing the error."
        },
        "@baseType":{
            "type":"string",
            "description":"Defines the super-class while sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"Defines the sub-class entity name while sub-classing."
        }
    }
}

405 Response

The requested resource does not support the particular request method.

Root Schema : Error

Type: object

Used when an API throws an error, typically with an HTTP error response-code.

Show Source

@baseType: string

Defines the super-class while sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Defines the sub-class entity name while sub-classing.
code(required): string

Application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

HTTP error code extension.


{
    "description":"Used when an API throws an error, typically with an HTTP error response-code.",
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "format":"uri",
            "description":"URI of documentation describing the error."
        },
        "@baseType":{
            "type":"string",
            "description":"Defines the super-class while sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"Defines the sub-class entity name while sub-classing."
        }
    }
}

500 Response

When an unexpected condition is identified and no specific message is appropriate, this generic error message is displayed.

Root Schema : Error

Type: object

Used when an API throws an error, typically with an HTTP error response-code.

Show Source

@baseType: string

Defines the super-class while sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Defines the sub-class entity name while sub-classing.
code(required): string

Application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

HTTP error code extension.


{
    "description":"Used when an API throws an error, typically with an HTTP error response-code.",
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "format":"uri",
            "description":"URI of documentation describing the error."
        },
        "@baseType":{
            "type":"string",
            "description":"Defines the super-class while sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"Defines the sub-class entity name while sub-classing."
        }
    }
}

Examples

This example shows how to add startDateTime and endDateTime for a product offering by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL.

curl -X PATCH 'http://hostname:port/productCatalogManagement/v4/productOffering/OnetimeOffer1210'

Example of the Request Body

The following example shows the contents of the request body in JSON format for the one time offer.

{       "@type": "ProductOfferingOracle",   
        "validFor": {   
              "endDateTime": "2023-03-08T00:33:55Z",       
              "startDateTime": "2023-03-03T00:33:50Z"   
      } 
}

Example of the Response Body

The following example shows the contents of the response body in JSON format for the one time offer.

{
    "atBaseType": "ProductOffering",
    "atType": "ProductOfferingOracle",
    "description": "OnetimeOffer1210",
    "href": "/productCatalogManagement/v4/productOffering/OnetimeOffer1210",
    "id": "OnetimeOffer1210",
    "isBundle": false,
    "isSellable": false,
    "lastUpdate": "2023-11-30T22:05:16Z",
    "lifecycleStatus": "Active",
    "name": "OnetimeOffer1210",
    "productOfferingPrice": [
        {
            "atType": "ProductOfferingPriceRefOracle",
            "href": "/productCatalogManagement/v4/productOfferingPrice/OnetimeOfferPrice1210",
            "id": "OnetimeOfferPrice1210",
            "name": "OnetimeOfferPrice1210"
        }
    ],
    "serviceCandidate": {
        "atReferredType": "ServiceCandidate",
        "atType": "ServiceCandidateRef",
        "id": "TelcoGsm",
        "name": "TelcoGsm"
    },
    "validFor": {
        "endDateTime": "2023-03-08T00:33:55Z",
        "startDateTime": "2023-03-03T00:33:50Z"
    },
    "version": "1.0"
}

Oracle Account

Oracle Account

Sign in to Cloud

REST API Reference for Pricing Design Center TMF 620 API

Update a Product Offering by ID

Request

Discriminator Values

Discriminator Values

Response

200 Response

Discriminator Values

Discriminator Values

400 Response

401 Response

404 Response

405 Response

500 Response

Examples