Agreement Attribute REST APIs

Overview

These endpoints enable administration of CPQ Pricing Portal agreement attributes using REST API services.

Administration

ClosedDelete Agreement Attribute

Delete Agreement AttributeDELETE method

Description

Use this endpoint to delete the specified pricing agreement attribute.

URI Endpoint

/rest/v17/pricingSetup/agreementAttributes/{attributeVariableName}

Endpoint Parameters

attributeVariableName

The variable name of the pricing agreement attribute.

HTTP Method

DELETE

Request Body Parameters

None

Success Response

204


ClosedGet Agreement Attribute

Get Agreement AttributeGET Method

Description

Use this endpoint to retrieve the specified pricing agreement attribute.

URI Endpoint

/rest/v17/pricingSetup/agreementAttributes/{attributeVariableName}

Endpoint Parameters

attributeVariableName

The variable name of the pricing agreement attribute.

(Optional) This endpoint supports the expand and fields query specifications. For more information, see Manage Collections.

HTTP Method

GET

Request Body Parameters None
Response Body Parameters

active

Indicates whether the pricing agreement attribute is active.

arrayType

Indicates whether pricing agreement attribute is an array type.

attributeLevel

Identifies the pricing agreement attribute level:

Allowed values: "Header", "Line", "Charge"

attributeLevelCode

The pricing agreement attribute level code.

createdBy

The details of the user who created the record.

dataType

Data Type of the pricing agreement attribute.
Allowed values: "Boolean", "Currency", "String", "Decimal", "Date", "Integer", "Text Area"

dateAdded

The date the pricing agreement attribute was created.

dateModified

The date the pricing agreement attribute was last modified.

defaultValue

The default value of the pricing agreement attribute.

defaultValueLabel

The default value display label of the pricing agreement attribute.

description

Description of the pricing agreement attribute.

lastModifiedBy

The details of the user who modified the record.

lookupType

The lookup type variable name for the pricing agreement attribute.

lookupTypeLabel

The lookup type display label for the pricing agreement attribute.

mappings

List of mappings for the pricing agreement attribute.

name

Name of the pricing agreement attribute.

required

Indicates whether Agreement Attribute is required.

templateVariableKey

The template variable key.

Allowed values:"Custom", "AgreementName", "AgreementDescription", "AgreementStartDate", "AgreementEndDate", "AccountID", "Account", "PartNumber", "ServiceDuration", "ServiceDurationPeriod", "ItemContractStartDate", "ItemContractEndDate", "RatePlanNumber", "ProductListPrice", "ProductPriceType", "ProductPricePeriod", "ProductNetPrice", "SourceTransactionId", "ChargeType", "ChargePriceType", "ChargePricePeriod", "ChargeUsageUOM", "ChargeDynamicPricingType", "ChargeDefinitionCode", "ChargeNetPrice", "RateCardStructure", "AgreementStatus"

valid

Indicates whether the pricing agreement attribute is valid.

variableName

Variable Name of the pricing agreement attribute.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_agreementStatus


ClosedSample Response Body

{ "createdBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "lastModifiedBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "name": "Agreement Status", "variableName": "_agreementStatus", "description": "Current status of the Agreement.", "dateModified": "2024-08-01T17:22:57Z", "dateAdded": "2024-08-01T17:22:57Z", "dataType": "String", "attributeLevel": "Header", "templateVariableKey": "AgreementStatus", "arrayType": false, "attributeLevelCode": 0, "active": true, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_agreementStatus" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_agreementStatus/mappings" } ] }


ClosedGet Agreement Attributes

Get Agreement Attributes GET Method

Description

Use this endpoint to retrieve all pricing agreement attributes.

URI Endpoint

/rest/v17/pricingSetup/agreementAttributes

Endpoint Parameters

None

(Optional) This endpoint supports the following query specifications: expand, fields, finder, limit, offset, onlyData, orderby, q, and totalResults.

For more information, see Manage Collections.

HTTP Method

GET

Request Body Parameters

None

Response Body Parameters

A collection of pricing agreement attributes.

active

Indicates whether the pricing agreement attribute is active.

arrayType

Indicates whether pricing agreement attribute is an array type.

attributeLevel

Identifies the pricing agreement attribute level:

Allowed values: "Header", "Line", "Charge"

attributeLevelCode

The pricing agreement attribute level code.

createdBy

The details of the user who created the record.

dataType

Data Type of the pricing agreement attribute.
Allowed values: "Boolean", "Currency", "String", "Decimal", "Date", "Integer", "Text Area"

dateAdded

The date the pricing agreement attribute was created.

dateModified

The date the pricing agreement attribute was last modified.

defaultValue

The default value of the pricing agreement attribute.

defaultValueLabel

The default value display label of the pricing agreement attribute.

description

Description of the pricing agreement attribute.

lastModifiedBy

The details of the user who modified the record.

lookupType

The lookup type variable name for the pricing agreement attribute.

lookupTypeLabel

The lookup type display label for the pricing agreement attribute.

mappings

List of mappings for the pricing agreement attribute.

name

Name of the pricing agreement attribute.

required

Indicates whether Agreement Attribute is required.

templateVariableKey

The template variable key.

Allowed values:"Custom", "AgreementName", "AgreementDescription", "AgreementStartDate", "AgreementEndDate", "AccountID", "Account", "PartNumber", "ServiceDuration", "ServiceDurationPeriod", "ItemContractStartDate", "ItemContractEndDate", "RatePlanNumber", "ProductListPrice", "ProductPriceType", "ProductPricePeriod", "ProductNetPrice", "SourceTransactionId", "ChargeType", "ChargePriceType", "ChargePricePeriod", "ChargeUsageUOM", "ChargeDynamicPricingType", "ChargeDefinitionCode", "ChargeNetPrice", "RateCardStructure", "AgreementStatus"

valid

Indicates whether the pricing agreement attribute is valid.

variableName

Variable Name of the pricing agreement attribute.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes?limit=3


ClosedSample Response Body

{ "items": [{ "createdBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "lastModifiedBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "name": "Agreement Name", "variableName": "_agreementName", "description": "Default to the Contract Name of the current transaction.", "dateModified": "2024-08-01T17:22:56Z", "dateAdded": "2024-08-01T17:22:56Z", "dataType": "String", "attributeLevel": "Header", "templateVariableKey": "AgreementName", "arrayType": false, "attributeLevelCode": 0, "active": true, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_agreementName" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_agreementName/mappings" } ] }, { "createdBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "lastModifiedBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "name": "Agreement Description", "variableName": "_agreementDescription", "description": "Default to the Transaction Description of the current transaction.", "dateModified": "2024-08-01T17:22:57Z", "dateAdded": "2024-08-01T17:22:57Z", "dataType": "String", "attributeLevel": "Header", "templateVariableKey": "AgreementDescription", "arrayType": false, "attributeLevelCode": 0, "active": true, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_agreementDescription" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_agreementDescription/mappings" } ] }, { "createdBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "lastModifiedBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "name": "Agreement Start Date", "variableName": "_agreementStartDate", "description": "Default to the Contract Start Date of the current transaction.", "dateModified": "2024-08-01T17:22:57Z", "dateAdded": "2024-08-01T17:22:57Z", "dataType": "Date", "attributeLevel": "Header", "templateVariableKey": "AgreementStartDate", "arrayType": false, "attributeLevelCode": 0, "active": true, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_agreementStartDate" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_agreementStartDate/mappings" } ] } ], "offset": 0, "limit": 3, "count": 3, "hasMore": true, "links": [{ "rel": "canonical", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes" }, { "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes?offset=0&limit=3" }, { "rel": "next", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes?offset=3&limit=3" } ] }


ClosedGet Agreement Attribute Mappings

Get Agreement Attribute Mappings GET Method

Description

Use this endpoint to retrieve all pricing agreement attribute mappings.

URI Endpoint

/rest/v17/pricingSetup/agreementAttributes/{attributeVariableName}/mappings

Endpoint Parameters

attributeVariableName

The variable name of the pricing agreement attribute.

(Optional) This endpoint supports the following query specifications: fields, finder, limit, offset, onlyData, orderby, and totalResults.

For more information, see Manage Collections.

HTTP Method

GET

Request Body Parameters

None

Response Body Parameters

A collection of pricing agreement attribute mappings.

attributeLabel

The label of the pricing data source attribute.

createdBy

The details of the user who created the record.

dataSourceAttribute

The mapped data source attribute.

dataSourceLabel

The mapped label of the data source.

dataSourceProviderVariableName

The variable name of the data source provider.

dateAdded

The date the pricing data source entity was created.

dateModified

The date the pricing data source entity was last modified.

id

The unique identifier of the pricing data source attribute.

lastModifiedBy

The details of the user who modified the record.

orderNumber

The position of the pricing data source attribute in the ordered list.

readOnly

Indicates if the attribute has any restrictions for edits.

sourceEntity

The name of the pricing data source entity.

validMapping

Indicates whether the pricing data source attribute has a valid mapping.

variableName

Variable name of the pricing data source attribute.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_sourceTransactionId/mappings


ClosedSample Response Body

{ "items": [{ "createdBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "lastModifiedBy": { "firstName": "John", "lastName": "Smith", "emailId": "john.smith@companyname.com" }, "orderNumber": 1, "id": 3023216482, "dataSourceAttribute": "/process/_all_commerce_process/_main_doc/_header/transactionID_t", "dataSourceLabel": "Quoting : All Processes", "dataSourceProviderVariableName": "_cm__all_commerce_process_main", "variableName": "transactionID_t", "attributeLabel": "Transaction Number", "validMapping": true, "dateModified": "2024-08-01T17:22:57Z", "dateAdded": "2024-08-01T17:22:57Z", "readOnly": true, "sourceEntity": "Header" } ], "offset": 0, "limit": 1000, "count": 1, "hasMore": false, "links": [{ "rel": "canonical", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_sourceTransactionId/mappings" }, { "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/_sourceTransactionId/mappings?offset=0&limit=1000" } ] }


ClosedMigrate Agreement Charge Attributes

Migrate Agreement Charge Attributes POST method

Description

Use this endpoint to create pricing agreement charge attributes from an existing price charge attribute..

URI Endpoint

/rest/v17/pricingSetup/agreementAttributes/actions/createFromChargeAttributes

Endpoint Parameters

None

HTTP Method

POST

Request Body Parameters

An array of charge attribute items.

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/actions/createFromChargeAttributes


ClosedSample Response Body

{ "items": ["_requestedAgreementNumber"] }


ClosedUpdate Agreement Attribute Mappings

Update Agreement Attribute Mappings PATCH method

Description

Use this endpoint to update attribute mappings for the specified price agreement attribute.

URI Endpoint

/rest/v17/pricingSetup/agreementAttributes/{attributeVariableName}/mappings

Endpoint Parameters

attributeVariableName

The variable name of the pricing agreement attribute.

HTTP Method

PATCH

Request Body Parameters

The array of pricing patch operations.

op

The operation to be performed. Allowed values: "add", "remove", "replace".

path

The JSON pointer string for "path" property.

value

The target value.

Refer to Get Agreement Attribute Mappings for parameters.

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/agreementAttributes/someAgreementAttribute/mappings


ClosedSample Request Body

[{ "op": "replace", "path": "/3024593198", "value": { "orderNumber": 1 } }, { "op": "replace", "path": "/3024593232", "value": { "orderNumber": 2 } }, { "op": "add", "value": { "dataSourceProviderVariableName": "CONFIG_ATTRS_test1", "orderNumber": 3, "variableName": "arrayTextSSPL1" }, "path": "/" } ]


 

Related Topics

Related Topics Link IconSee Also