Create a pricetag
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/priceTag
Request
There are no request parameters for this operation.
- application/json
 
objectPriceTagOracle- 
                
                    
                    @baseType: string
                    
                    
                     
                    
                
                
                Immediate base (class) type of the object
 - 
                
                    
                    @schemaLocation: string
                    
                    
                     
                    
                
                
                A link to the schema describing this object
 - 
                
                    
                    @type(required): 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:
30Unique 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:
ProjectRefProject Reference - 
                
                    
                    validFor: object
                    
                    
                
                
                    TimePeriod
                
                
                Title:
TimePeriodThe 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 
objectProjectRef- 
                
                    
                    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
 
objectTimePeriod- 
                
                    
                    endDateTime: string
                    
                    
                     (date-time) 
                    
                
                
                An instant of time, ending at the TimePeriod.
 - 
                
                    
                    startDateTime: string
                    
                    
                     (date-time) 
                    
                
                
                An instant of time, starting at the TimePeriod
 
objectPriceTagRuleOracle- 
                
                    
                    balanceElement: object
                    
                    
                
                
                    BalanceElementRef
                
                
                Title:
BalanceElementRefBalance 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:
30Unique 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. 
objectBalanceElementRef- 
                
                    
                    @baseType: string
                    
                    
                     
                    
                
                
                Indicates the base (class) type of this REST resource
 - 
                
                    
                    @referredType(required): string
                    
                    
                     
                    
                
                
                The Class type of referred balance element
 - 
                
                    
                    @schemaLocation: string
                    
                    
                     
                    
                
                
                This field provides a link to the schema describing this REST resource
 - 
                
                    
                    @type(required): 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: 
                 ServiceSpecificationRefOracle
            
            Title:
ServiceSpecificationRefOracle 
ServiceSpecificationRefOracle- 
                
                object 
                
                
             ServiceSpecificationRef
                
            Title:
ServiceSpecificationRefDiscriminator:{ "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]
                
            
 
objectServiceSpecificationRefDiscriminator Values
- 
                
                    
                    @baseType: string
                    
                    
                     
                    
                
                
                Indicates the base (class) type of this REST resource
 - 
                
                    
                    @referredType(required): string
                    
                    
                     
                    
                
                
                the class type of associated service specification
 - 
                
                    
                    @schemaLocation: string
                    
                    
                     
                    
                
                
                This field provides a link to the schema describing this REST resource
 - 
                
                    
                    @type(required): 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:
TargetServiceSchemaThe 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- 
                
                    
                    isApplicableToChildServices: boolean
                    
                    
                     
                    
                
                
                Indicates if applicable to child services.
 - 
                
                    
                    role: string
                    
                    
                     
                    
                
                
                Allowed Values:
[ "PRIMARY", "AUXILIARY" ]Service specification role - 
                
                    
                    serviceCode: string
                    
                    
                     
                    
                
                
                Code to service specification
 
Response
- application/json
 
201 Response
objectPriceTagOracle- 
                
                    
                    @baseType: string
                    
                    
                     
                    
                
                
                Immediate base (class) type of the object
 - 
                
                    
                    @schemaLocation: string
                    
                    
                     
                    
                
                
                A link to the schema describing this object
 - 
                
                    
                    @type(required): 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:
30Unique 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:
ProjectRefProject Reference - 
                
                    
                    validFor: object
                    
                    
                
                
                    TimePeriod
                
                
                Title:
TimePeriodThe 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 
objectProjectRef- 
                
                    
                    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
 
objectTimePeriod- 
                
                    
                    endDateTime: string
                    
                    
                     (date-time) 
                    
                
                
                An instant of time, ending at the TimePeriod.
 - 
                
                    
                    startDateTime: string
                    
                    
                     (date-time) 
                    
                
                
                An instant of time, starting at the TimePeriod
 
objectPriceTagRuleOracle- 
                
                    
                    balanceElement: object
                    
                    
                
                
                    BalanceElementRef
                
                
                Title:
BalanceElementRefBalance 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:
30Unique 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. 
objectBalanceElementRef- 
                
                    
                    @baseType: string
                    
                    
                     
                    
                
                
                Indicates the base (class) type of this REST resource
 - 
                
                    
                    @referredType(required): string
                    
                    
                     
                    
                
                
                The Class type of referred balance element
 - 
                
                    
                    @schemaLocation: string
                    
                    
                     
                    
                
                
                This field provides a link to the schema describing this REST resource
 - 
                
                    
                    @type(required): 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: 
                 ServiceSpecificationRefOracle
            
            Title:
ServiceSpecificationRefOracle 
ServiceSpecificationRefOracle- 
                
                object 
                
                
             ServiceSpecificationRef
                
            Title:
ServiceSpecificationRefDiscriminator:{ "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]
                
            
 
objectServiceSpecificationRefDiscriminator Values
- 
                
                    
                    @baseType: string
                    
                    
                     
                    
                
                
                Indicates the base (class) type of this REST resource
 - 
                
                    
                    @referredType(required): string
                    
                    
                     
                    
                
                
                the class type of associated service specification
 - 
                
                    
                    @schemaLocation: string
                    
                    
                     
                    
                
                
                This field provides a link to the schema describing this REST resource
 - 
                
                    
                    @type(required): 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:
TargetServiceSchemaThe 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- 
                
                    
                    isApplicableToChildServices: boolean
                    
                    
                     
                    
                
                
                Indicates if applicable to child services.
 - 
                
                    
                    role: string
                    
                    
                     
                    
                
                
                Allowed Values:
[ "PRIMARY", "AUXILIARY" ]Service specification role - 
                
                    
                    serviceCode: string
                    
                    
                     
                    
                
                
                Code to service specification
 
400 Response
objectError- 
                
                    
                    @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
objectError- 
                
                    
                    @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
objectError- 
                
                    
                    @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
objectError- 
                
                    
                    @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
objectError- 
                
                    
                    @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 a price tag 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/productCatalogReferenceManagement/v1/priceTag
                    -H 'Content-Type: application/json' -D @create_pricetag.json | json_pp
                     
                  
Example of Request Body
The following shows an example of the request body in JSON format.
{
    "id": "PT_0091",
    "name": "Price Tag1",
    "lifecycleStatus": "In design",
    "version": "1.0",
    "@type": "PriceTagOracle",
    "project": {
        "id": "I0601",
        "name": "I0601",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/I0601",
        "version": "1.0",
        "@referredType": "ProjectOracle"
    },
    "priceTagRules": [
        {
            "id": "pt-rule-1",
            "unitOfMeasure": "ALL",
            "productType": "ALL",
            "valueType": "LIST",
            "balanceElementCode": "ALL",
            "value": "10;20"
        }
    ]
}
                  Example of Response Body
The following shows an example of the response body in JSON format.
{
    "id": "PT_0091",
    "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/priceTag/PT_0091",
    "name": "Price Tag1",
    "lastUpdate": "2025-02-17T13:09:27.124Z",
    "lifecycleStatus": "In design",
    "version": "1.0",
    "@type": "PriceTagOracle",
    "project": {
        "id": "I0601",
        "name": "I0601",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/I0601",
        "version": "1.0",
        "@referredType": "ProjectOracle"
    },
    "priceTagRules": [
        {
            "id": "pt-rule-1",
            "unitOfMeasure": "ALL",
            "productType": "ALL",
            "valueType": "LIST",
            "balanceElementCode": "ALL",
            "value": "10;20"
        }
    ],
    "lastUpdatedBy": "booth",
    "created": "2025-02-17T13:09:27.000Z",
    "createdBy": "booth",
    "versionState": 0
}