Zum Hauptinhalt springen

Pennylane-Integration

Pennylane ist eine Online-Buchhaltungsplattform für den französischen Markt und benachbarte frankophone Länder (🇫🇷 Frankreich, 🇧🇪 Belgien, 🇱🇺 Luxemburg, 🇨🇭 Schweiz). Es unterstützt den Factur-X (PDF/A-3 + eingebettetes XML) E-Rechnungsstandard.

Factur-X-Pflicht

Factur-X-E-Rechnungen werden ab September 2026 für große Unternehmen in Frankreich verpflichtend und werden schrittweise bis 2027 auf alle Unternehmen ausgeweitet. Pennylane stellt sicher, dass Rechnungen automatisch im richtigen Format ausgestellt werden.

Voraussetzungen​

  • Aktives Pennylane-Konto (Essentiel-Paket oder höher — API-Zugriff ist im Starter-Paket nicht verfügbar)
  • Pennylane API-Token (siehe unten)
  • CADENSA Rechnungsanbieter muss konfiguriert sein

API-Token generieren​

  1. In Pennylane-Konto einloggen
  2. Einstellungen → Integrationen → API öffnen
  3. „Neues Token erstellen" klicken
  4. Token-Namen eingeben (z. B. „CADENSA")
  5. Den generierten Token kopieren — nur einmalig sichtbar!
Sicherheitshinweis

Den Token an einem sicheren Ort aufbewahren. Wenn du ihn verlierst, muss ein neuer Token generiert und in CADENSA aktualisiert werden.

Pennylane in CADENSA einrichten​

  1. Einstellungen → Rechnung öffnen
  2. Pennylane 🇫🇷 als Anbieter wählen
  3. Pennylane API-Token in das API-Key-Feld einfügen
  4. „Verbindung testen" klicken — bestätigt, dass der Token gültig ist
  5. Standard-MwSt.-Satz einstellen:
  • 20 — Standard-MwSt. (taux normal)
  • 10 — Ermäßigter MwSt. (taux intermédiaire)
  • 5.5 — Super-ermäßigter MwSt. (taux réduit)
  • 0 — Steuerbefreit
  1. „Speichern" klicken

Französische MwSt.-Sätze​

CodeRateBeschreibung
FR_20020%Taux normal — Standardsatz
FR_10010%Taux intermédiaire — Restaurantleistungen, bestimmte Bauarbeiten
FR_0555,5%Taux réduit — Lebensmittel, Bücher, Wasserversorgung, Barrierefreiheit
exempt0%Exonéré — steuerfreie Umsätze, Export

Kundenverwaltung (automatisch)​

Die Pennylane-Integration sucht oder erstellt Kunden automatisch:

  1. CADENSA sucht zunächst nach dem Kundennamen im Pennylane-Konto
  2. Wenn ein passender Kunde gefunden wird → die Rechnung wird dem bestehenden Kunden zugeordnet
  3. Wenn kein passender Kunde gefunden wird → der Kunde wird automatisch in Pennylane erstellt
Hinweis

Die automatische Kundenerstellung überträgt nur Grunddaten (Name, E-Mail). Detaillierte Informationen (Adresse, Steuernummer) können in Pennylane ergänzt werden.

Entwurfsmodus​

Die Pennylane-Integration erstellt Rechnungen standardmäßig im Entwurfsmodus (draft):

  • Rechnungen werden in Pennylane als Entwürfe erstellt
  • Finalisierung muss in der Pennylane-Oberfläche erfolgen
  • Ideal zum Testen: Es werden keine rechtsgültigen Rechnungen erstellt

Um den Entwurfsmodus zu deaktivieren (sofortiges Ausstellen finalisierter Rechnungen), wende dich an support@cadensa.io.

PDF-Download​

  1. Nach der Rechnungserstellung lädt CADENSA das PDF über die Pennylane API
  2. Der Download-Button erscheint im Tab Berichte → Rechnungen
  3. Das PDF spiegelt den aktuellen Stand der Pennylane-Server wider

Fehlerbehebung​

Fehler „Ungültiger API-Token"​

  • Prüfen, ob das Essentiel-Paket (oder höher) verwendet wird
  • Prüfen, ob der vollständige Token kopiert wurde
  • Neuen Token generieren, falls der vorherige abgelaufen ist

„Kunde konnte nicht erstellt werden"​

  • Prüfen, ob der Kundename keine Sonderzeichen enthält, die mit der Pennylane API inkompatibel sind
  • Einen kürzeren Kundennamen verwenden

„Verbindung testen" fehlgeschlagen​

  • Prüfen, ob das Pennylane-Konto aktiv ist und sich nicht in einer abgelaufenen Testphase befindet
  • API-Token-Berechtigungen in Pennylane (Einstellungen → API) prüfen

PDF wird nicht heruntergeladen​

  • Die Pennylane API kann gelegentlich verzögern; 30 Sekunden warten und erneut versuchen
  • Falls das Problem weiterhin besteht: support@cadensa.io

Unterstützte Märkte​

LandMwSt.-SystemHinweis
FrankreichTVAFactur-X ab 2026 verpflichtend
BelgienTVA/BTWVerfügbar über Pennylane BE-Version
LuxemburgTVAStandard-EU-MwSt.-Regelungen
SchweizMWST/TVAVerfügbar über Pennylane CH-Version

Weiterführende Themen​