> ## Documentation Index
> Fetch the complete documentation index at: https://docs.penzum.app/llms.txt
> Use this file to discover all available pages before exploring further.

# NAV Online Invoice Connection

> Sync outgoing and incoming invoices directly from the Hungarian tax authority

The NAV Online Invoice integration allows Penzum to pull your issued and received invoices directly from the Hungarian tax authority's (NAV) database — regardless of which invoicing software you use.

## Why use it?

* No manual income entry required
* All NAV-registered invoices sync automatically
* Incoming invoices issued to you also sync as expenses
* Can coexist with Számlázz.hu or Billingo, but only one source can be active at a time

## Step 1 — Create a Technical User

Penzum connects via a **technical user** that you create in NAV's system. It grants read-only access.

1. Log in at **[onlineszamla.nav.gov.hu](https://onlineszamla.nav.gov.hu)** with your NAV credentials
2. In the top menu, select **Felhasználók** (Users)
3. Click **Technikai felhasználó létrehozása** (Create Technical User)
4. Enter a name (e.g. "Penzum") and click **Mentés** (Save)
5. The system generates four credentials — copy or download all of them:
   * **XML signature key** (xmlSignatureKey)
   * **XML exchange key** (xmlExchangeKey)
   * **Username** (login)
   * **Password**

<Warning>
  The password and keys are shown only once — save them immediately in a secure location, as NAV will not display them again.
</Warning>

### Required Permission

When creating the technical user, select the **Számlák kezelése** (Invoice Management) permission. This is sufficient for the sync — no other permissions are needed.

## Step 2 — Connect in Penzum

You can enter the technical user credentials in two ways:

### QR Code (recommended)

1. On the NAV portal, open the technical user details and click **QR kód generálása** (Generate QR Code)
2. In Penzum's Settings, click **QR kód beolvasása** (Scan QR Code)
3. Hold the NAV portal QR code up to the camera — the fields fill in automatically

### Manual Entry

1. Open **Settings → Online invoicing and bank integrations**
2. Select **NAV Online Invoice** as the source
3. Click **Manuális megadás** (Manual entry)
4. Fill in the four fields with the credentials from the NAV portal
5. Click **Test Connection** — on success, the integration activates

## Sync Types

| Type              | Direction | Appears in    |
| ----------------- | --------- | ------------- |
| Outgoing invoices | OUTBOUND  | Income page   |
| Incoming invoices | INBOUND   | Expenses page |

The first sync pulls all invoices for the current calendar year. After that, a daily automatic sync runs for changes since the last sync.

Use the **Sync now** button to refresh data at any time.

## Security

Technical user credentials are stored encrypted. The connection is read-only — Penzum never modifies data in the NAV system.

## Disconnecting

You can disconnect at any time under **Settings → Online invoicing and bank integrations** — switch to another source or select **Manual entry**. Already-synced invoices are retained.