Financial (Cash) Discount

When a financial or cash discount is required this can be integrated in the Json body of the v1/order API.

Data to integrate when creating the invoice:

Property	Sample Value	Info
PaymentDiscountPercentage	1.5	Billit will use the percentage to calculate the discount amount.
PaymentReductionDays	8	Billit will calculate Payment Date for using the financial discount based on invoice date + the payment reduction days.

Data that can be obtained after creation of the invoice:

Property	Sample Value	Info
PaymentDiscountPercentage	1.5	Discount percentage
PaymentReductionDays	8	Number of reductionrays
PaymentDiscountAmount	6.75	The discount amount calculated by Billit
PaymentDiscountDate	2025-09-23T00:00:00	The date of payment to apply the discount

Example

{
 "OrderType": "Invoice",
 "OrderDirection": "Income",
 "OrderNumber": "QS-50001",
 "OrderDate": "2025-09-15",
 "ExpiryDate": "2025-10-30",
  "PaymentDiscountPercentage": 1.50,
  "PaymentReductionDays": 8,
  "Customer": {
   "Name": "Customer Name",
   "VATNumber": "BE0759529999",
   "PartyType": "Customer",
   "Addresses": [
        {
        "AddressType": "InvoiceAddress",
        "Name": "Customer Name",
        "Street": "Oktrooiplein",
        "StreetNumber": "1",
        "City": "Ghent",
        "Zip": "9000",
        "CountryCode": "BE"
        },
   ]
   },
 "OrderLines": [
     {
   "Quantity": 1,
   "UnitPriceExcl": 449.95,
   "Reference": "915999",
   "Description": "Box of cookies",
   "VATPercentage": 21.0,
   }
 ]
}

{
    "OrderID": 1814658,
    "CompanyID": 574991,
    "OrderNumber": "QS-50001",
    "OrderDate": "2025-09-15T00:00:00",
    "ExpiryDate": "2025-10-30T00:00:00",

     .....

    "PaymentDiscountPercentage": 1.50,
    "PaymentDiscountAmount": 6.75,
    "PaymentReductionDays": 8,
    "PaymentDiscountDate": "2025-09-23T00:00:00",

Below an example how it will be included in the UBL when it is sent via Open/Peppol

Explanation About the Content of the UBL:

Property	Sample Value	Info
1	PaymentTerms	Description about the discount generated by Billit in the language of the customer
2	AllowanceCharge	1 allowance and one charge. This allows to send the total amount of the invoice without charge, the customer can still decide whether to use the discount or not.
3	TaxSubtotal	Tax information compliant with regulations, including 0 percent for the cash discount
4	Totals	Totals include the allowance/charge of the tax discount.

Discounts

Financial (Cash) Discount

Commercial Discount