/ubl:Invoice/cac:PaymentTerms

Payment Terms

Poland | VRBL-Invoice-PL-B2B-3p0
Context ID INV0821
Usage O*

Description

Information about the terms that apply to the settlement of the invoice amount.

In Polish KSeF FA(3) transactions, the Payment Terms group serves two purposes: specifying general free-text payment terms or providing payment discount information. To provide both cases create a separate Payment Terms group for each.

Child elements
Usage Element Description Cardinality
O cbc:Note Payment Terms Note

Free-form text conveying information that is not contained explicitly in other structures.

0..n
O cbc:SettlementDiscountPercent Payment Terms Settlement Discount Percent

The percentage for the settlement discount that is offered for payment under these payment terms.

0..1
O cbc:InstallmentDueDate Payment Terms Installment Due Date

The due date for an installment payment for these payment terms.

0..1
Details

vrbl-invoice-pl-b2b-3p0

For Polish KSeF FA(3) transactions, following Payment Terms scenarios can be used.

  • Payment Terms group with free-text and Installment Due Date.
    Providing an invoice due date is mandatory.
    It can be specified either through the Installment Due Date or directly at the Document Level using the Invoice Due Date /ubl:Invoice/cbc:DueDate.
    It is recommened to use the Invoice Due Date.
    In this case the free-text element is mapped to the FA(3) element TerminOpis, which should contain a description of the payment deadline.

Example: General Payment Terms with Installment Due Date

<ubl:Invoice>
    <!-- Code omitted for clarity -->
    <cac:PaymentTerms>
        <cbc:Note>Until 09.02.2026 without discount</cbc:Note>
        <cbc:InstallmentDueDate>2026-02-09</cbc:InstallmentDueDate>
    </cac:PaymentTerms>
    <!-- Code omitted for clarity -->
</ubl:Invoice>
  • Payment Terms group providing payment discount information
    In this case a free-text and the discount percent is provided.
    In this case the free-text element is mapped to the FA(3) element WarunkiSkonta, which should contain the conditions that the purchaser must meet to benefit from the discount.

Example: Payment terms with discount percentage.

<ubl:Invoice>
    <!-- Code omitted for clarity -->
    <cac:PaymentTerms>
        <cbc:Note>Payment within 7 days from the date of invoice</cbc:Note>
        <cbc:SettlementDiscountPercent>2.00</cbc:SettlementDiscountPercent>         
    </cac:PaymentTerms>
    <!-- Code omitted for clarity -->
</ubl:Invoice>

Example: VRBL_FA3_AP-invoice-KSeF-number.xml

<ubl:Invoice>
  <!-- ... omitted for readability -->
  <cac:PaymentTerms>
    <cbc:Note>This is my payment terms note.</cbc:Note>
  </cac:PaymentTerms>
  <!-- ... omitted for readability -->
</ubl:Invoice>
Rules
Rule ID Error Message
VRBL-INV-CORE-284 The Payment Terms expects a maximum of one Payment Terms Instructions ID.
VRBL-INV-CORE-285 The Payment Terms expects a maximum of one Payment Terms Note.