Create Asset Charge
post
/rest/v19/assets/{id}/charges
This operation creates a new charge for the specified asset.
Request
Supported Media Types
- application/json
Path Parameters
Root Schema : assetChargeBean
Type:
Show Source
object
-
applyTo:
string()
Title:
Apply To
Indicates what this charge applies to -
assetKey:
string()
Title:
Asset Key
-
chargeDefIntegrationId:
string()
Title:
Charge Definition Integration Id
The charge definition code in the integrated order management system -
chargeName:
string()
Title:
Charge Name
Name of the charge -
chargeSequenceNumber:
integer(int64)
-
chargeTypeCode(required):
string()
Title:
Charge Type Code
-
contractDiscountAmount:
Contract Discount Amount
Title:
Contract Discount Amount
Discount amount based on contract -
contractListAmount:
Contract List Amount
Title:
Contract List Amount
List amount based on contract -
contractNetAmount:
Contract Net Amount
Title:
Contract Net Amount
Net amount based on contract -
customDiscountAmount:
Custom Discount Amount
Title:
Custom Discount Amount
Amount of custom discount -
customDiscountType:
string()
Title:
Custom Discount Type
Type of custom discount applied -
dateAdded:
string()
Title:
Date Added
Read Only:true
Last modified date of Asset Charge Bean. -
dateModified:
string()
Title:
Date Modified
Read Only:true
Creation date of the Asset Charge Bean. -
dynamicPricingType:
string()
Title:
Dynamic Pricing Type
Type of dynamic pricing -
extendedDiscountAmount:
Extended Discount Amount
Title:
Extended Discount Amount
Total extended discount amount -
id:
integer()
Title:
id
Read Only:true
-
links:
array Links
Title:
Links
Read Only:true
The link relations associated with the resource instance. -
listAmount:
List Amount
Title:
List Amount
The list amount for this charge -
netAmount:
Net Amount
Title:
Net Amount
Total net amount -
netPrice:
Net Price
Title:
Net Price
Price after applying discounts -
pricePeriodCode:
string()
Title:
Price Period Code
Code representing the pricing period -
priceTypeCode(required):
string()
Title:
Price Type Code
-
priceUom:
string()
Title:
Price UOM
Unit of measure for the price -
primaryFlag:
boolean()
Title:
Primary Flag
Indicates if this is the primary charge. -
rateCardStructure:
string()
Title:
Rate Card Structure
Structure of the rate card -
unitPrice:
Unit Price
Title:
Unit Price
Price per unit
Nested Schema : Contract Discount Amount
Title:
Contract Discount Amount
Discount amount based on contract
Match All
Discount amount based on contract
Show Source
Nested Schema : Contract List Amount
Title:
Contract List Amount
List amount based on contract
Match All
List amount based on contract
Show Source
Nested Schema : Contract Net Amount
Title:
Contract Net Amount
Net amount based on contract
Match All
Net amount based on contract
Show Source
Nested Schema : Custom Discount Amount
Title:
Custom Discount Amount
Amount of custom discount
Match All
Amount of custom discount
Show Source
Nested Schema : Extended Discount Amount
Title:
Extended Discount Amount
Total extended discount amount
Match All
Total extended discount amount
Show Source
Nested Schema : Links
Type:
array
Title:
Links
Read Only:
true
The link relations associated with the resource instance.
Show Source
Nested Schema : List Amount
Title:
List Amount
The list amount for this charge
Match All
The list amount for this charge
Show Source
Nested Schema : Net Amount
Title:
Net Amount
Total net amount
Match All
Total net amount
Show Source
Nested Schema : Net Price
Title:
Net Price
Price after applying discounts
Match All
Price after applying discounts
Show Source
Nested Schema : amountBean
Type:
Show Source
object
-
amount:
number()
Title:
Amount
Amount -
currencyCode:
string()
Title:
Currency Code
Currency Code
Response
Supported Media Types
- application/json
201 Response
Success
Root Schema : assetChargeBean
Type:
Show Source
object
-
applyTo:
string()
Title:
Apply To
Indicates what this charge applies to -
assetKey:
string()
Title:
Asset Key
-
chargeDefIntegrationId:
string()
Title:
Charge Definition Integration Id
The charge definition code in the integrated order management system -
chargeName:
string()
Title:
Charge Name
Name of the charge -
chargeSequenceNumber:
integer(int64)
-
chargeTypeCode(required):
string()
Title:
Charge Type Code
-
contractDiscountAmount:
Contract Discount Amount
Title:
Contract Discount Amount
Discount amount based on contract -
contractListAmount:
Contract List Amount
Title:
Contract List Amount
List amount based on contract -
contractNetAmount:
Contract Net Amount
Title:
Contract Net Amount
Net amount based on contract -
customDiscountAmount:
Custom Discount Amount
Title:
Custom Discount Amount
Amount of custom discount -
customDiscountType:
string()
Title:
Custom Discount Type
Type of custom discount applied -
dateAdded:
string()
Title:
Date Added
Read Only:true
Last modified date of Asset Charge Bean. -
dateModified:
string()
Title:
Date Modified
Read Only:true
Creation date of the Asset Charge Bean. -
dynamicPricingType:
string()
Title:
Dynamic Pricing Type
Type of dynamic pricing -
extendedDiscountAmount:
Extended Discount Amount
Title:
Extended Discount Amount
Total extended discount amount -
id:
integer()
Title:
id
Read Only:true
-
links:
array Links
Title:
Links
Read Only:true
The link relations associated with the resource instance. -
listAmount:
List Amount
Title:
List Amount
The list amount for this charge -
netAmount:
Net Amount
Title:
Net Amount
Total net amount -
netPrice:
Net Price
Title:
Net Price
Price after applying discounts -
pricePeriodCode:
string()
Title:
Price Period Code
Code representing the pricing period -
priceTypeCode(required):
string()
Title:
Price Type Code
-
priceUom:
string()
Title:
Price UOM
Unit of measure for the price -
primaryFlag:
boolean()
Title:
Primary Flag
Indicates if this is the primary charge. -
rateCardStructure:
string()
Title:
Rate Card Structure
Structure of the rate card -
unitPrice:
Unit Price
Title:
Unit Price
Price per unit
Nested Schema : Contract Discount Amount
Title:
Contract Discount Amount
Discount amount based on contract
Match All
Discount amount based on contract
Show Source
Nested Schema : Contract List Amount
Title:
Contract List Amount
List amount based on contract
Match All
List amount based on contract
Show Source
Nested Schema : Contract Net Amount
Title:
Contract Net Amount
Net amount based on contract
Match All
Net amount based on contract
Show Source
Nested Schema : Custom Discount Amount
Title:
Custom Discount Amount
Amount of custom discount
Match All
Amount of custom discount
Show Source
Nested Schema : Extended Discount Amount
Title:
Extended Discount Amount
Total extended discount amount
Match All
Total extended discount amount
Show Source
Nested Schema : Links
Type:
array
Title:
Links
Read Only:
true
The link relations associated with the resource instance.
Show Source
Nested Schema : List Amount
Title:
List Amount
The list amount for this charge
Match All
The list amount for this charge
Show Source
Nested Schema : Net Amount
Title:
Net Amount
Total net amount
Match All
Total net amount
Show Source
Nested Schema : Net Price
Title:
Net Price
Price after applying discounts
Match All
Price after applying discounts
Show Source
Nested Schema : amountBean
Type:
Show Source
object
-
amount:
number()
Title:
Amount
Amount -
currencyCode:
string()
Title:
Currency Code
Currency Code
Examples
The following example shows how to create a new charge for the specified asset by submitting a POST request to the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X POST -H "Authorization: Bearer <token>" -H "Content-type: application/json" -H "Accept: application/json" https://sitename.oracle.com/rest/v19/assets/51587512/charges
Request Body Sample
{ "chargeSequenceNumber": 2, "primaryFlag": false, "applyTo": "Price", "chargeName": "Recurring Pricing", "chargeTypeCode": "ORA_SALE", "priceTypeCode": "Recurring", "pricePeriodCode": "Per Month", "unitPrice": { "amount": 10, "currencyCode": "USD" }, "listAmount": { "amount": 10, "currencyCode": "USD" }, "customDiscountAmount": { "amount": 0, "currencyCode": "USD" }, "extendedDiscountAmount": { "amount": 0, "currencyCode": "USD" }, "netPrice": { "amount": 10, "currencyCode": "USD" }, "netAmount": { "amount": 10, "currencyCode": "USD" }, "contractDiscountAmount": { "amount": 0, "currencyCode": "USD" }, "contractNetAmount": { "amount": 10, "currencyCode": "USD" }, "contractListAmount": { "amount": 10, "currencyCode": "USD" }, "chargeDefIntegrationId": "RECURRING_TIME" }
Response Body Sample
{ "id": 51631607, "assetKey": "abo_4d93b451-0ce6-4df3-8a08-e725f1c67bd3", "chargeSequenceNumber": 2, "dateAdded": "2025-09-03T07:17:04Z", "dateModified": "2025-09-03T07:17:04Z", "primaryFlag": false, "applyTo": "Price", "chargeName": "Recurring Pricing", "chargeTypeCode": "ORA_SALE", "priceTypeCode": "Recurring", "pricePeriodCode": "Per Month", "unitPrice": { "amount": 10, "currencyCode": "USD" }, "listAmount": { "amount": 10, "currencyCode": "USD" }, "customDiscountAmount": { "amount": 0, "currencyCode": "USD" }, "extendedDiscountAmount": { "amount": 0, "currencyCode": "USD" }, "netPrice": { "amount": 10, "currencyCode": "USD" }, "netAmount": { "amount": 10, "currencyCode": "USD" }, "contractDiscountAmount": { "amount": 0, "currencyCode": "USD" }, "contractNetAmount": { "amount": 10, "currencyCode": "USD" }, "contractListAmount": { "amount": 10, "currencyCode": "USD" }, "chargeDefIntegrationId": "RECURRING_TIME" }