Charge Object

Charge Fields

PropertyTypeDescription
quantityDecimalThe quantity of the subscription product or purchase being charged for
unitPriceDecimalThe price per unit of quantity
amountDecimalThe total amount of the charge, not including any discounts
nameStringThe name of the line item
descriptionStringThe description of the line item
glCodeStringThe general ledger code for this transaction
effectiveTimestampTimestampThe effective time of the transaction.
proratedUnitPriceDecimalThe price per unit of quantity if the charge is subject to proration.
startServiceDateTimestampThe date the associated service starts.
endServiceDateTimestampThe date the associated service ends.
rangeQuantityIntegerFor non standard pricing, indicates the value used to calculate the price per unit
isReversableBooleanIndicates whether the charge can be reversed.
discountObject. Definition belowDeprecated. Use discounts instead
discountsList of Objects. Definition belowA list of the discounts applied to the line item at the point of charge.
subscriptionProductObject. Defined belowContains an id and uri that references the subscription product this charge is associated with. This is null if the charge is not associated with a subscription product.
purchaseObject. Defined belowContains an id and uri that references the purchase this charge is associated with. This is null if the charge is not associated with the direct purchase of a purchasable product.
chargeTiersList of Objects. Defined belowIf the charge was based on a subscription product or purchase using the Tiered pricing model, then this list breaks down the charge into its tiers
netsuiteChargeItemStringThe Item in NetSuite this charge relates to. Based on the value in the underlying product's netsuiteItemId. For the NetSuite plugin.
idIntegerThe Fusebill generated ID for this transaction

Discount

PropertyTypeDescription
configuredDiscountAmountDecimalThe dollar amount or percentage configured for the discount, depending on discountType
amountDecimalThe total amount discounted off the charge by this discount
quantityDecimalThe number of times this discount was applied to this charge.
unearnedAmountDecimalThe amount of this discount remaining to be earned
remainingReversalAmountDecimalThe amount of this discount that can still be reversed
discountTypeEnum: {Percentage, Amount, AmountPerUnit}Indicates how configuredDiscountAmount is interpreted for calculating the discount
descriptionStringThe label for this discount on the invoice. Typically something like "30% off Product Name"

Subscription Product

PropertyTypeDescription
itemsList of Objects. See Tracking; Tracked Items Object for detailsIf the subscription product that generated this charge is tracking quantities, then this is the list of tracked items that contributed to the charge
idIntegerThe Fusebill generated ID of the subscription product that generated this charge
uriStringThe full string path to the subscription product which generated this charge

Purchase

PropertyTypeDescription
itemsList of Objects. See Tracking; Tracked Items Object for detailsIf the purchase that generated this charge is tracking quantities, then this is the list of tracked items that contributed to the charge
idIntegerThe Fusebill generated ID of the purchase that generated this charge
uriStringThe full string path to the purchase which generated this charge

Charge Tier

PropertyTypeDescription
labelStringThe label of the charge tier e.g. "0-3", ">3-6", ">6"
quantityDecimalHow much of the charge's quantity is portioned to this tier
unitPriceDecimalThe price per unit of quantity in this tier
amountDecimalThe amount charged for this tier. This is the quantity multiplied by the unitPrice