
Document Types
Invoices, debit and credit notes, and protocols are distinguished by two-digit codes from the official NRA nomenclature.
How invoices and payments are built
- Each entry in a "Sales" or "Purchases" journal becomes an invoice. The invoice account is the settlement account with the customer/supplier (41…/40…); the invoice lines are the revenue/expense lines, the line amount is the tax base, and VAT sits only in the line's tax information.
- Indicator D means the line increases the receivable (sales) or the payable (purchases); C means it reduces it, e.g. a credit note. Section totals are the bases summed by indicator, without VAT.
- The invoice number and date must be as written on the document — the NRA matches supplier and customer invoices by them. For purchases, map the "Invoice Number (as printed)" and "Document Date" columns; without them the accounting entry number and the posting date are written. The document date is also the tax point date; the posting date decides the period.
- Protocols (intra-EU acquisitions, services under Art. 82 VAT Act, self-assessment) are type
09, customs declarations07, the sales report81, and a debit note is02even when titled "invoice". Set the type with the "Document Type" column. - Invoices for directly expensed costs and for fixed assets may use product code
0; stocked products map to a CN8-2026 code and services to00000000. - Payments are only real settlements with counterparties. Transfers between own accounts, cash withdrawals and deposits, currency exchange and advances to accountable persons are not submitted. D is money in, C is money out.
Source: NRA Questions and Answers, version 2 — III.5, III.6 (S.I.4, S.I.30, S.I.46, S.I.47), III.7, IV.2.5; Appendix 3, items IV.6–IV.7.
doc_numberText (max 70 chars)ConditionalThe source document reference: invoice number, voucher, journal entry number, or similar. This becomes the TransactionID in the SAF-T file and links GL lines to their source documents. The system recognises over 40 common column names (invoice_no, document_no, ref, voucher, je_no, move_name, …). If none are matched, a sequential code is generated automatically (TXN000001, …).
invoice_typeText (2 digits)ConditionalThe two-digit code from the NRA nomenclature. If your accounting software stores a readable label (e.g. "Invoice"), the system will apply automatic mapping.
Automatic mapping
| Description | Code |
|---|---|
| Фактура, Invoice, INV | 01 |
| Дебитно известие, Debit note, DN | 02 |
| Кредитно известие, Credit note, КИ | 03 |
| Протокол, Protocol | 09 |
Key codes
| Code | Description |
|---|---|
01 | Invoice |
02 | Debit note |
03 | Credit note |
04 | Warehouse call-off stock register (sent) |
05 | Warehouse call-off stock register (received) |
07 | Customs declaration |
09 | Protocol or other document |
11 | Invoice (cash accounting) |
12 | Debit note (cash accounting) |
13 | Credit note (cash accounting) |
23 | Credit note (Art. 126b§1 VATA) |
29 | Protocol (Art. 126b§2,7 VATA) |
81 | Sales report |
82 | Sales report (special taxation) |
91 | Protocol — due tax Art. 151c§3 |
92 | Protocol — tax credit Art. 151d§8 |
93 | Protocol Art. 151c§7 (standard recipient) |
94 | Protocol Art. 151c§7 (special regime recipient) |
95 | Protocol — gratuitous food goods |
journal_typeSALE | PURCHASE | BANK | CASH | GENERALConditionalClassifies the transaction by economic nature for the XML structure:
| Column | Description |
|---|---|
SALE | Sale — customer invoices, fiscal receipts |
PURCHASE | Purchase — supplier invoices |
BANK | Bank — bank transfers, card payments |
CASH | Cash — cash inflows and outflows |
GENERAL | General — depreciation, accruals, payroll, corrections |
payment_methodText (2 digits)ConditionalThe general payment category:
| Code | Description |
|---|---|
01 | Cash payment |
02 | Offset / netting |
03 | Non-cash (bank transfer, card, etc.) |
Payment mechanism (optional)
Specific channel within the category:
| Code | payment_method | Description |
|---|---|---|
10 | 01 | Cash |
42 | 03 | Bank transfer |
48 | 03 | Bank / debit card |
68 | 03 | Online payment service |
20 | 03 | Cheque |
97 | 02 | Offset between counterparties |
98 | 02 | Barter |
30 | 03 | Voucher |
is_reversalBooleanOptionalSet to true or 1 for reversal (storno) entries. Provide the original document number in reversed_invoice_no.
reversed_invoice_noText (max 70 chars)OptionalThe number of the original document being reversed or cancelled. Used together with is_reversal = true. This allows the NRA to link the correction entry to the original transaction in the audit trail.