Számlázási szolgáltató beállításai
Útvonal: Beállítások → Számla
Állítsd be, melyik szolgáltatót használja a CADENSA, amikor számlát generálsz az időbejegyzésekből.
A Belső PDF minden csomagban elérhető (FREE/PRO/ENTERPRISE). A külső számlázási szolgáltatók (Billingo, Lexoffice, Pennylane, Holded, SmartBill) PRO vagy ENTERPRISE csomagot igényelnek.
Szolgáltatók
Belső PDF (alapértelmezett)
Nem igényel külső integrációt. A CADENSA helyben generál egy márkázott PDF dokumentumot.
Azonnal működik — nincs szükség API kulcsra- Proforma számlákhoz és munkakimutatásokhoz megfelelő
Nem minősül jogilag érvényes adószámlának- Nincs NAV / e-számla megfelelőség
Billingo
A Billingo egy magyar online számlázási platform, amely megfelel a NAV Online Számla 3.0 követelményeinek.
- Jogilag érvényes magyar adószámla
- NAV Online Számla 3.0 kompatibilis
- Partnerlista-szinkron — ügyfelek kiválasztása a Billingo címjegyzékedből
- Automatikus számlaszám a Billingótól
- A PDF-en szerepel a Billingo számlaszáma
- Szükséges: Billingo API kulcs (v3)
- 📖 Billingo beállítási útmutató
Lexoffice
Német számlázási platform (Haufe Group), amely támogatja a ZUGFeRD / E-Rechnung szabványt.
- Jogilag érvényes német / osztrák / svájci számla
- ZUGFeRD / E-Rechnung (kötelező a német B2B-nél 2025-től)
- Partnerlista-szinkron — ügyfelek kiválasztása a Lexoffice címjegyzékedből
- Automatikus számlaszám a Lexoffice-tól
- Szükséges: Lexoffice API kulcs (Bearer token)
- 📖 Lexoffice beállítási útmutató
Pennylane
Francia számlázási platform, amely a Factur-X (beágyazott XML-lel ellátott PDF/A-3) szabványt támogatja, az FR, BE, LU, CH piacokra célozva.
- Jogilag érvényes francia számla (Factur-X)
- Factur-X kötelező 2026-09-től (nagyvállalatoknál) — fokozatos bevezetés 2027-ig
- Automatikus ügyfélkeresés vagy -létrehozás
- Francia ÁFA-kulcs kódok (20% / 10% / 5,5% / mentes)
- Piszkozat mód — előbb piszkozatot hoz létre, véglegesítés igény szerint
- Nincs sandbox — teszteléshez használd a piszkozat módot
- Szükséges: Pennylane API token (Bearer)
- 📖 Pennylane beállítási útmutató
Holded
Spanyol számlázási platform, amely a FacturaE e-számlázást támogatja, az ES, PT, IT, FR, DE piacokra célozva.
- Jogilag érvényes spanyol számla (FacturaE-kompatibilis)
- Automatikus kontaktkeresés vagy -létrehozás (adószám vagy név alapján)
- Spanyol IVA-kulcs leképezés (21% / 10% / 4% / mentes)
- Többnyelvű számlák (ES, EN, FR, DE, PT)
- Számla érvénytelenítés/törlés a Holded API-n keresztül
- Nincs sandbox — fejlesztéshez használj teszt kontaktokat
- Szükséges: Holded API kulcs
- 📖 Holded beállítási útmutató
SmartBill
Román számlázási platform e-Factura / ANAF megfelelőséggel, romániai bejegyzésű vállalkozásoknak.
- Jogilag érvényes román számla (factură fiscală)
- e-Factura / ANAF megfelelőség (kötelező B2B e-számla-továbbítás)
- Román TVA-kulcs leképezés (
Normala19% /Redusa9% /Redusa15% /Scutit0%) - Számla törlés (anulare) a SmartBill API-n keresztül
- Nincs partnerválasztó — a SmartBill REST API-nak nincs ügyféllista-végpontja; az ügyféladatokat kézzel kell kitölteni
- Nincs sandbox mód — fejlesztéshez használj teszt számlasorozatot a SmartBill Cloudban
- Szükséges: SmartBill API token + fiók e-mail cím + cég CIF/CUI
- 📖 SmartBill beállítási útmutató
Egyéb szolgáltatók
| Szolgáltató | Piac | Állapot |
|---|---|---|
| Számlázz.hu | Magyarország (NAV) | Hamarosan |
| Fakturoid | Csehország / Szlovákia | Hamarosan |
| Moneybird | Hollandia (Peppol) | Hamarosan |
| e-conomic | Dánia / Norvégia / Svédország | Hamarosan |
Billingo beállítása
1. Szerezd meg a Billingo API kulcsodat
- Jelentkezz be az app.billingo.hu oldalon
- Menj az Integráció → API menüpontra
- Kattints a + Új API kulcs létrehozása gombra
- Másold ki a generált v3 API kulcsot
Tartsd titokban az API kulcsodat. Ne oszd meg, és ne commitold verziókezelőbe.
2. Beállítás a CADENSA-ban
- Nyisd meg a Beállítások → Számla menüt a CADENSA-ban
- Válaszd a Billingo szolgáltatót
- Illeszd be az API kulcsodat az API Key mezőbe
- Kattints a Kapcsolat tesztelése gombra — a Mentés gomb csak sikeres teszt (zöld ✓) után válik aktívvá
- (Opcionális) Kapcsold be a Sandbox módot valós számlák kiállítása nélküli teszteléshez
- Kattints a Mentés gombra
A Mentés gomb mindaddig inaktív, amíg az API kulcs tesztje nem volt sikeres. Sikertelen vagy nem tesztelt kulcsot nem lehet elmenteni. Ez megakadályozza, hogy egy hibásan konfigurált integráció csendben megtörje a számlakiállítást.
3. Alapértelmezett értékek beállítása
Állítsd be az alapértelmezéseket, hogy a Számla generálása párbeszédablak előre ki legyen töltve:
| Beállítás | Leírás |
|---|---|
| Alapértelmezett pénznem | Új számlákon használt pénznem (pl. HUF, EUR) |
| Alapértelmezett ÁFA % | A párbeszédablakban előre kitöltött adókulcs (pl. 27 Magyarországnál) |
| Fizetési határidő (napok) | Az esedékesség napjainak száma (pl. 30) |
| Alapértelmezett dokumentumtípus | Melyik dokumentumtípus van előre kiválasztva (proforma / munkakimutatás / számla) |
| Kibocsátó ország | A céged országa ISO 3166-1 alfa-2 kódként (pl. HU, DE, AT). Az automatikus ÁFA-javaslathoz szükséges (fordított adózás, export felismerése). |
A Kibocsátó ország mező bekapcsolja az intelligens ÁFA-javaslatokat a Számla generálása párbeszédablakban. Nélküle a CADENSA a vevő belföldi ÁFA-kulcsára esik vissza minden tranzakciónál. Részletek: Számla generálása — ÁFA-javaslat.
4. Billingo-specifikus beállítások konfigurálása
| Beállítás | Leírás |
|---|---|
| Számlablokk azonosító | A használandó Billingo számlablokk (Billingo → Beállítások → Blokkok) |
| Bankszámla azonosító | A Billingo bankszámla-azonosítód (opcionális — a számlán jelenik meg) |
| Fizetési mód | Alapértelmezett fizetési mód a kiállított számlákon |
| Nyelv | A számla nyelve (hu, en, de, …) |
5. (Opcionális) Kibocsátói adatok beállítása
A PDF-en szereplő kibocsátói szakasz (a céged adatai) a Munkaterület beállításai → Számlázás menüből származik:
- Cégnév
- Utca, Város, Irányítószám, Ország
- ÁFA / adószám
- Számlázási e-mail
A (ugyanezen az oldalon beállított) Kibocsátó ország mezőt a Számla generálása párbeszédablak automatikus ÁFA-javaslata is felhasználja — ez elkülönül a számlázási cím országától.
Dokumentumtípus útválasztás
| Dokumentumtípus | Szolgáltató beállítás | Kimenet |
|---|---|---|
| Proforma | Csak belső PDF | Belső PDF |
| Munkakimutatás | Csak belső PDF | Belső PDF |
| Számla | belső PDF | Belső PDF |
| Számla | Billingo | Billingo API-ra küldve → PDF visszatöltve |
| Számla | Lexoffice | Lexoffice API-ra küldve → PDF visszatöltve |
| Számla | Pennylane | Pennylane API-ra küldve → PDF visszatöltve |
| Számla | Holded | Holded API-ra küldve → PDF visszatöltve |
| Számla | SmartBill | SmartBill API-ra küldve → PDF visszatöltve |
Ha egy külső szolgáltatót (Billingo, Lexoffice stb.) választasz, a Dokumentumtípus választó automatikusan Jogi számla értékre vált, és a Proforma / Munkakimutatás opciók elérhetetlenné válnak. Ezek a dokumentumtípusok csak a Belső PDF szolgáltatóval használhatók.
Szolgáltatók összehasonlítása
| Jellemző | Belső PDF | Billingo 🇭🇺 | Lexoffice 🇩🇪 | Pennylane 🇫🇷 | Holded 🇪🇸 | SmartBill 🇷🇴 |
|---|---|---|---|---|---|---|
| Piac | Bármelyik | Magyarország | DE / AT / CH | FR / BE / LU / CH | ES / PT / IT | Románia |
| Jogi számla | | NAV 3.0 | ZUGFeRD / E-Rechnung | Factur-X | FacturaE | e-Factura / ANAF |
| API kulcs szükséges | | | | | | |
| Sandbox mód | — | | | (piszkozat mód) | (teszt kontaktok) | (teszt sorozat) |
| Partnerválasztó | | | | (auto keresés/létrehozás) | (auto keresés/létrehozás) | (nincs API végpont) |
| Beállítási útmutató | — | Billingo útmutató | Lexoffice útmutató | Pennylane útmutató | Holded útmutató | SmartBill útmutató |
Kapcsolat tesztelése
A hitelesítő adatok megadása után használd a Kapcsolat tesztelése gombot. A CADENSA meghívja a szolgáltató API-ját, és ellenőrzi:
- Az API kulcs érvényes-e
- A fiók aktív-e
- A szükséges jogosultságok elérhetők-e (számlák olvasása + írása)
Sikeres teszt esetén:
✓ Sikeres kapcsolat — Billingo fiók: A Te Céged Kft.
Sikertelen teszt esetén megjelenik a hiba oka (érvénytelen kulcs, lejárt, hozzáférés megtagadva stb.).
A Mentés gomb inaktív marad, amíg a kapcsolat tesztje nem sikeres. Nem tesztelt vagy sikertelen tesztű API kulcsot nem lehet elmenteni. Ha csak más beállításokat módosítasz (pénznem, ÁFA %, fizetési feltételek) és nem adod meg újra a kulcsot, nem szükséges újratesztelni.
Hibaelhárítás
„INVOICE_NO_BILLABLE_ITEMS" hiba
A kiválasztott dátumtartományon belül minden tétel amount = 0 értékű. Ez akkor fordul elő, ha a projektjeidhez nincs beállítva óradíj.
Megoldás: Menj a Beállítások → Díjtételek menübe, és állíts be óradíjakat a projektjeidhez.
„Partner not found" hiba
A megadott ügyféladatok nem egyeznek egyetlen létező Billingo partnerrel sem, és az automatikus létrehozás nem sikerült.
Megoldás: Hozd létre a partnert kézzel a Billingóban, majd használd a partnerválasztót a Számla generálása párbeszédablakban.
A PDF-en nincs számlaszám
A Billingo API-hívás sikeres volt, de a PDF újragenerálása a külső számlaszámmal nem sikerült. Az eredeti PDF (szám nélkül) megmaradt.
Megoldás: Töltsd le újra a PDF-et a Számlázás → Számlaelőzmények menüből — a tárolt rekordban a helyes számlaszám szerepel.
Sandbox mód
Kapcsold be a Sandbox módot a szolgáltató beállításaiban, hogy valódi számlák kiállítása nélkül tesztelhess. A sandbox számlák nem jelennek meg a NAV-nál vagy a hivatalos Billingo számlalistádon.
Hamarosan érkező integrációk
A következő integrációk fejlesztés alatt állnak:
- Számlázz.hu — Magyar NAV Online Számla rendszer (alternatíva a Billingo mellett)
- Fakturoid — Csehország és Szlovákia
- Moneybird — Hollandia és Belgium
- e-conomic — Skandinávia (Dánia, Svédország, Norvégia)
Ha egy adott integráció fontos számodra, jelezd a support@cadensa.io e-mail-címen.