Discounts

View as Markdown

Discounts are optional and applied at the billing term level. They reduce the amount on every invoice or revenue schedule that the term generates.

TypeCSV field valueAmount formatExampleOn a $500 invoice
PERCENTAGEPERCENTAGEDecimal (0.2 = 20%)0.2500500 − 100 = $400
FIXEDFIXEDDollar amount3500500 − 3 = $497

The discount object

On create/update, pass a nested discount object:

  • type Optional: PERCENTAGE or FIXED. Omit for no discount.
  • amount Required (when discount is set): For PERCENTAGE: decimal where 0.20 = 20%. For FIXED: the dollar amount to subtract.
  • note Optional: Label shown on the invoice, e.g. “Early payment discount.”

On read, the billing term response returns discounts as an array: discounts: DiscountDto[].

Percentage format: 20% off = 0.2, not 20. 10% off = 0.1. Do not enter a percent sign or a whole number.