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 ToIndicates what this charge applies to
- 
            assetKey: 
            string()
            Title:Asset Key
- 
            chargeDefIntegrationId: 
            string()
            Title:Charge Definition Integration IdThe charge definition code in the integrated order management system
- 
            chargeName: 
            string()
            Title:Charge NameName of the charge
- 
            chargeSequenceNumber: 
            integer(int64)
            
- 
            chargeTypeCode(required): 
            string()
            Title:Charge Type Code
- 
            contractDiscountAmount: 
             Contract Discount Amount
            
            Title:Contract Discount AmountDiscount amount based on contract
- 
            contractListAmount: 
             Contract List Amount
            
            Title:Contract List AmountList amount based on contract
- 
            contractNetAmount: 
             Contract Net Amount
            
            Title:Contract Net AmountNet amount based on contract
- 
            customDiscountAmount: 
             Custom Discount Amount
            
            Title:Custom Discount AmountAmount of custom discount
- 
            customDiscountType: 
            string()
            Title:Custom Discount TypeType of custom discount applied
- 
            dateAdded: 
            string()
            Title:Date AddedRead Only:trueLast modified date of Asset Charge Bean.
- 
            dateModified: 
            string()
            Title:Date ModifiedRead Only:trueCreation date of the Asset Charge Bean.
- 
            dynamicPricingType: 
            string()
            Title:Dynamic Pricing TypeType of dynamic pricing
- 
            extendedDiscountAmount: 
             Extended Discount Amount
            
            Title:Extended Discount AmountTotal extended discount amount
- 
            id: 
            integer()
            Title:idRead Only:true
- 
            links: 
            array  Links
            
            Title:LinksRead Only:trueThe link relations associated with the resource instance.
- 
            listAmount: 
             List Amount
            
            Title:List AmountThe list amount for this charge
- 
            netAmount: 
             Net Amount
            
            Title:Net AmountTotal net amount
- 
            netPrice: 
             Net Price
            
            Title:Net PricePrice after applying discounts
- 
            pricePeriodCode: 
            string()
            Title:Price Period CodeCode representing the pricing period
- 
            priceTypeCode(required): 
            string()
            Title:Price Type Code
- 
            priceUom: 
            string()
            Title:Price UOMUnit of measure for the price
- 
            primaryFlag: 
            boolean()
            Title:Primary FlagIndicates if this is the primary charge.
- 
            rateCardStructure: 
            string()
            Title:Rate Card StructureStructure of the rate card
- 
            unitPrice: 
             Unit Price
            
            Title:Unit PricePrice per unit
Nested Schema : Contract Discount Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Contract Discount AmountDiscount amount based on contract
    
    
    
    
    
    
    Match All
    
        
            Discount amount based on contract
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Contract List Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Contract List AmountList amount based on contract
    
    
    
    
    
    
    Match All
    
        
            List amount based on contract
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Contract Net Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Contract Net AmountNet amount based on contract
    
    
    
    
    
    
    Match All
    
        
            Net amount based on contract
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Custom Discount Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Custom Discount AmountAmount of custom discount
    
    
    
    
    
    
    Match All
    
        
            Amount of custom discount
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Extended Discount Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Extended Discount AmountTotal extended discount amount
    
    
    
    
    
    
    Match All
    
        
            Total extended discount amount
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Links
    
      
      Type: 
    
    
    
    arrayTitle: 
    
    
    
    
    LinksRead Only: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    trueThe link relations associated with the resource instance.
    
    
    
    
    
        Show Source
        
        
    
    
    
    
    
    
Nested Schema : List Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    List AmountThe list amount for this charge
    
    
    
    
    
    
    Match All
    
        
            The list amount for this charge
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Net Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Net AmountTotal net amount
    
    
    
    
    
    
    Match All
    
        
            Total net amount
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Net Price
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Net PricePrice after applying discounts
    
    
    
    
    
    
    Match All
    
        
            Price after applying discounts
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : amountBean
    
      Type: 
      
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Show Source
        object- 
            amount: 
            number()
            Title:AmountAmount
- 
            currencyCode: 
            string()
            Title:Currency CodeCurrency Code
Response
Supported Media Types
                - application/json
201 Response
Success
                
                
                    Root Schema : assetChargeBean
    
      Type: 
      
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Show Source
        object- 
            applyTo: 
            string()
            Title:Apply ToIndicates what this charge applies to
- 
            assetKey: 
            string()
            Title:Asset Key
- 
            chargeDefIntegrationId: 
            string()
            Title:Charge Definition Integration IdThe charge definition code in the integrated order management system
- 
            chargeName: 
            string()
            Title:Charge NameName of the charge
- 
            chargeSequenceNumber: 
            integer(int64)
            
- 
            chargeTypeCode(required): 
            string()
            Title:Charge Type Code
- 
            contractDiscountAmount: 
             Contract Discount Amount
            
            Title:Contract Discount AmountDiscount amount based on contract
- 
            contractListAmount: 
             Contract List Amount
            
            Title:Contract List AmountList amount based on contract
- 
            contractNetAmount: 
             Contract Net Amount
            
            Title:Contract Net AmountNet amount based on contract
- 
            customDiscountAmount: 
             Custom Discount Amount
            
            Title:Custom Discount AmountAmount of custom discount
- 
            customDiscountType: 
            string()
            Title:Custom Discount TypeType of custom discount applied
- 
            dateAdded: 
            string()
            Title:Date AddedRead Only:trueLast modified date of Asset Charge Bean.
- 
            dateModified: 
            string()
            Title:Date ModifiedRead Only:trueCreation date of the Asset Charge Bean.
- 
            dynamicPricingType: 
            string()
            Title:Dynamic Pricing TypeType of dynamic pricing
- 
            extendedDiscountAmount: 
             Extended Discount Amount
            
            Title:Extended Discount AmountTotal extended discount amount
- 
            id: 
            integer()
            Title:idRead Only:true
- 
            links: 
            array  Links
            
            Title:LinksRead Only:trueThe link relations associated with the resource instance.
- 
            listAmount: 
             List Amount
            
            Title:List AmountThe list amount for this charge
- 
            netAmount: 
             Net Amount
            
            Title:Net AmountTotal net amount
- 
            netPrice: 
             Net Price
            
            Title:Net PricePrice after applying discounts
- 
            pricePeriodCode: 
            string()
            Title:Price Period CodeCode representing the pricing period
- 
            priceTypeCode(required): 
            string()
            Title:Price Type Code
- 
            priceUom: 
            string()
            Title:Price UOMUnit of measure for the price
- 
            primaryFlag: 
            boolean()
            Title:Primary FlagIndicates if this is the primary charge.
- 
            rateCardStructure: 
            string()
            Title:Rate Card StructureStructure of the rate card
- 
            unitPrice: 
             Unit Price
            
            Title:Unit PricePrice per unit
Nested Schema : Contract Discount Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Contract Discount AmountDiscount amount based on contract
    
    
    
    
    
    
    Match All
    
        
            Discount amount based on contract
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Contract List Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Contract List AmountList amount based on contract
    
    
    
    
    
    
    Match All
    
        
            List amount based on contract
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Contract Net Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Contract Net AmountNet amount based on contract
    
    
    
    
    
    
    Match All
    
        
            Net amount based on contract
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Custom Discount Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Custom Discount AmountAmount of custom discount
    
    
    
    
    
    
    Match All
    
        
            Amount of custom discount
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Extended Discount Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Extended Discount AmountTotal extended discount amount
    
    
    
    
    
    
    Match All
    
        
            Total extended discount amount
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Links
    
      
      Type: 
    
    
    
    arrayTitle: 
    
    
    
    
    LinksRead Only: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    trueThe link relations associated with the resource instance.
    
    
    
    
    
        Show Source
        
        
    
    
    
    
    
    
Nested Schema : List Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    List AmountThe list amount for this charge
    
    
    
    
    
    
    Match All
    
        
            The list amount for this charge
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Net Amount
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Net AmountTotal net amount
    
    
    
    
    
    
    Match All
    
        
            Total net amount
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : Net Price
    
      
      
    
    
    
    Title: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Net PricePrice after applying discounts
    
    
    
    
    
    
    Match All
    
        
            Price after applying discounts
        
    
    Show Source
    
    
    
    
    
    
    
Nested Schema : amountBean
    
      Type: 
      
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Show Source
        object- 
            amount: 
            number()
            Title:AmountAmount
- 
            currencyCode: 
            string()
            Title:Currency CodeCurrency 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"
}