PaymentTerms

Use the PaymentTerms element to model notes about the payment.

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

Name (Path)CardinalityDescription
Payment Terms Group (Invoice/PaymentTerms)0..nGroups information about the terms of payment.
Payment Terms (Invoice/PaymentTerms/Note)0..1A 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..1The discount as a percentage.
Terms Amount (Invoice/PaymentTerms/Amount)0..1The base amount for the discount.
Settlement Period End Date (Invoice/PaymentTerms/SettlementPeriod/EndDate)0..1Specify the end date, if you are using one.
Terms Installment Due Date (Invoice/PaymentTerms/SettlementPeriod/InstallmentDueDate)0..1The date any instalment is due.
Settlement Period Duration (Invoice/PaymentTerms/SettlementPeriod/DurationMeasure)0..1The length of the period for which the discount is valid.
Settlement Period Duration - Unit of Measure (Invoice/PaymentTerms/SettlementPeriod/DurationMeasure [@unitCode='D'])0..1Use 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>