Create a charge
post
/crmRestApi/resources/11.13.18.05/subscriptionProducts/{SubscriptionProductPuid}/child/charges
Request
Path Parameters
-
SubscriptionProductPuid(required): string
The public unique identifier of the subscription product.
Header Parameters
-
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
-
Upsert-Mode: string
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
adjustments: array
Adjustments
Title:
Adjustments
The adjustments resource is used to view, create, update, and delete the subscription charge adjustment details, such as adjustment name, adjustment type, adjustment value, adjustment reason, and effectivity. -
AggregationMethod: string
Title:
Aggregation Method
Maximum Length:30
The aggregation method used for the charges. -
Allowance: number
Title:
Allowance
The allowance part of the charge. -
AssetMeterYn: boolean
Title:
Asset Meter Flag
Maximum Length:1
The flag whether it is an asset meter or not. -
BatchTag: string
Title:
Batch Tag
Maximum Length:30
Batch Tag -
BillingFreq: string
Title:
Billing Frequency
Maximum Length:30
Billing Frequency -
BillingFreqName: string
Title:
Billing Frequency
Maximum Length:255
Billing Frequency Name -
BillLineId: integer
(int64)
The unique identifier of the bill line.
-
BlockSize: number
Title:
Block Size
The block size of the charge. -
chargeComponents: array
Subcription Product Charge Components Records
Title:
Subcription Product Charge Components Records
The subscription product charge components records resoure is used to view the price details of the individual charge components of subscription products. -
ChargeDefinition: string
Title:
Charge Name
Maximum Length:30
The definition that indicates the purpose of the charge. -
ChargeDefinitionName: string
Title:
Charge Definition
The name of the charge definition. -
ChargeId: integer
(int64)
The unique identifier of the charge.
-
chargeMilestoneEvents: array
Charge Milestone Events
Title:
Charge Milestone Events
The charge milestone events resource is used to view, create, update, and delete the milestone events associated with a charge of a subscription. -
ChargeName: string
Title:
Charge Name
Maximum Length:120
The name of the charge. -
ChargePeriodCode: string
Title:
Charge Period Code
Maximum Length:30
The code of the charge period associated with the charge. -
ChargePuid: string
Title:
Charge PUID
Maximum Length:120
The public unique identifier of the charge. -
chargeTiers: array
Charge Tiers
Title:
Charge Tiers
The charge tiers resource is used to view, create, update, and delete the subscription charge tier details, such as tier from, tier to, and list price. -
CoveredLevelId: integer
(int64)
Title:
Covered Level ID
The unique identifier of the covered level. -
EnableProration: string
Title:
Enable Proration
Maximum Length:1
Indicates whether proration is enabled or not. -
EstimatedAmount: number
Title:
Estimated Amount
The estimated amount of the charges. -
EstimatedMethodName: string
Title:
Estimation Method
The method used to estimate the amount. -
EstimatedQuantity: number
Title:
Estimated Quantity
The estimated quantity for the charge. -
EstimationMethod: string
Title:
Estimation Method
Maximum Length:30
The method used to estimate the amount. -
ExternalKey: string
Title:
External Key
Maximum Length:120
The external key used to measure the charge. -
ExternalParentKey: string
Title:
External Parent Key
Maximum Length:120
The external parent key. -
InitialMeterReadingId: integer
(int64)
Title:
Initial Meter Reading ID
The initial meter reading identifier value. -
InvoicingRuleId: integer
(int64)
Title:
Invoicing Rule Id
The ID of the invoice rule. -
InvoicingRuleName: string
Title:
Invoicing Rule
The name of the invoice rule. -
MeterDefinitionId: integer
(int64)
Title:
Meter Definition ID
The unique identifier of the meter definition associated with the charges. -
MeterId: integer
(int64)
Title:
Meter ID
The unique identifier of the meter associated with the charges. -
MilestoneBillingFlag: boolean
Title:
Enable Milestone Based Billing
Indicates whether the billing is impacted by milestone events or not. -
MilestoneRevenueFlag: boolean
Title:
Enable Milestone Based Revenue Recognition
Indicates whether the revenue is impacted by milestone events or not. -
MilestoneTemplateId: integer
(int64)
Title:
Template
The ID of the milestone event associated with a charge. -
MilestoneTemplateName: string
Maximum Length:
120
The name of the milestone template associated with a charge. -
MinimumAmount: number
Title:
Minimum Amount
The minimum amount to be charged. -
MinimumQuantity: number
Title:
Minimum Quantity
The minimum quantity that is allowed. -
PeriodicBillingFlag: boolean
Title:
Enable Periodic Billing
Maximum Length:1
Indicates whether periodic billing is allowed or not. -
PeriodicRevenueFlag: boolean
Title:
Enable Periodic Revenue Recognition
Maximum Length:1
Indicates the periodic revenue recognition of one-time charges. -
PrePaymentNumber: integer
(int64)
Title:
Prepayment Number
The prepayment number for the charge. -
PricePeriodicity: string
Title:
Periodicity
Maximum Length:30
The price periodicity for the charge. Indicates the frequency when the charge has to be applied. -
PricePeriodicityName: string
Title:
Periodicity
The name of the price periodicity. -
PriceType(required): string
Title:
Price Type
Maximum Length:30
The price type associated with the charge. -
QuotedTcv: number
Title:
Total Charge Amount
The quoted TCV of the charge. -
RecurringPricePeriodicityCode: string
Title:
Recurring Price Periodicity Code
Maximum Length:30
The recurring price periodicity code of the charge. -
RollupFlag: boolean
Title:
Rollup Flag
Maximum Length:1
Indicates if the charge needs to be rolled up. -
SequenceNumber: integer
(int32)
Title:
Sequence Number
The sequence number for the charge. -
SubscriptionId: integer
(int64)
Title:
Subscription ID
The unique identifier of the subscription. -
SubscriptionProductId: integer
(int64)
Title:
Subscription Product ID
The unique identifier of the subscription product. -
TieredFlag: boolean
Title:
Tiered
Maximum Length:3
Indicates whether the charge has tiers. -
TieredPricingHeaderId: integer
Title:
Tiered Pricing Header ID
Tiered Pricing Header Id -
TierType: string
Title:
Tier Type
Maximum Length:30
The type of the charge tier. -
TrueUpPeriod: string
Title:
True Up Period
Maximum Length:30
Default Value:ORA_OSS_USAGE_BILLING_PERIOD
The identifier of the trueup period. -
TrueUpPeriodName: string
Title:
True Up Period
The name of the trueup period. -
UnitListPrice: number
Title:
List Price
The price of the unit list. -
UsagePriceLockFlag: boolean
Title:
Usage Price Lock
Maximum Length:3
Indicates whether the usage price is locked or not. -
UsageUnitOfMeasure: string
Title:
Usage UOM
Maximum Length:3
The usage unit of measure of the charge.
Nested Schema : Adjustments
Type:
array
Title:
Adjustments
The adjustments resource is used to view, create, update, and delete the subscription charge adjustment details, such as adjustment name, adjustment type, adjustment value, adjustment reason, and effectivity.
Show Source
Nested Schema : Subcription Product Charge Components Records
Type:
array
Title:
Subcription Product Charge Components Records
The subscription product charge components records resoure is used to view the price details of the individual charge components of subscription products.
Show Source
Nested Schema : Charge Milestone Events
Type:
array
Title:
Charge Milestone Events
The charge milestone events resource is used to view, create, update, and delete the milestone events associated with a charge of a subscription.
Show Source
Nested Schema : Charge Tiers
Type:
array
Title:
Charge Tiers
The charge tiers resource is used to view, create, update, and delete the subscription charge tier details, such as tier from, tier to, and list price.
Show Source
Nested Schema : schema
Type:
Show Source
object
-
AdjustmentBasis: string
Title:
Basis
Maximum Length:30
The basis of the adjustment. -
AdjustmentName: string
Title:
Adjustment
Maximum Length:120
The name of the adjustment. -
AdjustmentReasonCode: string
Title:
Reason
Maximum Length:30
The code of the adjustment reason. -
AdjustmentReasonMeaning: string
Title:
Reason
The translated adjustment reason. -
AdjustmentType: string
Title:
Type
Maximum Length:30
The type of the adjustment. -
AdjustmentValue: number
Title:
Value
The value of the adjustment. -
AutoAdjustmentFlag: boolean
Maximum Length:
3
Indicates whether the adjustment is automatic or not. -
ChargeAdjustmentId: integer
(int64)
The unique identifier of the charge adjustment.
-
ChargeAdjustmentPuid: string
Maximum Length:
120
The public unique identifier of the charge adjustment. -
ChargeId: integer
(int64)
The unique identifier of the charge.
-
Effectivity: string
Title:
Effectivity
Maximum Length:30
The adjustment effectivity -
NumberOfPeriods: number
The number of periods
-
ObjectVersionNumber: integer
(int32)
The number used to implement optimistic locking. This number is incremented every time that the row is updated. The number is compared at the start and end of a transaction to determine whether another session has updated the row.
-
PeriodFrom: number
The period from which the adjustment was initiated.
-
PeriodUntil: number
The period until which the adjustment is initiated.
-
Reason: string
Title:
Reason Description
Maximum Length:120
The reason for the adjustment. -
SequenceNumber: integer
(int32)
Title:
Sequence
The sequence number of the adjustment. -
SubscriptionId: integer
(int64)
The unique identifier of the subscription.
-
SubscriptionProductId: integer
(int64)
The unique identifier of the subscription product.
Nested Schema : subscriptionProducts-charges-chargeComponents-item-post-request
Type:
Show Source
object
-
ChargeComponentId: integer
(int64)
The identifier of the charge component.
-
ChargeComponentPuid: string
Maximum Length:
120
The PUID of the charge component. -
ChargeCurrency: string
Title:
Currency
Maximum Length:15
The charge currency of the charge component. -
ChargeCurrencyExtAmount: number
Title:
Extended Amount
The extended amount of the charge component in charge currency. -
ChargeCurrencyUnitPrice: number
Title:
Currency Unit Price
The unit price of the charge component in charge currency. -
ChargeId: integer
(int64)
Title:
Charge ID
The identifier of the charge. -
CoverageExtendedAmount: number
Title:
Coverage Extended Amount
The extended coverage amount of the charge component. -
Explanation: string
Title:
Explanation
Maximum Length:1000
The explanation for the charge component. -
ExplanationMessageName: string
Title:
Explanation Message
Maximum Length:30
The explanation message name of the charge component. -
ObjectVersionNumber: integer
(int32)
The object version number of the charge component.
-
Price: number
Title:
Amount
The price of the charge component. -
PriceElement: string
Title:
Price Element
Maximum Length:30
The price element of the charge component. -
PriceElementUsage: string
Title:
Price Element Usage
Maximum Length:30
The price element usage of the charge component. -
PriceforQuantity: number
Title:
Price
The price for quantity of the charge component. -
PricingSourceId: integer
(int64)
The identifier of the pricing source of the charge component.
-
PricingSourceType: string
Title:
Pricing Source Type
Maximum Length:30
The type of pricing source of the charge component. -
RollupFlag: boolean
Title:
Rollup Flag
Maximum Length:1
The indicator of whether charge component should be rolled up or not. -
SequenceNumber: integer
(int32)
Title:
Sequence Number
The sequence number of the charge component. -
SubscriptionCurrency: string
Title:
Subscription Currency
Maximum Length:15
The subscription currency of the charge component. -
SubscriptionId: integer
(int64)
Title:
Subscription ID
The identifier of the subscription. -
TaxIncludedFlag: boolean
Title:
Tax Included Flag
Maximum Length:1
The indicator of whether tax is included for the charge component or not. -
UnitPrice: number
Title:
Unit Price
The unit price of the charge component.
Nested Schema : schema
Type:
Show Source
object
-
BillingOffset: number
The billing offset associated with a milestone event.
-
BillLineId: integer
(int64)
The bill line ID associated with the milestone event.
-
BillLinePuid: string
Title:
Bill Line PUID
Maximum Length:120
Bill Line Puid -
ChargeId: integer
(int64)
The charge ID with which the milestone event is associated.
-
ChargePuid: string
Maximum Length:
120
Default Value:Charges.ChargePuid
The PUID of the charge to which the milestone event is associated. -
CompletionDate: string
(date)
The completion date of the milestone event.
-
EventId: integer
(int64)
The ID of the milestone event.
-
EventSource: string
Maximum Length:
30
The source of the milestone event. -
EventSourceReference: string
Maximum Length:
120
The source reference of the milestone event. -
EventType: string
Maximum Length:
30
The type of the milestone event. -
ExpectedCompletionDate: string
(date)
The expected completion date of a milestone event.
-
MilestoneComment: string
Maximum Length:
300
The milestone event comment. -
MilestoneName: string
Maximum Length:
30
The name of the milestone event. -
MilestonePuid: string
Maximum Length:
120
The milestone event PUID. -
ObjectVersionNumber: integer
(int32)
The object version number of the milestone event.
-
Percentage: number
The percentage associated with a milestone event.
Nested Schema : schema
Type:
Show Source
object
-
AdditionalNumberFive: number
Title:
Additional Number Five
Additional number, if any, for the charge tier. -
AdditionalNumberFour: number
Title:
Additional Number Four
Additional number, if any, for the charge tier. -
AdditionalNumberOne: number
Title:
Additional Number One
Additional number, if any, for the charge tier. -
AdditionalNumberSix: number
Title:
Additional Number Six
Additional number, if any, for the charge tier. -
AdditionalNumberThree: number
Title:
Additional Number Three
Additional number, if any, for the charge tier. -
AdditionalNumberTwo: number
Title:
Additional Number Two
Additional number, if any, for the charge tier. -
AdditionalTextOne: string
Title:
Additional Text One
Maximum Length:4000
Additional text, if any, for the charge tier. -
AdditionalTextTwo: string
Title:
Additional Text Two
Maximum Length:4000
Additional text, if any, for the charge tier. -
AdditionalTimestampOne: string
(date-time)
Title:
Additional Time-stamp One
Additional timestamp, if any, for the charge tier. -
AdditionalTimestampThree: string
(date-time)
Title:
Additional Time-stamp Three
Additional timestamp, if any, for the charge tier. -
AdditionalTimestampTwo: string
(date-time)
Title:
Additional Time-stamp Two
Additional timestamp, if any, for the charge tier. -
AddtionalTextThree: string
Title:
Additional Text Three
Maximum Length:4000
Additional text, if any, for the charge tier. -
BlockSize: number
Title:
Block Size
The block size -
ChargeId: integer
(int64)
The unique identifier of the charge.
-
ChargeTierId: integer
(int64)
The unique identifier of the charge tier.
-
ChargeTierPuid: string
Maximum Length:
120
The public unique identifier of the charge tier. -
ListPrice: number
Title:
List Price
The list price -
PriceFormat: string
Title:
Price Format
Maximum Length:30
The display format of the price. -
SequenceNumber: number
The sequence number
-
SubscriptionId: integer
(int64)
The unique identifier of the subscription.
-
SubscriptionProductId: integer
(int64)
The unique identifier of the subscription product.
-
TierFrom: number
Title:
Tier From
The tier from -
TierTo: number
Title:
Tier To
The tier to
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : subscriptionProducts-charges-item-response
Type:
Show Source
object
-
adjustments: array
Adjustments
Title:
Adjustments
The adjustments resource is used to view, create, update, and delete the subscription charge adjustment details, such as adjustment name, adjustment type, adjustment value, adjustment reason, and effectivity. -
AggregationMethod: string
Title:
Aggregation Method
Maximum Length:30
The aggregation method used for the charges. -
Allowance: number
Title:
Allowance
The allowance part of the charge. -
AssetMeterYn: boolean
Title:
Asset Meter Flag
Maximum Length:1
The flag whether it is an asset meter or not. -
BatchTag: string
Title:
Batch Tag
Maximum Length:30
Batch Tag -
BillingFreq: string
Title:
Billing Frequency
Maximum Length:30
Billing Frequency -
BillingFreqName: string
Title:
Billing Frequency
Maximum Length:255
Billing Frequency Name -
BillLineId: integer
(int64)
The unique identifier of the bill line.
-
BlockSize: number
Title:
Block Size
The block size of the charge. -
chargeComponents: array
Subcription Product Charge Components Records
Title:
Subcription Product Charge Components Records
The subscription product charge components records resoure is used to view the price details of the individual charge components of subscription products. -
ChargeDefinition: string
Title:
Charge Name
Maximum Length:30
The definition that indicates the purpose of the charge. -
ChargeDefinitionName: string
Title:
Charge Definition
The name of the charge definition. -
ChargeId: integer
(int64)
The unique identifier of the charge.
-
chargeMilestoneEvents: array
Charge Milestone Events
Title:
Charge Milestone Events
The charge milestone events resource is used to view, create, update, and delete the milestone events associated with a charge of a subscription. -
ChargeName: string
Title:
Charge Name
Maximum Length:120
The name of the charge. -
ChargePeriodCode: string
Title:
Charge Period Code
Maximum Length:30
The code of the charge period associated with the charge. -
ChargePuid: string
Title:
Charge PUID
Maximum Length:120
The public unique identifier of the charge. -
chargeTiers: array
Charge Tiers
Title:
Charge Tiers
The charge tiers resource is used to view, create, update, and delete the subscription charge tier details, such as tier from, tier to, and list price. -
CoveredLevelId: integer
(int64)
Title:
Covered Level ID
The unique identifier of the covered level. -
CreatedBy: string
Read Only:
true
Maximum Length:64
The user who created the charge. -
CreationDate: string
(date-time)
Read Only:
true
The date when the charge was created. -
EnableProration: string
Title:
Enable Proration
Maximum Length:1
Indicates whether proration is enabled or not. -
EstimatedAmount: number
Title:
Estimated Amount
The estimated amount of the charges. -
EstimatedMethodName: string
Title:
Estimation Method
The method used to estimate the amount. -
EstimatedQuantity: number
Title:
Estimated Quantity
The estimated quantity for the charge. -
EstimationMethod: string
Title:
Estimation Method
Maximum Length:30
The method used to estimate the amount. -
ExternalKey: string
Title:
External Key
Maximum Length:120
The external key used to measure the charge. -
ExternalParentKey: string
Title:
External Parent Key
Maximum Length:120
The external parent key. -
InitialMeterReadingId: integer
(int64)
Title:
Initial Meter Reading ID
The initial meter reading identifier value. -
InvoicingRuleId: integer
(int64)
Title:
Invoicing Rule Id
The ID of the invoice rule. -
InvoicingRuleName: string
Title:
Invoicing Rule
The name of the invoice rule. -
LastUpdateDate: string
(date-time)
Read Only:
true
The date when the charge was last updated. -
LastUpdatedBy: string
Read Only:
true
Maximum Length:64
The user who last updated the charge. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
The login details of the user who last updated the charge. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MeterDefinitionId: integer
(int64)
Title:
Meter Definition ID
The unique identifier of the meter definition associated with the charges. -
MeterId: integer
(int64)
Title:
Meter ID
The unique identifier of the meter associated with the charges. -
MilestoneBillingFlag: boolean
Title:
Enable Milestone Based Billing
Indicates whether the billing is impacted by milestone events or not. -
MilestoneRevenueFlag: boolean
Title:
Enable Milestone Based Revenue Recognition
Indicates whether the revenue is impacted by milestone events or not. -
MilestoneTemplateId: integer
(int64)
Title:
Template
The ID of the milestone event associated with a charge. -
MilestoneTemplateName: string
Maximum Length:
120
The name of the milestone template associated with a charge. -
MinimumAmount: number
Title:
Minimum Amount
The minimum amount to be charged. -
MinimumQuantity: number
Title:
Minimum Quantity
The minimum quantity that is allowed. -
PeriodicBillingFlag: boolean
Title:
Enable Periodic Billing
Maximum Length:1
Indicates whether periodic billing is allowed or not. -
PeriodicRevenueFlag: boolean
Title:
Enable Periodic Revenue Recognition
Maximum Length:1
Indicates the periodic revenue recognition of one-time charges. -
PrePaymentNumber: integer
(int64)
Title:
Prepayment Number
The prepayment number for the charge. -
PricePeriodicity: string
Title:
Periodicity
Maximum Length:30
The price periodicity for the charge. Indicates the frequency when the charge has to be applied. -
PricePeriodicityName: string
Title:
Periodicity
The name of the price periodicity. -
PriceType: string
Title:
Price Type
Maximum Length:30
The price type associated with the charge. -
QuotedTcv: number
Title:
Total Charge Amount
The quoted TCV of the charge. -
RecurringPricePeriodicityCode: string
Title:
Recurring Price Periodicity Code
Maximum Length:30
The recurring price periodicity code of the charge. -
RollupFlag: boolean
Title:
Rollup Flag
Maximum Length:1
Indicates if the charge needs to be rolled up. -
SequenceNumber: integer
(int32)
Title:
Sequence Number
The sequence number for the charge. -
SubscriptionId: integer
(int64)
Title:
Subscription ID
The unique identifier of the subscription. -
SubscriptionProductId: integer
(int64)
Title:
Subscription Product ID
The unique identifier of the subscription product. -
TieredFlag: boolean
Title:
Tiered
Maximum Length:3
Indicates whether the charge has tiers. -
TieredPricingHeaderId: integer
Title:
Tiered Pricing Header ID
Tiered Pricing Header Id -
TierType: string
Title:
Tier Type
Maximum Length:30
The type of the charge tier. -
TrueUpPeriod: string
Title:
True Up Period
Maximum Length:30
Default Value:ORA_OSS_USAGE_BILLING_PERIOD
The identifier of the trueup period. -
TrueUpPeriodName: string
Title:
True Up Period
The name of the trueup period. -
UnitListPrice: number
Title:
List Price
The price of the unit list. -
UsagePriceLockFlag: boolean
Title:
Usage Price Lock
Maximum Length:3
Indicates whether the usage price is locked or not. -
UsageUnitOfMeasure: string
Title:
Usage UOM
Maximum Length:3
The usage unit of measure of the charge.
Nested Schema : Adjustments
Type:
array
Title:
Adjustments
The adjustments resource is used to view, create, update, and delete the subscription charge adjustment details, such as adjustment name, adjustment type, adjustment value, adjustment reason, and effectivity.
Show Source
Nested Schema : Subcription Product Charge Components Records
Type:
array
Title:
Subcription Product Charge Components Records
The subscription product charge components records resoure is used to view the price details of the individual charge components of subscription products.
Show Source
Nested Schema : Charge Milestone Events
Type:
array
Title:
Charge Milestone Events
The charge milestone events resource is used to view, create, update, and delete the milestone events associated with a charge of a subscription.
Show Source
Nested Schema : Charge Tiers
Type:
array
Title:
Charge Tiers
The charge tiers resource is used to view, create, update, and delete the subscription charge tier details, such as tier from, tier to, and list price.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : subscriptionProducts-charges-adjustments-item-response
Type:
Show Source
object
-
AdjustmentBasis: string
Title:
Basis
Maximum Length:30
The basis of the adjustment. -
AdjustmentName: string
Title:
Adjustment
Maximum Length:120
The name of the adjustment. -
AdjustmentReasonCode: string
Title:
Reason
Maximum Length:30
The code of the adjustment reason. -
AdjustmentReasonMeaning: string
Title:
Reason
The translated adjustment reason. -
AdjustmentType: string
Title:
Type
Maximum Length:30
The type of the adjustment. -
AdjustmentValue: number
Title:
Value
The value of the adjustment. -
AutoAdjustmentFlag: boolean
Maximum Length:
3
Indicates whether the adjustment is automatic or not. -
ChargeAdjustmentId: integer
(int64)
The unique identifier of the charge adjustment.
-
ChargeAdjustmentPuid: string
Maximum Length:
120
The public unique identifier of the charge adjustment. -
ChargeId: integer
(int64)
The unique identifier of the charge.
-
CreatedBy: string
Read Only:
true
Maximum Length:64
The user who created the adjustment. -
CreationDate: string
(date-time)
Read Only:
true
The date when the adjustment was created. -
Effectivity: string
Title:
Effectivity
Maximum Length:30
The adjustment effectivity -
LastUpdateDate: string
(date-time)
Read Only:
true
The date when the adjustment was last updated. -
LastUpdatedBy: string
Read Only:
true
Maximum Length:64
The user who last updated the adjustment. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
The login details of the user who last updated the adjustment. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
NumberOfPeriods: number
The number of periods
-
ObjectVersionNumber: integer
(int32)
The number used to implement optimistic locking. This number is incremented every time that the row is updated. The number is compared at the start and end of a transaction to determine whether another session has updated the row.
-
PeriodFrom: number
The period from which the adjustment was initiated.
-
PeriodUntil: number
The period until which the adjustment is initiated.
-
Reason: string
Title:
Reason Description
Maximum Length:120
The reason for the adjustment. -
SequenceNumber: integer
(int32)
Title:
Sequence
The sequence number of the adjustment. -
SubscriptionId: integer
(int64)
The unique identifier of the subscription.
-
SubscriptionProductId: integer
(int64)
The unique identifier of the subscription product.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : subscriptionProducts-charges-chargeComponents-item-response
Type:
Show Source
object
-
ChargeComponentId: integer
(int64)
The identifier of the charge component.
-
ChargeComponentPuid: string
Maximum Length:
120
The PUID of the charge component. -
ChargeCurrency: string
Title:
Currency
Maximum Length:15
The charge currency of the charge component. -
ChargeCurrencyExtAmount: number
Title:
Extended Amount
The extended amount of the charge component in charge currency. -
ChargeCurrencyName: string
Title:
Currency
Read Only:true
Maximum Length:80
The name of the charge currency. -
ChargeCurrencyUnitPrice: number
Title:
Currency Unit Price
The unit price of the charge component in charge currency. -
ChargeId: integer
(int64)
Title:
Charge ID
The identifier of the charge. -
CoverageExtendedAmount: number
Title:
Coverage Extended Amount
The extended coverage amount of the charge component. -
CreatedBy: string
Read Only:
true
Maximum Length:64
The user who created the record. -
CreationDate: string
(date-time)
Read Only:
true
The date when the record was created. -
Explanation: string
Title:
Explanation
Maximum Length:1000
The explanation for the charge component. -
ExplanationMessageName: string
Title:
Explanation Message
Maximum Length:30
The explanation message name of the charge component. -
LastUpdateDate: string
(date-time)
Read Only:
true
The date when the subscription was last updated. -
LastUpdatedBy: string
Read Only:
true
Maximum Length:64
The user who last updated the subscription. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
The login of the user who last updated the subscription. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
ObjectVersionNumber: integer
(int32)
The object version number of the charge component.
-
Price: number
Title:
Amount
The price of the charge component. -
PriceElement: string
Title:
Price Element
Maximum Length:30
The price element of the charge component. -
PriceElementName: string
Title:
Price Element
Read Only:true
Maximum Length:80
The name of the price element associated with the charge component. -
PriceElementUsage: string
Title:
Price Element Usage
Maximum Length:30
The price element usage of the charge component. -
PriceElementUsageName: string
Title:
Price Element Usage
Read Only:true
Maximum Length:80
The name of the price element usage associated with the charge component. -
PriceforQuantity: number
Title:
Price
The price for quantity of the charge component. -
PricingSourceId: integer
(int64)
The identifier of the pricing source of the charge component.
-
PricingSourceType: string
Title:
Pricing Source Type
Maximum Length:30
The type of pricing source of the charge component. -
PricingSourceTypeName: string
Title:
Pricing Source Type
Read Only:true
Maximum Length:80
The name of the pricing source type. -
RollupFlag: boolean
Title:
Rollup Flag
Maximum Length:1
The indicator of whether charge component should be rolled up or not. -
SequenceNumber: integer
(int32)
Title:
Sequence Number
The sequence number of the charge component. -
SubscriptionCurrency: string
Title:
Subscription Currency
Maximum Length:15
The subscription currency of the charge component. -
SubscriptionCurrencyName: string
Title:
Subscription Currency
Read Only:true
Maximum Length:80
The name of the subscription currency. -
SubscriptionId: integer
(int64)
Title:
Subscription ID
The identifier of the subscription. -
TaxIncludedFlag: boolean
Title:
Tax Included Flag
Maximum Length:1
The indicator of whether tax is included for the charge component or not. -
UnitPrice: number
Title:
Unit Price
The unit price of the charge component.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : subscriptionProducts-charges-chargeMilestoneEvents-item-response
Type:
Show Source
object
-
BillingOffset: number
The billing offset associated with a milestone event.
-
BillLineId: integer
(int64)
The bill line ID associated with the milestone event.
-
BillLinePuid: string
Title:
Bill Line PUID
Maximum Length:120
Bill Line Puid -
ChargeId: integer
(int64)
The charge ID with which the milestone event is associated.
-
ChargePuid: string
Maximum Length:
120
Default Value:Charges.ChargePuid
The PUID of the charge to which the milestone event is associated. -
CompletionDate: string
(date)
The completion date of the milestone event.
-
CreatedBy: string
Read Only:
true
Maximum Length:64
The login of the user who created the milestone event. -
CreationDate: string
(date-time)
Read Only:
true
The date on which the milestone event was created. -
EventId: integer
(int64)
The ID of the milestone event.
-
EventSource: string
Maximum Length:
30
The source of the milestone event. -
EventSourceReference: string
Maximum Length:
120
The source reference of the milestone event. -
EventType: string
Maximum Length:
30
The type of the milestone event. -
ExpectedCompletionDate: string
(date)
The expected completion date of a milestone event.
-
LastUpdateDate: string
(date-time)
Read Only:
true
The date of which the milestone event was last updated. -
LastUpdatedBy: string
Read Only:
true
Maximum Length:64
The user who updated the milestone event the last. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
The login which updated the milestone event the last. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MilestoneComment: string
Maximum Length:
300
The milestone event comment. -
MilestoneName: string
Maximum Length:
30
The name of the milestone event. -
MilestonePuid: string
Maximum Length:
120
The milestone event PUID. -
ObjectVersionNumber: integer
(int32)
The object version number of the milestone event.
-
Percentage: number
The percentage associated with a milestone event.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : subscriptionProducts-charges-chargeTiers-item-response
Type:
Show Source
object
-
AdditionalNumberFive: number
Title:
Additional Number Five
Additional number, if any, for the charge tier. -
AdditionalNumberFour: number
Title:
Additional Number Four
Additional number, if any, for the charge tier. -
AdditionalNumberOne: number
Title:
Additional Number One
Additional number, if any, for the charge tier. -
AdditionalNumberSix: number
Title:
Additional Number Six
Additional number, if any, for the charge tier. -
AdditionalNumberThree: number
Title:
Additional Number Three
Additional number, if any, for the charge tier. -
AdditionalNumberTwo: number
Title:
Additional Number Two
Additional number, if any, for the charge tier. -
AdditionalTextOne: string
Title:
Additional Text One
Maximum Length:4000
Additional text, if any, for the charge tier. -
AdditionalTextTwo: string
Title:
Additional Text Two
Maximum Length:4000
Additional text, if any, for the charge tier. -
AdditionalTimestampOne: string
(date-time)
Title:
Additional Time-stamp One
Additional timestamp, if any, for the charge tier. -
AdditionalTimestampThree: string
(date-time)
Title:
Additional Time-stamp Three
Additional timestamp, if any, for the charge tier. -
AdditionalTimestampTwo: string
(date-time)
Title:
Additional Time-stamp Two
Additional timestamp, if any, for the charge tier. -
AddtionalTextThree: string
Title:
Additional Text Three
Maximum Length:4000
Additional text, if any, for the charge tier. -
BlockSize: number
Title:
Block Size
The block size -
ChargeId: integer
(int64)
The unique identifier of the charge.
-
ChargeTierId: integer
(int64)
The unique identifier of the charge tier.
-
ChargeTierPuid: string
Maximum Length:
120
The public unique identifier of the charge tier. -
CreatedBy: string
Read Only:
true
Maximum Length:64
The user who created the charge tier. -
CreationDate: string
(date-time)
Read Only:
true
The date when the charge tier was created. -
LastUpdateDate: string
(date-time)
Read Only:
true
The date when the charge tier was last updated. -
LastUpdatedBy: string
Read Only:
true
Maximum Length:64
The user who last updated the charge tier. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
The login details of the user who last updated the charge tier. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
ListPrice: number
Title:
List Price
The list price -
PriceFormat: string
Title:
Price Format
Maximum Length:30
The display format of the price. -
SequenceNumber: number
The sequence number
-
SubscriptionId: integer
(int64)
The unique identifier of the subscription.
-
SubscriptionProductId: integer
(int64)
The unique identifier of the subscription product.
-
TierFrom: number
Title:
Tier From
The tier from -
TierTo: number
Title:
Tier To
The tier to
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Links
- EstimationMethodNameVA
-
Parameters:
- finder:
LookupTypeIsActiveEnabledFinder%3BBindLookupType%3DORA_OSS_USAGE_EST_METHOD
The list of values indicating the estimated method name.
The following properties are defined on the LOV link relation:- Source Attribute: EstimatedMethodName; Target Attribute: Meaning
- Display Attribute: Meaning
- finder:
- InvoiceRuleVA
-
Parameters:
- finder:
InvoiceRuleTypeFinder%3BBindType%3DI
The list of values indicating the invoice rule names.
The following properties are defined on the LOV link relation:- Source Attribute: InvoicingRuleName; Target Attribute: Name
- Display Attribute: Name
- finder:
- MilestoneTemplatesVA
-
The list of values indicating the milestone template identifier.
The following properties are defined on the LOV link relation:- Source Attribute: MilestoneTemplateId; Target Attribute: TemplateId
- Display Attribute: TemplateName
- PaymentSetIdVA
-
Parameters:
- finder:
BuIdAndBillToAccountAndPrepaymentNoFinder
The list of values indicating the pre payment numbers.
The following properties are defined on the LOV link relation:- Source Attribute: PrePaymentNumber; Target Attribute: PaymentSetId
- Display Attribute: PaymentSetId
- finder:
- TierTypePVO
-
Parameters:
- finder:
LookupTypeIsActiveEnabledFinder%3BBindLookupType%3DORA_OSS_PRICE_TIER_TYPE
The list of values indicating the tier type.
The following properties are defined on the LOV link relation:- Source Attribute: TierType; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- TimeUnitOfMeasureVA
-
The list of values indicating the billing frequency name.
The following properties are defined on the LOV link relation:- Source Attribute: BillingFreqName; Target Attribute: UnitOfMeasure
- Display Attribute: UnitOfMeasure
- TrueUpNameVA
-
Parameters:
- finder:
LookupTypeIsActiveEnabledFinder%3BBindLookupType%3DORA_OSS_USAGE_TRUE_UP_PERIOD
The list of values indicating the true up period name.
The following properties are defined on the LOV link relation:- Source Attribute: TrueUpPeriodName; Target Attribute: Meaning
- Display Attribute: Meaning
- finder:
- adjustments
-
Parameters:
- ChargePuid:
$request.path.ChargePuid
- SubscriptionProductPuid:
$request.path.SubscriptionProductPuid
The adjustments resource is used to view, create, update, and delete the subscription charge adjustment details, such as adjustment name, adjustment type, adjustment value, adjustment reason, and effectivity. - ChargePuid:
- chargeComponents
-
Parameters:
- ChargePuid:
$request.path.ChargePuid
- SubscriptionProductPuid:
$request.path.SubscriptionProductPuid
The subscription product charge components records resoure is used to view the price details of the individual charge components of subscription products. - ChargePuid:
- chargeMilestoneEvents
-
Parameters:
- ChargePuid:
$request.path.ChargePuid
- SubscriptionProductPuid:
$request.path.SubscriptionProductPuid
The charge milestone events resource is used to view, create, update, and delete the milestone events associated with a charge of a subscription. - ChargePuid:
- chargeTiers
-
Parameters:
- ChargePuid:
$request.path.ChargePuid
- SubscriptionProductPuid:
$request.path.SubscriptionProductPuid
The charge tiers resource is used to view, create, update, and delete the subscription charge tier details, such as tier from, tier to, and list price. - ChargePuid:
Examples
The following example shows how to create a charge by submitting a POST request on the REST resource using cURL.
cURL Command
curl -u <username:password> \ -X POST -d
@example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/subscriptionProducts/300100182015426/child/charges
Example of Request Body
The following example shows the contents of the request body in JSON format.
{ "BillLineId": null, "ChargeDefinition": "USAGE_CHARGESPM", "ChargePuid": "GP-5678-PRDT-1-CHRG-11", "PricePeriodicity": "0zG", "PriceType": "RECURRING", "ChargeName": "USAGE SPM CHARGE", "UnitListPrice": 20, "TieredFlag": true }
Example of Response Body
The following example shows the contents of the response body in JSON format.
{ "BillLineId": null, "ChargeDefinition": "USAGE_CHARGESPM", "ChargeId": 300100192686413, "ChargePuid": "GP-5678-PRDT-1-CHRG-11", "CoveredLevelId": null, "PrePaymentNumber": null, "PricePeriodicity": "0zG", "PriceType": "RECURRING", "RollupFlag": null, "SequenceNumber": null, "SubscriptionId": 300100181994494, "SubscriptionProductId": 300100192686405, "ChargeName": "USAGE SPM CHARGE", "ExternalKey": null, "ExternalParentKey": null, "UnitListPrice": 20, "Allowance": null, "BlockSize": null, "TieredFlag": true, "TierType": null, "UsagePriceLockFlag": null, "PricePeriodicityName": "MONTH", "ChargeDefinitionName": null, "CreatedBy": "SALES_ADMIN", "CreationDate": "2019-08-20T08:13:16+00:00", "LastUpdateDate": "2019-08-20T08:13:16.685+00:00", "LastUpdateLogin": "9062D47DF31EDAF6E0533EFDF40A2696", "LastUpdatedBy": "SALES_ADMIN", "links": ... }