Create or update a custom profile specification
put
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customProfileSpecification/{id}
Request
Path Parameters
-
id(required): string
The unique identifier of the resource item.
Supported Media Types
- application/json
Root Schema : CustomProfileSpecificationOracle
Type:
object
Title:
CustomProfileSpecificationOracle
CustomProfileSpecificationOracle
Show Source
-
@baseType: string
Immediate base (class) type of the Custom ProfileSpec
-
@schemaLocation: string
A link to the schema describing this Custom ProfileSpec
-
@type: string
Class type of the Custom ProfileSpec
-
applicationName: string
name of the external application
-
charValueObject: array
charValueObject
-
created: string
(date-time)
Date and time of creation
-
createdBy: string
name of the person who created
-
customProfileSpecChar: array
customProfileSpecChar
-
customProfileSpecRel: array
customProfileSpecRel
-
description: string
A string. A narrative that explains in detail what the Custom ProfileSpec is.
-
externalId: string
id of the external application
-
href: string
A string. Reference of the Custom ProfileSpec.
-
id: string
Maximum Length:
30
A string. Unique identifier of the Custom ProfileSpec. -
lastUpdate: string
(date-time)
A date time (DateTime). Date and time of the last update of the Custom ProfileSpec.
-
lastUpdatedBy: string
name of the person who updated
-
lifecycleStatus: string
A string. Used to indicate the current lifecycle status of the custom profile specification.
-
name(required): string
A string. Name of the Custom ProfileSpec.
-
profileCode: string
Code of the profile
-
profileType(required): string
Allowed Values:
[ "DEVICE_SPEC", "BUSINESS_CONFIG", "TRADE_IN", "CHARGING_TERM", "SUSPENSION_TERM", "RETURN_CHECKLIST", "ENTITY_PROFILE", "RENEWAL_TERM", "FINANCE_PLAN", "ZONE_VALUE_MAP", "STANDARD_ZONE" ]
type of the profile -
project: object
ProjectRef
Title:
ProjectRef
Project Reference - relatedParty: array relatedParty
-
targetProductSchema: object
TargetProductSchemaOracle
Title:
TargetProductSchemaOracle
The reference object to the schema and type of target product which is described by product specification -
validFor: object
TimePeriod
Title:
TimePeriod
The period for which the productOffering is valid -
version: string
A string. Custom ProfileSpec version.
-
versionState: number
Version state of the Customer Profile Specification
Nested Schema : charValueObject
Type:
Show Source
array
-
Array of:
object CharValueObjectRefOracle
Title:
CharValueObjectRefOracle
The Reference of the resource referred in CharValue of custom profile specification
Nested Schema : customProfileSpecRel
Type:
Show Source
array
-
Array of:
object CustomProfileSpecRel
Title:
CustomProfileSpecRel
A migration, substitution, dependency or exclusivity relationship between/among custom profile specifications.
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 : TargetProductSchemaOracle
Type:
object
Title:
TargetProductSchemaOracle
The reference object to the schema and type of target product which is described by product specification
Match All
The reference object to the schema and type of target product which is described by product specification
The reference object to the schema and type of target product which is described by product specification
Show Source
-
object
TargetProductSchema
Title:
TargetProductSchema
The reference object to the schema and type of target product which is described by product specification -
object
TargetProductSchemaOracle-allOf[1]
Nested Schema : TimePeriod
Type:
object
Title:
TimePeriod
The period for which the productOffering is valid
Show Source
-
endDateTime: string
(date-time)
An instant of time, ending at the TimePeriod.
-
startDateTime(required): string
(date-time)
An instant of time, starting at the TimePeriod
Nested Schema : CharValueObjectRefOracle
Type:
object
Title:
CharValueObjectRefOracle
The Reference of the resource referred in CharValue of custom profile specification
Show Source
-
@baseType: string
When sub-classing, this defines the super-class
-
@referredType: string
The actual type of the target instance when needed for disambiguation
-
@schemaLocation: string
(uri)
A URI to a JSON-Schema file that defines additional attributes and relationships
-
@type: string
When sub-classing, this defines the sub-class entity name
-
href: string
Unique reference of the project
-
id(required): string
Unique identifier of the resource referenced
-
name: string
Name of the resource
-
resourceType: string
Allowed Values:
[ "SERVICE_SPEC" ]
A string. The type of resource referenced in the char value
Nested Schema : CustomProfileSpecRel
Type:
object
Title:
CustomProfileSpecRel
A migration, substitution, dependency or exclusivity relationship between/among custom profile specifications.
Show Source
-
href: string
Reference of the custom profile Specification
-
id(required): string
Unique identifier of the custom profile Specification
-
relationshipType(required): string
Allowed Values:
[ "AGGREGATION", "MIGRATION", "SUBSTITUTION", "DEPENDENCY", "EXCLUSIVITY", "PARENT", "CONDITION", "EXCLUDES", "REQUIRES", "ALLOWED" ]
Type of relationship such as migration, substitution, dependency, exclusivity -
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party -
versionState: number
To hold the version state of reference
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 : RelatedParty
Type:
object
Title:
RelatedParty
RelatedParty reference. A related party defines party or party role linked to a specific entity.
Show Source
-
@baseType: string
The immediate base class type of the RelatedParty
-
@referredType: string
The class type of referred party/party role reference
-
@schemaLocation: string
A link to the schema describing this RelatedParty entity
-
@type: string
the class type of the RelatedParty
-
href: string
Reference of the related party, could be a party reference or a party role reference
-
id(required): string
Unique identifier of a related party
-
name: string
Name of the related party
-
role: string
Role of the related party.
Nested Schema : TargetProductSchema
Type:
object
Title:
TargetProductSchema
The reference object to the schema and type of target product which is described by product specification
Show Source
-
@schemaLocation(required): string
This field provides a link to the schema describing the target product
-
@type(required): string
class type of the target product
Nested Schema : TargetProductSchemaOracle-allOf[1]
Type:
Show Source
object
-
subType: string
class sub type of the target product
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : CustomProfileSpecificationOracle
Type:
object
Title:
CustomProfileSpecificationOracle
CustomProfileSpecificationOracle
Show Source
-
@baseType: string
Immediate base (class) type of the Custom ProfileSpec
-
@schemaLocation: string
A link to the schema describing this Custom ProfileSpec
-
@type: string
Class type of the Custom ProfileSpec
-
applicationName: string
name of the external application
-
charValueObject: array
charValueObject
-
created: string
(date-time)
Date and time of creation
-
createdBy: string
name of the person who created
-
customProfileSpecChar: array
customProfileSpecChar
-
customProfileSpecRel: array
customProfileSpecRel
-
description: string
A string. A narrative that explains in detail what the Custom ProfileSpec is.
-
externalId: string
id of the external application
-
href: string
A string. Reference of the Custom ProfileSpec.
-
id: string
Maximum Length:
30
A string. Unique identifier of the Custom ProfileSpec. -
lastUpdate: string
(date-time)
A date time (DateTime). Date and time of the last update of the Custom ProfileSpec.
-
lastUpdatedBy: string
name of the person who updated
-
lifecycleStatus: string
A string. Used to indicate the current lifecycle status of the custom profile specification.
-
name(required): string
A string. Name of the Custom ProfileSpec.
-
profileCode: string
Code of the profile
-
profileType(required): string
Allowed Values:
[ "DEVICE_SPEC", "BUSINESS_CONFIG", "TRADE_IN", "CHARGING_TERM", "SUSPENSION_TERM", "RETURN_CHECKLIST", "ENTITY_PROFILE", "RENEWAL_TERM", "FINANCE_PLAN", "ZONE_VALUE_MAP", "STANDARD_ZONE" ]
type of the profile -
project: object
ProjectRef
Title:
ProjectRef
Project Reference - relatedParty: array relatedParty
-
targetProductSchema: object
TargetProductSchemaOracle
Title:
TargetProductSchemaOracle
The reference object to the schema and type of target product which is described by product specification -
validFor: object
TimePeriod
Title:
TimePeriod
The period for which the productOffering is valid -
version: string
A string. Custom ProfileSpec version.
-
versionState: number
Version state of the Customer Profile Specification
Nested Schema : charValueObject
Type:
Show Source
array
-
Array of:
object CharValueObjectRefOracle
Title:
CharValueObjectRefOracle
The Reference of the resource referred in CharValue of custom profile specification
Nested Schema : customProfileSpecRel
Type:
Show Source
array
-
Array of:
object CustomProfileSpecRel
Title:
CustomProfileSpecRel
A migration, substitution, dependency or exclusivity relationship between/among custom profile specifications.
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 : TargetProductSchemaOracle
Type:
object
Title:
TargetProductSchemaOracle
The reference object to the schema and type of target product which is described by product specification
Match All
The reference object to the schema and type of target product which is described by product specification
The reference object to the schema and type of target product which is described by product specification
Show Source
-
object
TargetProductSchema
Title:
TargetProductSchema
The reference object to the schema and type of target product which is described by product specification -
object
TargetProductSchemaOracle-allOf[1]
Nested Schema : TimePeriod
Type:
object
Title:
TimePeriod
The period for which the productOffering is valid
Show Source
-
endDateTime: string
(date-time)
An instant of time, ending at the TimePeriod.
-
startDateTime(required): string
(date-time)
An instant of time, starting at the TimePeriod
Nested Schema : CharValueObjectRefOracle
Type:
object
Title:
CharValueObjectRefOracle
The Reference of the resource referred in CharValue of custom profile specification
Show Source
-
@baseType: string
When sub-classing, this defines the super-class
-
@referredType: string
The actual type of the target instance when needed for disambiguation
-
@schemaLocation: string
(uri)
A URI to a JSON-Schema file that defines additional attributes and relationships
-
@type: string
When sub-classing, this defines the sub-class entity name
-
href: string
Unique reference of the project
-
id(required): string
Unique identifier of the resource referenced
-
name: string
Name of the resource
-
resourceType: string
Allowed Values:
[ "SERVICE_SPEC" ]
A string. The type of resource referenced in the char value
Nested Schema : CustomProfileSpecRel
Type:
object
Title:
CustomProfileSpecRel
A migration, substitution, dependency or exclusivity relationship between/among custom profile specifications.
Show Source
-
href: string
Reference of the custom profile Specification
-
id(required): string
Unique identifier of the custom profile Specification
-
relationshipType(required): string
Allowed Values:
[ "AGGREGATION", "MIGRATION", "SUBSTITUTION", "DEPENDENCY", "EXCLUSIVITY", "PARENT", "CONDITION", "EXCLUDES", "REQUIRES", "ALLOWED" ]
Type of relationship such as migration, substitution, dependency, exclusivity -
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party -
versionState: number
To hold the version state of reference
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 : RelatedParty
Type:
object
Title:
RelatedParty
RelatedParty reference. A related party defines party or party role linked to a specific entity.
Show Source
-
@baseType: string
The immediate base class type of the RelatedParty
-
@referredType: string
The class type of referred party/party role reference
-
@schemaLocation: string
A link to the schema describing this RelatedParty entity
-
@type: string
the class type of the RelatedParty
-
href: string
Reference of the related party, could be a party reference or a party role reference
-
id(required): string
Unique identifier of a related party
-
name: string
Name of the related party
-
role: string
Role of the related party.
Nested Schema : TargetProductSchema
Type:
object
Title:
TargetProductSchema
The reference object to the schema and type of target product which is described by product specification
Show Source
-
@schemaLocation(required): string
This field provides a link to the schema describing the target product
-
@type(required): string
class type of the target product
Nested Schema : TargetProductSchemaOracle-allOf[1]
Type:
Show Source
object
-
subType: string
class sub type of the target product
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 update partially or fully a custom profile specification by submitting a PUT request on the REST resource using cURL
curl -H 'Authorization: Bearer <accessToken> -H PUT https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customProfileSpecification/id
Example of Request Body
The following shows an example of the request body.
{ "id": "BuiltInCustSpec004", "name": "Built In Cust Spec", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customProfileSpecification/BuiltInCustSpec004", "version": "1.0", "lifecycleStatus": "In design", "created": "2021-06-01T09:17:41.000Z", "createdBy": "booth", "lastUpdate": "2021-06-01T09:27:26.108Z", "lastUpdatedBy": "booth", "@type": "CustomProfileSpecificationOracle", "project": { "id": "CustomProject", "name": "CustomProject" }, "customProfileSpecChar": [ { "name": "Align Cycle 001", "description": "The cycle charges apply and are applicable for recurring charges", "valueType": "STRING", "configurable": true, "minCardinality": 0, "maxCardinality": 1, "customProfileSpecCharValue": [ { "isDefault": true, "valueType": "STRING", "value": "Activation Day" }, { "isDefault": false, "valueType": "STRING", "value": "Subscription Day" }, { "isDefault": false, "valueType": "STRING", "value": "Suspense Day" } ] }, { "name": "Discounts", "description": "Application of discount based on the discount validity", "configurable": true, "minCardinality": 0, "maxCardinality": 1, "customProfileSpecCharRel": [ { "id": "BuiltInCustSpec004", "relationshipType": "AGGREGATION", "name": "Discount to Mid Cycle for Cycle" } ] } ], "profileType": "CHARGING_TERM" }
Example of Response Body
The following example shows the contents of the response body in JSON format.
{ "id": "BuiltInCustSpec004", "name": "Built In Cust Spec", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customProfileSpecification/BuiltInCustSpec004/BuiltInCustSpec004", "version": "1.0", "lifecycleStatus": "In design", "created": "2021-06-01T09:17:41.000Z", "createdBy": "booth", "lastUpdate": "2021-06-03T12:54:51.386Z", "lastUpdatedBy": "booth", "@type": "CustomProfileSpecificationOracle", "project": { "id": "CustomProject", "name": "CustomProject" }, "customProfileSpecChar": [ { "name": "Align Cycle 001", "description": "The cycle charges apply and are applicable for recurring charges", "valueType": "STRING", "configurable": true, "minCardinality": 0, "maxCardinality": 1, "customProfileSpecCharValue": [ { "isDefault": true, "valueType": "STRING", "value": "Activation Day" }, { "isDefault": false, "valueType": "STRING", "value": "Subscription Day" }, { "isDefault": false, "valueType": "STRING", "value": "Suspense Day" } ] }, { "name": "Discounts", "description": "Application of discount based on the discount validity", "configurable": true, "minCardinality": 0, "maxCardinality": 1, "customProfileSpecCharRel": [ { "relationshipType": "AGGREGATION", "name": "Discount to Mid Cycle for Cycle" } ] } ], "profileType": "CHARGING_TERM" }