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 (POST):

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 (GET)

Property	Sample Value	Info
PaymentDiscountPercentage	1.5	Discount percentage
PaymentReductionDays	8	Number of reduction days
PaymentDiscountAmount	6.75	The discount amount calculated by Billit
PaymentDiscountDate	2025-09-23	The date of payment to apply the discount
ExpiryDate	2025-10-15	This is the normal due date if the customer does not use the financial discount

Remarks / LImitations:

This method for cash discount can only be used when posting discount percentage and payment reduction days. You cannot post an amount.
The calculation method is applicable for tax situation in Belgium.

If this limitation is not applicable, then apply the methods explained in the following pages.

Example of Json body while Posting and Feedback when you perform a GET.

{
 "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

Specific fields in 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.