/ubl:Invoice/cac:LegalMonetaryTotal

Legal Monetary Total Group

Context ID INV1115
Cardinality 1..1
Usage M

Description

The total amount payable on the Invoice, including Allowances, Charges, and Taxes.

A group of business terms providing the monetary totals for the Invoice.

For Polish KSeF FA(3) invoices see below for document totals examples.

Child elements

Cardinality Usage Description Element
0..1 - Legal Monetary Total Extensions Group cec:UBLExtensions
0..1 M Legal Monetary Total Line Extension Amount
The monetary amount of an extended transaction line, net of tax and settlement discounts, but inclusive of any applicable rounding amount. 		cbc:LineExtensionAmount
0..1 M Legal Monetary Total Tax Exclusive Amount
The monetary amount of an extended transaction line, exclusive of taxes. 		cbc:TaxExclusiveAmount
0..1 M Legal Monetary Total Tax Inclusive Amount
The monetary amount including taxes; the sum of payable amount and prepaid amount. 		cbc:TaxInclusiveAmount
0..1 O Legal Monetary Total Prepaid Amount
The total prepaid monetary amount. 		cbc:PrepaidAmount
0..1 O Legal Monetary Total Payable Rounding Amount
The rounding amount (positive or negative) added to produce the line extension amount. 		cbc:PayableRoundingAmount
1..1 M Legal Monetary Total Payable Amount
The amount of the monetary total to be paid. 		cbc:PayableAmount

Details

vrbl-invoice-pl-b2b-3p0

Example containing allowance after tax on document level:

Element Name Calculation
Ⓐ Total Invoice Amount Invoice Total Amount With Tax - Allowance Total Amount After Tax + Charge Total Amount After Tax
vrbl:TotalInvoiceAmount cbc:TaxInclusiveAmount - vrbl:AllowanceTotalAmountAfterTax + vrbl:ChargeTotalAmountAfterTax 
    <ubl:Invoice>
        <!-- code omitted for clarity -->
        <cac:AllowanceCharge>
            <cec:UBLExtensions>
                <cec:UBLExtension>
                    <cec:ExtensionContent>
                        <vrbl:AllowanceChargeExtension>
                            <vrbl:AfterTaxIndicator>true</vrbl:AfterTaxIndicator>
                        </vrbl:AllowanceChargeExtension>
                    </cec:ExtensionContent>
                </cec:UBLExtension>
            </cec:UBLExtensions>
            <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
            <!-- Mandatory Allowance Charge Reason. -->
            <cbc:AllowanceChargeReason>Settlement of a balance (buyer paid too much)</cbc:AllowanceChargeReason>
            <cbc:Amount currencyID="PLN">1000.00</cbc:Amount>
        </cac:AllowanceCharge>
        <!-- code omitted for clarity -->
        <cac:TaxTotal>
            <cbc:TaxAmount currencyID="PLN">12019.82</cbc:TaxAmount>
            <!-- code omitted for clarity -->
        </cac:TaxTotal>
        <!-- code omitted for clarity -->
        <cac:LegalMonetaryTotal>
            <ext:UBLExtensions>
                <ext:UBLExtension>
                    <ext:ExtensionContent>
                        <vrbl:LegalMonetaryTotalExtension>
                            <vrbl:AllowanceTotalAmountAfterTax currencyID="PLN">1000</vrbl:AllowanceTotalAmountAfterTax>
                            <vrbl:ChargeTotalAmountAfterTax currencyID="PLN">0</vrbl:ChargeTotalAmountAfterTax>
                            <vrbl:TotalInvoiceAmount currencyID="PLN">63279.92</vrbl:TotalInvoiceAmount> Ⓐ
                        </vrbl:LegalMonetaryTotalExtension>
                    </ext:ExtensionContent>
                </ext:UBLExtension>
            </ext:UBLExtensions>
            <cbc:LineExtensionAmount currencyID="PLN">52260.10</cbc:LineExtensionAmount>
            <cbc:TaxExclusiveAmount currencyID="PLN">52260.10</cbc:TaxExclusiveAmount>
            <cbc:TaxInclusiveAmount currencyID="PLN">64279.92</cbc:TaxInclusiveAmount>
            <cbc:PayableAmount currencyID="PLN">63279.92</cbc:PayableAmount>
        </cac:LegalMonetaryTotal>
        <!-- code omitted for clarity -->
    <ubl:Invoice>

Example containing prepaid amounts and indicating that the invoice is not fully paid yet:

Element Name Calculation
Ⓐ Amount Due for Payment When the Fully Paid Indicator is false: Total Invoice Amount - Sum of all Prepaid Amounts
cbc:PayableAmount if vrbl:FullyPaidIndicator = false then vrbl:TotalInvoiceAmount - ∑(/ubl:InvoiceLine/cac:PrepaidPayment/cbc:PaidAmount) 
<ubl:Invoice>
    <ext:UBLExtensions>
        <ext:UBLExtension>
            <ext:ExtensionContent>
                <!-- code omitted for clarity -->
                <vrbl:InvoiceExtension>
                    <!-- indicates that the invoice is not fully paid. -->
                    <vrbl:FullyPaidIndicator>false</vrbl:FullyPaidIndicator>
                </vrbl:InvoiceExtension>
                <!-- code omitted for clarity -->
            </ext:ExtensionContent>
        </ext:UBLExtension>
    </ext:UBLExtensions>
    <!-- code omitted for clarity -->
    <cac:PrepaidPayment>
        <!-- code omitted for clarity -->
        <!-- Prepaid Amount 1 -->
        <cbc:PaidAmount currencyID="PLN">10000.00</cbc:PaidAmount>
        <cbc:PaidDate>2026-01-27</cbc:PaidDate>
    </cac:PrepaidPayment>
    <cac:PrepaidPayment>
        <!-- code omitted for clarity -->
        <!-- Prepaid Amount 1 -->
        <cbc:PaidAmount currencyID="PLN">20000.00</cbc:PaidAmount>
        <cbc:PaidDate>2026-01-28</cbc:PaidDate>
    </cac:PrepaidPayment>
    <!-- code omitted for clarity -->
    <cac:LegalMonetaryTotal>
        <ext:UBLExtensions>
            <ext:UBLExtension>
                <ext:ExtensionContent>
                    <vrbl:LegalMonetaryTotalExtension>
                        <vrbl:TotalInvoiceAmount currencyID="PLN">64279.92</vrbl:TotalInvoiceAmount>
                    </vrbl:LegalMonetaryTotalExtension>
                </ext:ExtensionContent>
            </ext:UBLExtension>
        </ext:UBLExtensions>
        <cbc:LineExtensionAmount currencyID="PLN">52260.10</cbc:LineExtensionAmount>
        <cbc:TaxExclusiveAmount currencyID="PLN">52260.10</cbc:TaxExclusiveAmount>
        <cbc:TaxInclusiveAmount currencyID="PLN">64279.92</cbc:TaxInclusiveAmount>
        <cbc:PrepaidAmount currencyID="PLN">30000.00</cbc:PrepaidAmount> Ⓑ
        <cbc:PayableAmount currencyID="PLN">34279.92</cbc:PayableAmount> Ⓐ
    </cac:LegalMonetaryTotal>
    <!-- code omitted for clarity -->
<ubl:Invoice>

Example indicating that the invoice was fully paid:

Element Name Calculation
Ⓐ Amount Due for Payment cbc:PayableAmount When the Fully Paid Indicator is true then the Payable Amount is zero.
cbc:PayableAmount if vrbl:FullyPaidIndicator = true then cbc:PayableAmount = 0.00
Ⓑ Paid Amount cbc:PrepaidAmount When the Fully Paid Indicator is true then the Paid Amount is equal to the Total Invoice Amount.
cbc:PrepaidAmount if vrbl:FullyPaidIndicator = true then cbc:PrepaidAmount = vrbl:TotalInvoiceAmount 
<ubl:Invoice>
    <ext:UBLExtensions>
        <ext:UBLExtension>
            <ext:ExtensionContent>
                <!-- code omitted for clarity -->
                <vrbl:InvoiceExtension>
                    <vrbl:FullyPaidIndicator>true</vrbl:FullyPaidIndicator>
                </vrbl:InvoiceExtension>
                <!-- code omitted for clarity -->
            </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 -->
    <cac:LegalMonetaryTotal>
        <ext:UBLExtensions>
            <ext:UBLExtension>
                <ext:ExtensionContent>
                    <vrbl:LegalMonetaryTotalExtension>
                        <vrbl:TotalInvoiceAmount currencyID="PLN">64279.92</vrbl:TotalInvoiceAmount>
                    </vrbl:LegalMonetaryTotalExtension>
                </ext:ExtensionContent>
            </ext:UBLExtension>
        </ext:UBLExtensions>
        <cbc:LineExtensionAmount currencyID="PLN">52260.10</cbc:LineExtensionAmount>
        <cbc:TaxExclusiveAmount currencyID="PLN">52260.10</cbc:TaxExclusiveAmount>
        <cbc:TaxInclusiveAmount currencyID="PLN">64279.92</cbc:TaxInclusiveAmount>
        <cbc:PrepaidAmount currencyID="PLN">64279.92</cbc:PrepaidAmount>
        <cbc:PayableAmount currencyID="PLN">0.00</cbc:PayableAmount>
    </cac:LegalMonetaryTotal>
    <!-- code omitted for clarity -->
    <ubl:Invoice>

Rules

Rule ID Error Message
VRBL-INV-PL-B2B-3-74 If the Allowance Group exists, the Legal Monetary Total Allowance Total Amount After Tax must exist within the Legal Monetary Total Group.
VRBL-INV-PL-B2B-3-75 If the Charge Group exists, the Legal Monetary Total Charge Total Amount After Tax must exist within the Legal Monetary Total Group.