Get Transaction Line Charges
get
/rest/v19/commerce{Stage}{ProcessVarName}{MainDocVarName}/{id}/{subDocVarName}/{docNumber}/_chargeSet
Use this endpoint to retrieve all charges for the specified transaction line.
Request
Supported Media Types
- application/json
Path Parameters
-
MainDocVarName(required): string
The variable name of the main document, note the first letter must be capitalized.
-
ProcessVarName(required): string
The variable name of the commerce process, note the first letter must be capitalized.
-
Stage(required): string
The stage variable identifies where a transaction is within the Commerce process flow. (Documents, Quotes, Agreements, or Orders)
-
docNumber(required): integer
Unique document number to be used as document identifier in a process.
-
id(required): integer
Current unique user-side ID. This is the internal identifier for a transaction within a CPQ site.
-
subDocVarName(required): string
The variable name of the sub-document.
Query Parameters
-
excludeFieldTypes: string
Exclude specified field types.
-
fields: string
Restrict which fields shall be returned. The value is a comma delimited string and each token is a field name.
-
limit: integer
The requested page size, which limits the number of elements the collection should max return.
-
offset: integer
The offset of the page. By default, offset is 0, which means first page will be returned.
-
orderby: string
Specifies a comma-separated list of pairs to order the response by.
-
q: string
Allows to specify one or more filtering criteria. By default, no filtering is applied.
-
totalResults: boolean
Specifies that the total count of records should be included in the response when doing pagination.
Response
Supported Media Types
- application/json
Default Response
Root Schema : TransactionLine_chargeSet-collection
Type:
Show Source
object-
_state:
object state
Title:
stateCaptures the current state of the resource collection. Of available properties, only those that are applicable and whose values are known in the current context are included. -
count:
integer
The number of resource instances returned in the current range.
-
hasMore:
boolean
Returns true if more resources are available on the server than the subset returned in current page.
-
items:
array items
-
limit:
integer
The actual paging size used by the server.
-
offset:
integer
The offset used in the current page.
-
totalResults:
integer
Capture the total count of the resource instances, which not only includes the instances in the current range, but all instances on the server that satisfy the request.
Nested Schema : state
Type:
objectTitle:
stateCaptures the current state of the resource collection. Of available properties, only those that are applicable and whose values are known in the current context are included.
Show Source
-
actions:
object Actions
Title:
ActionsCaptures the current state of each action whose state was requested. The object contains one property per action, where the property name is the variable name for the action. -
defaultRowState:
object state
Title:
stateCaptures the current state of the resource row. Of available properties, only those that are applicable and whose values are known in the current context are included. -
focus:
object Focused Users
Title:
Focused UsersDetails about users who are focused on this item. The object contains one property per focused user, where the property name is the user's unique identifier. -
hasError:
boolean
Title:
Has ErrorBoolean value that specifies whether any error that occurred has been assigned to the collection itself. -
hasWarning:
boolean
Title:
Has WarningBoolean value that specifies whether any warning that was issued has been assigned to the collection itself. -
insertable:
boolean
Title:
InsertableBoolean value that specifies whether new rows can be inserted into the collection. -
messages:
array Messages
Title:
MessagesArray of messages that have been generated for a specific object. -
queryable:
boolean
Title:
QueryableBoolean value that specifies whether the rows in the collection can be queried. -
sortable:
boolean
Title:
SortableBoolean value that specifies whether the rows in the collection can be sorted.
Nested Schema : Actions
Type:
objectTitle:
ActionsCaptures the current state of each action whose state was requested. The object contains one property per action, where the property name is the variable name for the action.
Nested Schema : state
Type:
objectTitle:
stateCaptures the current state of the resource row. Of available properties, only those that are applicable and whose values are known in the current context are included.
Show Source
-
actions:
object Actions
Title:
ActionsCaptures the current state of each action whose state was requested. The object contains one property per action, where the property name is the variable name for the action. -
attributes:
object Attributes
Title:
AttributesCaptures the current state of each attribute whose state was requested. The object contains one property per group, where the property name is the resource field name for the attribute. -
deletable:
boolean
Title:
DeletableBoolean value that specifies whether the row can be deleted. -
focus:
object Focused Users
Title:
Focused UsersDetails about users who are focused on this item. The object contains one property per focused user, where the property name is the user's unique identifier. -
hasError:
boolean
Title:
Has ErrorBoolean value that specifies whether any error that occurred has been assigned to the row itself. -
hasWarning:
boolean
Title:
Has WarningBoolean value that specifies whether any warning that was issued has been assigned to the row itself. - hidden: boolean
-
messages:
array Messages
Title:
MessagesArray of messages that have been generated for a specific object. -
updatable:
boolean
Title:
UpdatableBoolean value that specifies whether the row can be updated.
Nested Schema : Focused Users
Type:
objectTitle:
Focused UsersDetails about users who are focused on this item. The object contains one property per focused user, where the property name is the user's unique identifier.
Nested Schema : Messages
Type:
arrayTitle:
MessagesArray of messages that have been generated for a specific object.
Show Source
-
Array of:
string
An error, warning, or informational message.
Nested Schema : Actions
Type:
objectTitle:
ActionsCaptures the current state of each action whose state was requested. The object contains one property per action, where the property name is the variable name for the action.
Nested Schema : Attributes
Type:
objectTitle:
AttributesCaptures the current state of each attribute whose state was requested. The object contains one property per group, where the property name is the resource field name for the attribute.
Nested Schema : Focused Users
Type:
objectTitle:
Focused UsersDetails about users who are focused on this item. The object contains one property per focused user, where the property name is the user's unique identifier.
Nested Schema : Messages
Type:
arrayTitle:
MessagesArray of messages that have been generated for a specific object.
Show Source
-
Array of:
string
An error, warning, or informational message.
Nested Schema : Charge Set
Type:
objectTitle:
Show Source
Charge Set-
_bs_id:
integer
Title:
_bs_id_bs_id -
_chargeSet_calculationInfo:
string
Title:
Calculation InformationA JSON array of the Price Models used in calculating this charge's price. -
_chargeSet_chargeDefinition:
string
Title:
Charge DefinitionThe display label of the charge definition. -
_chargeSet_chargeDefinitionCode:
string
Title:
Charge Definition CodeThe code of the charge definition. -
_chargeSet_chargeDefIntegrationId:
string
Title:
Charge Definition Integration IDThe charge definition code in the integrated order management system. -
_chargeSet_chargeType:
object Charge Type
Title:
Charge Type -
_chargeSet_discountAmount:
object Discount Amount
Title:
Discount AmountThe extended custom discount amount per period for this charge. Typically this represents the unit discount x quantity. -
_chargeSet_discountType:
object Discount Type
Title:
Discount Type -
_chargeSet_discountValue:
number
Title:
Discount ValueThe numeric value for a custom discount associated with the discount type for this charge. For example, if the Discount Type is Override, this value with be the override unit price for this charge. -
_chargeSet_dynamicPricingType:
string
Title:
Dynamic Pricing TypeThe type of dynamic pricing used to define this charge: static, tiered, volume, rateCard, advanced. -
_chargeSet_netAmount:
object Net Amount
Title:
Net AmountThe extended net price or amount per period that will be paid for this charge. Typically this represents the unit price x quantity. -
_chargeSet_netPrice:
object Net Price
Title:
Net PriceThe unit price net of all discounts for this charge. The Net Price is the unit price that the customer will be invoiced. -
_chargeSet_pricePeriod:
object Price Period
Title:
Price Period -
_chargeSet_priceType:
object Price Type
Title:
Price Type -
_chargeSet_rateCardInHTML:
string
Title:
Rate Card In HTMLThe HTML-formatted rate card data -
_chargeSet_rateCardName:
string
Title:
Rate CardDisplay label for the Rate Card applied in calculating this charge's price. -
_chargeSet_rateCardStructure:
string
Title:
Rate Card StructureThe rate card used to calculate this charge's price. -
_chargeSet_rateCardVariableName:
string
Title:
Rate Card Variable NameVariable Name for the Rate Card applied in calculating this charge's price. -
_chargeSet_unitPrice:
object Unit Price
Title:
Unit PriceThe unit price to be paid by the customer for this charge. -
_chargeSet_usageUOM:
object Usage UOM
Title:
Usage UOM -
_document_number:
integer
Title:
_document_number_document_number -
_row_number:
integer
Title:
_row_number_row_number -
_sequence_number:
integer
Title:
_sequence_number_sequence_number -
_state:
object state
Title:
stateCaptures the current state of the resource row. Of available properties, only those that are applicable and whose values are known in the current context are included. -
_transaction_currency_pref:
object _transaction_currency_pref
Title:
_transaction_currency_pref
Nested Schema : Charge Type
Type:
objectTitle:
Show Source
Charge Type-
displayValue:
string
Title:
displayValue -
value:
string
Title:
value
Nested Schema : Discount Amount
Type:
objectTitle:
Discount AmountThe extended custom discount amount per period for this charge. Typically this represents the unit discount x quantity.
Show Source
-
currency:
string
Title:
currency -
value:
number
Title:
value
Nested Schema : Discount Type
Type:
objectTitle:
Show Source
Discount Type-
displayValue:
string
Title:
displayValue -
value:
string
Title:
value
Nested Schema : Net Amount
Type:
objectTitle:
Net AmountThe extended net price or amount per period that will be paid for this charge. Typically this represents the unit price x quantity.
Show Source
-
currency:
string
Title:
currency -
value:
number
Title:
value
Nested Schema : Net Price
Type:
objectTitle:
Net PriceThe unit price net of all discounts for this charge. The Net Price is the unit price that the customer will be invoiced.
Show Source
-
currency:
string
Title:
currency -
value:
number
Title:
value
Nested Schema : Price Period
Type:
objectTitle:
Show Source
Price Period-
displayValue:
string
Title:
displayValue -
value:
string
Title:
value
Nested Schema : Price Type
Type:
objectTitle:
Show Source
Price Type-
displayValue:
string
Title:
displayValue -
value:
string
Title:
value
Nested Schema : Unit Price
Type:
objectTitle:
Unit PriceThe unit price to be paid by the customer for this charge.
Show Source
-
currency:
string
Title:
currency -
value:
number
Title:
value
Nested Schema : Usage UOM
Type:
objectTitle:
Show Source
Usage UOM-
displayValue:
string
Title:
displayValue -
value:
string
Title:
value
Nested Schema : _transaction_currency_pref
Type:
objectTitle:
Show Source
_transaction_currency_pref-
currencyCode:
string
Title:
Currency CodeUnique currency code for the currency. -
id:
integer
Title:
IdPrimary Key of the currency resource.
Examples
The following example shows how to retrieve all charges for the specified transaction line by submitting a GET request to the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X GET -H "Authorization: Bearer <token>" -H "Accept: application/json" https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/38926297/transactionLine/2/_chargeSet
Response Body Sample
{
"hasMore": false,
"links": [{
"rel": "self",
"href": "https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/38926297/transactionLine/2/_chargeSet"
}
],
"items": [{
"_chargeSet_chargeType": {
"displayValue": "Activation Fee",
"value": "activationFee_c"
},
"_sequence_number": 1,
"_chargeSet_calculationInfo": "[{\"_priceProfileVar\":\"_defaultPriceModel\",\"_priceProfileName\":\"Base Price Model\",\"_pricingEngineRuleVar\":\"_defaultPricingRule\",\"_pricingEngineRuleName\":\"Base Pricing Rule\",\"_runningUnitPrice\":250.0}]",
"_chargeSet_netAmount": {
"value": 250.0,
"currency": "USD"
},
"_chargeSet_rateCardInHTML": null,
"_chargeSet_chargeDefinitionCode": "activationFee_c",
"_chargeSet_pricePeriod": {
"displayValue": "Per Month",
"value": "Per Month"
},
"_row_number": 1,
"_chargeSet_discountValue": null,
"_chargeSet_rateCardName": null,
"_chargeSet_usageUOM": null,
"_chargeSet_rateCardStructure": null,
"_chargeSet_netPrice": {
"value": 250.0,
"currency": "USD"
},
"_chargeSet_dynamicPricingType": "static",
"_chargeSet_discountType": null,
"_chargeSet_rateCardVariableName": null,
"_transaction_currency_pref": {
"id": 5190368,
"currencyCode": "USD",
"links": [{
"rel": "domain",
"href": "https://sitename.oracle.com/currencies"
}, {
"rel": "canonical",
"href": "https://sitename.oracle.com/currencies/USD"
}
]
},
"_chargeSet_chargeDefinition": "Activation Fee",
"_chargeSet_chargeDefIntegrationId": "KI_ACTIVATION_CHARGE",
"_chargeSet_discountAmount": {
"value": 0.0,
"currency": "USD"
},
"_chargeSet_priceType": {
"displayValue": "One Time",
"value": "One Time"
},
"_chargeSet_unitPrice": {
"value": 250.0,
"currency": "USD"
},
"links": [{
"rel": "self",
"href": "https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/38926297/transactionLine/2/_chargeSet/1"
}, {
"rel": "parent",
"href": "https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/38926297/transactionLine/2"
}
]
}, {
"_chargeSet_chargeType": {
"displayValue": "Data Charge",
"value": "dataCharge_c"
},
"_sequence_number": 2,
"_chargeSet_calculationInfo": "[{\"_priceProfileVar\":\"_defaultPriceModel\",\"_priceProfileName\":\"Base Price Model\",\"_pricingEngineRuleVar\":\"_defaultPricingRule\",\"_pricingEngineRuleName\":\"Base Pricing Rule\"}]",
"_chargeSet_netAmount": {
"value": 0.0,
"currency": "USD"
},
"_chargeSet_rateCardInHTML": "<figure class=\"table\"><table style=\"border-collapse: collapse;\"><tbody><tr style=\"border:solid 1px;\"><td style=\"border:solid 1px;\"><b>Usage From</b></td><td style=\"border:solid 1px;\"><b>Usage To</b></td><td style=\"border:solid 1px;\"><b>Rate</b></td></tr><tr style=\"border:solid 1px;\"><td style=\"border:solid 1px;\">0</td><td style=\"border:solid 1px;\">100</td><td style=\"border:solid 1px;\">USD 0.9</td></tr><tr style=\"border:solid 1px;\"><td style=\"border:solid 1px;\">100</td><td style=\"border:solid 1px;\">1000</td><td style=\"border:solid 1px;\">USD 0.8</td></tr><tr style=\"border:solid 1px;\"><td style=\"border:solid 1px;\">1000</td><td style=\"border:solid 1px;\">null</td><td style=\"border:solid 1px;\">USD 0.5</td></tr></tbody></table></figure>",
"_chargeSet_chargeDefinitionCode": "dataUsage_c",
"_chargeSet_pricePeriod": {
"displayValue": "Per Month",
"value": "Per Month"
},
"_row_number": 2,
"_chargeSet_discountValue": null,
"_chargeSet_rateCardName": "Supremo Remote Access Volume Rates",
"_chargeSet_usageUOM": {
"displayValue": "Gb",
"value": "gb_c"
},
"_chargeSet_rateCardStructure": "{\"type\":\"rateCard\",\"name\":\"Supremo Remote Access Volume Rates\",\"variableName\":\"supremoRemoteAccessVolumeRates\",\"schema\":{\"columns\":[{\"name\":\"Usage From\",\"variableName\":\"from\",\"dataType\":\"Integer\",\"translations\":[]},{\"name\":\"Usage To\",\"variableName\":\"to\",\"dataType\":\"Integer\",\"translations\":[]},{\"name\":\"Rate\",\"variableName\":\"rate\",\"dataType\":\"Currency\",\"translations\":[]}],\"lookupData\":[]},\"data\":[{\"rate\":{\"currency\":\"USD\",\"value\":0.9},\"from\":0,\"to\":100},{\"rate\":{\"currency\":\"USD\",\"value\":0.8},\"from\":100,\"to\":1000},{\"rate\":{\"currency\":\"USD\",\"value\":0.5},\"from\":1000}]}",
"_chargeSet_netPrice": {
"value": 0.0,
"currency": "USD"
},
"_chargeSet_dynamicPricingType": "rateCard",
"_chargeSet_discountType": null,
"_chargeSet_rateCardVariableName": "supremoRemoteAccessVolumeRates",
"_transaction_currency_pref": {
"id": 5190368,
"currencyCode": "USD",
"links": [{
"rel": "domain",
"href": "https://sitename.oracle.com/currencies"
}, {
"rel": "canonical",
"href": "https://sitename.oracle.com/currencies/USD"
}
]
},
"_chargeSet_chargeDefinition": "Data Usage",
"_chargeSet_chargeDefIntegrationId": "KI_DATA_CHARGE",
"_chargeSet_discountAmount": {
"value": 0.0,
"currency": "USD"
},
"_chargeSet_priceType": {
"displayValue": "Usage",
"value": "Usage"
},
"_chargeSet_unitPrice": null,
"links": [{
"rel": "self",
"href": "https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/38926297/transactionLine/2/_chargeSet/2"
}, {
"rel": "parent",
"href": "https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/38926297/transactionLine/2"
}
]
}
]
}