A Zenamu lehetővé teszi bizonylatok (számla / nyugta) automatikus kiállítását a Billingo.hu vagy a Számlázz.hu segítségével. A bizonylatok a NAV Online Számla rendszerbe kerülnek bejelentésre. Ez a cikk végigvezeti a teljes beállítási folyamaton.
Miért van erre szükség?
A magyar adójogszabályok előírják, hogy minden értékesítésről bizonylatot kell kiállítani: azonnali fizetéseknél (kártya, készpénz, PayPal) azonnal, banki átutalásnál a teljesítéstől számított 8 napon belül. Az adatokat a NAV Online Számla rendszerbe is be kell jelenteni. A Billingo és a Számlázz.hu a NAV adatszolgáltatást a kiállítás pillanatában automatikusan elvégzi.
Az összekapcsolás után a Zenamu minden kifizetett megrendeléshez automatikusan kiállítja a bizonylatot (a megrendelés állapota „Kifizetve" kell legyen). Megrendelés lemondásakor — ha az korábban „Kifizetve" állapotú volt — automatikusan sztornó bizonylat készül.
Az ügyfél és Ön egyaránt látja a kiállított bizonylatokat a rendszerben.
Az ügyfelek e-mailt is kapnak a PDF bizonylat letöltési linkjével.
Követelmények
A beállítás előtt ellenőrizze:
Expert, Ultimate vagy 14 napos próbaidőszak — alacsonyabb csomagoknál a Billingo/Számlázz.hu integráció nem elérhető.
Kitöltött számlázási cím adószámmal.
Beállított ÁFA státusz (ÁFA-körös 27%, alanyi adómentes vagy tárgyi adómentes).
Aktív fiók a Billingónál VAGY a Számlázz.hu-nál — kitöltött vállalkozási adatokkal, beállított bankszámlával és aktív NAV Online Számla összekapcsolással.
Fontos: A NAV Online Számla összekapcsolásnak aktívnak kell lennie a szolgáltató (Billingo / Számlázz.hu) fiókjában, mielőtt aktiválná a Zenamuban. Enélkül a bizonylatok létrejönnek, de nem kerülnek bejelentésre a NAV felé. A regisztrációt az onlineszamla.nav.gov.hu oldalon végezheti el.
API kulcs megszerzése — Billingo
A Zenamu összekapcsolása előtt végezze el az alábbi lépéseket a Billingo adminisztrációjában:
1. Vállalkozási adatok kitöltése
Lépjen a Beállítások → Vállalkozási adatok menüpontra, és töltse ki a cégnevet, címet, adószámot és ÁFA státuszt. Enélkül a Billingo nem engedélyezi éles bizonylatok kiállítását.
2. Bankszámla hozzáadása
Beállítások → Számlázó → Bankszámlák → Új bankszámla
Bank neve: pl. „OTP Bank"
Bankszámlaszám: a számlaszám
Pénznem: HUF
Ne pipálja ki a „Ne jelenjen meg a számlán" opciót — a bankszámlának látszania kell a bizonylatokon.
3. Számlatömb (bizonylattömb) létrehozása számlához
Az előtagokat manuálisan kell létrehoznia a Billingo adminisztrációjában, mielőtt betöltené a Zenamuban.
Beállítások → Számlázó → Bizonylattömbök → Új Bizonylattömb
A Billingo 4 lépéses varázsló segít:
Alapadatok: Adjon nevet a tömbnek (pl. „Zenamu"), adjon meg prefixet (pl. „ZENAMU"), válassza ki a bankszámlát a 2. lépésből, töltse ki a küldő e-mail címet.
További beállítások: Hagyja bekapcsolva az „Azonnali fizetési módok... automatikusan fizetettre állítódnak" opciót (azonnali fizetések automatikusan „fizetve" státuszba kerülnek).
Logo: Opcionális — feltöltheti a stúdió logóját.
Sablon: Válasszon vizuális sablont (csak megjelenési kérdés).
4. (Opcionális) Számlatömb létrehozása nyugtához
Ha helyszíni fizetéseket fogad számlázási cím nélküli ügyfelektől, vagy helyszíni fizetésekhez nyugtát szeretne kiállítani, szükség van egy külön számlatömbre nyugtákhoz. A nyugta nem igényli a vevő címét.
Beállítások → Számlázó → Bizonylattömbök → Új Bizonylattömb → válassza a Nyugta típust (ne Számla). Adjon más prefixet, mint a számlánál (pl. „ZENAMU-NY").
Fontos: Olyan előtagot használjon, amelyet korábban nem alkalmazott más számlázási rendszerben. Az azonos előtagok NAV adatszolgáltatási problémákat okozhatnak.
5. NAV Online Számla összekapcsolása
Beállítások → INTEGRÁCIÓK → NAV összekötés — adja meg a NAV portálon létrehozott technikai felhasználó adatait.
6. API kulcs generálása
Beállítások → INTEGRÁCIÓK → API kulcsok → + Új API kulcs
API verzió: V3 (V3-nak kell lennie)
API neve: „Zenamu" (belső megnevezés)
Hozzátartozó összekötés: Válassza az Egyedi fejlesztés opciót (saját integráció)
API hatásköre: Olvasás és Írás — mindkét jogosultság szükséges
Kattintson a Mentés gombra, és másolja ki a generált kulcsot.
API kulcs megszerzése — Számlázz.hu
1. Vállalkozási adatok kitöltése
Alapbeállítások — cégnév, cím, adószám, bankszámla adatok. Ezek jelennek meg a bizonylatokon kibocsátóként.
2. Számla Agent aktiválása
A Számla Agent a Számlázz.hu kiegészítő szolgáltatása, amellyel API-n keresztül lehet bizonylatokat kiállítani. Darabonként kerül felszámításra. Minden tarifnál elérhető, a free-t is beleértve.
3. NAV Online Számla összekapcsolása
A Billingóhoz hasonlóan — a Számlázz.hu beállításaiban adja meg a NAV portálról származó adatokat.
4. Előtag létrehozása a dokumentumszámozáshoz
Beállítások → Előtagok → Új előtag
A Számlázz.hu API nem tud előtagokat létrehozni és lekérdezni — a Számlázz.hu adminisztrációjában kell manuálisan létrehoznia őket, mielőtt megadja a Zenamuban.
Előtag számlához:
Típus: Számlaszám előtag
Előtag: max 5 karakter, pl. „ZENAM"
Pipálja ki az „Engedélyezem az előtag használatát" opciót
Előtag nyugtához — opcionális:
Típus: Nyugtaszám előtag
Előtag: más, mint a számlánál, max 5 karakter, pl. „ZENNY"
Fontos: Olyan előtagot használjon, amelyet korábban nem alkalmazott más számlázási rendszerben. Az azonos előtagok NAV adatszolgáltatási problémákat okozhatnak.
5. Számla Agent kulcs (API kulcs) kimásolása
Beállítások → Számla Agent → másolja ki a kulcsot.
Beállítás a Zenamuban — lépésről lépésre
Lépjen a Beállítások → Fizetések → Fizetési bizonylatok oldalra. Győződjön meg arról, hogy a bizonylatkiállítás kapcsolója be van kapcsolva.
Lépjen a Külső számlázás (NAV) szekcióhoz — a bizonylatok szekció alatt jelenik meg.
Válassza ki a szolgáltatót — Billingo.hu vagy Számlázz.hu.
Adja meg az API kulcsot, és kattintson a Kapcsolat tesztelése gombra. A rendszer ellenőrzi, hogy a kulcs érvényes-e.
Dokumentumszámozás beállítása:
Billingo: A legördülő listából válassza ki a számlatömböt (bizonylattömb), amelyet a Billingóban létrehozott.
Számlázz.hu: Adja meg a Számlázz.hu adminisztrációjában létrehozott előtagot. Az előtagnak pontosan egyeznie kell — a Zenamu API-n keresztül nem tudja ellenőrizni.
(Billingo) Bankszámla: Ha több bankszámlája van a Billingóban, válassza ki, melyik jelenjen meg a bizonylatokon. Ha csak egy van, automatikusan az kerül használatra.
Bizonylatok helyszíni fizetésekhez: Határozza meg, hogyan kezelje a rendszer a helyszíni fizetéseket (készpénz / kártya a stúdióban):
Mindig bizonylat kiállítása — minden helyszíni fizetéshez automatikusan készül bizonylat.
Bizonylat kiállításának mellőzése — helyszíni fizetésekhez nem készül külső bizonylat.
Okos mód: ügyfél szerint — csak akkor készül bizonylat, ha az ügyfélnek van számlázási címe vagy korábbi bizonylata.
Bizonylat típusa helyszíni fizetésekhez (a „Mindig" vagy „Okos mód" választásakor jelenik meg):
Számla — az ügyfél számlázási címe szükséges.
Nyugta — cím nem szükséges, de csak azonnali fizetéseknél, legfeljebb 900 000 HUF összegig érvényes.
Ha nyugtát választ, állítsa be a számlatömböt / előtagot nyugtákhoz is (Billingo: legördülő lista, Számlázz: előtag megadása).
Kattintson a Mentés gombra. A Zenamu újra validálja az API kulcsot és elmenti a beállításokat.
Tipp: A Zenamuban beállított bankszámla (Beállítások → Fizetési módok → Bankszámla) egyezzen meg a szolgáltatónál beállított bankszámlával. A bizonylatokon a szolgáltató fiókjából származó adatok jelennek meg.
Mi történik az aktiválás után?
Minden fizetett megrendeléshez (bankkártya, PayPal, átutalás, helyszíni fizetés) automatikusan készül számla vagy nyugta.
A bizonylatot a szolgáltató automatikusan jelenti a NAV-nak.
Az ügyfél e-mailt kap a PDF letöltési linkjével.
Megrendelés lemondásakor vagy visszatérítéskor automatikusan sztornó bizonylat készül.
Ha a kiállítás sikertelen, a megrendelés részleteiben megjelenik a hiba és az Újrapróbálás gomb.
Számla és nyugta — mikor melyik készül?
Bankkártya (Stripe) — Számla. Online fizetés — mindig számla.
Banki átutalás — Számla. Nem azonnali fizetés — nyugta nem megengedett.
PayPal — Számla. Online fizetés — mindig számla.
GoCardless — Számla. Beszedés — nem azonnali fizetés.
Helyszíni + van cím — A beállítás szerint. A 7. lépésben választott típus.
Helyszíni + nincs cím — Nyugta. Számla nem állítható ki cím nélkül.
Számla kötelező (nyugta nem megengedett) az alábbi esetekben — a beállítástól függetlenül:
Az összeg eléri vagy meghaladja a 900 000 Ft-ot
A vevő jogi személy vagy ÁFA-fizető (a Zenamu a számlázási adatoknál nem gyűjt jogi személyekre vonatkozó adatokat — a Zenamun keresztül csak végfelhasználóknak állíthatók ki bizonylatok)
ÁFA státusz hatása
ÁFA (27%) — a bizonylaton az ÁFA összege és az adóalap külön feltüntetésre kerül.
AAM (alanyi adómentes) — a bizonylaton az „Alanyi adómentes" megjegyzés jelenik meg, ÁFA nincs felszámítva.
MENTES (tárgyi adómentes) — a bizonylaton az „ÁFA-mentes tevékenység" megjegyzés jelenik meg.
ÁFA kulcsok ÁFA-fizető vállalkozásoknak
A magyar adójogszabályok kizárólag az alábbi ÁFA kulcsokat engedélyezik: 0%, 5%, 18% és 27%. A Zenamuban a legördülő listából választhatja ki a megfelelő adókulcsot — egyéni értéket nem lehet megadni.
Az adókulcsok a Beállítások → Fizetések → Fizetési bizonylatok oldalon állíthatók be, külön a szolgáltatásokhoz és külön az árucikkekhez. Az ajándékutalványok a szolgáltatásokhoz beállított adókulccsal adóznak.
Szolgáltató váltása
Ha másik szolgáltatóra szeretne váltani:
Válassza le az aktuális szolgáltatót a Leválasztás gombbal.
Állítsa be az új szolgáltatót a fenti lépések szerint.
A korábban kiállított bizonylatok az eredeti szolgáltatónál maradnak. Ha egy régi megrendelést sztornóz, a sztornó az eredeti szolgáltatón keresztül történik.
Csomag korlátozások
Ha visszalép alacsonyabb csomagra:
A beállítások megmaradnak — nem kell újra konfigurálnia.
Az automatikus bizonylatkiállítás szünetel.
Narancssárga figyelmeztetés jelenik meg a „Csomag frissítése" hivatkozással.
Visszaváltás Expert vagy Ultimate csomagra: az automatikus kiállítás azonnal folytatódik.
Gyakran ismételt kérdések
Mi történik a korábban fizetett megrendelésekkel?
Az integráció aktiválása előtti megrendelésekhez nem készül külső bizonylat. Csak az aktiválás utáni fizetések kapnak automatikusan bizonylatot.
Használhatok egyszerre két szolgáltatót?
Nem. Egy időben csak egy szolgáltató lehet aktív. A korábban kiállított bizonylatok az eredeti szolgáltatón maradnak (pl. sztornó céljából).
Mi van, ha lejár vagy érvénytelen az API kulcs?
A Zenamu naponta ellenőrzi a szolgáltatóval való kapcsolatot. Ha az API kulcs érvénytelen, figyelmeztető e-mailt kap. Generáljon új kulcsot a szolgáltató adminisztrációjában, majd frissítse a Zenamuban (Beállítások → Fizetések → Külső számlázás).
A Zenamu küld bizonylatot az ügyfélnek e-mailben?
Igen. A bizonylat kiállítása után a Zenamu e-mailt küld az ügyfélnek a PDF letöltési linkjével.
Mennyibe kerül az integráció?
A Zenamu az integrációért nem számít fel külön díjat. A költségek a szolgáltatótól függenek:
Billingo: Havi vagy éves előfizetés.
Számlázz.hu: Darabonkénti díj a Számla Agent szolgáltatáson keresztül.
Ha az ügyfél céges számlát kér (B2B, adószámmal)?
A Zenamu magánszemélyeknek (B2C) állít ki automatikusan bizonylatot. Ha egy céges ügyfélnek adószámos számlára van szüksége, a bizonylatot manuálisan kell kiállítani a Billingo vagy Számlázz.hu saját felületén.
Miért nem tudok egyéni ÁFA kulcsot megadni?
A magyar jogszabályok kizárólag meghatározott ÁFA kulcsokat engedélyeznek. A rendszer ezért csak az érvényes értékeket kínálja fel: 0%, 5%, 18% és 27%. Az adókulcsot a Beállítások → Fizetések → Fizetési bizonylatok oldalon választhatja ki.
Milyen adókulccsal adóznak az ajándékutalványok?
Az ajándékutalványok a szolgáltatásokhoz beállított adókulccsal adóznak (a „Szolgáltatások adókulcsa" mező értékével). Ezt a Beállítások → Fizetések → Fizetési bizonylatok oldalon találja.
Miért nem tudok a Számlázz.hu-nál előtagot választani legördülő listából?
A Számlázz.hu API nem teszi lehetővé az előtagok lekérdezését. Az előtagot a Számlázz.hu adminisztrációjában kell létrehozni, majd pontosan ugyanazt kell beírni a Zenamuban.
Kredittel, bérlettel fizetett megrendelésekhez készül bizonylat?
Nem. Külső bizonylat csak valódi pénzmozgásnál (HUF) készül. A bizonylat a kredit vagy bérlet megvásárlásakor készül el, nem a felhasználáskor.
Kapcsolódó cikkek