Prepaid Invoice

About Prepaid

An invoice might have been prepaid : partially or completely. It is important that this information is included in the einvoice sent to the customer.

Information Element	Json tag	Example	Extra Info
Partially Paid	"To Pay"	"ToPay": 0.90	If partially paid, then do not use the element "Paid"
Fully Paid	"Paid"	"Paid": true	If fully paid, then do not use the element "ToPay"

Examples Json and Output UBL

Below examples how it is included in the Json body on header level (partially paid and fully paid)

{
    "Order" : {
            "OrderNumber": "QS-202565987", 
            "OrderType": "Invoice",
            "OrderDirection": "Income",
            "OrderDate": "2025-08-28",
            "ExpiryDate": "2025-08-28",
            "ToPay": 0.90,
            "OrderLines": [
            {
              "Quantity": 1,
              "UnitPriceExcl": 1.0,
              "Description": "my order line",
              "VATPercentage": 21.0
            }
            ],
            "Customer": {
              "Name": "TestCustomerName",
              "VATNumber": "BE0446725999",
              "PartyType": "Customer",
              "Email" : "[email protected]"
            }
    }
}

{
    "Order" : {
            "OrderNumber": "QS-202565987", 
            "OrderType": "Invoice",
            "OrderDirection": "Income",
            "OrderDate": "2025-08-28",
            "ExpiryDate": "2025-08-28",
            "Paid": true,
            "OrderLines": [
            {
              "Quantity": 1,
              "UnitPriceExcl": 1.0,
              "Description": "my order line",
              "VATPercentage": 21.0
            }
            ],
            "Customer": {
              "Name": "TestCustomerName",
              "VATNumber": "BE0446725999",
              "PartyType": "Customer",
              "Email" : "[email protected]"
            }
    }
}

What will be the result in case of the sending of a Peppol UBL, in the LegalMonetaryTotal segment:

  <cac:LegalMonetaryTotal>
    <cbc:LineExtensionAmount currencyID="EUR">1.00</cbc:LineExtensionAmount>
    <cbc:TaxExclusiveAmount currencyID="EUR">1.00</cbc:TaxExclusiveAmount>
    <cbc:TaxInclusiveAmount currencyID="EUR">1.21</cbc:TaxInclusiveAmount>
    <cbc:AllowanceTotalAmount currencyID="EUR">0</cbc:AllowanceTotalAmount>
    <cbc:ChargeTotalAmount currencyID="EUR">0</cbc:ChargeTotalAmount>
    <cbc:PrepaidAmount currencyID="EUR">0.31</cbc:PrepaidAmount>
    <cbc:PayableAmount currencyID="EUR">0.90</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>

The PrepaidAmount and the PayableAmount are adapted (calculated by Billit) accordingly.

Billit Human Readable when fully paid

When the sender does not include a PDF, then a Billit Human Readable will be generated.

Indication Paid will appear on the Human Readable when:

the amount is fully prepaid
date will be based on the Json tag ""PaidDate"

Example: