Not tax advice. Computation tools only. Have a professional check your work before filing.
openaccountants/skills/hungary-einvoice.md

Use this skill with your AI agent

View on GitHub

Paste this skill into your AI agent's context, or save the file to your project. Works with any AI agent that reads markdown.

hungary-einvoice.md374 lines19.2 KB
v10Hungary
Not yet verified by an accountantContact accountant
1---
2name: hungary-einvoice
3description: >
4 Use this skill whenever asked about e-invoicing in Hungary, NAV Online Számla, real-time invoice reporting (RTIR), NAV Online Invoicing System, XML 3.0 schema, invoice data reporting to the Hungarian tax authority, electronic invoice hash, completenessIndicator, or any question about issuing, transmitting, validating, or archiving electronic invoices under Hungarian law. Trigger on phrases like "NAV Online Számla", "RTIR Hungary", "real-time invoice reporting", "NAV API", "XML 3.0 Hungary", "invoiceData.xsd", "Online Invoicing System", "e-számla", "Hungarian invoice reporting", or "ManageInvoiceRequest". ALWAYS read this skill before touching any Hungary invoicing compliance work.
5version: 1.0
6jurisdiction: HU
7category: invoicing
8depends_on:
9 - einvoice-workflow-base
10---
11 
12# Hungary E-Invoicing Compliance Skill v1.0
13 
14---
15 
16## Section 1 -- Quick Reference
17 
18| Field | Value |
19|---|---|
20| Country | Hungary (Magyarország) |
21| Currency | HUF (domestic); EUR/USD accepted for cross-border with HUF conversion |
22| E-invoicing system name | NAV Online Számla Rendszer (Online Invoicing System) |
23| Governing body | Nemzeti Adó- és Vámhivatal (NAV -- National Tax and Customs Administration) |
24| Key legislation | Act CXXVII of 2007 on VAT (Áfa tv.); Act LXXXIII of 2018 (Online Invoicing System); Government Decree 23/2014 on technical requirements |
25| Implementation timeline | Jul 2018 (B2B, VAT ≥ 100k HUF); Jul 2020 (all B2B invoices); Jan 2021 (B2C included); Jun 2021 (XSD 3.0 mandatory); May 2025 (XSD 2.0 end of life) |
26| Current status (2026) | Fully operational RTIR covering 100% of invoices issued by VAT-registered persons; XSD 3.0 only; optional e-invoice (XML as legal invoice) available; preparing for ViDA alignment |
27| Skill version | 1.0 |
28 
29---
30 
31## Section 2 -- Mandate Scope
32 
33### Who Must Comply
34 
35**All Hungarian VAT-registered taxpayers** who issue invoices must report invoice data in real-time to the NAV Online Számla system. This includes:
36 
37- Domestic B2B invoices (all VAT amounts, including zero)
38- Domestic B2C invoices
39- Invoices issued to other EU member states (intra-community supplies)
40- Export invoices to third countries
41- Self-billing invoices (buyer issues on behalf of supplier)
42- Modification invoices (credit notes, corrections)
43 
44The only invoices excluded from RTIR are those issued under the OSS (One-Stop Shop) regime for non-established sellers.
45 
46### Timeline Phases
47 
48| Date | Milestone |
49|---|---|
50| 1 July 2018 | RTIR launched for B2B invoices with VAT ≥ HUF 100,000 |
51| 1 July 2020 | RTIR extended to all B2B invoices regardless of VAT amount (XSD 2.0 mandatory) |
52| 4 January 2021 | B2C invoices included in RTIR; all invoices now reportable |
53| 1 June 2021 | XSD 3.0 mandatory for all submissions; optional e-invoice feature activated |
54| 1 April 2021 | XSD 2.0 and earlier rejected; 3.0 exclusively accepted |
55| 15 May 2025 | NAV officially ends all support for XSD 2.0 |
56| 2026--2028 | ViDA alignment: transition from RTIR (data reporting) to full structured e-invoicing (EN 16931 XML as the legally binding invoice) |
57 
58### RTIR vs E-Invoicing Distinction
59 
60Hungary operates a **real-time invoice data reporting** model, not a clearance model. The reported XML is a copy of the invoice data, not the invoice itself (unless `completenessIndicator=true`). The legal invoice can be paper, PDF, or (optionally) the XML itself.
61 
62With XSD 3.0, businesses can opt to declare the XML as the actual electronic invoice by setting `completenessIndicator=true`. In this case, the XML becomes the legally binding document and is available to the buyer via NAV's system.
63 
64---
65 
66## Section 3 -- Technical Format
67 
68### XML Schema (XSD 3.0)
69 
70The NAV Online Számla system uses a proprietary XML schema maintained by NAV. As of 2026, only **XSD version 3.0** is accepted.
71 
72| Schema | Namespace | Purpose |
73|---|---|---|
74| `invoiceData.xsd` | `http://schemas.nav.gov.hu/OSA/3.0/data` | Invoice data content |
75| `invoiceApi.xsd` | `http://schemas.nav.gov.hu/OSA/3.0/api` | API request/response envelopes |
76| `base.xsd` | `http://schemas.nav.gov.hu/OSA/3.0/base` | Common base types |
77| `common.xsd` | `http://schemas.nav.gov.hu/NTCA/1.0/common` | NTCA common types |
78 
79### Key Schema Structures
80 
81| Structure | Description |
82|---|---|
83| `InvoiceData` | Root element for invoice data XML |
84| `InvoiceMain` | Contains `Invoice` (for normal invoices) or `BatchInvoice` (for summary invoices) |
85| `InvoiceHead` | Supplier data, customer data, fiscal representative |
86| `InvoiceDetail` | Invoice-level detail: category, appearance, currency, exchange rate, payment method, dates |
87| `InvoiceLines` | Line-level data: descriptions, quantities, amounts, VAT rates, product codes |
88| `InvoiceSummary` | Summary totals per VAT rate, global totals |
89 
90### API Request Types
91 
92| Request | XML Root | Purpose |
93|---|---|---|
94| `ManageInvoiceRequest` | `invoiceApi:ManageInvoiceRequest` | Submit new invoices or modifications |
95| `TokenExchangeRequest` | `invoiceApi:TokenExchangeRequest` | Obtain session token |
96| `QueryInvoiceDataRequest` | `invoiceApi:QueryInvoiceDataRequest` | Query submitted invoice data |
97| `QueryTransactionStatusRequest` | `invoiceApi:QueryTransactionStatusRequest` | Check processing status |
98| `ManageAnnulmentRequest` | `invoiceApi:ManageAnnulmentRequest` | Technical annulment of erroneous data |
99 
100---
101 
102## Section 4 -- Mandatory Fields
103 
104### Invoice Data Fields (XSD 3.0)
105 
106| Field | XPath (within InvoiceData) | Notes |
107|---|---|---|
108| Invoice number | `invoiceHead/invoiceDetail/invoiceNumber` | Unique identifier |
109| Invoice category | `invoiceHead/invoiceDetail/invoiceCategory` | NORMAL, SIMPLIFIED, AGGREGATE |
110| Invoice issue date | `invoiceHead/invoiceDetail/invoiceIssueDate` | ISO 8601 |
111| Invoice appearance | `invoiceHead/invoiceDetail/invoiceAppearance` | PAPER, ELECTRONIC, EDI, UNKNOWN |
112| Supplier tax number | `invoiceHead/supplierInfo/supplierTaxNumber/taxpayerId` | 8-digit Hungarian tax ID |
113| Supplier name | `invoiceHead/supplierInfo/supplierName` | |
114| Supplier address | `invoiceHead/supplierInfo/supplierAddress` | Structured address |
115| Customer status | `invoiceHead/customerInfo/customerVatStatus` | DOMESTIC, OTHER, PRIVATE_PERSON |
116| Customer tax number | `invoiceHead/customerInfo/customerVatData/customerTaxNumber/taxpayerId` | Required for DOMESTIC; optional for PRIVATE_PERSON |
117| Customer name | `invoiceHead/customerInfo/customerName` | Required for B2B |
118| Customer address | `invoiceHead/customerInfo/customerAddress` | Required for B2B |
119| Currency | `invoiceHead/invoiceDetail/currencyCode` | ISO 4217 |
120| Exchange rate | `invoiceHead/invoiceDetail/exchangeRate` | Required if currency ≠ HUF |
121| Supply date | `invoiceHead/invoiceDetail/invoiceDeliveryDate` | Teljesítés dátuma |
122| Payment method | `invoiceHead/invoiceDetail/paymentMethod` | TRANSFER, CASH, CARD, VOUCHER, OTHER |
123| Payment date | `invoiceHead/invoiceDetail/paymentDate` | Due date |
124| Line description | `invoiceLines/line/lineDescription` | Description of goods/services |
125| Line quantity | `invoiceLines/line/quantity` | |
126| Line unit of measure | `invoiceLines/line/unitOfMeasure` | |
127| Line unit price | `invoiceLines/line/unitPrice` | |
128| Line net amount | `invoiceLines/line/lineAmountsNormal/lineNetAmountData/lineNetAmount` | |
129| Line VAT rate | `invoiceLines/line/lineAmountsNormal/lineNetAmountData/lineVatRate/vatPercentage` | |
130| Line VAT amount | `invoiceLines/line/lineAmountsNormal/lineVatAmountData/lineVatAmount` | |
131| Summary per VAT rate | `invoiceSummary/summaryByVatRate` | Net, VAT, gross per rate |
132| Invoice grand total | `invoiceSummary/summaryGrossData/invoiceGrossAmount` | |
133 
134### Modification Invoice Fields
135 
136| Field | Notes |
137|---|---|
138| `modificationReferenceNumber` | Original invoice number being modified |
139| `modificationTimestamp` | When the modification was initiated |
140| `modifyWithoutMaster` | `true` if original invoice was issued before RTIR or not in the system |
141| `modificationIndex` | Sequential number of modifications to the same original |
142 
143### Electronic Invoice (completenessIndicator=true)
144 
145| Field | Location | Notes |
146|---|---|---|
147| `completenessIndicator` | `ManageInvoiceRequest/invoiceOperations/compressedContent` (attribute) | Set to `true` to declare XML as the legal invoice |
148| `electronicInvoiceHash` | `ManageInvoiceRequest/invoiceOperations/invoiceOperation/electronicInvoiceHash` | SHA3-512 or SHA-256 hash of the invoice XML |
149| `cryptoType` | Attribute of `electronicInvoiceHash` | `SHA3-512` or `SHA-256` |
150 
151When `completenessIndicator=true`, NAV makes the invoice XML available to the buyer for download, and the XML serves as the legally binding invoice.
152 
153---
154 
155## Section 5 -- Transmission Method
156 
157### NAV Online Számla API
158 
159| Component | Detail |
160|---|---|
161| API type | RESTful XML-based API |
162| Production URL | `https://api.onlineszamla.nav.gov.hu/invoiceService/v3/` |
163| Test URL | `https://api-test.onlineszamla.nav.gov.hu/invoiceService/v3/` |
164| Web portal | `https://onlineszamla.nav.gov.hu` (manual queries and management) |
165| Authentication | Technical user credentials (login + password) + XML signing key + XML exchange key |
166| Submission deadline | Immediately upon invoice issuance; technically within 5 minutes |
167 
168### API Workflow
169 
1701. **Token Exchange**: Call `TokenExchangeRequest` to obtain a session token (valid for 5 minutes)
1712. **Prepare Invoice XML**: Generate `invoiceData` XML conforming to XSD 3.0
1723. **Compress and encode**: Base64-encode the invoice data; optionally compress
1734. **Submit**: Call `ManageInvoiceRequest` with the encoded invoice data, operation type (CREATE, MODIFY, STORNO), and request signature
1745. **Receive transaction ID**: NAV returns a `transactionId`
1756. **Query status**: Call `QueryTransactionStatusRequest` to verify processing result (RECEIVED, PROCESSING, DONE, ABORTED)
176 
177### Request Signature
178 
179Every `ManageInvoiceRequest` must include a request signature computed from:
180- Request ID
181- Timestamp
182- XML signing key
183- Invoice hash values
184 
185The signature algorithm uses SHA-512 and the technical user's signing key.
186 
187### Batch Submission
188 
189Up to 100 invoice operations can be submitted in a single `ManageInvoiceRequest` (within the `invoiceOperations` element). Each operation has its own index, operation type, and invoice data.
190 
191### Technical User Management
192 
193Each taxpayer registers an "elsődleges felhasználó" (primary user) on the NAV portal, who then creates technical users for API access. Each technical user has:
194- Login name and password
195- XML signing key (cserekulcs)
196- XML exchange key (aláírókulcs)
197 
198If keys are regenerated on the portal, they must be updated in the invoicing software immediately.
199 
200---
201 
202## Section 6 -- Validation Rules
203 
204### NAV-Side Validation
205 
206NAV validates every submitted invoice against:
207 
2081. **XSD schema validation** -- must conform to XSD 3.0; earlier versions rejected
2092. **Request signature validation** -- cryptographic signature must be valid
2103. **Technical user validation** -- credentials and keys must match
2114. **Business rule validation**:
212 - Tax number format and validity (8-digit taxpayer ID + VAT code + county code)
213 - Invoice number uniqueness per supplier
214 - Modification references: original invoice must exist in the system (unless `modifyWithoutMaster=true`)
215 - `completenessIndicator` restrictions (cannot be true for paper invoices, private person invoices, merged invoices, or pre-2021 invoices)
216 - Currency and exchange rate consistency
217 - VAT rate validity against current Hungarian VAT law
218 
219### Pre-Submission Checks
220 
221- Validate XML against XSD 3.0 locally before API call
222- Verify request signature computation is correct
223- Confirm technical user credentials and keys are current (keys must be refreshed if regenerated on the portal)
224- Verify tax number validity using NAV's public tax number query service
225- Ensure invoice number has not been previously submitted
226- For modifications: verify original invoice exists and modification index is sequential
227 
228### Common Rejection Reasons
229 
230| Reason | Detail |
231|---|---|
232| XSD version mismatch | Submission uses XSD 1.x or 2.0 (rejected since April 2021) |
233| Invalid request signature | Signing key mismatch or computation error |
234| Invalid tax number | Supplier or customer tax number format invalid or not registered |
235| Duplicate invoice number | Same invoice number already submitted by the same supplier |
236| Modification reference error | Referenced original invoice not found and `modifyWithoutMaster=false` |
237| CompletionIndicator conflict | `completenessIndicator=true` with non-electronic appearance or private person |
238| Missing mandatory field | Required XSD element absent or empty |
239| Rate validation failure | VAT percentage does not match known Hungarian rates |
240 
241---
242 
243## Section 7 -- Tax Computation Rules
244 
245### Hungarian VAT Rates (2026)
246 
247| Rate | Percentage | Application |
248|---|---|---|
249| Standard | 27% | Most goods and services (one of the highest in the EU) |
250| Reduced 1 | 18% | Dairy products, bakery products, commercial accommodation |
251| Reduced 2 | 5% | Basic foodstuffs (meat, eggs, milk), books, newspapers, medicines, district heating, internet access, new residential property (conditions apply), live performances |
252| Exempt | 0% | Intra-community supplies, exports, certain financial and insurance services |
253 
254### Rounding Rules
255 
256- VAT amounts calculated per line in the invoice currency (HUF or foreign currency).
257- HUF amounts rounded to the nearest whole forint (no decimals).
258- EUR/foreign currency amounts rounded to 2 decimal places.
259- Summary totals are the sum of rounded line-level amounts.
260- NAV validates that line-level amounts sum to the summary totals (with tolerance).
261 
262### Multi-Rate Invoice Handling
263 
264Each VAT rate has a separate `summaryByVatRate` element in the `invoiceSummary`. Each element contains:
265- `vatRateNetData` (taxable base at this rate)
266- `vatRateVatData` (VAT amount at this rate)
267- `vatRateGrossData` (gross amount at this rate)
268 
269Lines with different VAT rates must declare the rate individually.
270 
271### Currency Handling
272 
273For invoices in foreign currency:
274- `currencyCode` must be a valid ISO 4217 code
275- `exchangeRate` is the MNB (Magyar Nemzeti Bank) rate on the tax point date or a contractual rate
276- HUF equivalents are required in the summary for tax reporting purposes
277- If the invoice is in HUF, `exchangeRate` must be 1
278 
279### Reverse Charge
280 
281Domestic reverse charge (fordított adózás) invoices must be reported with:
282- `vatExemption` or `vatOutOfScope` indicator on relevant lines
283- Specific VAT rate type `VAT_RATE_EXEMPT` with the appropriate exemption reason
284 
285---
286 
287## Section 8 -- Archiving Requirements
288 
289| Requirement | Detail |
290|---|---|
291| Retention period | 8 years from the end of the year in which the invoice was issued (Számviteli törvény) |
292| Format (paper invoice) | Paper original must be retained; RTIR XML is a data report, not the legal document |
293| Format (PDF invoice) | Digitally signed PDF with timestamp is the legal document; must be archived with signature intact |
294| Format (XML e-invoice, completenessIndicator=true) | The XML submitted to NAV is the legal document; buyer downloads from NAV; both parties must retain the XML |
295| Integrity | No modification permitted to the archived document; audit trail required |
296| Accessibility | Must be available for NAV audit within the territory of Hungary (or EU with immediate electronic access) |
297| NAV portal | NAV retains all submitted RTIR data; businesses can query via the web portal or API; however, NAV data is a report, not an archive -- businesses must maintain their own records |
298| Buyer obligation (XML e-invoice) | If `completenessIndicator=true`, the buyer retrieves the XML from NAV and archives it as the original invoice |
299 
300---
301 
302## Section 9 -- Penalties for Non-Compliance
303 
304### RTIR-Specific Penalties
305 
306| Violation | Penalty (HUF) |
307|---|---|
308| Failure to report invoice data to NAV | Up to HUF 500,000 per invoice (approx. EUR 1,300) |
309| Late reporting (beyond the real-time deadline) | Graduated fines based on delay duration |
310| Incorrect data in RTIR submission | Up to HUF 500,000 per invoice |
311| Use of non-compliant invoicing software | Fines per NAV decree; software must be registered with NAV |
312| Systematic non-compliance | Triggers risk classification; increased audit probability |
313 
314### General VAT Penalties
315 
316| Violation | Penalty |
317|---|---|
318| Failure to issue invoice | Up to HUF 500,000 per instance |
319| Incorrect invoice content | Tax reassessment + penalty (50% of tax shortfall as default penalty; 200% if fraud) |
320| Late VAT return filing | Late payment interest + administrative fine |
321| VAT fraud | Criminal penalties under Hungarian Penal Code |
322 
323### Practical Consequences
324 
325- NAV uses RTIR data for automated risk analysis; persistent errors trigger compliance audits
326- The planned e-ÁFA (pre-filled VAT return) system relies on correct RTIR data; incorrect submissions lead to discrepancies in the pre-filled return
327- Buyers increasingly verify supplier RTIR compliance before accepting invoices
328 
329---
330 
331## Section 10 -- Interaction with Tax Skills
332 
333### RTIR → VAT Return (ÁFA bevallás)
334 
335NAV uses RTIR data to construct the e-ÁFA (electronic VAT) pre-filled return. From 2024, NAV offers taxpayers a draft VAT return based on:
336- Supplier-reported outbound invoices
337- Buyer-received inbound invoices
338- Customs declarations
339 
340Taxpayers review, adjust, and submit the pre-filled return. Discrepancies between RTIR data and the filed return trigger automated queries.
341 
342### RTIR → e-ÁFA Pre-Filled Return
343 
344The e-ÁFA system pre-populates:
345- Output VAT from the taxpayer's submitted invoices
346- Input VAT from suppliers' reported invoices where the taxpayer is the buyer
347- Adjustments for credit notes and modifications
348 
349This significantly reduces manual data entry for small and medium businesses.
350 
351### Electronic Invoice (completenessIndicator=true) → Buyer AP
352 
353When a supplier sets `completenessIndicator=true`, the buyer can retrieve the structured XML invoice from NAV's system. This enables automated accounts payable processing, booking, and reconciliation.
354 
355### RTIR → Corporate Tax (Társasági adó)
356 
357NAV cross-references RTIR data against corporate tax returns. Revenue and cost data from invoices feeds into NAV's risk-analysis algorithms for corporate tax audits.
358 
359### Future: ViDA Alignment
360 
361Hungary's RTIR is expected to evolve into a full structured e-invoicing system aligned with EU ViDA requirements by 2028--2030. The transition will shift from data reporting (XML as a copy) to clearance or exchange (XML as the legally binding invoice, EN 16931 format). Hungary's advanced RTIR infrastructure positions it well for this transition.
362 
363### NAV Online Számla → e-Nyugta (Electronic Receipt)
364 
365NAV is developing the e-nyugta system for electronic receipts, which will eventually replace traditional cash registers for retail B2C transactions. This system will integrate with the existing Online Számla infrastructure.
366 
367---
368 
369## Disclaimer
370 
371This skill and its outputs are provided for informational and computational purposes only and do not constitute tax, legal, or financial advice. Open Accountants and its contributors accept no liability for any errors, omissions, or outcomes arising from the use of this skill. All outputs must be reviewed and signed off by a qualified professional (such as a CPA, tax attorney, or equivalent licensed practitioner in your jurisdiction) before filing or acting upon.
372 
373The most up-to-date, verified version of this skill is maintained at [openaccountants.com](https://openaccountants.com).
374 

Run this skill, then get an accountant to check it

After running the full skill pack in your AI agent, sign up and upload your worksheet. We'll connect you with a trusted accountant in our network who can review your numbers before you file.

Verification status

Research-verified

Drafted from authoritative sources (tax authority sites, Big-4 summaries). Awaiting credentialed sign-off.

Needs section-by-section practitioner review to reach accountant-verified.

Section review progress

0/36

About

Use this skill whenever asked about e-invoicing in Hungary, NAV Online Számla, real-time invoice reporting (RTIR), NAV Online Invoicing System, XML 3.0 schema, invoice data reporting to the Hungarian tax authority, electronic invoice hash, completenessIndicator, or any question about issuing, transmitting, validating, or archiving electronic invoices under Hungarian law. Trigger on phrases like "NAV Online Számla", "RTIR Hungary", "real-time invoice reporting", "NAV API", "XML 3.0 Hungary", "invoiceData.xsd", "Online Invoicing System", "e-számla", "Hungarian invoice reporting", or "ManageInvoiceRequest". ALWAYS read this skill before touching any Hungary invoicing compliance work.

HUty-2025

Use this skill

This skill is open source and free to use in any AI agent. Copy it, download it, or clone the repo. If you find an error, report an issue — a licensed accountant will review.

5 of 5 in the HU workflow: