| customerRef | string | REQ | Vaše stabilné customerRef nastavené pre schválenú firmu; v kanonickom Connector toku ho pošlite presne raz. |
| externalId | string | REQ | max 255 znakov / chars |
| delivery | string | optional | send (default) dispatches the document; stage only stores it for a later send or cancel. A staged document is kept for 14 days; after that it is cancelled and can no longer be sent. (default: send) (povolené: send, stage) |
| type | string | optional | (default: invoice) (povolené: invoice, credit_note, debit_note, prepayment_invoice, advance_payment, correction, self_billing_invoice, self_billing_credit_note) |
| number | string | REQ | max 255 znakov / chars |
| precedingDocumentNumber | string | optional | Original invoice number. Required for credit_note, self_billing_credit_note, correction (384) and debit_note (383). At most 100 characters. (max 255 znakov / chars) |
| recipient | object | REQ | |
| recipient.country | string | REQ | ISO country code that determines how the ordinary identifier is interpreted. (max 2 znakov / chars, pattern ^[A-Za-z]{2}$) |
| recipient.name | string | optional | max 255 znakov / chars |
| recipient.companyId | string | optional | Company registration number for this country. Do not put a tax or VAT identifier in this field. At most 20 characters. (max 255 znakov / chars) |
| recipient.taxId | string | optional | Local tax identifier for this country. Do not put a company registration or VAT identifier in this field. At most 20 characters. (max 255 znakov / chars) |
| recipient.vatId | string | optional | VAT identifier for this country. Do not put a company registration or local tax identifier in this field. At most 20 characters. (max 255 znakov / chars) |
| recipient.networkId | string | optional | Optional expert override. The identifier is still verified before use. At most 100 characters. (max 255 znakov / chars) |
| recipient.address | object | optional | street at most 255, city at most 120 and postalCode at most 20 characters. |
| recipient.address.street | string | optional | |
| recipient.address.city | string | optional | |
| recipient.address.postalCode | string | optional | max 32 znakov / chars |
| issueDate | date | optional | |
| dueDate | date | optional | |
| taxPointDate | date | optional | VAT tax point date (BT-7). Kept separate from the actual delivery date. For advance_payment (388) and prepayment_invoice (386) it is the date the payment was received; required for 388, not after issueDate and not in the future. |
| deliveryDate | date | optional | Actual delivery date for the whole document (BT-72). |
| documentDiscountPercent | number | optional | Document-level discount percentage represented as a Peppol BG-20 allowance. This is additional to any lines[].discount. (0–100) |
| currency | string | optional | max 3 znakov / chars (default: EUR) |
| note | string | optional | max 5000 znakov / chars |
| iban | string | optional | max 64 znakov / chars |
| paymentMethod | string | optional | UNCL4461 payment means code (e.g. 30 bank transfer). At most 30 characters. |
| paymentTerms | string | optional | Peppol BT-20 textual payment terms. (max 500 znakov / chars) |
| variableSymbol | string | optional | At most 50 characters. Only its digits are kept and sent as the payment identifier (PaymentID) (Slovak variable symbol); when more than 10 digits remain, the last 10 are used. A value without digits is treated as not sent. The format is never refused. |
| buyerReference | string | optional | Peppol BT-10 internal buyer routing reference, up to 100 characters. A document must contain buyerReference or orderReference. (max 100 znakov / chars, pattern \S) |
| orderReference | string | optional | Peppol BT-13 purchase-order reference, up to 100 characters. A document must contain orderReference or buyerReference. (max 100 znakov / chars, pattern \S) |
| contractReference | string | optional | Optional contract number (BT-12), up to 100 characters. (max 100 znakov / chars) |
| projectReference | string | optional | Optional project reference (BT-11), up to 100 characters. (max 100 znakov / chars) |
| invoicePeriodStart | date | optional | Optional first day of the billing period (BT-73) in YYYY-MM-DD format. |
| invoicePeriodEnd | date | optional | Optional last day of the billing period (BT-74) in YYYY-MM-DD format. It must not be before invoicePeriodStart. |
| prepaidAmount | number | optional | min 0 |
| prepayments | object[] | optional | max 100 položiek / items |
| prepayments[].advanceInvoiceRef | string | optional | |
| prepayments[].taxDocumentRef | string | optional | |
| prepayments[].settlementDate | date | optional | |
| prepayments[].amountWithoutVat | number | optional | min 0 |
| prepayments[].vatAmount | number | optional | min 0 |
| prepayments[].amountWithVat | number | REQ | min 0 |
| prepayments[].vatRate | number | optional | 0–100 |
| prepayments[].taxTreatment | string | optional | (povolené: standard, zero_rated, reverse_charge, exempt, intra_community_supply, export, out_of_scope) |
| lines | object[] | REQ | At most 999 lines. (max 1000 položiek / items) |
| lines[].description | string | REQ | max 1000 znakov / chars |
| lines[].quantity | number | REQ | Non-zero. A negative quantity on a standard line is a discount or returned item (unitPrice stays non-negative); lineType=advance_deduction requires a negative quantity. |
| lines[].unit | string | optional | max 16 znakov / chars |
| lines[].unitPrice | number | REQ | min 0 |
| lines[].vatRate | number | REQ | Slovak VAT rate: 0, 5, 10, 19, 20 or 23. Must be 0 for zero_rated, reverse_charge, exempt, intra_community_supply, export and out_of_scope, and greater than 0 for standard. (0–100) |
| lines[].taxTreatment | string | optional | (povolené: standard, zero_rated, reverse_charge, exempt, intra_community_supply, export, out_of_scope) |
| lines[].taxExemptionReasonCode | string | optional | Peppol BT-121 VAT exemption reason code from the current CEF VATEX list. The code must match taxTreatment and is allowed only for exempt or non-taxable values. (max 255 znakov / chars) |
| lines[].taxExemptionReason | string | optional | Peppol BT-120 human-readable VAT exemption reason. Allowed only for exempt or non-taxable taxTreatment values. (max 1000 znakov / chars) |
| lines[].discount | number | optional | 0–100 |
| lines[].deliveryDate | date | optional | |
| lines[].lineType | string | optional | standard (default) or advance_deduction. advance_deduction requires a negative quantity and advanceInvoiceReference. |
| lines[].advanceInvoiceReference | string | optional | |
| lines[].customsTariffCode | string | optional | Customs tariff (KN) code, 4-10 digits. |
| lines[].commodityClassificationCode | string | optional | |
| lines[].commodityClassificationListId | string | optional | |
| lines[].reverseChargeParagraphLetter | string | optional | |
| lines[].controlStatementType | string | optional | Kontrolný výkaz reverse-charge category: IO or MT. |
| lines[].controlStatementQuantity | number | optional | Greater than 0 when present. (min 0) |
| lines[].controlStatementUnit | string | optional | kg, t, m or ks. |
| attachments | object[] | optional | max 20 položiek / items |
| attachments[].fileName | string | REQ | max 255 znakov / chars |
| attachments[].mimeType | string | REQ | application/pdf, image/png, image/jpeg, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet or application/vnd.oasis.opendocument.spreadsheet. (max 255 znakov / chars) |
| attachments[].content | base64 | REQ | Base64 file content. At most 10 MB per file and 15 MB for all attachments together (decoded); the bytes must match mimeType. |
| attachments[].description | string | optional | max 1000 znakov / chars |