/ubl:Invoice/cac:AllowanceCharge[string(cbc:ChargeIndicator) = 'true']

Charge Group

Context ID	INV0902
Cardinality	0..n
Usage	O*

Description

A discount or charge that applies to a price component.

A group of business terms providing information about charges and taxes other than tax, applicable to the Invoice as a whole.

In the KSeF FA(3) format this group is used to report Charges after tax.

Child elements

Cardinality	Usage	Description	Element
0..1	-	Charge Extensions Group	`cec:UBLExtensions`
1..1	M	Charge Indicator An indicator that this AllowanceCharge describes a charge (true) or a discount (false).	`cbc:ChargeIndicator`
0..n	O	Charge Reason The reason for this allowance or charge.	`cbc:AllowanceChargeReason`
1..1	M	Charge Amount The monetary amount of this allowance or charge to be applied.	`cbc:Amount`

Details

vrbl-invoice-pl-b2b-3p0

Important: * Charges before tax: In the KSeF FA(3) format there is no representation for Charges before taxes on the document level. For outgoing AR invoices, if provided in the VRBL format, this Charges will be represented as an additional invoice line. It is recommended that the invoice issuer already creates the invoice using invoice lines to represent document Charges instead of the Document Level Allowance and Charge group. The After Tax Indicator vrbl:AfterTaxIndicator can be omitted, since it defaults to false.

Charges after tax: In the KSeF FA(3) format only Charges after taxes can be provided on the document level. They can be represented in the document level Allowance and Charge group and must be flagged with the After Tax Indicator vrbl:AfterTaxIndicator set to true. Looking at the invoice totals /ubl:Invoice/cac:LegalMonetaryTotal, the specified allowance or charge amount shows the difference between the Invoice Total Tax Inclusive Amount cbc:TaxInclusiveAmount and the Total Invoice Amount vrbl:TotalInvoiceAmount. When providing Charges after tax it is mandatory to provide the Document Level Allowance/Charge Reason cbc:AllowanceChargeReason. Additionally it is required to provide the total of the Charges after tax in vrbl:ChargeTotalAmountAfterTax. Also the Total Invoice Amount vrbl:TotalInvoiceAmount has to be provided. See the respective sections for more information.

Example indicating Charges before tax: In this case, in the final format a new invoice line will be added, therefore also the tax information is required. The Invoiced Quantity will be set to 1. In case of an allowance the invoice line net amount will be negative.

<ubl:Invoice>
    <!-- code omitted for clarity -->
    <!-- vrbl:AfterTaxIndicator can be omitted, defaults to false -->
    <cac:AllowanceCharge>
        <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
        <cbc:AllowanceChargeReason>Production error discount</cbc:AllowanceChargeReason>
        <cbc:Amount currencyID="PLN">20000.00</cbc:Amount>
        <cac:TaxCategory>
            <cbc:ID>VRBL:PL:01</cbc:ID>
            <cbc:Percent>23</cbc:Percent>
            <cac:TaxScheme>
                <cbc:ID>VAT</cbc:ID>
            </cac:TaxScheme>
        </cac:TaxCategory>
    </cac:AllowanceCharge>
    <!-- code omitted for clarity -->
</ubl:Invoice>

Example indicating Charges after tax. It is mandatory to provide the Allowance Charge Reason.

<ubl:Invoice>
    <!-- code omitted for clarity -->
    <cac:AllowanceCharge>
        <cec:UBLExtensions>
            <cec:UBLExtension>
                <cec:ExtensionContent>
                    <vrbl:AllowanceChargeExtension>
                        <!-- Indicates that allowance is applied after tax -->
                        <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:LegalMonetaryTotal>
        <ext:UBLExtensions>
            <ext:UBLExtension>
                <ext:ExtensionContent>
                    <vrbl:LegalMonetaryTotalExtension>
                        <vrbl:AllowanceTotalAmountAfterTax currencyID="PLN">1000.00</vrbl:AllowanceTotalAmountAfterTax>
                        <vrbl:ChargeTotalAmountAfterTax currencyID="PLN">0.00</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>

Rules

Rule ID	Error Message
VRBL-INV-CORE-320	The Charge Group expects a maximum of one Charge Reason.