Ugrás a fő tartalomhoz

Pennylane integráció

A Pennylane egy online könyvelési és számlázási platform, amelyet a francia piac (FR / BE / LU / CH) számára fejlesztettek. 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, a Factur-X szabványnak megfelelően — amely 2026 szeptemberétől kötelező a francia B2B e-számlázásban.

Támogatott országok

A Pennylane a Franciaországban 🇫🇷, Belgiumban 🇧🇪, Luxemburgban 🇱🇺 és Svájcban 🇨🇭 működő vállalkozások számára készült.

Factur-X megfelelőség

A Factur-X (beágyazott XML-t tartalmazó PDF/A-3) kötelezővé válik Franciaországban:

  • 2026 szeptembere — nagyvállalatok
  • 2027 — fokozatos bevezetés minden vállalkozásnál

A CADENSA Pennylane integrációja készen áll erre a követelményre.

Mielőtt elkezdenéd​

Szükséged lesz:

  • Aktív Pennylane fiókra — Essentiel csomag vagy magasabb (az API a Basique csomagban nem elérhető)
  • Pennylane API tokenre (lásd alább)
  • CADENSA munkaterületre, ahol legalább Admin szerepköröd van
Csomag követelmény

A Pennylane Public API-ja csak az Essentiel (24 €/hó) és a Premium (79 €/hó) csomagban érhető el. A Basique csomag (14 €/hó) nem tartalmaz API hozzáférést.

1. lépés — Hozz létre egy Pennylane fiókot​

  1. Látogass el a pennylane.com oldalra
  2. Kattints a „Démarrer maintenant" (jobb felül) gombra
  3. Válaszd az „Essentiel" csomagot, és kattints az „Essayer" gombra
  4. Regisztrálj az email címeddel és jelszavaddal
  5. Hozz létre egy céget (kötelező — a tokenek céghez kötöttek)

Automatikusan elindul egy 15 napos ingyenes próbaidőszak. Nincs szükség kötelezettségvállalásra.

2. lépés — Szerezd meg a Pennylane API tokenedet​

  1. Jelentkezz be az app.pennylane.com oldalon
  2. A bal oldali menüsávban kattints a Paramètres (Beállítások — fogaskerék ikon, bal alul) menüpontra
  3. Navigálj az Intégrations → API menüpontba
  4. Kattints a „Générer un token" (Token generálása) gombra
  5. Másold ki a generált Bearer tokent
Tartsd titokban az API tokenedet

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

A hivatalos Pennylane útmutatóért lásd: pennylane.readme.io/docs/generating-my-api-token

3. 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 Pennylane 🇫🇷 szolgáltatót
  3. Illeszd be az API tokenedet az API Key mezőbe
  4. Kattints a Kapcsolat tesztelése gombra — egy zöld jelzi, hogy a token érvényes, és megjeleníti a céged nevét
  5. Kattints a Mentés gombra

4. 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 (FR)Leírás
Alapértelmezett pénznemEURAz új számlákon használt pénznem
Alapértelmezett ÁFA %20Standard francia ÁFA (TVA) kulcs
Fizetési határidő (nap)30Napok száma az esedékességig (30 nap a szokásos Franciaországban)
Alapértelmezett dokumentumtípusSzámlaEz lesz előre kiválasztva a párbeszédablakban
Kibocsátó országFRA céged országa — engedélyezi az automatikus ÁFA javaslatot
Egyéb francia ÁFA kulcsok
  • 10% — Csökkentett kulcs (vendéglátás, közlekedés)
  • 5,5% — Szuper csökkentett kulcs (élelmiszer, könyvek, egyes kulturális szolgáltatások)
  • 0% — Mentes (közösségen belüli értékesítés, export)

Számla kiállítása a Pennylane-en 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 Pennylane-t mutat
  4. Töltsd ki az ügyfél adatait (név, cím, ország, adószám, ha alkalmazható)
  5. Állítsd be az ÁFA kulcsot (alapértelmezés: 20%)
  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 (Pennylane) gombra

A CADENSA elküldi a számlát a Pennylane API-nak. A rendszer automatikusan megkeresi vagy létrehozza az ügyfélrekordot névegyezés alapján. A számla létrejön és véglegesítésre kerül, a PDF pedig letöltésre kerül a Pennylane-ből.

Mi történik a Pennylane-ben
  • Egy új ügyfélszámla jön létre a Pennylane-ben a Ventes → Factures clients menüpont alatt
  • A számla azonnal véglegesítésre kerül (állapot: waiting_payment)
  • A PDF letölthető mind a CADENSA-ból (Számlaelőzmények), mind a Pennylane-ből

Vázlat mód​

Vázlat számla létrehozásához véglegesítés nélkül:

A Pennylane integráció alapértelmezetten véglegesített számlákat hoz létre (draft: false). Teszteléshez vagy áttekintéshez vedd fel a kapcsolatot a Pennylane fiókoddal, hogy manuálisan vázlatra állítsd a számlákat, vagy töröld a teszt számlákat a Pennylane irányítópultjáról a tesztelés után.

Tesztelés valódi számlák nélkül

Mivel a Pennylane-nek nincs sandbox környezete, használd a Proforma vagy Munkakimutatás dokumentumtípust a CADENSA-ban teszteléshez — ezek mindig belső PDF-ként jönnek létre, és soha nem kerülnek elküldésre a Pennylane-be.

ÁFA kulcskódok​

A Pennylane belsőleg meghatározott francia ÁFA kulcskódokat használ:

AdókulcsPennylane kódFelhasználási eset
20%FR_200Standard TVA (taux normal)
10%FR_100Csökkentett kulcs (taux intermédiaire)
5,5%FR_055Szuper csökkentett kulcs (taux réduit)
0%exemptÁFA-mentes, export, EU-n belüli

A CADENSA automatikusan leképezi a számszerű adókulcsodat a megfelelő Pennylane kódra.

Dokumentum útválasztás​

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

Csak a Számla típusú dokumentumok kerülnek elküldésre a Pennylane-be. 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 Jelentések → Számlák menüpontban a CADENSA-ban
  • A számla a Pennylane-fiókodban is megjelenik a Ventes → Factures clients menüpont alatt
  • A PDF-et bármikor újra letöltheted bármelyik helyről

Kapcsolat tesztelése​

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

  • A token érvényes
  • A cégnév visszaadásra kerül

Egy sikeres teszt a következőt mutatja:

✓ Sikeres kapcsolat — Pennylane fiók: A céged neve

Hibaelhárítás​

„401 Unauthorized" hiba​

Az API token érvénytelen, lejárt, vagy rossz Pennylane fiókból származik.

Megoldás: Generálj új tokent a Pennylane-ben (Paramètres → Intégrations → API → Générer un token), és add meg újra a CADENSA-ban.

„API not available" / 403 hiba​

A Pennylane csomagod nem tartalmaz API hozzáférést.

Megoldás: Válts az Essentiel (24 €/hó) vagy Premium (79 €/hó) csomagra — a Basique csomag nem tartalmaz API hozzáférést.

„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.

Az ügyfél nem jött létre / rossz ügyfél lett hozzárendelve​

A CADENSA a cégnév alapján keres meglévő Pennylane ügyfelet. Ha nincs egyezés, új ügyfél jön létre. Ha a névegyezés hibás, manuálisan ellenőrizd vagy frissítsd az ügyfelet a Pennylane-ben.

Megoldás: Ellenőrizd a Contacts menüpontot a Pennylane-ben, és egyesítsd vagy javítsd a duplikált ügyfélrekordokat.

A PDF letöltése sikertelen​

A Pennylane aszinkron módon generálja a PDF-eket. Ha a PDF nem érhető el azonnal, a CADENSA rövid ideig újrapróbálkozik.

Megoldás: Várj egy kicsit, majd töltsd le újra a Jelentések → Számlák menüpontból.

Lásd még​