/ubl:Invoice/cec:UBLExtensions/cec:UBLExtension/cec:ExtensionContent/vrbl:InvoiceExtension/vrbl:AdditionalProperty

Additional Property

Context ID	INV0045
Cardinality	0..n
Usage	O*

Description

A group of key-value pairs that provides additional invoice information.

In Polish KSeF FA(3) invoicing, this group provides additional properties as key/value pairs at the invoice document level. It can be used for any additional data which is not covered by the scope of the structure.

Child elements

Cardinality	Usage	Description	Element
1..1	M	Additional Property Name	`cbc:Name`
1..1	M	Additional Property Value	`cbc:Value`

Details

vrbl-invoice-pl-b2b-3p0

A specific use case for the Polish KSeF FA(3) is the Article 109 sec. 3d Indicator:

Article 109 sec. 3d Indicator

In Polish KSeF FA(3) invoicing if your document refers to Art. 109 sec. 3d (FP flag) then you can either use the Invoice Type Code cbc:InvoiceTypeCode 751 or you can specify it by using an Additional Property. This usage is required if you want to apply the flag to a Correction-, Advanced Payment-, Final- or Self-Billing invoice.

To use the Additional Propery provide the following key value pair:

Element	Name	Value
`cbc:Name`	Key	`VBRL:PL:FP`
`cbc:Value`	Value	`true`

Example:

<ubl:Invoice>
    <cec:UBLExtensions>
        <cec:UBLExtension>
            <cec:ExtensionContent>
                <vrbl:InvoiceExtension>
                    <!-- Key/value pair on document level -->
                    <vrbl:AdditionalProperty>
                        <cbc:Name>VRBL:PL:FP</cbc:Name>
                        <cbc:Value>true</cbc:Value>
                    </vrbl:AdditionalProperty>
                    <!-- code omitted for clarity -->
                </vrbl:InvoiceExtension>
            </cec:ExtensionContent>
        </cec:UBLExtension>
    </cec:UBLExtensions>
    <!-- code omitted for clarity -->
</ubl:Invoice>

Rules

Rule ID	Error Message
VRBL-INV-PL-B2B-3-131	The Additional Property Name must be provided in the Additional Property.
VRBL-INV-PL-B2B-3-132	The Additional Property Value must be provided in the Additional Property.