Webshop — saját NAV-azonosító bekötése (számla-automatikus-küldés)
Hogyan kösd be a saját NAV-technikai-felhasználódat a PromNET-webshopba, hogy minden fizetett rendelés után automatikusan menjen az online-számla a saját NAV-fiókoddal.
A PromNET-webshop saját NAV-fiókoddal állít ki online-számlát minden fizetett rendelés után. Ez a kötelező mód — a számla a Te neveden / EV-d / Kft-d alatt megy, a NAV-felé Te vagy a kibocsátó.
Ez azért van így, mert:
- Adójog: az online-számla-kibocsátási kötelezettség az értékesítőé (Te), nem egy köztes szolgáltatóé
- NAV adattovábbítás: 5 percen belül kell mennie a számláknak (NAV Online Számla 3.0). Ezt a saját adótudásod alapján a Te NAV-API-d küldi, NEM a PromNET-é
Mire lesz szükséged
- Aktív NAV-cégbejelentkezés — Központi Ügyfél-szolgálat, kbz.gov.hu
- NAV-technikai-felhasználó (NEM az adóügyintéző fiókod!)
- 3 db kulcs: login, password, signature-key
- 1 db exchange-key (XML-aláírásokhoz)
1. NAV-technikai-felhasználó létrehozása
A NAV-on belül NEM ugyanaz az “ügyfélkapus belépés” mint a “technikai-felhasználó” — ez utóbbi kell a számla-API-hoz:
- Menj a https://onlineszamla.nav.gov.hu-ra
- Lépj be ügyfélkapus azonosítóval (NAV-portál-bejelentkezés)
- Bal-felső menü → Felhasználók → + Új technikai felhasználó
- Add meg:
- Felhasználó-név (saját választás, pl.
promnet-tech-1) - Jelszó (erős, sose használd újra máshol)
- Felhasználó-név (saját választás, pl.
- A létrehozás után megjelenik:
- XML-aláírókulcs (signature-key, ~32 karakter)
- XML-csere-kulcs (exchange-key, ~16 karakter)
FONTOS: ezek a kulcsok MINDÖSSZE EGYSZER jelennek meg! Másold ki őket azonnal, és tedd biztonságos helyre (pl. egy jelszó-menedzser). Ha elveszted, új technikai-felhasználót kell létrehozni.
2. Adattovábbítási jogosultság
A technikai-felhasználódnak külön jogot kell kapnia a számla-küldéshez:
- Felhasználók → válaszd ki a most létrehozott technikai-fiókot
- Tab: Adattovábbítások → kattints “Új adattovábbítási jogosultság”
- Cég: a saját adószámod (alapból ki van töltve)
- Művelet: pipáld be:
- ✅
manageInvoice— számla-küldés - ✅
queryInvoice— küldött-számlák lekérdezése (status-check-hez)
- ✅
- Mentés
Most a technikai-felhasználódnak van joga a Te adóköteles ügyleteid nevében számlát küldeni a NAV-nak.
3. Bekötés a PromNET-webshopba
A PromNET-en:
- Admin → Shop → Beállítások → NAV tab
- Töltsd ki:
- NAV adószám — saját EV / Kft adószámod (8-1-2 formátum:
12345678-1-42) - Login — a 1.lépésben létrehozott technikai-fh-név (
promnet-tech-1) - Password — a hozzá tartozó jelszó
- Signature key — XML-aláírókulcs
- Exchange key — XML-csere-kulcs
- NAV adószám — saját EV / Kft adószámod (8-1-2 formátum:
- Kattints a “Kapcsolat tesztelése” gombra — a PromNET egy üres query-t küld a NAV-nak a fiókod azonosításához. Sikeres → ✓ zöld badge a NAV-API-verzióval (jelenleg 3.0)
- Mentés — a kulcsok titkosítva tárolódnak (AES-GCM, master-key a CF Pages-secret-ben)
4. Hogyan működik élesben
Minden fizetett rendelésnél (shop_orders.status = 'paid') automatikusan:
- A PromNET összeállítja a NAV-Online-Számla-3.0-formátumú XML-t a Te technikai-fiókod alatt
- Aláírja a Te signature-key-eddel
- Beküldi a NAV-nak
- 5-10 másodperc múlva visszakapja a
transactionId-t - Periodikusan check-eli a státuszt (5min cron) →
nav_status: ACCEPTED
Te csak a banki számlán látod a bevételt — a NAV-folyamat fully-auto.
5. Számla-fejléc + bankszámlaszám
A NAV-számlán nem csak az adattovábbítás kell, hanem a számla-fejléc (név, cím, adószám) és a bankszámlaszám (átutalási-fizetésekhez — Stripe-fizetéshez nem feltétel, de ajánlott).
Admin → Shop → Beállítások → Számla tab:
- Cégnév (jogi név, pl. “Kovács Elek e.v.”)
- Cím (telephely vagy magán-lakcím, NAV-bejelentett)
- Bankszámlaszám (28 jegyű GIRO vagy IBAN — opcionális)
- EV / KATA / TAO flag — ÁFA-kezelés alapja
Hibakeresés
- “401 Unauthorized”: rossz login/password vagy a technikai-fh-nek nincs adattovábbítási joga (2.lépés)
- “Invalid signature”: rossz signature-key — másold újra a NAV-ról
- “Tax number mismatch”: a megadott adószám nem egyezik a NAV-fiókoddal
- “NAV server timeout”: a NAV-szervere átmenetileg lassú (gyakori hónap-fordulón) — a rendszer 3× próbálkozik exponential-backoff-fal
Bármilyen kérdés / probléma → Privát ticket.
Pro tipp: már most NAV-aktív vagy?
Ha már online-számláztál NAV-on (pl. korábbi szolgáltatóval), és látod a saját számláidat a NAV-portálon, akkor a technikai-felhasználód valószínűleg már létezik. Kérdezd meg a könyvelődet vagy nézd meg a “Felhasználók” listát az onlineszamla.nav.gov.hu-n — adattovábbítási jogot szükség esetén bővíteni kell, de új user nem feltétlenül kell.