Create or update a product line
put
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/productLine/{id}
Request
Path Parameters
-
id(required): string
The unique identifier of the resource item.
Supported Media Types
- application/json
Root Schema : ProductLineOracle
Title:
ProductLineOracle
Represents entities that groups product offerings
Match All
Represents entities that groups product offerings
Represents entities that groups product offerings
Show Source
-
object
ProductLine
Title:
ProductLine
Discriminator:{ "propertyName":"@type", "mapping":{ "ProductLine":"#/components/schemas/ProductLine", "ProductLineOracle":"#/components/schemas/ProductLineOracle" } }
Represents entities that groups product offerings -
object
type
Nested Schema : ProductLine
Type:
object
Title:
ProductLine
Discriminator: @type
Discriminator Values
Represents entities that groups product offerings
Show Source
-
@baseType: string
Immediate base (class) type of the product offering
-
@schemaLocation: string
A link to the schema describing this product offering
-
@type: string
Class type of the product offering
-
description: string
Description of the product line
-
href: string
Reference of the Product line
-
id: string
Maximum Length:
30
Unique identifier of the product line -
lastUpdate: string
(date-time)
Date and time of the last update
-
lifecycleStatus: string
Used to indicate the current lifecycle status
-
name(required): string
Name of the product line
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party -
version: string
ProductOffering version
Nested Schema : type
Type:
Show Source
object
-
applicationName: string
name of the external application
-
compatibilityRules: array
compatibilityRules
-
created: string
(date-time)
Date and time of creation
-
createdBy: string
name of the person who created item
-
externalId: string
id of the external application
-
lastUpdatedBy: string
name of the person who updated item
-
productOffering: array
productOffering
-
project: object
ProjectRef
Title:
ProjectRef
Project Reference -
versionState: number
Version state of the product line
Nested Schema : compatibilityRules
Type:
Show Source
array
-
Array of:
object CompatibilityRulesOracle
Title:
CompatibilityRulesOracle
specifies the compatibilty rule for the offer
Nested Schema : productOffering
Type:
Show Source
array
-
Array of:
object ProductLineOfferingRef
Title:
ProductLineOfferingRef
ProductOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Nested Schema : ProjectRef
Type:
object
Title:
ProjectRef
Project Reference
Show Source
-
href: string
Unique reference of the project
-
id(required): string
Unique identifier of the project
-
name: string
Name of the project
-
version: string
Version of the project
Nested Schema : CompatibilityRulesOracle
Type:
object
Title:
CompatibilityRulesOracle
specifies the compatibilty rule for the offer
Show Source
-
active: boolean
A flag indicating if the rule is active or not
-
compatibilityRuleType: string
Allowed Values:
[ "REQUIRES", "EXCLUDES" ]
Specifies the type of compatability rule -
name(required): string
Unique name of the Compatibility Rule
-
objectProduct: string
object offer component of the compatability rule
-
objectProductLine: string
Object Product Line component of the compatability rule
-
subjectProduct: string
Subject offer component of the compatability rule
-
subjectProductLine: string
Subject Product Line component of the compatability rule
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party
Nested Schema : TimePeriodOracle
Type:
object
Title:
TimePeriodOracle
Validity period of the related party
Show Source
-
endDateTime: string
(date-time)
An instant of time, ending at the TimePeriod.
-
startDateTime: string
(date-time)
An instant of time, starting at the TimePeriod
Nested Schema : ProductLineOfferingRef
Type:
object
Title:
ProductLineOfferingRef
ProductOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Show Source
-
@referredType: string
the class type of the referred product offering
-
href: string
Reference of the product offering
-
id(required): string
Unique identifier of the product offering
-
isBundle: boolean
Indicates if the offer is simple or composite
-
lifecycleStatus: string
lifecycleStatus of the product offering
-
name: string
Name of the product offering
-
version: string
Version of the product offering
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : ProductLineOracle
Title:
ProductLineOracle
Represents entities that groups product offerings
Match All
Represents entities that groups product offerings
Represents entities that groups product offerings
Show Source
-
object
ProductLine
Title:
ProductLine
Discriminator:{ "propertyName":"@type", "mapping":{ "ProductLine":"#/components/schemas/ProductLine", "ProductLineOracle":"#/components/schemas/ProductLineOracle" } }
Represents entities that groups product offerings -
object
type
Nested Schema : ProductLine
Type:
object
Title:
ProductLine
Discriminator: @type
Discriminator Values
Represents entities that groups product offerings
Show Source
-
@baseType: string
Immediate base (class) type of the product offering
-
@schemaLocation: string
A link to the schema describing this product offering
-
@type: string
Class type of the product offering
-
description: string
Description of the product line
-
href: string
Reference of the Product line
-
id: string
Maximum Length:
30
Unique identifier of the product line -
lastUpdate: string
(date-time)
Date and time of the last update
-
lifecycleStatus: string
Used to indicate the current lifecycle status
-
name(required): string
Name of the product line
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party -
version: string
ProductOffering version
Nested Schema : type
Type:
Show Source
object
-
applicationName: string
name of the external application
-
compatibilityRules: array
compatibilityRules
-
created: string
(date-time)
Date and time of creation
-
createdBy: string
name of the person who created item
-
externalId: string
id of the external application
-
lastUpdatedBy: string
name of the person who updated item
-
productOffering: array
productOffering
-
project: object
ProjectRef
Title:
ProjectRef
Project Reference -
versionState: number
Version state of the product line
Nested Schema : compatibilityRules
Type:
Show Source
array
-
Array of:
object CompatibilityRulesOracle
Title:
CompatibilityRulesOracle
specifies the compatibilty rule for the offer
Nested Schema : productOffering
Type:
Show Source
array
-
Array of:
object ProductLineOfferingRef
Title:
ProductLineOfferingRef
ProductOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Nested Schema : ProjectRef
Type:
object
Title:
ProjectRef
Project Reference
Show Source
-
href: string
Unique reference of the project
-
id(required): string
Unique identifier of the project
-
name: string
Name of the project
-
version: string
Version of the project
Nested Schema : CompatibilityRulesOracle
Type:
object
Title:
CompatibilityRulesOracle
specifies the compatibilty rule for the offer
Show Source
-
active: boolean
A flag indicating if the rule is active or not
-
compatibilityRuleType: string
Allowed Values:
[ "REQUIRES", "EXCLUDES" ]
Specifies the type of compatability rule -
name(required): string
Unique name of the Compatibility Rule
-
objectProduct: string
object offer component of the compatability rule
-
objectProductLine: string
Object Product Line component of the compatability rule
-
subjectProduct: string
Subject offer component of the compatability rule
-
subjectProductLine: string
Subject Product Line component of the compatability rule
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party
Nested Schema : TimePeriodOracle
Type:
object
Title:
TimePeriodOracle
Validity period of the related party
Show Source
-
endDateTime: string
(date-time)
An instant of time, ending at the TimePeriod.
-
startDateTime: string
(date-time)
An instant of time, starting at the TimePeriod
Nested Schema : ProductLineOfferingRef
Type:
object
Title:
ProductLineOfferingRef
ProductOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Show Source
-
@referredType: string
the class type of the referred product offering
-
href: string
Reference of the product offering
-
id(required): string
Unique identifier of the product offering
-
isBundle: boolean
Indicates if the offer is simple or composite
-
lifecycleStatus: string
lifecycleStatus of the product offering
-
name: string
Name of the product offering
-
version: string
Version of the product offering
400 Response
Your request couldn't be processed because it contains missing or invalid information, such as a validation error on an input field, a missing required value, and so forth.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
401 Response
Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
404 Response
Your request includes a resource URI that doesn't exist.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
405 Response
HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
500 Response
The server encountered something unexpected that prevented it from completing the request.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
Examples
The following example shows how to create or update a product line by submitting a PUT request on the REST resource using cURL.
cURL Command
curl -u username:password -X PUT https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/productLine/InternetOffersPL2020 -H 'Content-Type: application/json' -D @put_productline.json | json_pp
Example of Request Body
The following example shows the contents of the request body in JSON format.
{ "id": "InternetOffersPL2020", "name": "Internet Offers PL2020", "@type": "ProductLineOracle", "@baseType": "ProductLine", "version": "1.0", "description": "Product line 12 for IPTV TV and Movie offers", "lifecycleStatus": "In design", "project": { "id": "SpringProject", "name": "SpringProject" }, }
Example of Response Body
The
following example shows the contents of the response body in JSON
format.
{ "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/productLine/IPTVProductLine2/InternetOffersPL2020", "id": "InternetOffersPL2020", "createdBy": "anonymous", "created": "2020-08-19T16:02:10.004Z", "lastUpdate": "2020-08-19T16:02:11.427Z", "lastUpdatedBy": "anonymous", "version": "1.0", "name": "Internet Offers PL2020", "description": "Product line 12 for IPTV TV and Movie offers", "@type": "ProductLineOracle", "@baseType": "ProductLine", "@schemaLocation": "https://{FusionAppsHost}/CatalogManagement/schema/oracle/ProductLineOracle.yml", "lifecycleStatus": "In design", "project": { "id": "SpringProject", "name": "SpringProject" } }