Ugrás a fő tartalomhoz

Lexoffice integráció

A Lexoffice (Haufe Group) egy online könyvelési és számlázási platform a német nyelvű piac (DE / AT / CH) számára. A CADENSA-ban való beállítás után jogilag érvényes számlákat állíthatsz ki közvetlenül a rögzített időbejegyzéseidből — beleértve az automatikus E-Rechnung (ZUGFeRD) generálást is a német B2B számlákhoz, amely 2025-től kötelező.

Támogatott országok

A Lexoffice a Németországban 🇩🇪, Ausztriában 🇦🇹 és Svájcban 🇨🇭 működő vállalkozások számára készült.

Mielőtt elkezdenéd​

Szükséged lesz:

  • Aktív Lexoffice fiókra (bármely csomag — a Public API minden fizetős csomagban elérhető)
  • Lexoffice API kulcsra (lásd alább)
  • CADENSA munkaterületre, ahol legalább Admin szerepköröd van

1. lépés — Szerezd meg a Lexoffice API kulcsodat​

  1. Jelentkezz be az app.lexoffice.de oldalon
  2. A bal oldali menüsávban kattints az Erweiterungen (Bővítmények) menüpontra
  3. A Weitere Apps szekcióban keresd meg a Public API kártyát
  4. Kattints a Verwalten (Kezelés) gombra
  5. Kattints a + API-Schlüssel erstellen (API kulcs létrehozása) gombra
  6. Másold ki azonnal a generált kulcsot — csak egyszer jelenik meg
Tartsd titokban az API kulcsodat

Soha ne oszd meg az API kulcsodat, és ne kerüljön verziókezelőbe. Aki hozzáfér a kulcshoz, a nevedben hozhat létre és kezelhet számlákat.

2. lépés — Konfigurálás a CADENSA-ban​

  1. Nyisd meg a Beállítások → Számla menüpontot a CADENSA-ban
  2. Válaszd a Lexoffice 🇩🇪 szolgáltatót
  3. Megjelenik egy infódoboz:

A Lexoffice API kulcsodat itt találod: Erweiterungen → Weitere Apps → Public API → Verwalten → + API-Schlüssel erstellen

  1. Illeszd be az API kulcsodat az API Key mezőbe
  2. Kattints a Kapcsolat tesztelése gombra — egy zöld jelzi, hogy a kulcs érvényes
  3. Kattints a Mentés gombra

3. lépés — 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 ésszerű értékekkel legyen előre kitöltve:

BeállításAjánlott érték (DE)Leírás
Alapértelmezett pénznemEURAz új számlákon használt pénznem
Alapértelmezett ÁFA %19Standard német ÁFA kulcs (csökkentett: 7, mentes: 0)
Fizetési határidő (nap)14 vagy 30Napok száma az esedékességig
Alapértelmezett dokumentumtípusSzámlaEz lesz előre kiválasztva a párbeszédablakban
Osztrák és svájci kulcsok
  • Ausztria: a standard ÁFA 20%
  • Svájc: a standard ÁFA 8,1%

Számla kiállítása a Lexoffice-on keresztül​

A beállítás után kövesd a szokásos számlagenerálási folyamatot:

  1. Nyisd meg a Jelentések menüt → alkalmazz dátumtartomány- és projektszűrőket
  2. Kattints a Számla generálása gombra
  3. A Dokumentumtípus mezőben válaszd a Számla lehetőséget — a kimeneti csatorna Lexoffice-t mutat
  4. (Opcionális) Használd a partnerkeresőt ügyfél kiválasztásához a Lexoffice-kontaktjaid címjegyzékéből
  5. Töltsd ki az ügyfél adatait, az ÁFA %-ot és az esedékesség dátumát
  6. Kattints a Számla előnézete gombra → tekintsd át a tételeket és az összegeket
  7. Kattints a Számla kiállítása (Lexoffice) gombra

A CADENSA elküldi a számlát a Lexoffice API-nak, megkapja a számlaszámot, és letölti a PDF-et.

Mi történik a Lexoffice-ban
  • Egy új számla jön létre vázlat állapotban, majd azonnal véglegesítésre kerül (ami hozzárendeli a számlaszámot)
  • A véglegesített számlák megjelennek a Lexoffice számlalistádban
  • A német B2B számlákhoz automatikusan hozzáadódik egy ZUGFeRD / E-Rechnung XML melléklet

Partnerkereső​

Ha a Lexoffice be van állítva, a Számla generálása párbeszédablak megjelenít egy partnerkeresőt — egy kereshető legördülő listát a Lexoffice-kontaktjaidból.

Egy kontakt kiválasztása automatikusan kitölti:

  • Cégnév
  • Kapcsolattartó neve
  • Utca, irányítószám, város, ország
  • Adószám (Steuernummer / USt-IdNr.)

Ez elkerülhetővé teszi az ügyféladatok ismételt beírását visszatérő számláknál. A kontaktok élőben töltődnek be a Lexoffice /contacts API-jából (csak vevő szerepkörű kontaktok).

ÁFA kulcsok​

A Lexoffice csak meghatározott érvényes ÁFA kulcsokat fogad el:

KulcsFelhasználási eset
19%Standard német ÁFA (Regelsteuersatz)
7%Csökkentett német ÁFA (ermäßigter Steuersatz)
0%ÁFA-mentes, közösségen belüli értékesítés, harmadik ország
Érvénytelen ÁFA kulcsok

Ha 0, 7 vagy 19 mellett más ÁFA kulcsot adsz meg, a CADENSA automatikusan a legközelebbi érvényes Lexoffice-értékre kerekíti. Használd a 0 kulcsot ÁFA-mentes számláknál (pl. Kleinunternehmerregelung § 19 UStG).

Dokumentum útválasztás​

DokumentumtípusKimenet
ProformaBelső PDF (soha nem kerül elküldésre a Lexoffice-ba)
MunkakimutatásBelső PDF (soha nem kerül elküldésre a Lexoffice-ba)
SzámlaElküldve a Lexoffice API-ra → PDF visszaadva

Csak a Számla típusú dokumentumok kerülnek elküldésre a Lexoffice-ba. A Proforma és a Munkakimutatás mindig belsőleg jön létre, a szolgáltató beállításától függetlenül.

Számlaelőzmények és PDF letöltés​

Sikeres számlalétrehozás után:

  • A számla megjelenik a Számlázás → Számlaelőzmények menüpontban a CADENSA-ban
  • A számla a Lexoffice-fiókodban is megjelenik az Umsätze → Ausgangsrechnungen menüpont alatt
  • A PDF-et bármikor újra letöltheted bármelyik helyről

Kapcsolat tesztelése​

Az API kulcs megadása után használd a Kapcsolat tesztelése gombot. A CADENSA meghívja a Lexoffice /profile végpontját, hogy ellenőrizze:

  • Az API kulcs érvényes és nem járt le
  • A fiók aktív

Egy sikeres teszt a következőt mutatja:

✓ Sikeres kapcsolat

Hibaelhárítás​

„401 Unauthorized" hiba​

Az API kulcs érvénytelen vagy visszavonásra került.

Megoldás: Generálj új API kulcsot a Lexoffice-ban (Erweiterungen → Public API → + API-Schlüssel erstellen), és add meg újra a CADENSA-ban.

„INVOICE_NO_ENTRIES" hiba​

Nem található időbejegyzés a kiválasztott dátumtartományhoz és projektszűrőkhöz.

Megoldás: Módosítsd a dátumtartományt vagy a projektszűrőt, majd próbáld újra.

A számla vázlatban ragad / nincs számlaszám​

A Lexoffice megköveteli, hogy a számlák véglegesítve legyenek, mielőtt számlaszámot rendelne hozzájuk. A CADENSA a létrehozáskor azonnal véglegesíti a számlát (?finalize=true). Ha a véglegesítés sikertelen (pl. hiányzó kötelező mezők miatt), a számla vázlatban maradhat.

Megoldás:

  1. Jelentkezz be a Lexoffice-ba, és nézd meg a vázlat számlákat az Umsätze → Ausgangsrechnungen menüpontban
  2. Nézd át a hiányzó mezőket (jellemzően: országkód vagy adószám)
  3. Fejezd be a számlát manuálisan a Lexoffice-ban, vagy töröld, és próbáld újra a CADENSA-ból teljes ügyféladatokkal

A PDF letöltése sokáig tart​

A Lexoffice aszinkron módon generálja a PDF-eket. A CADENSA legfeljebb 30 másodpercig lekérdezi az API-t a PDF-re várva. Ha a PDF időben nem készül el, hibaüzenet jelenik meg.

Megoldás: Várj egy kicsit, majd töltsd le újra a Számlázás → Számlaelőzmények menüpontból.

Az ÁFA kulcs nincs elfogadva​

A Lexoffice csak a 0, 7 és 19 értékeket fogadja el érvényes ÁFA kulcsként.

Megoldás: A Számla generálása párbeszédablakban ezen értékek egyikét használd az ÁFA % mezőben.

Az ügyfél országkódja nem ismerhető fel​

A Lexoffice érvényes ISO 3166-1 alpha-2 országkódot igényel (pl. DE, AT, CH, US). A szabadszöveges országnevek automatikusan konvertálódnak, de a szokatlan nevek meghiúsulhatnak.

Megoldás: Add meg közvetlenül a 2 betűs ISO országkódot az Ország mezőben (pl. DE a „Germany" helyett).

Lexoffice vs. Billingo​

FunkcióLexoffice 🇩🇪Billingo 🇭🇺
PiacDE / AT / CHMagyarország
Jogi szabványZUGFeRD / E-RechnungNAV Online Számla 3.0
HitelesítésBearer token (API kulcs)API kulcs (v3)
Sandbox mód Nem elérhető Elérhető
Partnerkereső /contacts végpont /partners végpont
PDF generálásAszinkron (lekérdezéssel)Szinkron
Számla véglegesítésExplicit (?finalize=true)Automatikus

Kapcsolódó oldalak​