Pennylane-Integration
Pennylane ist eine Online-Buchhaltungs- und Rechnungsplattform für den französischen Markt (FR / BE / LU / CH). Wenn Pennylane in CADENSA konfiguriert ist, können Sie direkt aus Ihren erfassten Zeiteinträgen rechtsgültige Rechnungen ausstellen, konform mit dem Factur-X-Standard — ab September 2026 verpflichtend für französische B2B-E-Rechnungen.
Pennylane ist für Unternehmen in Frankreich 🇫🇷, Belgien 🇧🇪, Luxemburg 🇱🇺 und der Schweiz 🇨🇭 konzipiert.
Factur-X (PDF/A-3 mit eingebettetem XML) wird in Frankreich verpflichtend:
- September 2026 — für Großunternehmen
- 2027 — stufenweise Einführung für alle Unternehmen
Die Pennylane-Integration von CADENSA ist für diese Anforderung bereit.
Voraussetzungen
Sie benötigen:
- Ein aktives Pennylane-Konto — Paket Essentiel oder höher (die API ist im Paket Basique nicht verfügbar)
- Ein Pennylane-API-Token (siehe unten)
- CADENSA-Einheit mit mindestens Admin-Rolle
Die Public API von Pennylane ist nur in den Paketen Essentiel (24 €/Monat) und Premium (79 €/Monat) verfügbar. Das Paket Basique (14 €/Monat) enthält keinen API-Zugang.
Schritt 1 — Ein Pennylane-Konto erstellen
- Zu pennylane.com gehen
- Auf „Démarrer maintenant" klicken (oben rechts)
- „Essentiel" auswählen und auf „Essayer" klicken
- Mit E-Mail und Passwort registrieren
- Ein Unternehmen anlegen (erforderlich — Tokens sind unternehmensgebunden)
Eine 15-tägige kostenlose Testphase startet automatisch. Keine Verpflichtung erforderlich.
Schritt 2 — Pennylane-API-Token generieren
- Anmelden bei app.pennylane.com
- In der linken Seitenleiste auf Paramètres klicken (Einstellungen — Zahnrad-Symbol, unten links)
- Zu Intégrations → API navigieren
- Auf „Générer un token" klicken (Token generieren)
- Den generierten Bearer-Token kopieren
Teilen Sie Ihren Token niemals und committen Sie ihn nicht in die Versionsverwaltung. Jeder mit dem Token kann in Ihrem Namen Rechnungen erstellen und verwalten.
Die offizielle Pennylane-Anleitung finden Sie unter: pennylane.readme.io/docs/generating-my-api-token
Schritt 3 — In CADENSA konfigurieren
- Einstellungen → Rechnung in CADENSA öffnen
- Pennylane 🇫🇷 als Anbieter auswählen
- API-Token in das API Key-Feld einfügen
- Auf Verbindung testen klicken — ein grünes
bestätigt, dass der Token gültig ist, und zeigt Ihren Firmennamen an - Auf Speichern klicken
Schritt 4 — Standardwerte festlegen
Standardwerte konfigurieren, damit der Dialog Rechnung generieren mit sinnvollen Werten vorausgefüllt ist:
| Einstellung | Empfohlener Wert (FR) | Beschreibung |
|---|---|---|
| Standardwährung | EUR | Währung für neue Rechnungen |
| Standard-MwSt. % | 20 | Französischer Regel-TVA-Satz |
| Zahlungsfrist (Tage) | 30 | Tage bis zum Fälligkeitsdatum (30 Tage sind in Frankreich Standard) |
| Standard-Dokumenttyp | Rechnung | Vorauswahl von „Rechnung" im Dialog |
| Ausstellerland | FR | Land Ihres Unternehmens — ermöglicht automatische MwSt.-Vorschläge |
- 10 % — ermäßigter Satz (Gastgewerbe, Transport)
- 5,5 % — stark ermäßigter Satz (Lebensmittel, Bücher, bestimmte kulturelle Dienstleistungen)
- 0 % — steuerbefreit (innergemeinschaftliche Lieferung, Export)
Rechnung über Pennylane ausstellen
Folgen Sie nach der Konfiguration dem Standardablauf zur Rechnungserstellung:
- Berichte öffnen → Datumsbereich und Projektfilter einstellen
- Auf Rechnung generieren klicken
- Im Feld Dokumenttyp Rechnung auswählen — der Ausgabekanal zeigt
Pennylane - Kundendaten eingeben (Name, Adresse, Land, ggf. USt-IdNr.)
- MwSt.-Satz festlegen (Standard: 20 %)
- Auf Vorschau klicken → Positionen und Gesamtbeträge prüfen
- Auf Rechnung ausstellen (Pennylane) klicken
CADENSA sendet die Rechnung an die Pennylane-API. Ein Kundendatensatz wird automatisch anhand des Namens gefunden oder erstellt. Die Rechnung wird erstellt und fertiggestellt, und die PDF wird von Pennylane heruntergeladen.
- Eine neue Kundenrechnung wird in Pennylane unter Ventes → Factures clients erstellt
- Die Rechnung wird sofort fertiggestellt (Status:
waiting_payment) - Die PDF steht sowohl in CADENSA (Rechnungshistorie) als auch in Pennylane zum Download bereit
Entwurfsmodus
So erstellen Sie eine Entwurfsrechnung, ohne sie fertigzustellen:
Die Pennylane-Integration erstellt standardmäßig fertiggestellte Rechnungen (draft: false). Für Test- oder Prüfzwecke wenden Sie sich an Ihr Pennylane-Konto, um Rechnungen manuell auf Entwurf zu setzen, oder löschen Sie Testrechnungen nach dem Testen im Pennylane-Dashboard.
Da Pennylane über keine Sandbox-Umgebung verfügt, verwenden Sie für Testläufe die Dokumenttypen Proforma oder Arbeitszusammenfassung in CADENSA — diese werden immer als interne PDFs erzeugt und nie an Pennylane gesendet.
MwSt.-Satzcodes
Pennylane verwendet intern spezifische französische MwSt.-Satzcodes:
| MwSt.-Satz | Pennylane-Code | Anwendungsfall |
|---|---|---|
| 20 % | FR_200 | Standard-TVA (taux normal) |
| 10 % | FR_100 | Ermäßigter Satz (taux intermédiaire) |
| 5,5 % | FR_055 | Stark ermäßigter Satz (taux réduit) |
| 0 % | exempt | Steuerbefreit, Export, innergemeinschaftlich |
CADENSA ordnet Ihren numerischen Steuersatz automatisch dem passenden Pennylane-Code zu.
Belegweiterleitung
| Dokumenttyp | Ausgabe |
|---|---|
| Proforma | Interne PDF (nie an Pennylane gesendet) |
| Arbeitszusammenfassung | Interne PDF (nie an Pennylane gesendet) |
| Rechnung | An Pennylane-API gesendet → PDF zurückgegeben |
Nur Dokumente vom Typ „Rechnung" werden an Pennylane gesendet. Proforma und Arbeitszusammenfassung werden unabhängig von der Anbieter-Einstellung immer intern erzeugt.
Rechnungsverlauf & PDF-Download
Nach erfolgreicher Rechnungserstellung:
- Die Rechnung erscheint unter Berichte → Rechnungen in CADENSA
- Die Rechnung erscheint auch in Ihrem Pennylane-Konto unter Ventes → Factures clients
- Sie können die PDF jederzeit von beiden Stellen erneut herunterladen
Verbindung testen
Nutzen Sie die Schaltfläche Verbindung testen nach Eingabe des API-Tokens. CADENSA ruft den Pennylane-Endpunkt /me auf, um Folgendes zu prüfen:
- Der Token ist gültig
- Der Firmenname wird zurückgegeben
Ein erfolgreicher Test zeigt:
✓ Verbindung erfolgreich — Pennylane-Konto: Ihr Firmenname
Fehlerbehebung
Fehler „401 Unauthorized"
Der API-Token ist ungültig, abgelaufen oder stammt aus dem falschen Pennylane-Konto.
Lösung: Einen neuen Token in Pennylane generieren (Paramètres → Intégrations → API → Générer un token) und in CADENSA neu eingeben.
Fehler „API not available" / 403
Ihr Pennylane-Paket enthält keinen API-Zugang.
Lösung: Auf das Paket Essentiel (24 €/Monat) oder Premium (79 €/Monat) upgraden — das Paket Basique enthält keinen API-Zugang.
Fehler „INVOICE_NO_ENTRIES"
Für den ausgewählten Datumsbereich und die Projektfilter wurden keine Zeiteinträge gefunden.
Lösung: Datumsbereich oder Projektfilter anpassen und erneut versuchen.
Kunde wird nicht erstellt / falscher Kunde zugeordnet
CADENSA sucht einen bestehenden Pennylane-Kunden anhand des Firmennamens. Wird keine Übereinstimmung gefunden, wird ein neuer Kunde erstellt. Stimmt der Name fälschlicherweise überein, den Kunden in Pennylane manuell prüfen oder korrigieren.
Lösung: Contacts in Pennylane prüfen und doppelte Kundendatensätze zusammenführen oder korrigieren.
PDF-Download schlägt fehl
Pennylane erstellt PDFs asynchron. Ist die PDF nicht sofort verfügbar, versucht CADENSA es für kurze Zeit erneut.
Lösung: Einen Moment warten und erneut von Berichte → Rechnungen herunterladen.
Siehe auch
- Rechnungsanbieter-Einstellungen — Überblick über alle Anbieter
- Rechnungsgenerierung — wie Sie Rechnungen aus Zeiteinträgen erstellen
- Rechnungshistorie — vergangene Rechnungen ansehen und erneut herunterladen