Create or update an array of pricelist
put
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/pricelists
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
array
Minimum Number of Items:
1
Maximum Number of Items:
Show Source
50
-
Array of:
object PricelistOracle
Title:
PricelistOracle
A list of offers and its coresponding prices which can be used for selling the offer in a region or a particular set of customers
Nested Schema : PricelistOracle
Type:
object
Title:
PricelistOracle
A list of offers and its coresponding prices which can be used for selling the offer in a region or a particular set of customers
Show Source
-
@baseType: string
Immediate base (class) type of the object
-
@schemaLocation: string
A link to the schema describing this object
-
@type: string
Class type of the object
-
balanceElement: object
BalanceElementRef
Title:
BalanceElementRef
Balance element ref in price -
businessUnitId: number
Indicates Business Unit to which the offer belongs.
-
businessUnitName: string
Indicates name of Business Unit to which the offer belongs.
-
currency: string
Currency (ISO4217 norm uses 3 letters to define the currency)
-
description: string
Description of the Pricelist
-
href: string
Reference of the Pricelist
-
id: string
Maximum Length:
30
Unique identifier of the Pricelist -
lastUpdate: string
(date-time)
Date and time of the last update
-
lifecycleStatus: string
Used to indicate the current lifecycle status
-
name: string
Name of the Pricelist
-
pricelistType: string
Indicates if the pricelist is a Residential, Business or other type of resource
-
project: object
ProjectRef
Title:
ProjectRef
Project Reference - relatedParty: array relatedParty
-
validFor: object
TimePeriod
Title:
TimePeriod
The period for which the productOffering is valid -
version: string
Promotion version
-
versionState: number
Version state of the promotion
Nested Schema : BalanceElementRef
Type:
object
Title:
BalanceElementRef
Balance element ref in price
Show Source
-
@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
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 : 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 : 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.
Response
Supported Media Types
- application/json
200 Response
Your request is successful and the resources have been created or updated.
Root Schema : schema
Type:
Show Source
array
-
Array of:
object PricelistOracle
Title:
PricelistOracle
A list of offers and its coresponding prices which can be used for selling the offer in a region or a particular set of customers
Nested Schema : PricelistOracle
Type:
object
Title:
PricelistOracle
A list of offers and its coresponding prices which can be used for selling the offer in a region or a particular set of customers
Show Source
-
@baseType: string
Immediate base (class) type of the object
-
@schemaLocation: string
A link to the schema describing this object
-
@type: string
Class type of the object
-
applicationName: string
name of the external application
-
balanceElement: object
BalanceElementRef
Title:
BalanceElementRef
Balance element ref in price -
businessUnitId: number
Indicates Business Unit to which the offer belongs.
-
businessUnitName: string
Indicates name of Business Unit to which the offer belongs.
-
created: string
(date-time)
Date and time of the creation
-
createdBy: string
name of the person who created item
-
currency: string
Currency (ISO4217 norm uses 3 letters to define the currency)
-
description: string
Description of the Pricelist
-
externalId: string
id of the external application
-
href: string
Reference of the Pricelist
-
id: string
Maximum Length:
30
Unique identifier of the Pricelist -
lastUpdate: string
(date-time)
Date and time of the last update
-
lastUpdatedBy: string
name of the person who updated item
-
lifecycleStatus: string
Used to indicate the current lifecycle status
-
name: string
Name of the Pricelist
-
pricelistType: string
Allowed Values:
[ "RESIDENTIAL", "BUSINESS" ]
Indicates if the pricelist is a Residential, Business or other type of resource -
productOffering: array
productOffering
-
project: object
ProjectRef
Title:
ProjectRef
Project Reference -
promotion: array
promotion
- relatedParty: array relatedParty
-
validFor: object
TimePeriod
Title:
TimePeriod
The period for which the productOffering is valid -
version: string
Promotion version
-
versionState: number
Version state of the price list
Nested Schema : BalanceElementRef
Type:
object
Title:
BalanceElementRef
Balance element ref in price
Show Source
-
@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
Nested Schema : productOffering
Type:
Show Source
array
-
Array of:
object ProductOfferingRef
Title:
ProductOfferingRef
ProductOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Nested Schema : ProjectRef
Type:
object
Title:
ProjectRef
Project Reference
Show Source
-
href: string
Unique reference of the project
-
id(required): string
Unique identifier of the project
-
name: string
Name of the project
-
version: string
Version of the project
Nested Schema : promotion
Type:
Show Source
array
-
Array of:
object PromotionRef
Title:
PromotionRef
Promotion reference.
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 : ProductOfferingRef
Type:
object
Title:
ProductOfferingRef
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
base class type (immediate parent) of the ProductOfferingRef
-
@referredType: string
the class type of the referred product offering
-
@schemaLocation: string
Hyperlink reference to schema describing this object
-
@type: string
The class type of this ProductOfferingRef
-
href: string
Reference of the product offering
-
id(required): string
Unique identifier of the product offering
-
name: string
Name of the product offering
-
versionState: number
To hold the version state for the reference
Nested Schema : PromotionRef
Type:
object
Title:
PromotionRef
Promotion reference.
Show Source
-
@baseType: string
base class type (immediate parent) of the Promotion
-
@referredType: string
the class type of the referred Promotion
-
@schemaLocation: string
Hyperlink reference to schema describing this object
-
@type: string
The class type of this Promotion
-
href: string
Reference of the Promotiong
-
id(required): string
Unique identifier of the Promotiong
-
name: string
Name of the Promotion
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.
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 : schema
Type:
Show Source
array
-
Array of:
object Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "Error":"#/components/schemas/Error", "BulkError":"#/components/schemas/BulkError" } }
401 Response
Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
404 Response
Your request includes a resource URI that doesn't exist.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
405 Response
HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
500 Response
The server encountered something unexpected that prevented it from completing the request.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
Examples
The following example shows how to create or update pricelists by submitting a put request on the REST resource using cURL.
cURL Command
curl -u username:password -X PUT https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/pricelists
Example of Request Body
The following shows an example of the request body in JSON format.
[ { "name": "PriceList_Y2021_001", "id": "PriceList_Y2021_001", "@type": "PricelistOracle", "@baseType": "PricelistOracle", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/pricelist/TestPrice90", "lifecycleStatus": "In design", "businessUnitId": 204, "validFor": { "startDateTime": "2020-05-02T16:42:23.0Z", "endDateTime": "2021-07-14T00:00:00.0Z" }, "project": { "id": "BulkDocProject", "name": "Bulk Doc Project" }, "relatedParty": [ { "id": "12343", "name": "Gustave Flaubert laptop", "href": "https://mycsp.com:8080/tmf-api/partyManagement/v4/partyRole/1234", "role": "Owner" } ], "description": "TestPrice890 description", "currency": "USD", "version": "1.0" }, { "name": "PriceList_2021_002", "id": "PriceList_2021_002", "@type": "PricelistOracle", "@baseType": "PricelistOracle", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/pricelist/TestPrice90", "lifecycleStatus": "In design", "validFor": { "startDateTime": "2020-05-02T16:42:23.0Z", "endDateTime": "2021-07-14T00:00:00.0Z" }, "project": { "id": "BulkDocProject", "name": "Bulk Doc Project" }, "relatedParty": [ { "id": "12343", "name": "Gustave Flaubert laptop", "href": "https://mycsp.com:8080/tmf-api/partyManagement/v4/partyRole/1234", "role": "Owner" } ], "description": "TestPrice890 description", "currency": "USD", "version": "1.0" }, { "@type": "PricelistOracle", "lifecycleStatus": "In design", "validFor": { "endDateTime": "2021-11-27T18:30:00.000Z", "startDateTime": "2020-11-11T18:30:00.000Z" }, "balanceElement": { "id": "USACurrency", "name": "USACurrency", "version": "1.0", "@referredType": "BalanceElementOracle", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/balanceElement/USACurrency" }, "description": "Pricelist for US", "version": "1.0", "name": "PriceList_2021_003", "id": "PriceList_2021_003" } ]
Example of Response Body
The following shows an example of the response body in JSON format.
[ { "@type": "PricelistOracle", "@baseType": "PricelistOracle", "relatedParty": [ { "id": "12343", "name": "Gustave Flaubert laptop", "href": "https://mycsp.com:8080/tmf-api/partyManagement/v4/partyRole/1234", "role": "Owner" } ], "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/pricelists/PriceList_Y2021_001", "lifecycleStatus": "In design", "businessUnitId": 204, "businessUnitName": "Vision Operations", "validFor": { "startDateTime": "2020-05-02T16:42:23.0Z", "endDateTime": "2021-07-14T00:00:00.0Z" }, "balanceElement": { "id": "USACurrency", "name": "USA Currency", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/balanceElement/USACurrency", "@referredType": "BalanceElementOracle" }, "project": { "id": "BulkDocProject", "name": "Bulk Doc Project", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/project/BulkDocProject" }, "description": "TestPrice890 description", "currency": "USD", "version": "1.0", "name": "PriceList_Y2021_001", "id": "PriceList_Y2021_001" }, { "@type": "PricelistOracle", "@baseType": "PricelistOracle", "relatedParty": [ { "id": "12343", "name": "Gustave Flaubert laptop", "href": "https://mycsp.com:8080/tmf-api/partyManagement/v4/partyRole/1234", "role": "Owner" } ], "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/pricelists/PriceList_2021_002", "lifecycleStatus": "In design", "validFor": { "startDateTime": "2020-05-02T16:42:23.0Z", "endDateTime": "2021-07-14T00:00:00.0Z" }, "balanceElement": { "id": "USACurrency", "name": "USA Currency", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/balanceElement/USACurrency", "@referredType": "BalanceElementOracle" }, "project": { "id": "BulkDocProject", "name": "Bulk Doc Project", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/project/BulkDocProject" }, "description": "TestPrice890 description", "currency": "USD", "version": "1.0", "name": "PriceList_2021_002", "id": "PriceList_2021_002" }, { "@type": "PricelistOracle", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/pricelists/PriceList_2021_003", "lifecycleStatus": "In design", "validFor": { "startDateTime": "2020-11-11T18:30:00.000Z", "endDateTime": "2021-11-27T18:30:00.000Z" }, "balanceElement": { "id": "USACurrency", "name": "USACurrency", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/balanceElement/USACurrency", "version": "1.0", "@referredType": "BalanceElementOracle" }, "description": "Pricelist for US", "currency": "USD", "version": "1.0", "name": "PriceList_2021_003", "id": "PriceList_2021_003" } ]