> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.fotostudio.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Synchronisation mit Pennylane

# 🔗 Pennylane-Verbindung zu Fotostudio

## Was ist Pennylane?

[Pennylane](https://www.pennylane.com/) ist eine französische Buchhaltungssoftware für KMU und Steuerberater. Die Verbindung mit Fotostudio ermöglicht dir die automatische Synchronisation deiner Buchhaltungsdokumente (Rechnungen, Zahlungen, Gutschriften) zu Pennylane, ohne jegliche Neueingabe.

---

## Was die Integration macht

Sobald aktiviert, sendet die Integration automatisch an Pennylane:

| Was synchronisiert wird | Detail |
| ---- |
| **Rechnungen** | Mit allen Zeilen, Netto-/Bruttobeträgen und Steuersätzen |
| **Zahlungen** | Die Rechnung wird automatisch als bezahlt in Pennylane markiert |
| **Gutschriften** | In Pennylane erstellt und mit der Originalrechnung verknüpft, wenn diese bereits synchronisiert ist |
| **Kunden** | Automatisch in Pennylane erstellt (Unternehmen und Privatpersonen), wenn sie noch nicht existieren |

---

## Wie du Pennylane verbindest

### Schritt 1 — Generiere deinen API-Schlüssel in Pennylane

![](https://storage.crisp.chat/users/helpdesk/website/-/1/1/0/6/1106822c7ec6b200/pennylane_1qe37gm.png)


1. Melde dich bei deinem Konto auf [app.pennylane.com](https://app.pennylane.com) an
2. Gehe zu **Einstellungen** → **Konnektivität**
3. Klicke auf den Tab **Entwickler**
4. Klicke auf **API-Token generieren**
5. Wähle **Unbegrenzt** für die Gültigkeitsdauer und aktiviere das Warnungsfeld
6. Im nächsten Schritt bei den Berechtigungen aktiviere Lesen und Schreiben für: Kundenverwaltung, Kundenrechnungsverwaltung, Lieferantenrechnungsverwaltung, Transaktionsverwaltung, Lieferantenverwaltung
7. Schließe ab und kopiere den angezeigten Schlüssel (er wird nur einmal sichtbar sein)

### Schritt 2 — Pennylane in Fotostudio konfigurieren

1. In Fotostudio, gehe zu **Buchhaltung** → **Einstellungen** → **Buchhaltungssynchronisation**
2. Klicke auf den Button **Service konfigurieren**
3. Scrolle zum Abschnitt **Pennylane**
4. Füge deinen API-Schlüssel in das Feld **API-Schlüssel** ein
5. Klicke auf **Verbindung testen** um zu überprüfen, dass der Schlüssel gültig ist
6. Aktiviere **Synchronisation mit Pennylane aktivieren**
7. Klicke auf **Speichern**

> ℹ️ Du kannst nur eine Buchhaltungssoftware gleichzeitig aktivieren. Wenn du SevDesk oder Lexware verwendet hast, wird die Aktivierung von Pennylane diese automatisch deaktivieren.

---

## Wie die Synchronisation funktioniert

### Automatische Synchronisation

Sobald Pennylane aktiviert ist, wird die Synchronisation **automatisch** ausgelöst:
* Wenn eine **Rechnung** finalisiert wird
* Wenn eine **Zahlung** erfasst wird
* Wenn eine **Gutschrift** ausgestellt und finalisiert wird

Du musst nichts manuell tun.

### Manuelle Synchronisation

Auf der Seite **Buchhaltungssynchronisation** (`/app/accounting_sync`) kannst du:
* Den Synchronisationsstatus jedes Dokuments sehen (Erfolg, Fehler, ausstehend)
* Manuell die Synchronisation eines bestimmten Dokuments auslösen
* Ein Dokument bei Fehler erneut synchronisieren

### Idempotenz

Die Synchronisation ist **gegen Duplikate gesichert**: Wenn eine Rechnung oder Gutschrift bereits an Pennylane gesendet wurde, erkennt Fotostudio dies und erstellt kein Duplikat. Kunden werden ebenfalls nur einmal erstellt, eindeutig identifiziert über ihre interne Referenz.

---

### Unterstützte Länder und Steuersätze

Die Integration verwaltet die offiziellen Pennylane-Steuercodes für folgende Länder:

| Land | Unterstützte Sätze |
| ---- |
| 🇫🇷 Frankreich | 20 %, 10 %, 5,5 %, 2,1 %, 0 % |
| 🇧🇪 Belgien | 21 %, 12 %, 6 %, 0 % |
| 🇪🇸 Spanien | 21 %, 10 %, 4 %, 0 % |
| 🇮🇹 Italien | 22 %, 10 %, 5 %, 4 %, 0 % |
| 🇵🇹 Portugal | 23 %, 13 %, 6 %, 0 % |
| 🇩🇪 Deutschland | 19 %, 7 %, 0 % |
| 🇨🇭 Schweiz | 8,1 %, 2,6 %, 0 % |


---

## Synchronisationsverlauf einsehen

Gehe zu **Einstellungen** → **Buchhaltungssynchronisation** → **Verlauf** um zu sehen:
* Die Liste aller synchronisierten Dokumente
* Den Status jeder Synchronisation (Erfolg / Fehler / ausstehend)
* Die Details der Fehler bei Misserfolg

---

## Häufige Probleme

### "Fehlender API-Schlüssel"
Der API-Schlüssel ist nicht hinterlegt oder leer. Überprüfe, dass er korrekt in den Einstellungen eingegeben ist und die Integration aktiviert ist.

### "Pennylane-Kunde kann nicht erstellt/abgerufen werden"
Der mit der Rechnung verknüpfte Kontakt ist nicht auffindbar oder unvollständig. Überprüfe, dass die Rechnung in Fotostudio mit einem Kontakt verknüpft ist.

### "Rechnung nicht mit Pennylane synchronisiert"
Eine Zahlung ist erfasst, aber die entsprechende Rechnung wurde noch nicht synchronisiert. Synchronisiere zuerst die Rechnung, dann synchronisiere die Zahlung erneut.

### Verbindungsfehler
Bei Netzwerkfehler oder Timeout schlägt die Synchronisation mit Status "Fehler" fehl. Du kannst von der Verlaufsseite aus manuell neu synchronisieren. Wenn das Problem weiterhin besteht, überprüfe, ob der API-Schlüssel in Pennylane noch gültig ist (er kann aus den Pennylane-Einstellungen widerrufen werden).

---

## Häufig gestellte Fragen

**Werden bereits vor der Aktivierung ausgestellte Rechnungen synchronisiert?**  
Nein, die automatische Synchronisation gilt nur für Dokumente, die nach der Aktivierung erstellt wurden. Frühere Dokumente können manuell von der Seite Buchhaltungssynchronisation aus synchronis