Create a product line
post
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/productLine
Creates a new product line using the supplied request payload and returns the created resource.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : ProductLineOracle
Title:
ProductLineOracleMatch All
Show Source
-
object
ProductLine
Title:
ProductLineDiscriminator:{ "propertyName":"@type", "mapping":{ "ProductLine":"#/components/schemas/ProductLine", "ProductLineOracle":"#/components/schemas/ProductLineOracle" } }The entity that groups product offerings. -
object
type
Nested Schema : ProductLine
Type:
objectTitle:
ProductLineDiscriminator: @type
Discriminator Values
The entity that groups product offerings.
Show Source
-
@baseType: string
The base type of the product line.
-
@schemaLocation: string
The URI of the schema that defines the product line.
-
@type(required): string
The class type of the product line.
-
description: string
The description of the product line.
-
href: string
The hyperlink reference to the product line.
-
id: string
Maximum Length:
30The ID of the product line. -
lastUpdate: string
(date-time)
The date and time when the product line was last updated.
-
lifecycleStatus: string
The status of the product line.
-
name(required): string
The name of the product line.
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracleThe validity period of the related party. -
version: string
The product line version.
Nested Schema : type
Type:
Show Source
object-
applicationName: string
The name of the application associated with the product line.
-
compatibilityRules: array
compatibilityRules
A list of compatibility rules associated with the product line.
-
created: string
(date-time)
The date and time of creation.
-
createdBy: string
The name of the person who created item.
-
externalId: string
The ID of the external associated with the product line.
-
lastUpdatedBy: string
The name of the person who updated item.
-
productOffering: array
productOffering
A list of product offerings associated with the product line.
-
project: object
ProjectRef
Title:
ProjectRefThe project reference resource. -
versionState: number
The version state of the product line.
Nested Schema : compatibilityRules
Type:
arrayA list of compatibility rules associated with the product line.
Show Source
-
Array of:
object CompatibilityRulesOracle
Title:
CompatibilityRulesOracleSpecifies the compatibility rule for the offer.
Nested Schema : productOffering
Type:
arrayA list of product offerings associated with the product line.
Show Source
-
Array of:
ProductOfferingRefOracle
Title:
ProductOfferingRefOracle
Nested Schema : ProjectRef
Type:
objectTitle:
ProjectRefThe project reference resource.
Show Source
-
href: string
The hyperlink reference to the project reference.
-
id(required): string
The ID of the project reference.
-
name: string
The name of the project reference.
-
version: string
The version of the project.
Nested Schema : CompatibilityRulesOracle
Type:
objectTitle:
CompatibilityRulesOracleSpecifies the compatibility rule for the offer.
Show Source
-
active: boolean
Whether the compatibility rule has active.
-
compatibilityRuleType: string
Allowed Values:
[ "REQUIRES", "EXCLUDES" ]The type or classification of the compatibility rule. Valid values are REQUIRES, and EXCLUDES. -
name(required): string
The name of the compatibility rule.
-
objectProduct: string
The object offer component of the compatability rule.
-
objectProductLine: string
The object Product Line component of the compatability rule.
-
subjectProduct: string
The subject offer component of the compatability rule.
-
subjectProductLine: string
The subject Product Line component of the compatability rule.
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracleThe validity period of the related party.
Nested Schema : TimePeriodOracle
Type:
objectTitle:
TimePeriodOracleThe validity period of the related party.
Show Source
-
endDateTime: string
(date-time)
The end date and time of the time period.
-
startDateTime: string
(date-time)
The start date and time of the time period.
Nested Schema : ProductOfferingRefOracle
Title:
ProductOfferingRefOracleMatch All
Show Source
-
object
ProductOfferingRef
Title:
ProductOfferingRefDiscriminator:{ "propertyName":"@type", "mapping":{ "ProductOfferingRef":"#/components/schemas/ProductOfferingRef", "BundledProductOffering":"#/components/schemas/BundledProductOffering", "BundledProductOfferingChoiceOracle":"#/components/schemas/BundledProductOfferingChoiceOracle", "BundledProductOfferingOracle":"#/components/schemas/BundledProductOfferingOracle" } }The productOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information. -
object
ProductOfferingRefOracle-allOf[1]
Nested Schema : ProductOfferingRef
Type:
objectTitle:
ProductOfferingRefDiscriminator: @type
Discriminator Values
- ProductOfferingRef
- BundledProductOffering
- BundledProductOfferingChoiceOracle
- BundledProductOfferingOracle
The productOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Show Source
-
@baseType: string
The base type of the product offering reference.
-
@referredType(required): string
The type of the referred product offering reference.
-
@schemaLocation: string
The URI of the schema that defines the product offering reference.
-
@type(required): string
The class type of the product offering reference.
-
href: string
The hyperlink reference to the product offering reference.
-
id(required): string
The ID of the product offering reference.
-
name: string
The name of the product offering reference.
-
version: string
The version of the product offering.
-
versionState: number
The version state of the reference.
Nested Schema : ProductOfferingRefOracle-allOf[1]
Type:
Show Source
object-
isBundle: boolean
Whether the product offering reference is bundle.
-
lifecycleStatus: string
The status of the product offering reference.
-
version: string
The version of the product offering.
Response
Supported Media Types
- application/json
201 Response
The product line was created successfully.
Root Schema : ProductLineOracle
Title:
ProductLineOracleMatch All
Show Source
-
object
ProductLine
Title:
ProductLineDiscriminator:{ "propertyName":"@type", "mapping":{ "ProductLine":"#/components/schemas/ProductLine", "ProductLineOracle":"#/components/schemas/ProductLineOracle" } }The entity that groups product offerings. -
object
type
Nested Schema : ProductLine
Type:
objectTitle:
ProductLineDiscriminator: @type
Discriminator Values
The entity that groups product offerings.
Show Source
-
@baseType: string
The base type of the product line.
-
@schemaLocation: string
The URI of the schema that defines the product line.
-
@type(required): string
The class type of the product line.
-
description: string
The description of the product line.
-
href: string
The hyperlink reference to the product line.
-
id: string
Maximum Length:
30The ID of the product line. -
lastUpdate: string
(date-time)
The date and time when the product line was last updated.
-
lifecycleStatus: string
The status of the product line.
-
name(required): string
The name of the product line.
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracleThe validity period of the related party. -
version: string
The product line version.
Nested Schema : type
Type:
Show Source
object-
applicationName: string
The name of the application associated with the product line.
-
compatibilityRules: array
compatibilityRules
A list of compatibility rules associated with the product line.
-
created: string
(date-time)
The date and time of creation.
-
createdBy: string
The name of the person who created item.
-
externalId: string
The ID of the external associated with the product line.
-
lastUpdatedBy: string
The name of the person who updated item.
-
productOffering: array
productOffering
A list of product offerings associated with the product line.
-
project: object
ProjectRef
Title:
ProjectRefThe project reference resource. -
versionState: number
The version state of the product line.
Nested Schema : compatibilityRules
Type:
arrayA list of compatibility rules associated with the product line.
Show Source
-
Array of:
object CompatibilityRulesOracle
Title:
CompatibilityRulesOracleSpecifies the compatibility rule for the offer.
Nested Schema : productOffering
Type:
arrayA list of product offerings associated with the product line.
Show Source
-
Array of:
ProductOfferingRefOracle
Title:
ProductOfferingRefOracle
Nested Schema : ProjectRef
Type:
objectTitle:
ProjectRefThe project reference resource.
Show Source
-
href: string
The hyperlink reference to the project reference.
-
id(required): string
The ID of the project reference.
-
name: string
The name of the project reference.
-
version: string
The version of the project.
Nested Schema : CompatibilityRulesOracle
Type:
objectTitle:
CompatibilityRulesOracleSpecifies the compatibility rule for the offer.
Show Source
-
active: boolean
Whether the compatibility rule has active.
-
compatibilityRuleType: string
Allowed Values:
[ "REQUIRES", "EXCLUDES" ]The type or classification of the compatibility rule. Valid values are REQUIRES, and EXCLUDES. -
name(required): string
The name of the compatibility rule.
-
objectProduct: string
The object offer component of the compatability rule.
-
objectProductLine: string
The object Product Line component of the compatability rule.
-
subjectProduct: string
The subject offer component of the compatability rule.
-
subjectProductLine: string
The subject Product Line component of the compatability rule.
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracleThe validity period of the related party.
Nested Schema : TimePeriodOracle
Type:
objectTitle:
TimePeriodOracleThe validity period of the related party.
Show Source
-
endDateTime: string
(date-time)
The end date and time of the time period.
-
startDateTime: string
(date-time)
The start date and time of the time period.
Nested Schema : ProductOfferingRefOracle
Title:
ProductOfferingRefOracleMatch All
Show Source
-
object
ProductOfferingRef
Title:
ProductOfferingRefDiscriminator:{ "propertyName":"@type", "mapping":{ "ProductOfferingRef":"#/components/schemas/ProductOfferingRef", "BundledProductOffering":"#/components/schemas/BundledProductOffering", "BundledProductOfferingChoiceOracle":"#/components/schemas/BundledProductOfferingChoiceOracle", "BundledProductOfferingOracle":"#/components/schemas/BundledProductOfferingOracle" } }The productOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information. -
object
ProductOfferingRefOracle-allOf[1]
Nested Schema : ProductOfferingRef
Type:
objectTitle:
ProductOfferingRefDiscriminator: @type
Discriminator Values
- ProductOfferingRef
- BundledProductOffering
- BundledProductOfferingChoiceOracle
- BundledProductOfferingOracle
The productOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Show Source
-
@baseType: string
The base type of the product offering reference.
-
@referredType(required): string
The type of the referred product offering reference.
-
@schemaLocation: string
The URI of the schema that defines the product offering reference.
-
@type(required): string
The class type of the product offering reference.
-
href: string
The hyperlink reference to the product offering reference.
-
id(required): string
The ID of the product offering reference.
-
name: string
The name of the product offering reference.
-
version: string
The version of the product offering.
-
versionState: number
The version state of the reference.
Nested Schema : ProductOfferingRefOracle-allOf[1]
Type:
Show Source
object-
isBundle: boolean
Whether the product offering reference is bundle.
-
lifecycleStatus: string
The status of the product offering reference.
-
version: string
The 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:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
401 Response
Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
404 Response
The resource with the specified URI couldn't be found.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
405 Response
HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
500 Response
The server encountered something unexpected that prevented it from completing the request.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
Examples
The following example shows how to create a product line by submitting a POST request on the REST resource using cURL.
cURL Command
curl -u username:password -X POST
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/productLine/
\ -H 'Content-Type: application/json' -D @create_productline.json |
json_pp
Example of Request Body
The following example shows the contents of the request body in JSON format.
{
"id": "InternetOffersPL",
"name": "Internet Offers PL",
"@type": "ProductLineOracle",
"@baseType": "ProductLine",
"version": "1.0",
"description": "Product line 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.
{
"id": "InternetOffersPL",
"name": "Internet Offers PL",
"@type": "ProductLineOracle",
"@baseType": "ProductLine",
"version": "1.0",
"description": "Product line for IPTV TV and Movie offers",
"lifecycleStatus": "In design",
"project": {
"id": "SpringProject",
"name": "SpringProject"
},
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/productLine/InternetOffersPL",
"createdBy": "anonymous",
"created": "2020-08-19T15:52:49.000Z",
"lastUpdatedBy": "anonymous",
"lastUpdate": "2020-08-19T15:52:49.000Z"
}