KSeF REST API – generating invoices
description of attributes for the operation ksefInvoiceGenerate
ksefInvoiceGenerate
A method that allows you to generate an XML structured invoice that is compliant with the current (up-to-date) version of the schema used in National e-Invoice System.
Figure: ksefInvoiceGenerateKsefInvoiceGenerateRequest
The class represents input attributes describing the KSeF invoice
Invoice
VAT invoice
heading : TNaglowek – Structured invoice header.
The attribute value must match TNeader.
subject1 : Entity1 – Taxpayer details. Name and surname or name of the seller of goods or services.
The attribute value must match Subject1.
subject2 : Entity2 – Buyer details.
The attribute value must match Subject2.
subject3 : Entity3 – Details of the third party/ies (other than the seller and buyer listed in the Entity2 section) associated with the invoice.
The attribute value must match Subject3. (Maintenance: [0..100])
entityAuthorized : Authorized Entity – Details of the authorized entity related to the invoice.
The attribute value must match Authorized Entity. (Required: [0..1])
fa : Fa – Based on art. 106a – 106q of the Act. Fields concerning sales value and tax are filled in in the currency in which the invoice was issued, except for fields concerning tax converted in accordance with the provisions of Section VI in connection with art. 106e sec. 11 of the Act. In the event of issuing a correction invoice, all fields are filled in according to the state after correction, and fields concerning tax base, tax and total receivables are filled in by the difference.
The attribute value must match Fa.
footer : Footer – Footer of the invoice. Other data on the invoice.
The attribute value must match Footer. (Required: [0..1])
KsefInvoiceGenerateResponse
The class represents the response returned by the operation ksefInvoiceGenerate, which contains a generated KSeF invoice compliant with the schema applicable in KSeF.
TextXmlContent
The class represents a KSeF Invoice or an Official Receipt Confirmation (UPO) in XML format
description : string – = Invoice or UPO.
Invoice
Drawing: InvoiceFormCode
Form template symbol.
SystemCode
System code
VersionSchema
XSD schema version.
TNeader
Heading
FormCode : TKodFormularza – Form template symbol. The attribute value must be consistent with TKodForm.
FormVariant : Integer – Number defining the form variant
dateofproductionFa : DateTime – Date and time of invoice creation
systemInfo : String – Name of the IT system used by the taxpayer
TKodForm
TKodForm
FormCode : KodFormularza – Form code of the structured invoice. The value must be consistent with the Enumeration FormCode.
codeSystem : KodSystemowy – System code of the structured invoice. The value must be consistent with the Enumeration SystemCode.
versionSchema : SchemaVersion – Schema version. The value must match the Enumeration VersionSchema.
Fa
Based on art. 106a – 106q of the Act. Fields concerning sales value and tax are filled in in the currency in which the invoice was issued, except for fields concerning tax converted in accordance with the provisions of Section VI in connection with art. 106e sec. 11 of the Act. In the event of issuing a correction invoice, all fields are filled in according to the state after correction, and fields concerning tax base, tax and total receivables are filled in by the difference.
Attention! Attributes P_13_1, P_14_1 and P_14_1W completed when the invoice contains a sale covered by the basic rate – currently 23% or 22%, excluding the margin procedure.
Attention! Attributes P_13_2, P_14_2 and P_14_2W completed in the event of a sale covered by the first reduced rate on the invoice – currently 8 % or 7%, excluding the margin procedure.
Attention! Attributes P_13_3, P_14_3 and P_14_3W completed in the event of a sale covered by the second reduced rate on the invoice – currently 5%, excluding the margin procedure.
Attention! Attributes P_13_4, P_14_4 and P_14_4W completed in the event of a sale covered by the third reduced rate – flat-rate for passenger taxis – on the invoice.
Attention! Attributes P_13_5, P_14_5, P_13_6_1, P_13_6_2, P_13_6_3, P_13_7, P_13_8, P_13_9, P_13_10, P_13_11, P_15 completed in the event of the occurrence on the invoice of sales under the special procedure referred to in section XII, chapter 6a of the Act.
codeCurrencies : TKodWalury – Three-letter currency code (ISO 4217).
The attribute value must match TKodCurrency.
P_1 : Date – Date of issue of the invoice, subject to Article 106na paragraph 1 of the Act.
P_1M : String – Invoice issue location. (Required: [0..1])
P_2 : String – A sequential invoice number, assigned within one or more series, that uniquely identifies the invoice.
WZ : List – Numbers of warehouse documents WZ (issue outside) related to the invoice (Maturity: [0..1000])
P_13_1 : Double – Sum of net sales value with basic rate – currently 23% or 22%. In case of advance payment invoices, net advance payment amount. In case of correction invoices, difference amount referred to in art. 106j sec. 2 item 5 of the Act.
P_14_1 : Double – Tax amount from the sum of the net sales value covered by the basic rate – currently 23% or 22%. In the case of advance payment invoices, the tax amount calculated according to the formula referred to in art. 106f sec. 1 item 3 of the Act. In the case of correction invoices, the difference amount referred to in art. 106j sec. 2 item 5 of the Act.
P_14_1W : Double – If the invoice is issued in a foreign currency, the amount of tax from the sum of the net sales value covered by the basic rate, converted in accordance with the provisions of Section VI in connection with art. 106e sec. 11 of the Act – currently 23% or 22%. In the case of advance payment invoices, the amount of tax calculated according to the formula referred to in art. 106f sec. 1 item 3 of the Act. In the case of correction invoices, the amount of the difference referred to in art. 106j sec. 2 item 5 of the Act. (Mayor: [0..1])
P_13_2 : Double – The sum of the net sales value covered by the first reduced rate – currently 8 % or 7%. In the case of advance payment invoices, the net advance payment amount. In the case of correction invoices, the difference amount referred to in art. 106j sec. 2 item 5 of the Act
P_14_2 : Double – Tax amount from the sum of the net sales value covered by the first reduced rate – currently 8% or 7%. In the case of advance payment invoices, the tax amount calculated according to the formula referred to in art. 106f sec. 1 item 3 of the Act. In the case of correction invoices, the difference amount referred to in art. 106j sec. 2 item 5 of the Act.
P_14_2W : Double – If the invoice is issued in a foreign currency, the amount of tax from the sum of the net sales value covered by the reduced rate, converted in accordance with the provisions of Section VI in connection with art. 106e sec. 11 of the Act – currently 8% or 7%. In the case of advance payment invoices, the amount of tax calculated according to the formula referred to in art. 106f sec. 1 item 3 of the Act. In the case of correction invoices, the amount of the difference referred to in art. 106j sec. 2 item 5 of the Act. (Mayor: [0..1])
P_13_3 : Double – The sum of the net sales value covered by the second reduced rate – currently 5%. In the case of advance payment invoices, the net advance payment amount. In the case of correction invoices, the difference amount referred to in art. 106j sec. 2 item 5 of the Act.
P_14_3 : Double – Tax amount from the sum of the net sales value covered by the second reduced rate – currently 5%. In the case of advance payment invoices, the tax amount calculated according to the formula referred to in art. 106f sec. 1 item 3 of the Act. In the case of correction invoices, the difference amount referred to in art. 106j sec. 2 item 5 of the Act.
P_14_3W : Double – If the invoice is issued in a foreign currency, the amount of tax from the sum of the net sales value covered by the second reduced rate, converted in accordance with the provisions of Section VI in connection with art. 106e sec. 11 of the Act – currently 5%. In the case of advance payment invoices, the amount of tax calculated according to the formula referred to in art. 106f sec. 1 item 3 of the Act. In the case of correction invoices, the amount of the difference referred to in art. 106j sec. 2 item 5 of the Act. (Mayor: [0..1])
P_13_4 : Double – The sum of the net sales value covered by the flat-rate tax for passenger taxis. In the case of advance payment invoices, the net advance payment amount. In the case of correction invoices, the difference amount referred to in art. 106j sec. 2 item 5 of the Act
P_14_4 : Double – Tax amount from the sum of the net sales value in the case of a flat-rate tax for passenger taxis. In the case of advance payment invoices, the tax amount calculated according to the formula referred to in art. 106f sec. 1 item 3 of the Act. In the case of correction invoices, the difference amount referred to in art. 106j sec. 2 item 5 of the Act.
P_14_4W : Double – If the invoice is issued in a foreign currency, the amount of the flat-rate tax for passenger taxis, converted in accordance with the provisions of Section VI in connection with art. 106e sec. 11 of the Act. In the case of advance payment invoices, the amount of tax calculated according to the formula referred to in art. 106f sec. 1 item 3 of the Act. In the case of correction invoices, the amount of the difference referred to in art. 106j sec. 2 item 5 of the Act. (Maturity: [0..1])
P_13_5 : Double – The sum of the net sales value in the case of the special procedure referred to in Section XII in Chapter 6a of the Act. In the case of advance payment invoices, the net advance payment amount. In the case of correction invoices, the difference amount referred to in Article 106j paragraph 2 item 5 of the Act.
P_14_5 : Double – Amount of value added tax in the case of the special scheme referred to in section XII in chapter 6a of the Act. In the case of advance payment invoices, the amount of tax calculated according to the formula referred to in art. 106f sec. 1 item 3 of the Act. In the case of correction invoices, the amount of the difference referred to in art. 106j sec. 2 item 5 of the Act.
P_13_6_1 : Double – The sum of the value of sales covered by the 0% rate, excluding intra-Community supplies of goods and exports. In the case of advance payment invoices, the advance payment amount. In the case of correction invoices, the difference amount referred to in art. 106j sec. 2 item 5 of the Act.
P_13_6_2 : Double – The sum of the sales value covered by the 0% rate in the case of intra-Community supply of goods. In the case of correction invoices, the amount of the difference referred to in art. 106j sec. 2 item 5 of the Act.
P_13_6_3 : Double – The sum of the sales value covered by the 0% rate in the case of export. In the case of advance payment invoices, the advance payment amount. In the case of correction invoices, the difference amount referred to in art. 106j sec. 2 item 5 of the Act.
P_13_7 : Double – The sum of the value of sales exempt from tax. In the case of advance payment invoices, the amount of the advance payment. In the case of correction invoices, the amount of the difference in the value of sales.
P_13_8 : Double – The sum of the sales value in the case of delivery of goods and provision of services outside the country, excluding the amounts shown in fields P_13_5 and P_13_9. In the case of advance payment invoices, the advance payment amount. In the case of correction invoices, the amount of the difference in the sales value.
P_13_9 : Double – The sum of the value of the provision of services referred to in art. 100 sec. 1 item 4 of the Act. In the case of advance payment invoices, the advance payment amount. In the case of correction invoices, the amount of the difference in the sales value.
P_13_10 : Double – The sum of the value of sales in the reverse charge procedure, for which the taxpayer is the purchaser in accordance with art. 17 sec. 1 points 7 and 8 of the Act and other cases of reverse charge occurring in domestic trade. In the case of advance payment invoices, the amount of the advance payment. In the case of correction invoices, the amount of the difference referred to in art. 106j sec. 2 point 5 of the Act.
P_13_11 : Double – The sum of the sales value in the margin procedure referred to in Article 119 and Article 120 of the Act. In the case of advance payment invoices, the advance payment amount. In the case of correction invoices, the amount of the difference in the sales value.
P_15 : Double – Total amount due. In the case of advance payment invoices, the payment amount documented by the invoice. In the case of invoices referred to in art. 106f sec. 3 of the Act, the amount remaining to be paid. In the case of correction invoices, correction of the amount resulting from the corrected invoice. In the case referred to in art. 106j sec. 3 of the Act, correction of the amounts resulting from the corrected invoices.
exchange rateCurrencyZ : Double – Currency exchange rate used to calculate the tax amount in cases referred to in the provisions of Part VI of the Act on invoices referred to in Art. 106b sec. 1 item 4 of the Act.
annotations : Annotations – Other annotations on the invoice.
The attribute value must match Annotations.
type of invoice : TRodajInvoices – Invoice type:
The attribute value must match Type of Invoice.
causeCorrections : String – Reason for correction for correction invoices. (Maintenance: [0..1])
typeCorrections : Integer – The type of the effect of the correction in the records for the goods and services tax.
The attribute value must match CorrectionType. (Required: [0..1])
dataFaCorrected : CorrectedInvoiceData – Corrected invoice data.
The attribute value must match DataFaCorrected. (Required: [0..*])
periodFaCorrected : String – For a correction invoice referred to in art. 106j sec. 3 of the Act – the period to which the discount or reduction granted applies, in the case where the taxpayer grants a discount or price reduction in relation to deliveries of goods or services made or provided to one recipient in a given period. (Majority: [0..1])
nrFaCorrected : String – Correct number of the corrected invoice in case the reason for the correction is an incorrect number of the corrected invoice. In such a case, the incorrect invoice number should be indicated in the field noFaCorrected. (Required: [0..1])
subject1K : Entity1K – In case of correction of seller's data, provide full seller's data appearing on the corrected invoice. The field does not apply in case of correction of incorrect NIP appearing on the original invoice – then correction of the invoice to zero values is required.
The attribute value must match Subject1K. (Required: [0..1])
entity2K : Entity2K – In the event of correction of the data of the buyer appearing as Entity2 or an additional buyer appearing as Entity3, the full data of this entity appearing on the corrected invoice should be provided. Incorrect numbers identifying the buyer and additional buyer are not subject to correction. In the event of correction of the remaining data of the buyer or additional buyer, the indicated identification number should be identical to the number in the Entity2 or Entity3 part of the correcting invoice.
The attribute value must match Entity2K. (Maintenance: [0..101])
P_15ZK : Double – In the case of corrections to advance payment invoices, the amount of payment before correction. In the case of corrections to invoices referred to in art. 106f sec. 3 of the Act, the amount remaining to be paid before correction. (Duty: [0..1])
exchange rateCurrencyZK : Double – Currency exchange rate used to calculate the tax amount in cases referred to in Section VI of the Act before correction. (Mayor: [0..1])
advancePartial : Partial Advance – Data for invoices documenting the receipt of more than one payment, as referred to in art. 106b sec. 1 item 4 of the Act. In the event that the invoice referred to in art. 106f sec. 3 of the Act also documents the receipt of part of the payment before the action is performed, the difference in the amount in the field P_15 and the sums of the individual fields P_15Z is the amount remaining above the payments received before the activity documented by the invoice is performed.
The attribute value must match Advance paymentPartial. (Maintenance: [0..31])
FP : Integer – Invoice referred to in Article 109 section 3d of the Act. (Maturity: [0..1])
TP : Integer – Existing links between the purchaser and the supplier of goods or services, in accordance with § 10 section 4 item 3, subject to section 4b of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax. (Majority: [0..1])
additionalDescription : TKluczWartosc – Fields intended for displaying additional data on the invoice, including that required by law, for which other fields/elements are not provided.
The attribute value must match TKeyValue. (Mayor: [0..10000])
invoiceAdvance payment : Advance Invoice – Advance invoice numbers or their KSeF numbers, if they were issued using KSeF.
The attribute value must match InvoiceAdvance payment. (Maintenance: [0..100])
Excise Duty Refund : Integer – Additional information required for farmers applying for a refund of excise tax included in the price of diesel oil. (Majority: [0..1])
faVersion : FaWiersz – Detailed invoice items in the currency in which the invoice was issued – optional node for an advance payment invoice, an invoice correcting an advance payment invoice, and correction invoices concerning all deliveries of goods or services made or provided in a given period, referred to in art. 106j sec. 3 of the Act, for which data on the discount or reduction should be provided, broken down by tax rate and procedure in part Fa. In the case of correction invoices referred to in art. 106j sec. 3 of the Act, when the discount or price reduction refers to part of the deliveries of goods or services made or provided in a given period, the FaWiersz part should provide the names (types) of goods or services covered by the correction. In the case of invoices referred to in art. 106f sec. 3 of the Act, the full values of the order or contract should be provided. In the case of invoices correcting invoice items (including invoices correcting invoices referred to in art. 106f sec. 3 of the Act, if the correction concerns the value of the order), differences resulting from the correction of individual items or data of corrected items in the state before and after the correction should be shown as separate lines. In the case of invoices correcting invoices referred to in art. 106f sec. 3 of the Act, if the correction does not concern the value of the order and at the same time changes the amount of the tax base or tax, an entry should be made according to the state before the correction and an entry in the state after the correction in order to confirm that the value of a given invoice item has not changed.
The attribute value must match FaVersh. (Mayor: [0..10000])
reckoning : Settlement – Additional settlements on the invoice.
The attribute value must match Reckoning. (Required: [0..1])
payment : Payment – Payment Terms.
The attribute value must match Payment.
Transaction Terms : TransactionTerms – The terms of the transaction, if any.
The attribute value must match TransactionTerms.
order : Order – Order or agreement referred to in art. 106f sec. 1 item 4 of the Act (for advance payment invoices) in the currency in which the advance payment invoice was issued. In the case of an invoice correcting an advance payment invoice, differences resulting from the correction of individual items of the order or agreement or data of corrected items in the state before and after correction should be shown as separate lines, if the correction concerns the value of the order or agreement. In the case of invoices correcting advance payment invoices, if the correction does not concern the value of the order or agreement and at the same time changes the amount of the tax base or tax, an entry should be made according to the state before correction and an entry in the state after correction in order to confirm that the value of a given item has not changed.
The attribute value must match Order.
P_6 : Date – Date of delivery or completion of delivery of goods or provision of services or date of receipt of payment, referred to in art. 106b sec. 1 item 4 of the Act, provided that such date is specified and is different from the invoice issue date. The field is completed when the date is common for all invoice items. (Required: [0..1])
periodFa : PeriodFa – The period to which the invoice relates in the cases referred to in art. 19a sec. 3 first sentence and sec. 4 and sec. 5 item 4 of the Act.
The attribute value must match PeriodFa.
Subject1
Taxpayer details. Name and surname or name of the seller (invoice issuer) of goods or services
Taxpayer prefix : TKodyKrajowUE – EU VAT taxpayer code (prefix) for cases specified in art. 97 sec. 10 points 2 and 3 of the Act and in the case referred to in art. 136 sec. 1 point 3 of the Act.
By default, this is the taxpayer code from Poland, i.e. "PL". The attribute value must be consistent with TKodiCodesCountryEU. = PL (Required: [0..1])
noEORI : String – EORI number of the taxpayer (seller, invoice issuer) (Maintenance: [0..1])
Identification data : TPodmiot1 – Identification data of the taxpayer issuing the invoice. The attribute value must be consistent with Subject1.
address : TAddress – Address of the taxpayer issuing the invoice.
The attribute value must match TAddress.
addressCorrespondence : TAddress – Correspondence address of the taxpayer issuing the invoice. The attribute value must be consistent with TAddress. (Required: [0..1])
contactdata : Contact Data – A set of contact details of the taxpayer (phone, e-mail) issuing the invoice. The attribute value must be consistent with Contact Details. (Maintenance: [0..3])
TaxpayerInfo status : Integer – Status of the taxpayer issuing the invoice (Maintenance: [0..1])
Subject2
Buyer details
noEORI : String – EORI number of the buyer of the goods (Required: [0..1])
Identification data : TPodmiot2 – Data identifying the buyer.
The attribute value must match Subject2.
address : TAddress – Buyer's address. Optional fields for cases specified in art. 106e sec. 5 item 3 of the Act.
The attribute value must match TAddress.
addressCorrespondence : TAddress – Buyer's correspondence address.
The attribute value must match TAddress. (Required: [0..1])
contactdata : Contact Details – Buyer's contact details.
The attribute value must match Contact Details. (Maintenance: [0..3])
CustomerNo. : String – Customer number for cases where the buyer uses it in the contract or order (Required: [0..1])
Buyer ID : String – Unique key for linking buyer data on correction invoices, in case the buyer data on the correction invoice has changed in relation to the data on the corrected invoice. (Required: [0..1])
Subject3
Details of the third party/ies (other than the seller and buyer listed in the Entity2 section) associated with the invoice
Buyer ID : String – Unique key for linking buyer data on correction invoices, in case the buyer data on the correction invoice has changed in relation to the data on the corrected invoice. (Required: [0..1])
noEORI : String – EORI number of the third party (Required: [0..1])
Identification data : TPodmiot3 – Data identifying the third party. The attribute value must be consistent with Subject3.
address : TAddress – Third party address. The attribute value must match TAddress.
addressCorrespondence : TAddress – Third party correspondence address. The attribute value must be consistent with TAddress. (Required: [0..1])
contactdata : ContactData – Contact details of the third party. The attribute value must be consistent with Contact Details. (Maintenance: [0..3])
role : Integer – The role of the entity.
The attribute value must match EntityTroll3. Attribute required unless there is another entity role (roleOther). Then this attribute shouldn't be filled in. (Required: [0..1])
roleOther : Integer – Other entity tag: 1 – Other entity. The attribute should only be filled in if there is a different role than those defined for the attribute role (i.e. a role other than the one mentioned in EntityTroll3) (Required: [0..1])
descriptionRoli : String – Description of the entity role – in case of selecting the role as Other entity. Attribute required only and exclusively in case of filling in the attribute roleOther. (Required: [0..1])
participation : Double – Share – percentage share of the additional buyer. The difference between the value of 100% and the sum of the shares of additional buyers is the share of the buyer listed in the Entity2 section. If the field is not filled in, it is assumed that the shares of the buyers appearing on the invoice are equal (Maintenance: [0..1])
CustomerNo. : String – Customer number for cases where the entity listed as a third party uses it in the contract or order (Required: [0..1])
Authorized Entity
Details of the authorized entity related to the invoice
noEORI : String – EORI number of the authorized entity. (Required: [0..1])
Identification data : TPodmiot1 – Identification data of the authorized entity.
The attribute value must match Subject1.
address : TAddress – Address of the authorized entity.
The attribute value must match TAddress.
addressCorrespondence : TAddress – Correspondence address of the authorized entity.
The attribute value must match TAddress. (Required: [0..1])
contactdata : PUContactData – Contact details of the authorized entity.
The attribute value must match Contact Details. (Maintenance: [0..3])
rolePU : Integer – Role of the authorized entity.
The attribute value must match Authorized EntityTrolley.
Footer
Other data on the invoice.
information : Information - Other data. (Required: [0..3])
registers : Registers – Numbers of an entity or group of entities in other registers and databases. (Required: [0..100])
Information
Other data.
footerInvoices : String – Invoice footer. (Required: [0..1])
Registers
Entity or group of entities numbers in other registers and databases
fullName : String – Full name of entity (Required: [0..1])
KRS : String – National Court Register Number (Majority: [0..1])
REGON : String – REGON number. (Required: [0..1])
BDO : String – Number in the Waste Database (Required: [0..1])
Fa
Drawing: FaAnnotations
Other notes on the invoice
P_16 : Integer – In the case of delivery of goods or provision of services in respect of which the tax liability arises in accordance with art. 19a sec. 5 item 1 or art. 21 sec. 1 of the Act – the words "cash method", the value "1" should be provided; otherwise – the value "2".
P_17 : Integer – In the case of invoices referred to in art. 106d sec. 1 of the Act – the word “self-invoicing”, the value “1” should be provided; otherwise – the value “2”
P_18 : Integer – In the case of delivery of goods or provision of services for which the purchaser of the goods or services is obliged to settle value added tax or a tax of a similar nature – the words "reverse charge", the value "1" should be provided, otherwise - the value "2".
P_18A : Integer – In the case of invoices in which the total amount due exceeds PLN 15,000 or its equivalent expressed in a foreign currency, covering the delivery of goods or the provision of services to the taxpayer, referred to in Annex No. 15 to the Act – the words "split payment mechanism", and the conversion rules for amounts expressed in a foreign currency used to determine the tax base shall apply to the conversion of amounts into PLN; value "1" should be provided, otherwise - value "2".
sick leave : Exemption – A set of attributes informing about possible tax exemptions.
The attribute value must match Sick leave.
newMeans of transport : NoweSrodkiTransportu – A set of attributes describing new means of transport.
The attribute value must match NewMeansofTransport.
P_23 : Integer – In the case of invoices issued under the simplified procedure by the second taxpayer referred to in art. 135 sec. 1 item 4 letters b and c and sec. 2, containing the annotation referred to in art. 136 sec. 1 item 1 and the statement referred to in art. 136 sec. 1 item 2 of the Act, value "1" should be provided, otherwise - value "2".
pmarists : PMarzy – Marker for the occurrence of margin procedures.
The attribute value must match PMars.
Type of Invoice
Invoice type.
REGRET : – Advance payment invoice. An invoice documenting the receipt of payment or part thereof before the performance of an activity and an invoice issued in connection with Article 106f paragraph 4 of the Act.
PINK : – Settlement invoice. Invoice issued in connection with Article 106f paragraph 3 of the Act.
UPR : – Simplified invoice. Invoice referred to in art. 106e sec. 5 item 3 of the Act.
KOR_ZAL : – Correction of an advance payment invoice. An invoice correcting an invoice documenting the receipt of payment or part thereof before the action is performed and an invoice issued in connection with Article 106f paragraph 4 of the Act.
KOR_ROZ : – Correction of a settlement invoice. Invoice correcting an invoice issued in connection with Article 106f paragraph 3 of the Act.
CorrectionType
Type of correction effect in the records for goods and services tax
1 : Integer – Correction effective on the date the original invoice was recorded.
2 : Integer – Correction effective on the date of issuing the corrective invoice.
3 : Integer – Correction effective on a different date, including when these dates are different for different items of the corrective invoice.
DataFaCorrected
Corrected invoice details.
CorrectedOccurrence date : Date – Date of issuing the corrected invoice
noFaCorrected : String – Corrected invoice number.
nrKSeF : Integer – KSeF number marker of the corrected invoice.
CorrectedNo.KSeFFa : String – Number identifying the invoice being corrected in KSeF.
Attribute value verified by regular expression:
([1-9]((\d[1-9])|([1-9]\d))\d{7}|M\d{9}|[AZ]{3}\d{7})-(20[2-9][0-9]|2[1-9][0-9]{2}|[3-9][0 -9]{3})(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])-([0-9A-F]{6})-?([0-9A-F]{6})-([0-9A-F]{2})
nrKSeFN : Integer – Tag of a corrected invoice issued outside KSeF
Subject1K
In the case of correction of the seller's data, the full seller's data appearing on the corrected invoice must be provided. The field does not apply in the case of correction of an incorrect NIP appearing on the original invoice - then the invoice correction to zero values is required
Taxpayer prefix : TKodyKrajowUE – EU VAT taxpayer code (prefix) for cases specified in art. 97 sec. 10 points 2 and 3 of the Act and in the case referred to in art. 136 sec. 1 point 3 of the Act.
Identification data : TEntity1 – Data identifying the taxpayer.
The attribute value must match Subject1.
address : TAddress – Taxpayer's address.
The attribute value must match TAddress.
Entity2K
In the event of correction of the data of the buyer appearing as Entity2 or an additional buyer appearing as Entity3, the full data of this entity appearing on the corrected invoice must be provided. Incorrect numbers identifying the buyer and the additional buyer are not subject to correction. In the event of correction of the remaining data of the buyer or the additional buyer, the indicated identification number must be identical to the number in the Entity2 or Entity3 part of the corrective invoice.
Identification data : TPodmiot2 – Data identifying the buyer.
The attribute value must match Subject2.
address : TAddress – Buyer's address. Optional fields for cases specified in art. 106e sec. 5 item 3 of the Act.
The attribute value must match TAddress. (Required: [0..1])
Buyer ID : String – Unique key for linking buyer data on correction invoices, in case the buyer data on the correction invoice has changed in relation to the data on the corrected invoice. (Required: [0..1])
Advance paymentPartial
Data for cases of invoices documenting the receipt of more than one payment, referred to in art. 106b sec. 1 item 4 of the Act. In the event that the invoice referred to in art. 106f sec. 3 of the Act also documents the receipt of part of the payment before the action is performed, the difference between the amount in field P_15 and the sum of the individual fields P_15Z constitutes the amount remaining over and above the payments received before the action documented by the invoice is performed.
P_6Z : DateTime – Date of receipt of payment referred to in Article 106b section 1 point 4 of the Act.
P_15Z : Double – Payment amount referred to in art. 106b sec. 1 item 4 of the Act, making up the amount in field P_15. In the case of correction invoices, correction of the amount resulting from the corrected invoice.
exchange rateCurrencyZW : Double – Currency exchange rate used to calculate the tax amount in cases referred to in Section VI of the Act. (Mayor: [0..1])
TKeyValue
Composite type, key-value.
Fields intended for showing additional data on the invoice, including those required by law, for which no other fields/elements are provided
no.of line : Integer – Row number given in the NrWierszaFa or NrWierszaZam field, if the information refers only to a given invoice item. (Required: [0..1])
InvoiceAdvance payment
Advance payment invoice numbers or their KSeF numbers, if they were issued using KSeF.
The class should be filled with either an attribute invoiceAdvance paymentNo., or invoiceAdvance paymentNo.KSeF. Both attributes cannot appear at the same time.
invoiceAdvance paymentNo. : InvoiceAdvanceNo – The attribute value must be consistent with InvoiceAdvance paymentNo.. (Required: [0..1])
invoiceAdvance paymentNo.KSeF : InvoiceAdvanceNrKSeF – The attribute value must be consistent with InvoiceAdvance paymentNo.KSeF. (Required: [0..1])
InvoiceAdvance paymentNo.
Advance payment invoice number issued outside KSeF
nrKSeFZN : Integer – Tag of an advance payment invoice issued outside KSeF.
no.FaZalikcyjne : String – Number of the advance payment invoice issued outside KSeF. Mandatory field for an invoice issued after the delivery of goods or the provision of a service, referred to in art. 106f sec. 3 of the Act and the last of the invoices, referred to in art. 106f sec. 4 of the Act.
InvoiceAdvance paymentNo.KSeF
Advance payment invoice number issued using KSeF.
no.KSeFFaZalikcyjne : String – Number identifying the advance payment invoice in KSeF. Mandatory field if the advance payment invoice was issued using KSeF.
FaVersh
Detailed invoice items in the currency in which the invoice was issued – optional node for an advance payment invoice, an invoice correcting an advance payment invoice, and correction invoices concerning all deliveries of goods or services made or provided in a given period, referred to in art. 106j sec. 3 of the Act, for which data on the discount or reduction should be provided, broken down by tax rate and procedure in part Fa. In the case of correction invoices referred to in art. 106j sec. 3 of the Act, when the discount or price reduction refers to part of the deliveries of goods or services made or provided in a given period, the names (types) of goods or services covered by the correction should be provided in the FaWiersz part. In the case of invoices referred to in art. 106f sec. 3 of the Act, the full values of the order or contract should be provided. In the case of invoices correcting invoice items (including invoices correcting invoices referred to in art. 106f sec. 3 of the Act, if the correction concerns the value of the order), differences resulting from the correction of individual items or data of corrected items in the state before and after the correction should be shown as separate lines. In the case of invoices correcting invoices referred to in art. 106f sec. 3 of the Act, if the correction does not concern the value of the order and at the same time changes the amount of the tax base or tax, an entry should be made according to the state before the correction and an entry in the state after the correction in order to confirm that the value of a given invoice item has not changed.
no.ofPoemFa : Integer – Sequential invoice line number.
UU_ID : String – Universal unique invoice line number (Maintenance: [0..1])
P_6A : Date – Date of delivery or completion of delivery of goods or services or date of receipt of payment, referred to in art. 106b sec. 1 item 4 of the Act, if such date is specified and is different from the invoice issue date. The field is completed in the case when different dates occur for individual invoice items. (Required: [0..1])
P_7 : String – Name (type) of goods or services. Optional field only for the case specified in art. 106j sec. 3 item 2 of the Act (correction invoice) (Majority: [0..1])
index : String – Field intended for entering the internal code of the product or service assigned by the taxpayer or an additional description (Required: [0..1])
GTIN : String – Global trade item number. (Required: [0..1])
pkWiU : String – Symbol of the Polish Classification of Products and Services. (Required: [0..1])
CN : String – Combined Nomenclature Symbol. (Required: [0..1])
PKOB : String – Symbol of the Polish Classification of Construction Objects. (Required: [0..1])
P_8A : String – Measure of goods delivered or scope of services performed. Optional field for the case specified in art. 106e sec. 5 item 3 of the Act. (Required: [0..1])
P_8B : Double – Quantity (number) of delivered goods or scope of services provided. Optional field for the case specified in art. 106e sec. 5 item 3 of the Act. (Required: [0..1])
P_9A : Double – Unit price of the product or service without the tax amount (net unit price). Optional field for cases specified in art. 106e sec. 2 and 3 and sec. 5 item 3 of the Act (Majority: [0..1])
P_9B : Double – Price with tax amount (gross unit price), in case of application of art. 106e sec. 7 and 8 of the Act. (Mayor: [0..1])
P_10 : Double – Amounts of any discounts or price reductions, including in the form of a discount for early payment, unless they have been included in the net unit price, and in the case of application of art. 106e sec. 7 of the Act, in the gross unit price. Optional field for cases specified in art. 106e sec. 2 and 3 and sec. 5 item 1 of the Act. (Required: [0..1])
P_11 : Double – Value of delivered goods or services covered by the transaction, excluding the tax amount (net sales value). Optional field for cases specified in art. 106e sec. 2 and 3 and sec. 5 item 3 of the Act. (Required: [0..1])
P_11A : Double – Gross sales value, in case of application of Article 106e paragraphs 7 and 8 of the Act. (Majority: [0..1])
p11Vat : Double – Tax amount in the case referred to in Article 106e paragraph 10 of the Act. (Mayor: [0..1])
P_12 : TStawkaPodatku – Tax rate. Optional field for cases specified in art. 106e sec. 2, 3, sec. 4 point 3 and sec. 5 point 3 of the Act. (Required: [0..1])
P_12_XII : Double – Value added tax rate in the case referred to in section XII in chapter 6a of the Act. (Mayor: [0..1])
p12Zal15 : Integer – Marker for goods or services listed in Annex No. 15 to the Act – value "1". (Required: [0..1])
amountExcise duty : Double – The amount of excise tax included in the price of the goods. (Mayor: [0..1])
GTU : TGTU – Designation for the delivery of goods and services.
The attribute value must match TGTU. (Required: [0..1])
procedure : TOProceduredesignation – Designation relating to a procedure.
The attribute value must match TOmarkProcedures. (Required: [0..1])
exchange rateCurrencies : Double – Currency exchange rate used to calculate the tax amount in cases referred to in Section VI of the Act (Mayor: [0..1])
stateBefore : Integer – Pre-correction status marker in the case of a correction invoice or an invoice correcting an invoice issued in connection with art. 106f sec. 3 of the Act, in the case where the correction concerns data shown in invoice items and is made in a way that shows the data before and after correction as separate lines with separate numbering and in the case of confirming the lack of change in the value of a given item (Required: [0..1])
Reckoning
Additional settlements on invoice.
The class should be filled with either an attribute toPayment, or toSettlement. Both attributes cannot appear at the same time.
The attribute value must match Loads. (Maintenance: [0..100])
totalLoad : Double – Total of charges. (Duration: [0..1])
deductions : Deductions – Deductions.
The attribute value must match Deductions. (Maintenance: [0..100])
sumDeductions : Double – Sum of deductions (Maturity: [0..1])
toPayment : Double – The amount of the payment due equal to the field P_15 increased by Loads and reduced by Deductions. (Required: [0..1])
toSettlement : Double – Overpaid amount to be settled/refunded. (Duration: [0..1])
Payment
Payment Terms.
paid : Integer – A tag indicating that the amount due from the invoice has been paid: 1 – paid
Payment date : Date – Date of payment, if payment has been made before the invoice was issued.
partialpaymenttag : Integer – A tag informing that the amount due from the invoice has been paid in part: 1 – paid in part.
paymentPartial : PartialPayment – Partial payment details.
The attribute value must match PartialPayment. (Due date: [1..100])
PaymentTerm : PaymentTerm – Payment deadline.
The attribute value must match PaymentDate. (Maintenance: [0..100])
formPayments : Integer – Payment method.
The attribute value must match PaymentForm.
paymentOther : Integer – Other payment method tag: 1 – other payment method.
descriptionPayments : String – Specification of another form of payment.
bankaccount : BankTransaction – Bank account details.
The attribute value must match Bankaccount. (Maintenance: [0..100])
BankFactorAccount : TRachunekBankowy – Factor's bank account details.
The attribute value must match Bankaccount. (Due: [0..20])
discount : Discount – Discount.
The attribute value must match Discount.
TransactionTerms
Terms of the transaction, if any.
contracts : Contracts – Data describing the contract.
The attribute value must match Agreements. (Maintenance: [0..100])
orders : Orders – Data describing the order.
The attribute value must match Orders. (Maintenance: [0..100])
ProductBatchNo : List – Product batch numbers (Required: [0..1])
delivery terms : String – Terms of delivery of goods – in the event that there is an agreement between the parties to the transaction specifying the terms of delivery, the so-called Incoterms.
courseConventional : Double – Conventional rate – in cases where the invoice contains information on the rate at which the amounts shown on the invoice in PLN were converted. Does not apply to cases referred to in Section VI of the Act. (Maturity: [0..1])
currencyConventional : TKodWaluty – Conventional currency – three-letter currency code (ISO-4217) in cases where the invoice contains information on the exchange rate at which the amounts shown on the invoice in zloty were converted. Does not apply to cases referred to in Section VI of the Act.
The attribute value must match TKodCurrency.
transport : Transport – Data describing the transport used during delivery.
The attribute value must match Transport. (Due: [0..20])
entityIntermediary : Integer – Value "1" means a delivery made by an entity referred to in art. 22 sec. 2d of the Act. The field concerns the case in which the entity participates in a chain transaction other than the simplified triangular procedure referred to in art. 135 sec. 1 item 4 of the Act. (Required: [0..1])
Order
Order or agreement referred to in art. 106f sec. 1 item 4 of the Act (for advance payment invoices) in the currency in which the advance payment invoice was issued. In the case of an invoice correcting an advance payment invoice, differences resulting from the correction of individual items of the order or agreement or data of corrected items in the state before and after correction should be shown as separate lines, if the correction concerns the value of the order or agreement. In the case of invoices correcting advance payment invoices, if the correction does not concern the value of the order or agreement and at the same time changes the amount of the tax base or tax, an entry should be made according to the state before correction and an entry in the state after correction in order to confirm that the value of the given item has not changed.
valueOrders : Double – Value of the order or contract including the tax amount.
orderPoem : OrderLine – Detailed items of the order or contract in the currency in which the advance payment invoice was issued.
The attribute value must match OrderLine. = new ArrayList<>() (Required: [1..10000])
PeriodFa
The period to which the invoice relates in the cases referred to in Art. 19a sec. 3 first sentence and sec. 4 and sec. 5 item 4 of the Act.
p6From : java.time.LocalDate – The start date of the period to which the invoice applies.
p6To : java.time.LocalDate – The end date of the period to which the invoice relates – the date of delivery or completion of the delivery of goods or provision of services.
Annotations
Drawing: AnnotationsAnnotations
Class Description Annotations.
NewMeansofTransport
The class should be filled with either an attribute from NewMeansofTransportNone, or attributes from NewTransportationType. Both attributes cannot appear at the same time.
newTransportationNo : New Means of TransportNone – No new means of transport in the delivery.
The attribute value must match NewMeansofTransportNone. (Required: [0..1])
newTransportationType : NewMeansofTransportType – Type of new means of transport in the delivery.
The attribute value must match NewTransportationType. (Required: [0..1])
NewMeansofTransportNone
The class informs about the absence of a new means of transport in the delivery.
P_22N : Integer – Flag of the lack of intra-Community delivery of new means of transport.
NewTransportationType
The class informs about the type of new means of transport in the delivery.
P_22 : Integer – Intra-Community delivery of new means of transport tag.
P_42_5 : Integer – If there is an obligation referred to in Article 42, paragraph 5 of the Act, the value "1" should be entered, otherwise – the value "2".
newMeansofTransport : NewTransportMeans – Attribute describing a new means of transport.
The attribute value must match NewMeansofTransport. (Duration: [1..10000])
NewMeansofTransport
The class describes a new means of transportation.
P_22A : Date – Date of approval of the new means of transport for use.
pLineNrNST : Integer – Invoice line number showing the delivery of a new means of transport.
P_22BMK : String – Brand of the new means of transport (Required: [0..1])
P_22BMD : String – Model of the new means of transport. (Required: [0..1])
P_22BK : String – Color of the new means of transport (Required: [0..1])
P_22BNR : String – Registration number of the new means of transport. (Required: [0..1])
P_22BRP : String – Year of production of the new means of transport. (Required: [0..1])
P_22B : String – If the delivery concerns land vehicles referred to in art. 2 point 10 letter a of the Act – the mileage of the vehicle should be provided.
P_22B1 : String – If the delivery concerns land vehicles referred to in art. 2 item 10 letter a of the Act – the VIN number can be provided. (Required: [0..1])
P_22B2 : String – If the delivery concerns land vehicles referred to in art. 2 point 10 letter a of the Act – the chassis number can be provided (Required: [0..1])
P_22B3 : String – If the delivery concerns land vehicles referred to in art. 2 point 10 letter a of the Act – the chassis number can be provided (Required: [0..1])
P_22B4 : String – If the delivery concerns land vehicles referred to in art. 2 item 10 letter a of the Act – the frame number can be provided. (Required: [0..1])
P_22BT : String – If the delivery concerns land vehicles referred to in art. 2 point 10 letter a of the Act – the type of new means of transport can be specified (Required: [0..1])
P_22C : String – If the delivery concerns vessels referred to in art. 2 point 10 letter b of the Act, the number of working hours of use of the new means of transport should be provided.
P_22C1 : String – If the delivery concerns vessels referred to in art. 2 item 10 letter b of the Act, the hull number of the new means of transport may be provided. (Required: [0..1])
P_22D : String – If the delivery concerns aircraft referred to in art. 2 point 10 letter c of the Act, the number of working hours of use of the new means of transport should be entered.
P_22D1 : String – If the delivery concerns aircraft referred to in art. 2 point 10 letter c of the Act, the serial number of the new means of transport may be provided.
PMars
Class describing the margin procedure.
P_PMarzy : Integer – Flag of the occurrence of margin procedures referred to in Article 119 or Article 120 of the Act.
P_PMarzy_2 : Integer – Marker of the provision of tourism services for which the tax base is the margin, in accordance with art. 119 sec. 1 of the Act, and the invoice documenting the provision contains the words "margin procedure for travel agencies"
P_PMarzy_3_1 : Integer – Marker of the delivery of used goods for which the tax base is the margin, in accordance with Art. 120 of the Act, and the invoice documenting the delivery contains the words "margin procedure – used goods".
P_PMarzy_3_2 : Integer – Marker of the delivery of works of art for which the tax base is the margin, in accordance with art. 120 of the Act, and the invoice documenting the delivery contains the words "margin procedure - works of art"
P_PMarzy_3_3 : Integer – Marker of the delivery of collectors' items and antiques, for which the tax base is the margin, in accordance with Art. 120 of the Act, and the invoice documenting the delivery contains the words "margin procedure - collectors' items and antiques".
P_PMarzyN : Integer – Marker of the absence of margin procedures referred to in Article 119 or Article 120 of the Act.
Sick leave
The class should be filled with either an attribute from ExemptionNone, or attributes from ExemptionType. Both attributes cannot appear at the same time.
exemptionNone : ExemptionNone – Attribute filled in if there is no tax exemption.
The attribute value must match ExemptionNone. (Required: [0..1])
releaseType : ExemptionType – Attribute filled in in the event of a tax exemption.
The attribute value must match ExemptionType. (Required: [0..1])
ExemptionNone
No tax exemption.
P_19N : Integer – Identifier of the lack of delivery of goods or provision of services exempt from tax under Article 43 sec. 1, Article 113 sec. 1 and 9 of the Act or regulations issued under Article 82 sec. 3 of the Act or under other regulations.
ExemptionType
Tax exemption
P_19 : Integer – Marker of the delivery of goods or provision of services exempt from tax under Article 43 sec. 1, Article 113 sec. 1 and 9 or regulations issued under Article 82 sec. 3 of the Act or under other regulations.
P_19A : String – If the field P_19 equals "1" – indicate the provision of the Act or an act issued pursuant to the Act, on the basis of which the taxpayer applies tax exemption.
P_19B : String – If the field P_19 equals "1" – the provision of Directive 2006/112/EC which exempts such a supply of goods or services from tax should be indicated.
P_19C : String – If the field P_19 equals "1" – another legal basis should be indicated indicating that the delivery of goods or provision of services is exempt from tax.
FaVersh
Drawing: FaWiersz
TGTU
Designation relating to the delivery of goods and the provision of services.
value : String
GTU_01 : – Delivery of goods referred to in § 10 section 3 point 1 letter a of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax.
GTU_02 : – Delivery of goods referred to in § 10 section 3 point 1 letter b of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_03 : – Delivery of goods referred to in § 10 section 3 point 1 letter c of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_04 : – Delivery of goods referred to in § 10 section 3 point 1 letter d of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_05 : – Delivery of goods referred to in § 10 section 3 point 1 letter e of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_06 : – Delivery of goods referred to in § 10 section 3 point 1 letter f of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_07 : – Delivery of goods referred to in § 10 section 3 point 1 letter g of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_08 : – Delivery of goods referred to in § 10 section 3 point 1 letter h of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_09 : – Delivery of goods referred to in § 10 section 3 point 1 letter i of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_10 : – Delivery of goods referred to in § 10 section 3 point 1 letter j of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_11 : – Provision of services referred to in § 10 section 3 point 2 letter a of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_12 : – Provision of services referred to in § 10 section 3 point 2 letter b of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
GTU_13 : – Provision of services referred to in § 10 section 3 point 2 letter c of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
TaxRate
Tax rate
value : String
e.g. : – Non-taxable - delivery of goods and provision of services outside the territory of the country
FaVersh
Class Description FaVersh.
TOmarkProcedures
Invoice Procedure Designations
value : String
WSTO_EE : – Designation concerning the procedure referred to in § 10 section 4 point 2a of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
IED : - Designation concerning the procedure referred to in § 10 section 4 point 2b of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
TT_D : - Designation concerning the procedure referred to in § 10 section 4 point 5 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
I_42 : - meaning related to the procedure referred to in § 10 section 4 point 8 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
I_63 : - Designation concerning the procedure referred to in § 10 section 4 point 9 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
B_SPV : - Designation concerning the procedure referred to in § 10 section 4 point 10 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
B_SPV_DELIVERY : – Designation concerning the procedure referred to in § 10 section 4 item 11 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax.
B_MPV_COMMISSION : - Designation concerning the procedure referred to in § 10 section 4 point 12 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax
Reckoning
Figure: Settlement
Reckoning
Class Description Reckoning.
Loads
Loads
sum : Double – The amount added to the amount shown in the field P_15.
reason : String – Reason for charging.
Deductions
Deductions.
sum : Double – Amount deducted from the amount shown in the field P_15.
reason : String – Reason for deduction.
Payment
Figure: PaymentPayment
Class Description Payment.
PartialPayment
Partial payment details.
PartialPaymentAmount : Double – Partial payment amount.
PartialPaymentDate : Date – Date of partial payment, if partial payment was made before the invoice was issued
PaymentDate
Maturity.
deadline : Date – The date defining the due date of payment.
termDescription : String – Description of the payment term.
Bankaccount
Account Information
nrRB : String – Full account number.
The attribute value is verified with a regular expression: [0-9A-Z]{10,32}
The attribute value is verified with a regular expression:
[AZ]{6}[A-Z0-9]{2}([A-Z0-9]{3}){0,1} (Required: [0..1])
OwnBank Account : Integer – Bank's own account.
The attribute value must match Bank'sOwnAccount. (Required: [0..1])
name of the bank : String – Bank name. (Required: [0..1])
description of the account : String – Account description (Maintenance: [0..1])
Discount
Discount
conditionsSkonta : String – Conditions that the buyer must meet to benefit from the discount.
heightDiscounts : String – Discount amount.
PaymentForm
Types of payment methods
Bank'sOwnAccount
Types of own accounts
1 : integer – A bank account or a cooperative savings and credit union account used to make settlements in respect of monetary receivables acquired by that bank or that union.
2 : integer – A bank account or a cooperative savings and credit union account used by this bank or union to collect receivables from the purchaser of goods or the recipient of services for the delivery of goods or the provision of services, confirmed by an invoice, and to transfer it in whole or in part to the supplier of goods or the provider of services.
3 : integer – A bank account or an account of a cooperative savings and credit union maintained by that bank or union as part of its own operations, which is not a settlement account.
Transaction Terms
TransactionTerms
Class Description TransactionTerms.
Agreements
Data describing the contract.
dateoftheagreement : Date – Date of conclusion of the contract. (Maturity: [0..1])
No.ofContracts : String – Contract number. (Required: [0..1])
Orders
Orders
dateOrders : Date – Date of order. (Maintenance: [0..1])
no.Orders : String – Order number. (Required: [0..1])
Transport
Transport
type of transport : Integer – Type of transport used in the case of delivery of goods.
The attribute value must match Type of Transport.
transportOther : Integer – Other type of transport tag: 1 – other type of transport
descriptionOtherTransport : String – Description of another type of transport
carrier : Carrier – Data describing the carrier performing the transport.
The attribute value must match Carrier. (Required: [0..1])
no.TransportOrder : String – Transport order number. (Required: [0..1])
description of the cargo : Integer – Description of the load type.
The attribute value must match TLoad.
loadOther : Integer – Other cargo tag: 1 – other cargo.
descriptionOtherCargo : String – Description of other cargo, including mixed cargo.
unitPackaging : String – Packaging unit. (Required: [0..1])
dateTimeTransportStart : DateTime – Date and time of the start of the transport. (Required: [0..1])
dateTimeTransportEnd : DateTime – Date and time of the end of the transport. (Required: [0..1])
shippingFrom : TAddress – Shipping location address.
The attribute value must match TAddress. (Required: [0..1])
shippingBy : TAddress – Intermediate shipping address.
The attribute value must match TAddress. (Due: [0..20])
shippingTo : TAddress – Address of the destination to which the transport was ordered.
The attribute value must match TAddress. (Required: [0..1])
Carrier
Carrier performing the transport.
Identification data : TPodmotyw2 – Carrier identification data.
The attribute value must match Subject2.
Carrier's address : TAddress – Carrier's address.
The attribute value must match TAddress.
Type of Transport
Type of transport
7 : Integer – Fixed transmission installations
8 : Integer – Inland navigation
TLoad
Types of cargo
15 : Integer – Solid Bulk Container
16 : Integer – Container for bulk cargo in liquid form
Order
TGTU
Enumeration description TGTU.
TaxRate
Enumeration description TaxRate.
Order
Order or agreement referred to in art. 106f sec. 1 item 4 of the Act (for advance payment invoices) in the currency in which the advance payment invoice was issued. In the case of an invoice correcting an advance payment invoice, differences resulting from the correction of individual items of the order or agreement or data of corrected items in the state before and after correction should be shown as separate lines, if the correction concerns the value of the order or agreement. In the case of invoices correcting advance payment invoices, if the correction does not concern the value of the order or agreement and at the same time changes the amount of the tax base or tax, an entry should be made according to the state before correction and an entry in the state after correction in order to confirm that the value of the given item has not changed.
valueOrders : Double – Value of the order or contract including the tax amount.
orderPoem : OrderLine – Detailed items of the order or contract in the currency in which the advance payment invoice was issued.
The attribute value must match OrderLine. = new ArrayList<>() (Required: [1..10000])
OrderLine
Detailed order or contract items in the currency in which the advance payment invoice was issued.
RowNo.Order : Integer – Sequential line number of the order or contract.
UU_IDZ : String – Universally unique order or contract line number (Required: [0..1])
P_7Z : String – Name (type) of product or service. (Required: [0..1])
indexZ : String – Field intended for entering the internal code of the product or service assigned by the taxpayer or an additional description. (Required: [0..1])
GTINZ : String – Global trade item number. (Required: [0..1])
PKWiUZ : String – Symbol of the Polish Classification of Products and Services. (Required: [0..1])
CNZ : String – Combined Nomenclature Symbol. (Required: [0..1])
PKOBZ : String – Symbol of the Polish Classification of Construction Objects. (Required: [0..1])
P_8AZ : String – Measure of the ordered product or scope of service. (Required: [0..1])
P_8BZ : Double – Quantity of ordered goods or scope of service. (Required: [0..1])
P_9AZ : Double – Net unit price.
p11NettoZ : Double – Value of the ordered goods or services without the tax amount. (Majority: [0..1])
p11VatZ : Double – Tax amount for the ordered goods or services. (Mayor: [0..1])
The attribute value must match TaxRate. (Required: [0..1])
P_12Z_XII : Double – Value added tax rate in the case referred to in section XII in chapter 6a of the Act. (Mayor: [0..1])
p12ZZal15 : Integer – Marker for goods or services listed in Annex No. 15 to the Act – value "1". (Required: [0..1])
GTUZ : TGTU – Designation for the delivery of goods and services.
The attribute value must match TGTU. (Required: [0..1])
procedureZ : TOmarkProcedureZ – Designations relating to procedures.
The attribute value must match TOmarkProcedureWith.
amountExcise duty : Double – The amount of excise tax included in the price of the goods. (Mayor: [0..1])
stateBefore : Integer – Pre-correction status marker in the case of a correction invoice, an invoice documenting the receipt of payment or its part before the action was performed and an invoice issued in connection with art. 106f sec. 4 of the Act, in the case where the correction concerns data shown in the order items and is made in a way that consists in showing the data before and after the correction as separate lines with separate numbering and in the case of confirming the lack of change in the value of a given item. (Required: [0..1])
TOmarkProcedureWith
Designations for order procedures.
value : String
WSTO_EE : – Designation concerning the procedure referred to in § 10 section 4 point 2a of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax.
IED : – Designation concerning the procedure referred to in § 10 section 4 item 2b of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax.
TT_D : – Designation concerning the procedure referred to in § 10 section 4 point 5 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax.
B_SPV : – Designation concerning the procedure referred to in § 10 section 4 item 10 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax.
B_SPV_DELIVERY : – Designation concerning the procedure referred to in § 10 section 4 item 11 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax.
B_MPV_COMMISSION : – Designation concerning the procedure referred to in § 10 section 4 item 12 of the regulation on the detailed scope of data included in tax returns and records in the scope of goods and services tax.
Common
Address
Subject1
Class Description Subject1.
Subject2
Class Description Subject2.
Subject3
Class Description Subject3.
Authorized Entity
Class Description Authorized Entity.
Subject1K
In the case of correction of the seller's data, the full seller's data appearing on the corrected invoice must be provided. The field does not apply in the case of correction of an incorrect NIP appearing on the original invoice - then the invoice correction to zero values is required
Taxpayer prefix : TKodyKrajowUE – EU VAT taxpayer code (prefix) for cases specified in art. 97 sec. 10 points 2 and 3 of the Act and in the case referred to in art. 136 sec. 1 point 3 of the Act.
Identification data : TEntity1 – Data identifying the taxpayer.
The attribute value must match Subject1.
address : TAddress – Taxpayer's address.
The attribute value must match TAddress.
Entity2K
In the event of correction of the data of the buyer appearing as Entity2 or an additional buyer appearing as Entity3, the full data of this entity appearing on the corrected invoice must be provided. Incorrect numbers identifying the buyer and the additional buyer are not subject to correction. In the event of correction of the remaining data of the buyer or the additional buyer, the indicated identification number must be identical to the number in the Entity2 or Entity3 part of the corrective invoice.
Identification data : TPodmiot2 – Data identifying the buyer.
The attribute value must match Subject2.
address : TAddress – Buyer's address. Optional fields for cases specified in art. 106e sec. 5 item 3 of the Act.
The attribute value must match TAddress. (Required: [0..1])
Buyer ID : String – Unique key for linking buyer data on correction invoices, in case the buyer data on the correction invoice has changed in relation to the data on the corrected invoice. (Required: [0..1])
Transport
Class Description Transport.
Carrier
Class Description Carrier.
TAddress
Address description information
Country code : TKodKraju – Country Code [Country Code]. The attribute value must be consistent with CountryCode.
addressL1 : String – Address [Address] – first line of address. Max 512 characters
addressL2 : String – Address [Address] – the second line of the address. Max 512 characters (Required: [0..1])
GLN : String – Global Location Number [Global Location Number] (Required: [0..1])
Identification of
Subject1
Class Description Subject1.
Subject2
Class Description Subject2.
Subject3
Class Description Subject3.
Authorized Entity
Class Description Authorized Entity.
Subject1
A set of taxpayer identification data.
Tax Identification Number : String – Tax Identification Number NIP
name : String – Name and surname or taxpayer name. Max 512 characters
Subject2
A set of identification data and address data of the buyer.
Attention! Must be filled in only one of 4 possible identifiers:
- Tax Identification Number, or
- codeEU and EUVATNo., or
- Country code and No.ID, or
- noID
The selected identifier is the number by means of which the purchaser of goods or services is identified for tax or value added tax under which he received goods or services, subject to art. 106e sec. 1 point 24 letter b of the Act. Optional field for the case specified in art. 106e sec. 5 point 2 of the Act. In the case of invoices issued in the simplified procedure by the second taxpayer in the order, referred to in art. 135 sec. 1 point 4 letters b and c and sec. 2 of the Act, the number referred to in art. 136 sec. 1 point 4 of the Act.
Tax Identification Number : String – Tax Identification Number.
The attribute value is validated according to the regular expression: [1-9]((\d[1-9])|([1-9]\d))\d{7} (Required: [0..1])
codeEU : TKodyKrajowUE – Code (prefix) of the EU VAT buyer, referred to in art. 106e sec. 1 item 24 of the Act and in the case referred to in art. 136 sec. 1 item 4 of the Act.
By default, this is the Polish feeder code, i.e. "PL". The attribute value must be consistent with TKodiCodesCountryEU.
(Required: [0..1])
EUVATNo. : String – EU contractor's VAT identification number. (Required: [0..1])
Country code : TKodKraju – Country code of the tax identifier. The attribute value must be consistent with CountryCode. (Required: [0..1])
No.ID : String – Other tax ID.
The attribute value is validated according to the regular expression: [a-zA-Z0-9]{1,50} (Required: [0..1])
noID : Integer – The entity does not have a tax identifier or the identifier is not on the invoice: 1 - yes (Required: [0..1])
name : String – Optional data for cases referred to in art. 106e sec. 5 item 3 of the Act. Name and surname or name. (Required: [0..1])
Subject3
A set of identification data and address data of third parties.
Attention! Must be filled in only one of 5 possible identifiers:
- Tax Identification Number, or
- idIn, or
- codeEU and EUVATNo., or
- Country code and No.ID, or
- noID
The selected identifier is the number by which the purchaser of goods or services is identified for tax or value added tax, under which he received the goods or services, subject to art. 106e sec. 1 item 24 letter b of the Act. Optional field for the case specified in art. 106e sec. 5 item 2 of the Act. In the case of invoices issued in the simplified procedure by the second taxpayer in the order, referred to in art. 135 sec. 1 item 4 letters b and c and sec. 2 of the Act, the number referred to in art. 136 sec. 1 item 4 of the Act
Tax Identification Number : String – Tax Identification Number.
The attribute value is validated according to the regular expression: [1-9]((\d[1-9])|([1-9]\d))\d{7}
idIn : String – Internal identifier from Tax Identification Number.
The attribute value is validated according to the regular expression: [1-9]((\d[1-9])|([1-9]\d))\d{7}-\d{5}
codeEU : TKodyKrajowUE – Code (prefix) of the EU VAT buyer, referred to in art. 106e sec. 1 item 24 of the Act and in the case referred to in art. 136 sec. 1 item 4 of the Act.
By default, this is the Polish feeder code, i.e. "PL". The attribute value must be consistent with TKodiCodesCountryEU.
EUVATNo. : String – VAT identification number of the EU contractor.
Country code : TKodKraju – Country code of the tax identifier. The attribute value must be consistent with CountryCode.
No.ID : String – Other tax ID.
The attribute value is validated according to the regular expression: [a-zA-Z0-9]{1,50}
noID : Integer – The entity does not have a tax identifier or the identifier is not on the invoice: 1- yes
name : String – Optional data for cases referred to in art. 106e sec. 5 item 3 of the Act. Name and surname or name.
EntityTroll3
The role of a third party
1 : Integer – Factor – if the invoice contains factor data
2 : Integer – Recipient – in the case when the invoice contains data on internal units, branches, separated within the buyer, which themselves do not constitute the buyer within the meaning of the Act
3 : Integer – Primary entity – in the event that the invoice contains data of an entity that is an acquired or transformed entity in relation to the taxpayer, which provided the service or made the delivery. Excluding cases referred to in art. 106j sec. 2 item 3 of the Act, when this data is shown in the Entity1K part
4 : Integer – Additional buyer – if the invoice contains data of additional buyers (other than the one mentioned in the Entity2 section)
5 : Integer – Invoice Issuer – in the case when the invoice contains data of the entity issuing the invoice on behalf of the taxpayer. Does not apply when the invoice issuer is the buyer
6 : Integer – Payer – in the event that the invoice contains the details of the entity settling the obligation instead of the buyer
7 : Integer – Local government unit – issuer
8 : Integer – Local government unit – recipient
9 : Integer – VAT group member – issuer
10 : Integer – VAT group member – recipient
Authorized EntityTrolley
The role of the authorized entity
1 : Integer – Enforcement body – in the case referred to in art. 106c point 1 of the Act
2 : Integer – Court bailiff – in the case referred to in art. 106c point 2 of the Act
3 : Integer – Tax representative – in the event that the invoice contains the details of the tax representative referred to in the provisions of Art. 18a – 18d of the Act
Contact details
Subject1
Class Description Subject1.
Subject2
Class Description Subject2.
Subject3
Class Description Subject3.
Authorized Entity
Class Description Authorized Entity.
Contact detailsPU
Contact details of the authorized entity.
Contact Details
Taxpayer contact details
e-mail : String – Taxpayer email address (Required: [0..1])
phone : String – Taxpayer's telephone number (Required: [0..1])
Enumerations
CountryCode
Country code dictionary.
TKodCurrency
Currency Code Dictionary
TKodiCodesCountryEU
European Union country codes, including the code for Northern Ireland
value : String
AT : - Austria
BE : - Belgium
BG : – Bulgaria
CY : – Cyprus
CZ : - The czech republic
DK : - Denmark
EE : – Estonia
FI : – Finland
FR : – France
DE : - Germany
EL : - Greece
HR : - Croatia
HU : – Hungary
IE : - Ireland
IT : – Italy
LV : – Latvia
LT : - Lithuania
LU : – Luxembourg
MT : - Malta
NL : – Netherlands (Holland)
PL : - Poland
PT : – Portugal
RO : – Romania
SK : – Slovakia
AI : – Slovenia
ES : - Spain
SE : – Sweden
XI :- Northern Ireland