/ubl:Invoice/cac:PrepaidPayment

Prepaid Payment Group

Context ID INV0844
Cardinality 0..n
Usage O

Description

A prepaid payment.

A group providing information about prepayments.

In Polish KSeF FA(3) transactions the Prepaid Payment group can be used to indicate prepayments. Information about prepayments impacts the Amount Due For Payment cbc:PayableAmount provided in the Document Totals

Child elements

Cardinality Usage Description Element
0..1 - Prepaid Payment Paid Amount
The amount of this payment. 		cbc:PaidAmount

Details

vrbl-invoice-pl-b2b-3p0

Depending on the business scenario different elements must be provided.

Example: Full invoice amount was already prepaid

In this case the the group must contain only the Paid Date cbc:PaidDate which indicates the date when the invoice was fully paid. Additionally the Fully Paid Indicator vrbl:FullyPaidIndicator on the document level invoice extension must be set to true.

<ubl:Invoice>
    <ext:UBLExtensions>
        <ext:UBLExtension>
            <ext:ExtensionContent>
                <vrbl:InvoiceExtension>
                    <!-- Indicates that the invoice was fully paid -->
                    <vrbl:FullyPaidIndicator>true</vrbl:FullyPaidIndicator>
                </vrbl:InvoiceExtension>
            </ext:ExtensionContent>
        </ext:UBLExtension>
    </ext:UBLExtensions>
    <!-- Code omitted for clarity -->
    <cac:PrepaidPayment>
        <cbc:PaidDate>2026-01-27</cbc:PaidDate>
    </cac:PrepaidPayment>
    <!-- Code omitted for clarity -->
</ubl:Invoice>

Example: Fully paid invoice amount indicating multiple payments with payment details

In this case, nextto the Paid Date cbc:PaidDate, also the Paid Amount cbc:PaidAmount and the Prepayment Payment Means Type Code cbc:PaymentMeansCode must be provided. For more information on the allowed codes check the Payment Means Type Code section on document level. The Fully Paid Indicator vrbl:FullyPaidIndicator on the document level invoice extension must be set to true.

<ubl:Invoice>
    <ext:UBLExtensions>
        <ext:UBLExtension>
            <ext:ExtensionContent>
                <vrbl:InvoiceExtension>
                    <!-- Code omitted for clarity -->
                    <!-- Indicates that the invoice was fully paid -->
                    <vrbl:FullyPaidIndicator>true</vrbl:FullyPaidIndicator>
                    <!-- Code omitted for clarity -->
                </vrbl:InvoiceExtension>
            </ext:ExtensionContent>
        </ext:UBLExtension>
    </ext:UBLExtensions>
    <!-- Code omitted for clarity -->
    <cac:PrepaidPayment>
        <ext:UBLExtensions>
            <ext:UBLExtension>
                <ext:ExtensionContent>
                    <vrbl:PrepaidPaymentExtension>
                        <cac:PaymentMeans>
                            <!-- Indicates the type of payment -->
                            <cbc:PaymentMeansCode>VRBL:PL:01</cbc:PaymentMeansCode>
                        </cac:PaymentMeans>
                    </vrbl:PrepaidPaymentExtension>
                </ext:ExtensionContent>
            </ext:UBLExtension>
        </ext:UBLExtensions>
        <cbc:PaidAmount currencyID="PLN">10000</cbc:PaidAmount>
        <cbc:PaidDate>2026-01-27</cbc:PaidDate>
    </cac:PrepaidPayment>
    <cac:PrepaidPayment>
        <ext:UBLExtensions>
            <ext:UBLExtension>
                <ext:ExtensionContent>
                    <vrbl:PrepaidPaymentExtension>
                        <cac:PaymentMeans>
                            <!-- Indicates the type of payment -->
                            <cbc:PaymentMeansCode>VRBL:PL:01</cbc:PaymentMeansCode>
                        </cac:PaymentMeans>
                    </vrbl:PrepaidPaymentExtension>
                </ext:ExtensionContent>
            </ext:UBLExtension>
        </ext:UBLExtensions>
        <cbc:PaidAmount currencyID="PLN">20000</cbc:PaidAmount>
        <cbc:PaidDate>2026-02-14</cbc:PaidDate>
    </cac:PrepaidPayment>
    <!-- Code omitted for clarity -->
</ubl:Invoice>

Example: Partially paid invoice amount indicating multiple payments with payment details

In this case, nextto the Paid Date cbc:PaidDate, also the Paid Amount cbc:PaidAmount and the Prepayment Payment Means Type Code cbc:PaymentMeansCode must be provided. For more information on the allowed codes check the Payment Means Type Code section on document level. The Fully Paid Indicator extension on document level must be set to false or can be omitted since it defaults to false if not provided.

<ubl:Invoice>
    <ext:UBLExtensions>
        <ext:UBLExtension>
            <ext:ExtensionContent>
                <vrbl:InvoiceExtension>
                    <!-- Code omitted for clarity -->
                    <!-- Indicates that the invoice was only paid partially -->
                    <vrbl:FullyPaidIndicator>false</vrbl:FullyPaidIndicator>
                    <!-- Code omitted for clarity -->
                </vrbl:InvoiceExtension>
            </ext:ExtensionContent>
        </ext:UBLExtension>
    </ext:UBLExtensions>
    <!-- Code omitted for clarity -->
    <cac:PrepaidPayment>
        <ext:UBLExtensions>
            <ext:UBLExtension>
                <ext:ExtensionContent>
                    <vrbl:PrepaidPaymentExtension>
                        <cac:PaymentMeans>
                            <cbc:PaymentMeansCode>VRBL:PL:01</cbc:PaymentMeansCode>
                        </cac:PaymentMeans>
                    </vrbl:PrepaidPaymentExtension>
                </ext:ExtensionContent>
            </ext:UBLExtension>
        </ext:UBLExtensions>
        <cbc:PaidAmount currencyID="PLN">10000</cbc:PaidAmount>
        <cbc:PaidDate>2026-01-27</cbc:PaidDate>
    </cac:PrepaidPayment>
    <cac:PrepaidPayment>
        <ext:UBLExtensions>
            <ext:UBLExtension>
                <ext:ExtensionContent>
                    <vrbl:PrepaidPaymentExtension>
                        <cac:PaymentMeans>
                            <cbc:PaymentMeansCode>VRBL:PL:01</cbc:PaymentMeansCode>
                        </cac:PaymentMeans>
                    </vrbl:PrepaidPaymentExtension>
                </ext:ExtensionContent>
            </ext:UBLExtension>
        </ext:UBLExtensions>
        <cbc:PaidAmount currencyID="PLN">20000</cbc:PaidAmount>
        <cbc:PaidDate>2026-02-14</cbc:PaidDate>
    </cac:PrepaidPayment>
    <!-- Code omitted for clarity -->
</ubl:Invoice>