Pennylane integráció
A Pennylane egy online könyvelési platform a francia piac és a szomszédos frankofón országok számára ( Franciaország, Belgium, Luxemburg, Svájc). Támogatja a Factur-X (PDF/A-3 + beágyazott XML) e-számlázási szabványt.
A Factur-X e-számlázás 2026 szeptemberétől kötelező Franciaországban a nagy vállalatok számára, majd fokozatosan kiterjed az összes vállalkozásra 2027-ig. A Pennylane biztosítja a megfelelő formátumú számlák automatikus kiállítását.
Előfeltételek
- Aktív Pennylane fiók (Essentiel csomag vagy magasabb — az API hozzáférés a Starter csomagban nem elérhető)
- Pennylane API token (lásd alább)
- CADENSA Számlázási szolgáltató beállítása szükséges
API token generálása
- Jelentkezz be a Pennylane fiókodba
- Nyisd meg a Beállítások → Integrációk → API menüt
- Kattints az Új token létrehozása gombra
- Add meg a token nevét (pl. „CADENSA")
- Másold ki a generált tokent — csak egyszer látható!
A tokent biztonságos helyen tárold. Ha elveszíted, új tokent kell generálni, és a CADENSA-ban frissíteni kell.
Pennylane beállítása a CADENSA-ban
- Nyisd meg a Beállítások → Számla menüt
- Válaszd a Pennylane szolgáltatót
- Illeszd be a Pennylane API tokenedet az API Key mezőbe
- Kattints a Kapcsolat tesztelése gombra — ez megerősíti, hogy a token érvényes
- Kattints a Mentés gombra
Alapértelmezett értékek beállítása
| Beállítás | Ajánlott érték (FR) | Leírás |
|---|---|---|
| Alapértelmezett pénznem | EUR | Új számlákon alkalmazott pénznem |
| Alapértelmezett ÁFA % | 20 | Standard francia TVA (taux normal) |
| 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 | FR | A cég országa — automatikus ÁFA javaslat engedélyezéséhez |
Francia ÁFA kulcsok
| Kód | Arány | Leírás |
|---|---|---|
FR_200 | 20% | Taux normal — standard kulcs |
FR_100 | 10% | Taux intermédiaire — éttermi szolgáltatások, egyes építési munkák |
FR_055 | 5.5% | Taux réduit — élelmiszer, könyvek, vizes termékek, akadálymentesítés |
exempt | 0% | Exonéré — adómentes ügyletek, export |
Ügyfél kezelése (automatikus)
A Pennylane integráció automatikusan keresi meg vagy hozza létre az ügyfelet:
- A CADENSA először az ügyfél neve alapján keres a Pennylane-fiókodban
- Ha talál egyező ügyfelet → az meglévő ügyfélhoz köti a számlát
- Ha nem talál egyező ügyfelet → automatikusan létrehozza az ügyfelet a Pennylane-ben
Az automatikus ügyfél-létrehozás csak az alapadatokat viszi át (név, e-mail). A részletes adatokat (cím, adószám) a Pennylane-ben lehet kiegészíteni.
Vázlat mód
A Pennylane integráció alapértelmezetten vázlat (draft) módban hozza létre a számlákat:
- A számlák a Pennylane-ben vázlatként kerülnek létrehozásra
- Véglegesítés a Pennylane felületén szükséges
- Teszteléshez ideális: nem generál valódi, jogi hatályú számlát
A vázlat mód letiltásához (végleges számlák azonnali kiállítása) vedd fel a kapcsolatot a support@cadensa.io e-mail-címen.
PDF letöltés
- A számla generálása után a CADENSA lekéri a PDF-et a Pennylane API-ján keresztül
- A PDF letöltési gomb a Jelentések → Számlák fülön jelenik meg
- A PDF a Pennylane szervereinek aktuális állapotát tükrözi
Hibaelhárítás
„Érvénytelen API token" hiba
- Ellenőrizd, hogy az Essentiel (vagy magasabb) csomagodat használod
- Ellenőrizd, hogy a teljes tokent másoltad-e be
- Generálj új tokent, ha az előző lejárt
„Ügyfél létrehozása sikertelen"
- Ellenőrizd, hogy az ügyfél neve nem tartalmaz speciális karaktereket, amelyek a Pennylane API-val nem kompatibilisek
- Próbálj rövidebb ügyfélnevet használni
„Kapcsolat tesztelése" sikertelen
- Ellenőrizd, hogy a Pennylane-fiókod aktív és nem lejárt próbaidőszakban van
- Ellenőrizd az API token jogosultságait a Pennylane Beállítások → API menüjében
A PDF nem töltődik le
- A Pennylane API néha késleltet; várj 30 másodpercet, majd próbáld újra
- Ha a probléma fennáll: support@cadensa.io
Támogatott piacok
| Ország | ÁFA rendszer | Megjegyzés |
|---|---|---|
| Franciaország | TVA | Factur-X kötelező 2026-tól |
| Belgium | TVA/BTW | Pennylane BE-verzión elérhető |
| Luxemburg | TVA | Standard európai ÁFA szabályok |
| Svájc | MWST/TVA | Pennylane CH-verzión elérhető |
Dokumentum típus útválasztás
| Dokumentumtípus | Kimenet |
|---|---|
| Proforma | Belső PDF (nem kerül elküldésre a Pennylane-be) |
| Munkakimutatás | Belső PDF (nem kerül elküldésre a Pennylane-be) |
| Számla | Elküldve a Pennylane API-ra → PDF visszatöltve |
Csak a Számla típusú dokumentumok kerülnek a Pennylane-be.