Charge Definition REST APIs

Overview

These endpoints enable administration of Pricing Portal charge definitions using REST API services.

Administration

ClosedAdd Charge Definition

Add Charge Definition POST method

Description

Use this endpoint to add a charge definition.

URI Endpoint

/rest/v17/pricingSetup/chargeDefinitions

Endpoint Parameters

None

HTTP Method

POST

Request Body Parameters

active

Indicates if the charge definition is active.

chargeType

Display label of Charge Type

chargeTypeCode

Charge Type lookup code.

code

Variable Name of the charge definition.

integrationId

Integration ID

name

Display Name of the charge definition.

priceType

Display label of Price Type

priceTypeCode

Price Type lookup code.

type

Indicates whether a charge definition is Standard or Custom

Response Body Parameters JSON data for the newly added charge definition.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions


ClosedSample Request Body

{ "code": "newChargeDefinition_c", "name": "New Charge Definition", "integrationId": "QP_NEW_CHARGE_DEFINITION", "chargeTypeCode": "ORA_SALE", "priceTypeCode": "Usage" }


ClosedSample Response Body

{ "createdBy": { "firstName": "John", "lastName": "Smith", emailId": "john.smith@companyname.com" }, "lastModifiedBy": { "firstName": "John", "lastName": "Smith", emailId": "john.smith@companyname.com" }, "code": "newChargeDefinition_c", "name": "New Charge Definition", "integrationId": "QP_NEW_CHARGE_DEFINITION", "chargeType": "Sales Price", "chargeTypeCode": "ORA_SALE", "priceType": "Usage", "priceTypeCode": "Usage", "dateAdded": "2023-09-21T23:12:23Z", "dateModified": "2023-09-21T23:12:23Z", "type": "Custom Definition", "active": false }


ClosedDelete Charge Definition

Delete Charge DefinitionDELETE method

Description

Use this endpoint to delete the specified charge definition.

URI Endpoint

/rest/v17/pricingSetup/chargeDefinitions/{code}

Endpoint Parameters

code

Variable Name of the charge definition.

HTTP Method

DELETE

Request Body Parameters

None

Success Response

204


ClosedGet Charge Definition

Get Charge DefinitionGET Method

Description

Use this endpoint to retrieve the specified charge definition.

URI Endpoint

/rest/v17/pricingSetup/chargeDefinitions/{code}

Endpoint Parameters

code

Variable Name of the charge definition.

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

HTTP Method

GET

Request Body Parameters None
Response Body Parameters

active

Indicates if the charge definition is active.

chargeType

Display label of Charge Type

chargeTypeCode

Charge Type lookup code.

code

Variable Name of the charge definition.

createdBy

The details of the user who created the record.

dateAdded

Creation Date of the charge definition.

dateModified

Last Modified date of the charge definition.

description

Description of the charge definition.

integrationId

Integration ID

lastModifiedBy

The details of the user who modified the record.

name

Display Name of the charge definition.

priceType

Display label of Price Type

priceTypeCode

Price Type lookup code.

type

Indicates whether a charge definition is Standard or Custom

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions/usage_callCharge_c


ClosedSample Response Body

{ "code": "usage_callCharge_c", "name": "Usage Call Charge", "description": "Generated Charge Definition", "chargeType": "Call Charge", "chargeTypeCode": "callCharge_c", "priceType": "Usage", "priceTypeCode": "Usage", "dateAdded": "2023-08-29T19:35:18Z", "dateModified": "2023-08-29T19:35:18Z", "type": "Custom Definition", "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions/usage_callCharge_c" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions" } ], "active": true }


ClosedGet Charge Definitions

Get Charge Definitions GET Method

Description

Use this endpoint to retrieve all charge definitions.

URI Endpoint

/rest/v17pricingSetup/chargeDefinitions

Endpoint Parameters

None

(Optional) This endpoint supports the following query specifications: fields, 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 charge definitions.

active

Indicates if the charge definition is active.

chargeType

Display label of Charge Type

chargeTypeCode

Charge Type lookup code.

code

Variable Name of the charge definition.

createdBy

The details of the user who created the record.

dateAdded

Creation Date of the charge definition.

dateModified

Last Modified date of the charge definition.

description

Description of the charge definition.

integrationId

Integration ID

lastModifiedBy

The details of the user who modified the record.

name

Display Name of the charge definition.

priceType

Display label of Price Type

priceTypeCode

Price Type lookup code.

type

Indicates whether a charge definition is Standard or Custom

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions?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" }, "code": "usage_callCharge_c", "name": "Usage Call Charge", "description": "Generated Charge Definition", "chargeType": "Call Charge", "chargeTypeCode": "callCharge_c", "priceType": "Usage", "priceTypeCode": "Usage", "dateAdded": "2023-08-29T19:35:18Z", "dateModified": "2023-08-29T19:35:18Z", "type": "Custom Definition", "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions/usage_callCharge_c" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions" } ], "active": true }, { "createdBy": { "firstName": "John", "lastName": "Smith", emailId": "john.smith@companyname.com" }, "lastModifiedBy": { "firstName": "John", "lastName": "Smith", emailId": "john.smith@companyname.com" }, "code": "recurring_oRASALE_c", "name": "Recurring Sales Price", "description": "Generated Charge Definition", "chargeType": "Sales Price", "chargeTypeCode": "ORA_SALE", "priceType": "Recurring", "priceTypeCode": "Recurring", "dateAdded": "2023-08-29T19:35:18Z", "dateModified": "2023-08-29T19:35:18Z", "type": "Custom Definition", "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions/recurring_oRASALE_c" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions" } ], "active": true }, { "createdBy": { "firstName": "John", "lastName": "Smith", emailId": "john.smith@companyname.com" }, "lastModifiedBy": { "firstName": "John", "lastName": "Smith", emailId": "john.smith@companyname.com" }, "code": "usage_dataCharge_c", "name": "Usage Data Charge", "description": "Generated Charge Definition", "chargeType": "Data Charge", "chargeTypeCode": "dataCharge_c", "priceType": "Usage", "priceTypeCode": "Usage", "dateAdded": "2023-08-29T19:35:18Z", "dateModified": "2023-08-29T19:35:18Z", "type": "Custom Definition", "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions/usage_dataCharge_c" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions" } ], "active": true } ], "offset": 0, "limit": 3, "count": 3, "hasMore": true, "links": [{ "rel": "canonical", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions" }, { "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions?offset=0&limit=3" }, { "rel": "next", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions?offset=3&limit=3" } ] }


ClosedUpdate Charge Definition

Update Charge Definition PATCH method

Description

Use this endpoint to update the specified charge definition.

URI Endpoint

/rest/v17/pricingSetup/chargeDefinitions/{code}

Endpoint Parameters

code

Variable Name of the charge definition.

HTTP Method

PATCH

Request Body Parameters

active

Indicates if the charge definition is active.

code

Variable Name of the charge definition.

integrationId

Integration ID

name

Display Name of the charge definition.

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/chargeDefinitions/newChargeDefinition_c


ClosedSample Request Body

{ "name": "New Charge Definition", "description": "Charge Definition for New Charge", "active": false, "integrationId": "QP_NEW_CHARGE_DEFINITION" }


 

Related Topics

Related Topics Link IconSee Also