Guides

Poland KSF: Price Details (FA(3))

You can model detailed information about prices.

Suggest Edits

You must include the Item Net Price (/Invoice/InvoiceLine/Price/PriceAmount) element.

We recommend that you also include the Item Gross Price (Invoice/InvoiceLine/Price/UBLExtensions/UBLExtension/ ExtensionContent/PriceExtension/PriceAmountBeforeAllowanceCharge) element. This represents the item's price before any allowances and charges are applied on the price level.

Elements

Use the PriceDetails element to model this information:

Name (Path)CardinalityDescription
Price Details (/Invoice/InvoiceLine/Price)1..1A group of elements providing information about the price applied for the goods and services invoiced on the invoice line.
Item Net Price (/Invoice/InvoiceLine/Price/PriceAmount)1..1The price of an item, exclusive of tax, after subtracting item price discount.
Item Price Base Quantity (/Invoice/InvoiceLine/Price/BaseQuantity)0..1The number of item units to which the price applies.
Item Price Base Quantity (/Invoice/InvoiceLine/Price/BaseQuantity @unitCode)0..1The unit of measure. Use a code from the UN/ECE Recommendation 20 with Rec 21 extension here.
Allowance (/Invoice/InvoiceLine/Price/AllowanceCharge)0..1A group of elements providing information about the allowance applied to the gross price.
Charge Indicator (/Invoice/InvoiceLine/Price/AllowanceCharge/ChargeIndicator)1..1Mandatory element. Value must be false.
Item Price Discount (/Invoice/InvoiceLine/Price/AllowanceCharge/Amount)1..1The total discount subtracted from the Item gross price to calculate the Item net price.
Item Price Discount (/Invoice/InvoiceLine/Price/AllowanceCharge/Amount @currencyID)1..1The currency. Use one of the codes from the ISO4217 list.
Item Gross Price (/Invoice/InvoiceLine/Price/AllowanceCharge/BaseAmount)0..1The unit price, exclusive of tax, before subtracting Item price discount.
Item Gross Price (/Invoice/InvoiceLine/Price/AllowanceCharge/BaseAmount @currencyID)0..1The currency. Use one of the codes from the ISO4217 list.

Use the following sub-elements of the PriceAmountBeforeAllowanceCharge (Extn) to model the item's gross price:

Name (Path)CardinalityDescription
Item Gross Price (Invoice/InvoiceLine/Price/UBLExtensions/UBLExtension/ ExtensionContent/PriceExtension/PriceAmountBeforeAllowanceCharge)0..1Price before any allowance and charges on the price level.
Item Gross Price Currency (Invoice/InvoiceLine/Price/UBLExtensions/UBLExtension/ ExtensionContent/PriceExtension/PriceAmountBeforeAllowanceCharge @currencyID)1..1Currency of the price before any allowance and charges on the price level.

Restrictions

All given amounts must use the currencyID attribute. Use currency codes from the Peppol PINT defined subset of the ISO4217 code list.

The attribute unitCode of the cbc:BaseQuantity should be coded according to the UN/ECE Recommendation 20 with Rec 21 extension code list for outgoing invoices (AR). The unit of measurement is a free-text element in the FA(3) format; therefore, we cannot guarantee any coded values for incoming invoices (AP).

Examples

No price allowance and charge, Item Gross Price equals Item Net Price


<ubl:Invoice>
    <!-- Code omitted for clarity -->
    <cac:InvoiceLine>
        <!-- Code omitted for clarity -->
        <cac:Price>
            <!-- Code omitted for clarity -->
            <cec:UBLExtensions>
                <cec:UBLExtension>
                    <cec:ExtensionContent>
                        <vrbl:PriceExtension>
                            <!-- Item Gross Price -->
                            <vrbl:PriceAmountBeforeAllowanceCharge currencyID="PLN">1000</vrbl:PriceAmountBeforeAllowanceCharge>
                        </vrbl:PriceExtension>                            
                    </cec:ExtensionContent>
                </cec:UBLExtension>
            </cec:UBLExtensions>
            <cbc:PriceAmount currencyID="PLN">1000</cbc:PriceAmount>
        </cac:Price>
    </cac:InvoiceLine>
</ubl:Invoice>

Allowance on price level

The Invoice Line Net Amount is calculated by the Item Net Price (cbc:PriceAmount) multiplied by the Invoiced Quantity (cbc:InvoicedQuantity).


<ubl:Invoice>
    <!-- code omitted for clarity -->
    <cac:InvoiceLine>
        <!-- code omitted for clarity -->
        <cbc:InvoicedQuantity unitCode="H87">2</cbc:InvoicedQuantity>
        <cbc:LineExtensionAmount currencyID="PLN">1600.00</cbc:LineExtensionAmount>
        <!-- code omitted for clarity -->
        <cac:Price>
            <!-- Code omitted for clarity -->
            <cec:UBLExtensions>
                <cec:UBLExtension>
                    <cec:ExtensionContent>
                        <vrbl:PriceExtension>
                            <!-- Item Gross Price -->
                            <vrbl:PriceAmountBeforeAllowanceCharge currencyID="PLN">1000.00</vrbl:PriceAmountBeforeAllowanceCharge>
                        </vrbl:PriceExtension>                            
                    </cec:ExtensionContent>
                </cec:UBLExtension>
            </cec:UBLExtensions>
            <cbc:PriceAmount currencyID="EUR">800.00</cbc:PriceAmount>
            <cbc:BaseQuantity unitCode="H87">1.00</cbc:Value>
            <cac:AllowanceCharge>
                <cbc:ChargeIndicator>false</cbc:ChargeIndicator>                
                <cbc:Amount currencyID="EUR">200.00</cbc:Amount>
                <cbc:BaseAmount currencyID="EUR">1000.00</cbc:BaseAmount>
            </cac:AllowanceCharge>
        </cac:Price>
        <!-- code omitted for clarity -->
    </cac:InvoiceLine>
</ubl:Invoice>

Updated about 10 hours ago