Configuration

Technical user

Create a technical user on the Online Számla website (or, for testing, on the test website) and generate its signing key (XML aláírókulcs) and exchange key (XML cserekulcs). The user name, the password and the two keys are needed in Odoo.

Settings

Go to Accounting ‣ Configuration ‣ Settings, scroll to the NAV Online invoice data reporting section, and tick NAV Enable. The same options are available in the NAV Data Reporting tab of the company form.

NAV Data Reporting

  • Operaion Mode: Test sends the reports to the NAV test system with the test credentials, Production to the live system.

  • Do not send invoices to the NAV. FOR TESTING PURPOSES ONLY!: suspends the reporting completely (for example, in a copy of the production database).

  • Loading Taxpayer Name (Short Name or Full Name), Keep the manually set partner name and Keep the manually set partner address: control the taxpayer query on contacts.

  • Do not check the VAT Number: Hungarian tax numbers are accepted without querying NAV.

  • Import Default Journal and Import Default Account: used by the invoice import.

Login Details

  • User Name, Password, Sign Key and Exchange Key of the production technical user;

  • Test User Name, Test Password, Test Sign Key and Test Exchange Key of the technical user created on the test website.

screenshot: finance-fl-hungary-nav-settings
menu
Accounting ‣ Configuration ‣ Settings
shows
Settings page scrolled to the "NAV Online invoice data reporting" section: "NAV Enable" ticked, the operation mode, the testing switch, the taxpayer name options, the import journal and account, the "Login Details" block with the eight credential fields, and the "NAV Export", "NAV Technikai érvénytelenítés" and "NAV Import" buttons.
highlight
The "NAV Data Reporting" and "Login Details" blocks (red frame).
data
Demo company "YourCompany HU"; mode "Test"; test user name "abcdefgh1234567".
module
eyssen_l10n_hu
notes
English UI, light theme, 1440px width, crop to the section. Use throw-away secrets; password and keys must not be readable.

Important

  • The reporting only works if the company’s VAT Number is valid and all four credentials of the selected mode are filled in; otherwise confirming a customer invoice is refused.

  • A copied (neutralized) database should always run in Test mode or with the Do not send invoices to the NAV switch enabled.

Other Settings

  • Automatically post Credit Note: credit notes created with the Credit Note button are confirmed (and therefore reported) immediately.

Reporting invoices

When a customer invoice, corrective invoice or credit note is confirmed, Odoo first checks the mandatory data, then queues the data report. The report is sent by a background job about one minute later and is retried every five minutes until NAV accepts it. Nothing else has to be done by the user.

The NAV tab of the invoice shows the result:

  • NAV Sending Date and NAV Sending State (Beküldés folyamatban while the report is waiting to be sent);

  • NAV Processing State: RECEIVED, PROCESSING, SAVED, DONE (accepted) or ABORTED (rejected);

  • NAV Transaction ID and NAV Response (warnings and error messages of NAV);

  • NAV Submitted XML: the data that was sent;

  • No need to hand it over to the NAV! and It did not have to be submitted to the NAV for the following reasons: if the invoice was not reported.

The NAV Processing State is also displayed as a colored badge in the customer invoice and credit note lists, so rejected reports are easy to find.

screenshot: finance-fl-hungary-nav-tab
menu
Accounting ‣ Customers ‣ Invoices ‣ (posted invoice) ‣ NAV tab
shows
Posted customer invoice with the "NAV" tab open: sending date, sending state, processing state "DONE" in green, transaction ID, empty response, and the submitted XML below.
highlight
The "NAV Processing State" field (red frame).
data
Invoice "KI/2026/00012" for "Minta Kft.", 127,000 HUF, reported in test mode.
module
eyssen_l10n_hu
notes
English UI, light theme, 1440px width, crop to the tab. Normal (non-developer) mode, so the technical buttons are hidden.

An ABORTED report means that NAV refused the data (the reason is in NAV Response). Correct the cause (typically master data such as the tax number or address of the customer, or the NAV settings of a tax group); the report is sent again automatically. In developer mode, the NAV tab also offers the buttons Send to NAV, Immediately Send to NAV, Check State, Get from NAV, Get Invoice Chain from NAV and Link storno to original for administrators.

Invoices that are not reported

No data report is sent, and the reason is recorded on the NAV tab, for

  • vendor bills and other non-customer documents;

  • invoices of journals marked No need to hand it over to the NAV! (see below), and invoices imported from NAV;

  • invoices issued under a foreign VAT registration and EU OSS invoices;

  • any invoice while Do not send invoices to the NAV. FOR TESTING PURPOSES ONLY! is enabled.

Scheduled actions

The following scheduled actions are created (Settings ‣ Technical ‣ Scheduled Actions, in developer mode):

Name

Interval

Purpose

NAV beküldetlen számlák beküldése

5 minutes

Queues posted customer invoices that were not sent yet.

NAV beküldött számlák ellenőrzése

30 minutes

Refreshes the processing state of reports not yet DONE.

NAV sikeresen elvégzett adatküldés műveletek törlése

1 hour

Removes the finished per-invoice sending jobs (NAV adatszolgáltatás: <number>).

NAV számlák importálása (aktuális nap)

1 hour, inactive

Imports the vendor bills reported to NAV today.

NAV számlák importálása (utolsó 30 nap)

2 days, inactive

Imports the vendor bills reported to NAV in the last 30 days.

Journals for invoices issued in another system

Invoices that were issued and reported by another invoicing program (or in a previous system) can be recorded in a dedicated sales journal. In developer mode, open the journal and set, in the Hungarian Invoicing section of the Journal Entries tab:

  • No need to hand it over to the NAV!: the invoices of the journal are never reported and their NAV tab is hidden;

  • No automatic serial number: the invoice number can be typed in on the draft invoice;

  • Backdated date can be set: the invoice date may differ from today;

  • Accept externally-issued foreign VAT invoices: the journal may also record invoices that were issued elsewhere under a foreign VAT registration (requires the first two options).

Warning

Never use such a journal for invoices issued from Odoo: the continuous numbering and the data reporting obligation apply to every invoice issued by the company.

Importing invoices from NAV

Vendor bills reported by suppliers on the company’s tax number can be downloaded from NAV as draft bills. Set the Import Default Journal in the settings first (its default account is the Import Default Account used on lines for which no better account is found).

  • By period: go to Accounting ‣ Vendors ‣ NAV Inbound Invoice Import, set the Start Date and End Date (the dates on which the invoices were reported to NAV), and click Import. The two inactive scheduled actions listed above can do the same automatically.

  • By invoice number: in the settings, click NAV Import, choose the Direction (Inbound or Outbound) and the Journal, and list the Invoice Numbers, one per line. For inbound invoices, type the first eight digits of the supplier’s tax number, a space, then the invoice number (12345678 INV-2026-001).

For every invoice that does not exist yet (an invoice with the same number is skipped, even if it is cancelled), a draft bill is created:

  • the supplier is found by tax number (or name and city); if there is no match, a new company contact is created from the NAV data;

  • the supplier’s invoice number becomes the Bill Reference; the invoice, fulfillment and due dates, the currency and the exchange rate are taken from the report;

  • the lines are created with the product found by name, the unit of measure and a tax matching the reported VAT rate or exemption code. If no matching tax exists, a new tax is created, so review the taxes of imported bills;

  • storno invoices become credit notes linked to the original bill, modifying invoices become corrective invoices;

  • the bill is marked No need to hand it over to the NAV!, its line data is locked against recomputation, and the downloaded XML is stored on the NAV tab.

Check the accounts, taxes and analytic distribution of the draft, then confirm it as usual.

screenshot: finance-fl-hungary-nav-import-wizard
menu
Accounting ‣ Vendors ‣ NAV Inbound Invoice Import
shows
The import dialog with "Direction" (read-only, Inbound), "Start Date", "End Date" and the "Import" and "Cancel" buttons.
highlight
The date fields (red frame).
data
Start Date = first day of the current month, End Date = today.
module
eyssen_l10n_hu
notes
English UI, light theme, 1440px width, crop to the dialog.

Tax audit export

For a tax audit, NAV can request the data of the issued invoices in a standard XML file. In the settings, click NAV Export, set Date from and Date to, and click Export. The file NAV_export.xml contains the posted customer invoices and credit notes whose invoice date falls into the period.

Technical annulment

A data report that was sent with wrong data because of a technical error can be withdrawn with a technical annulment (technikai érvénytelenítés). It does not cancel the invoice itself, only the data report, and nothing changes on the invoice in Odoo.

In the settings, click NAV Technikai érvénytelenítés and fill in:

  • Számla sorszáma: the number of the invoice whose report is annulled;

  • Érvénytelenítés kódja: the reason code (wrong data content, wrong invoice number, wrong issue date, or wrong electronic invoice hash);

  • Érvénytelenítés oka: a free-text explanation.

Click Érvénytelenítés. A notification shows the NAV transaction ID and the status of the request.

Important

According to the rules of the Online Számla system, a technical annulment takes effect only after it has been approved on the Online Számla website by a user of the taxpayer.

Note

The labels of this dialog are displayed in Hungarian in the current module version.