Lexoffice integráció
A Lexoffice egy online könyvelési és számlázási platform a DACH piac számára (Németország , Ausztria , Svájc ). Támogatja a ZUGFeRD és E-Rechnung e-számlázási szabványokat.
Németországban az E-Rechnung (elektronikus számla) 2025. január 1-jétől kötelező a B2B tranzakciókban vállalkozások között. A Lexoffice biztosítja a ZUGFeRD-kompatibilis számlák automatikus kiállítását.
Előfeltételek
- Aktív Lexoffice fiók (bármely csomag)
- Lexoffice API kulcs (lásd alább)
- CADENSA Számlázási szolgáltató beállítása szükséges
API kulcs generálása
- Jelentkezz be a Lexoffice fiókodba
- Nyisd meg a Profil → Erweiterungen (Bővítmények) menüt
- Kattints az API fülre
- Kattints a Neuen API-Schlüssel generieren (Új API kulcs generálása) gombra
- Másold ki a generált kulcsot — csak egyszer látható!
Az API kulcsot biztonságos helyen tárold (pl. jelszókezelő). Ha elveszíted, új kulcsot kell generálni.
Lexoffice beállítása a CADENSA-ban
- Nyisd meg a Beállítások → Számla menüt
- Válaszd a Lexoffice szolgáltatót
- Illeszd be a Lexoffice API kulcsodat az API Key mezőbe
- Kattints a Kapcsolat tesztelése gombra — ez megerősíti, hogy a kulcs érvényes
- Kattints a Mentés gombra
Alapértelmezett értékek beállítása
| Beállítás | Ajánlott érték (DE) | Leírás |
|---|---|---|
| Alapértelmezett pénznem | EUR | Új számlákon alkalmazott pénznem |
| Alapértelmezett ÁFA % | 19 | Standard német MwSt (Regelsteuersatz) |
| Fizetési határidő (nap) | 30 | Esedékesség napjai |
| Alapértelmezett dokumentumtípus | Számla | Ez lesz előre kiválasztva az párbeszédablakban |
| Kibocsátó ország | DE | A cég országa — automatikus ÁFA javaslat engedélyezéséhez |
ÁFA kulcsok
| Kulcs | Arány | Leírás |
|---|---|---|
19 | 19% | Standard Regelsteuersatz — általános áruk és szolgáltatások |
7 | 7% | Ermäßigter Steuersatz — élelmiszer, könyvek, egyes szolgáltatások |
0 | 0% | Steuerfrei — adómentes ügyletek, export, közösségen belüli értékesítés |
Kulcs / Felhasználási eset
| Kulcs | Felhasználási eset |
|---|---|
| 19% | Standard üzleti szolgáltatások, tanácsadás |
| 7% | Élelmiszer, könyvek, egyes kulturális szolgáltatások |
| 0% | Export, közösségen belüli értékesítés, adómentes ügyletek |
Dokumentum típus útválasztás
| Dokumentumtípus | Kimenet |
|---|---|
| Proforma | Belső PDF (nem kerül elküldésre a Lexoffice-ba) |
| Munkakimutatás | Belső PDF (nem kerül elküldésre a Lexoffice-ba) |
| Számla | Elküldve a Lexoffice API-ra → PDF visszatöltve |
Partner kereső
A számla generálásakor a Partner kereső lehetővé teszi, hogy a Lexoffice-fiókodból keress ügyfeleket:
- A Számla generálása párbeszédablakban kattints a Partner keresése gombra
- Gépeld be az ügyfél nevét (minimum 2 karakter)
- Válaszd ki a megfelelő ügyfelet a listából
- Az összes ügyfélmező automatikusan kitöltődik (név, cím, adószám)
Ha az ügyfél nem szerepel a listában, töltsd ki manuálisan a mezőket. Az ügyfél nem kerül automatikusan létrehozásra a Lexoffice-ban — ezt manuálisan kell megtenni a Lexoffice felületén.
PDF letöltés
A Lexoffice az aszinkron PDF-generálást polling mechanizmussal végzi:
- A számla létrehozása után a CADENSA automatikusan lekérdezi a PDF állapotát
- A PDF általában 5-15 másodpercen belül elérhető
- A letöltési gomb a Jelentések → Számlák fülön jelenik meg, amint a PDF kész
Ha a PDF 2 perc után sem töltődik le, frissítsd az oldalt.
Számla visszavonása / törlése
Egy kész (finalized) Lexoffice-számla nem törölhető, csak stornózható. Kövessük a Lexoffice szabályait.
- Vázlat (draft) számlák: Törölhetők a Lexoffice felületén
- Kész számlák: Stornó számla (Stornierung) kiállítása szükséges a Lexoffice-ban
Hibaelhárítás
„Érvénytelen API kulcs" hiba
- Ellenőrizd, hogy a teljes kulcsot másoltad-e be (kezdő/záró szóközök nélkül)
- Generálj új API kulcsot a Lexoffice-ban, ha az előző lejárt
„Partner nem található" — kereső üres
- A partner kereső a Lexoffice-fiókodban lévő ügyfeleket mutatja
- Ha az ügyfél nem szerepel, hozd létre előbb a Lexoffice-ban
A PDF letöltése sikertelen
- Ellenőrizd az internetkapcsolatot
- Próbáld meg a letöltést 30 másodperccel később
- Ha a probléma fennáll, vedd fel a kapcsolatot: support@cadensa.io
„Kapcsolat tesztelése" sikertelen
- Ellenőrizd az API kulcsot
- Ellenőrizd, hogy a Lexoffice-fiókod aktív
- Ellenőrizd, hogy az API kulcsnak van-e számlázási jogosultsága
Lexoffice vs. Billingo
| Funkció | Lexoffice 🇩🇪 | Billingo 🇭🇺 |
|---|---|---|
| Piac | DE / AT / CH | Magyarország |
| Jogi szabvány | ZUGFeRD / E-Rechnung | NAV Online Számla 3.0 |
| Hitelesítés | Bearer token (API kulcs) | API kulcs (v3) |
| Sandbox mód |  Nem elérhető |  Elérhető |
| Partner kereső | /contacts endpoint | /partners endpoint |
| PDF generálás | Aszinkron (polling) | Szinkron |
| Számla véglegesítés | Explicit (?finalize=true) | Automatikus |
Lásd még
- Számlázási szolgáltatók — Összes elérhető integráció
- Pennylane integráció — Francia piac
- Holded integráció — Spanyol piac
- SmartBill integráció — Román piac
- Számla generálása