Update a price tag
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/priceTag/{id}
Request
-
id(required): string
The unique identifier of the resource item.
- application/json
object
PriceTagOracle
-
@baseType: string
Immediate base (class) type of the object
-
@schemaLocation: string
A link to the schema describing this object
-
@type: string
Indicates the type of resource.
-
created: string
(date-time)
Date and time of the priceTag creation.
-
createdBy: string
name of the person who created the priceTag.
-
description: string
Description of priceTag.
-
href: string
Hypertext Reference of the priceTag.
-
id: string
Maximum Length:
30
Unique identifier of the priceTag. -
lastUpdate: string
(date-time)
Latest update date of priceTag.
-
lastUpdatedBy: string
name of the person who updated the priceTag.
-
lifecycleStatus: string
Status of priceTag
-
name(required): string
Name of priceTag.
-
priceTagRules: array
priceTagRules
-
project: object
ProjectRef
Title:
ProjectRef
Project Reference -
validFor: object
TimePeriod
Title:
TimePeriod
The period for which the productOffering is valid -
version: string
PriceTag version
-
versionState: number
Version state of the priceTag.
array
-
Array of:
object PriceTagRuleOracle
Title:
PriceTagRuleOracle
object
ProjectRef
-
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
object
TimePeriod
-
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
object
PriceTagRuleOracle
-
balanceElement: object
BalanceElementRef
Title:
BalanceElementRef
Balance element ref in price -
balanceElementCode: string
Currency (ISO4217 norm uses 3 letters to define the currency and user defined code for non currency
-
id(required): string
Maximum Length:
30
Unique identifier of the priceTag. -
productType: string
Allowed Values:
[ "ALL", "ACCOUNT", "SERVICE" ]
Type of offer to which the priceTag rule applies to. -
serviceSpecification: array
serviceSpecification
-
unitOfMeasure: string
The unit of measure for which the priceTag rule applies to.
-
value: string
Value corresponding to the selected valueType in semicolon selected format.
-
valueType: string
Allowed Values:
[ "ALL", "LIST", "RANGE" ]
Type of value.
object
BalanceElementRef
-
@baseType: string
Indicates the base (class) type of this REST resource
-
@referredType: string
The Class type of referred balance element
-
@schemaLocation: string
This field provides a link to the schema describing this REST resource
-
@type: string
Indicates the (class) type of balance element.
-
href: string
Unique reference of the balance element
-
id(required): string
Unique identifier of the balance element
-
name: string
Name of the balance element
-
version: string
Version of the balance element
-
versionState: number
To hold the version state of reference
array
-
Array of:
ServiceSpecificationReferenceOracle
Title:
ServiceSpecificationReferenceOracle
ServiceSpecificationReferenceOracle
-
allOf
ServiceSpecificationRefOracle
Title:
ServiceSpecificationRefOracle
-
object
ServiceSpecificationReferenceOracle-allOf[1]
ServiceSpecificationRefOracle
-
object
ServiceSpecificationRef
Title:
ServiceSpecificationRef
Discriminator:{ "propertyName":"@type", "mapping":{ "ServiceSpecificationRef":"#/components/schemas/ServiceSpecificationRef", "ServiceSpecificationRefOracle":"#/components/schemas/ServiceSpecificationRefOracle" } }
Service specification reference: ServiceSpecification(s) required to realize a ProductSpecification. -
object
ServiceSpecificationRefOracle-allOf[1]
object
ServiceSpecificationRef
Discriminator Values
-
@baseType: string
Indicates the base (class) type of this REST resource
-
@referredType: string
the class type of associated service specification
-
@schemaLocation: string
This field provides a link to the schema describing this REST resource
-
@type: string
Indicates the (class) type of ServiceSpecificationRef.
-
href: string
Reference of the serviceSpecification
-
id(required): string
Unique identifier of the service specification
-
name: string
Name of the requiredServiceSpecification
-
targetServiceSchema: object
TargetServiceSchema
Title:
TargetServiceSchema
The reference object to the schema and type of target product which is described by product specification -
version: string
Service specification version
-
versionState: number
To hold the version state for the reference
object
-
role: string
Allowed Values:
[ "PRIMARY", "AUXILIARY" ]
Service specification role -
serviceCode: string
Code to service specification
object
-
isApplicableToChildServices: boolean
Indicates if applicable to child services.
Response
- application/json
200 Response
object
PriceTagOracle
-
@baseType: string
Immediate base (class) type of the object
-
@schemaLocation: string
A link to the schema describing this object
-
@type: string
Indicates the type of resource.
-
created: string
(date-time)
Date and time of the priceTag creation.
-
createdBy: string
name of the person who created the priceTag.
-
description: string
Description of priceTag.
-
href: string
Hypertext Reference of the priceTag.
-
id: string
Maximum Length:
30
Unique identifier of the priceTag. -
lastUpdate: string
(date-time)
Latest update date of priceTag.
-
lastUpdatedBy: string
name of the person who updated the priceTag.
-
lifecycleStatus: string
Status of priceTag
-
name(required): string
Name of priceTag.
-
priceTagRules: array
priceTagRules
-
project: object
ProjectRef
Title:
ProjectRef
Project Reference -
validFor: object
TimePeriod
Title:
TimePeriod
The period for which the productOffering is valid -
version: string
PriceTag version
-
versionState: number
Version state of the priceTag.
array
-
Array of:
object PriceTagRuleOracle
Title:
PriceTagRuleOracle
object
ProjectRef
-
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
object
TimePeriod
-
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
object
PriceTagRuleOracle
-
balanceElement: object
BalanceElementRef
Title:
BalanceElementRef
Balance element ref in price -
balanceElementCode: string
Currency (ISO4217 norm uses 3 letters to define the currency and user defined code for non currency
-
id(required): string
Maximum Length:
30
Unique identifier of the priceTag. -
productType: string
Allowed Values:
[ "ALL", "ACCOUNT", "SERVICE" ]
Type of offer to which the priceTag rule applies to. -
serviceSpecification: array
serviceSpecification
-
unitOfMeasure: string
The unit of measure for which the priceTag rule applies to.
-
value: string
Value corresponding to the selected valueType in semicolon selected format.
-
valueType: string
Allowed Values:
[ "ALL", "LIST", "RANGE" ]
Type of value.
object
BalanceElementRef
-
@baseType: string
Indicates the base (class) type of this REST resource
-
@referredType: string
The Class type of referred balance element
-
@schemaLocation: string
This field provides a link to the schema describing this REST resource
-
@type: string
Indicates the (class) type of balance element.
-
href: string
Unique reference of the balance element
-
id(required): string
Unique identifier of the balance element
-
name: string
Name of the balance element
-
version: string
Version of the balance element
-
versionState: number
To hold the version state of reference
array
-
Array of:
ServiceSpecificationReferenceOracle
Title:
ServiceSpecificationReferenceOracle
ServiceSpecificationReferenceOracle
-
allOf
ServiceSpecificationRefOracle
Title:
ServiceSpecificationRefOracle
-
object
ServiceSpecificationReferenceOracle-allOf[1]
ServiceSpecificationRefOracle
-
object
ServiceSpecificationRef
Title:
ServiceSpecificationRef
Discriminator:{ "propertyName":"@type", "mapping":{ "ServiceSpecificationRef":"#/components/schemas/ServiceSpecificationRef", "ServiceSpecificationRefOracle":"#/components/schemas/ServiceSpecificationRefOracle" } }
Service specification reference: ServiceSpecification(s) required to realize a ProductSpecification. -
object
ServiceSpecificationRefOracle-allOf[1]
object
ServiceSpecificationRef
Discriminator Values
-
@baseType: string
Indicates the base (class) type of this REST resource
-
@referredType: string
the class type of associated service specification
-
@schemaLocation: string
This field provides a link to the schema describing this REST resource
-
@type: string
Indicates the (class) type of ServiceSpecificationRef.
-
href: string
Reference of the serviceSpecification
-
id(required): string
Unique identifier of the service specification
-
name: string
Name of the requiredServiceSpecification
-
targetServiceSchema: object
TargetServiceSchema
Title:
TargetServiceSchema
The reference object to the schema and type of target product which is described by product specification -
version: string
Service specification version
-
versionState: number
To hold the version state for the reference
object
-
role: string
Allowed Values:
[ "PRIMARY", "AUXILIARY" ]
Service specification role -
serviceCode: string
Code to service specification
object
-
isApplicableToChildServices: boolean
Indicates if applicable to child services.
400 Response
object
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
object
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
object
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
object
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
object
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 a price tag by submitting a patch request on the REST resource using cURL.
cURL Command
curl -u username:password -X PATCH
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/priceTag/{id}
-H 'Content-Type: application/json' -D @update_pricetag.json | json_pp
Example of Request Body
The following shows an example of the request body in JSON format.
{ "id": "PriceTagConfigZoneTest", "name": "PriceTagConfigZoneTest", "description": "PriceTagConfigZone test description", "lastUpdate": "2024-09-24T22:27:11.049Z", "lifecycleStatus": "In design", "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z" }, "version": "1.0", "@type": "PriceTagOracle", "priceTagRules": [ { "id": "PriceTagConfigids1", "unitOfMeasure": "ALL", "productType": "ALL", "valueType": "LIST", "balanceElementCode": "ALL", "value": "10;20" } ], "lastUpdatedBy": "booth", "created": "2024-07-26T22:18:07.000Z", "createdBy": "booth", "versionState": 0 }
Example of Response Body
The following shows an example of the response body in JSON format.
{ "id": "PriceTagConfigZoneTest", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/priceTag/PriceTagConfigZoneTest", "name": "PriceTagConfigZoneTest", "description": "PriceTagConfigZone test description", "lastUpdate": "2024-09-26T07:25:39.006Z", "lifecycleStatus": "In design", "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z" }, "version": "1.0", "@type": "PriceTagOracle", "priceTagRules": [ { "id": "PriceTagConfigids1", "unitOfMeasure": "ALL", "productType": "ALL", "valueType": "LIST", "balanceElementCode": "ALL", "value": "10;20" } ], "lastUpdatedBy": "booth", "created": "2024-09-26T07:23:52.000Z", "createdBy": "booth" }