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

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.

Commercial Discount

On the invoice line:

you can mention a the line net price (no indication of commercial discount)
you can include discount information (if customer wants to know the discount details)

Data that can be obtained after creation of the invoice:

Property	Sample Value	Info
DiscountPercentage	25	Discount percentage

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": 14,
              "UnitPriceExcl": 2.23,
              "Description": "my order line1",
              "ReductionPercentage": 25,  // % commercial discount
              "VATPercentage": 21.0
            }
            ],
}

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	ChargeIndicator	false : it is a discount
2	AllowanceChargeReason	fixed text set by Billit : allowance
3	Amount	Total amount of the line discount, calculated by Billit based on ReductionPercentage