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

Additional Property

Poland | VRBL-Invoice-PL-B2B-3p0
Context ID INV0045
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
Usage Element Description Cardinality
M cbc:Name Additional Property Name 1..1
M cbc:Value Additional Property Value 1..1
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>

Example: VRBL_FA3_advance-invoice.xml

<ubl:Invoice>
  <ext:UBLExtensions>
    <ext:UBLExtension>
      <ext:ExtensionContent>
        <vrbl:InvoiceExtension>
          <!-- ... omitted for readability -->
          <vrbl:AdditionalProperty>
            <cbc:Name>wysokosć wpłaconego zadatku</cbc:Name>
            <cbc:Value>20000 zł</cbc:Value>
          </vrbl:AdditionalProperty>
          <!-- ... omitted for readability -->
        </vrbl:InvoiceExtension>
      </ext:ExtensionContent>
    </ext:UBLExtension>
  </ext:UBLExtensions>
  <!-- ... omitted for readability -->
</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.