For example, you may want to specify a settlement end date or add a note to explain the conditions of payment to a document.

One use case for this is to model validity ranges for discounts. These discounts can have an end date, or you can specify the time range for which they are valid. The approach can vary depending on country requirements and other factors.

Elements

Use the PaymentTerms element to model this information.

Name (Path)	Cardinality	Description
Payment Terms Group (`Invoice/PaymentTerms`)	0..n	Groups information about the terms of payment.
Payment Terms (`Invoice/PaymentTerms/Note`)	0..1	A textual description of the payment terms that apply to the amount due for payment (Including description of possible penalties).
Percentage Discount (`Invoice/PaymentTerms/SettlementDiscountPercent`)	0..1	The discount as a percentage.
Terms Amount (`Invoice/PaymentTerms/Amount`)	0..1	The base amount for the discount.
Settlement Period End Date (`Invoice/PaymentTerms/SettlementPeriod/EndDate`)	0..1	Specify the end date, if you are using one.
Terms Installment Due Date (`Invoice/PaymentTerms/SettlementPeriod/InstallmentDueDate`)	0..1	The date any instalment is due.
Settlement Period Duration (`Invoice/PaymentTerms/SettlementPeriod/DurationMeasure`)	0..1	The length of the period for which the discount is valid.
Settlement Period Duration - Unit of Measure (`Invoice/PaymentTerms/SettlementPeriod/DurationMeasure [@unitCode='D']`)	0..1	Use this attribute to specify the units of the period, for example, use `D` for days.

Country-Specific Topics

Examples

<Invoice>
    <!-- code omitted for clarity -->
    <cac:PaymentTerms>
        <cbc:Note>Payment within 10 days, 2% discount</cbc:Note>
        <cbc:Amount>3000.00</cbc:Amount>
        <cbc:InstallmentDueDate>2024-11-01</cbc:InstallmentDueDate>
    </cac:PaymentTerms>
    <!-- code omitted for clarity -->
</Invoice>

End Date

The following example shows an end date for Italy:

<ubl:Invoice>
    <!-- Code omitted for clarity -->
    <cac:PaymentTerms>
        <!-- Code omitted for clarity -->
        <cac:SettlementPeriod>
            <cbc:EndDate>2024-06-10</cbc:EndDate>
        </cac:SettlementPeriod>
        <!-- Code omitted for clarity -->
    </cac:PaymentTerms>
    <!-- Code omitted for clarity -->
</ubl:Invoice>

Date Range

The following example shows a period of 30 days during which the discount is valid.


<ubl:Invoice>
    <!-- Code omitted for clarity -->
    <cac:PaymentTerms>
        <cbc:Note>Pay within 10 days and get a discount of 2% of the payable amount</cbc:Note>
        <cbc:SettlementDiscountPercent>2.00</cbc:SettlementDiscountPercent>
        <cbc:Amount currencyID="EUR">1000.00</cbc:Amount>
        <cac:SettlementPeriod>
            <cbc:DurationMeasure unitCode="D">30</cbc:DurationMeasure>
        </cac:SettlementPeriod>
    </cac:PaymentTerms>
    <!-- Code omitted for clarity -->
</ubl:Invoice>