> ## 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).

# Synchronisatie met Pennylane

# 🔗 Pennylane verbinding met Fotostudio

## Wat is Pennylane?

[Pennylane](https://www.pennylane.com/) is een Franse boekhoudsoftware voor kleine en middelgrote bedrijven en accountants. De verbinding met Fotostudio synchroniseert automatisch je boekhoudkundige documenten (facturen, betalingen, creditnota's) naar Pennylane, zonder handmatige invoer.

---

## Wat doet de integratie

Eenmaal geactiveerd, stuurt de integratie automatisch naar Pennylane:

| Wat wordt gesynchroniseerd | Detail |
| ---- |
| **Facturen** | Met alle regels, bedragen excl./incl. BTW en BTW-tarieven |
| **Betalingen** | De factuur wordt automatisch als betaald gemarkeerd in Pennylane |
| **Creditnota's** | Aangemaakt in Pennylane en gekoppeld aan de originele factuur als deze al gesynchroniseerd is |
| **Klanten** | Automatisch aangemaakt in Pennylane (bedrijven en particulieren) als ze nog niet bestaan |

---

## Hoe verbind je Pennylane

### Stap 1 — Genereer je API-sleutel in Pennylane

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


1. Log in op je account op [app.pennylane.com](https://app.pennylane.com)
2. Ga naar **Instellingen** → **Connectiviteit**
3. Klik op het tabblad **Ontwikkelaars**
4. Klik op **Genereer een API-token**
5. Kies **Onbeperkt** voor de geldigheidsperiode en vink het waarschuwingsvakje aan
6. Bij de volgende stap, vink bij de permissies lezen en schrijven aan: Klantbeheer, Verkoopfactuurbeheer, Inkoopfactuurbeheer, Transactiebeheer, Leveranciersbeheer
7. Rond af en kopieer de weergegeven sleutel (deze is slechts één keer zichtbaar)

### Stap 2 — Configureer Pennylane in Fotostudio

1. Ga in Fotostudio naar **Boekhouding** → **Instellingen** → **Boekhoudsynchronisatie**
2. Klik op de knop **Configureer een service**
3. Scroll naar de sectie **Pennylane**
4. Plak je API-sleutel in het veld **API-sleutel**
5. Klik op **Test de verbinding** om te controleren of de sleutel geldig is
6. Vink **Activeer synchronisatie met Pennylane** aan
7. Klik op **Opslaan**

> ℹ️ Je kunt slechts één boekhoudsoftware tegelijk activeren. Als je SevDesk of Lexware gebruikte, wordt deze automatisch uitgeschakeld bij het activeren van Pennylane.

---

## Hoe werkt de synchronisatie

### Automatische synchronisatie

Zodra Pennylane geactiveerd is, start de synchronisatie **automatisch**:
* Wanneer een **factuur** wordt afgerond
* Wanneer een **betaling** wordt geregistreerd
* Wanneer een **creditnota** wordt uitgegeven en afgerond

Je hoeft niets handmatig te doen.

### Handmatige synchronisatie

Vanaf de pagina **Boekhoudsynchronisatie** (`/app/accounting_sync`) kun je:
* De synchronisatiestatus van elk document zien (succes, fout, wachtend)
* Handmatig de synchronisatie van een specifiek document starten
* Een document opnieuw synchroniseren bij een fout

### Idempotentie

De synchronisatie is **beveiligd tegen duplicaten**: als een factuur of creditnota al naar Pennylane is gestuurd, detecteert Fotostudio dit en maakt geen duplicaat. Klanten worden ook slechts één keer aangemaakt, uniek geïdentificeerd via hun interne referentie.

---

### Ondersteunde landen en BTW-tarieven

De integratie beheert de officiële Pennylane BTW-codes voor de volgende landen:

| Land | Ondersteunde tarieven |
| ---- |
| 🇫🇷 Frankrijk | 20%, 10%, 5,5%, 2,1%, 0% |
| 🇧🇪 België | 21%, 12%, 6%, 0% |
| 🇪🇸 Spanje | 21%, 10%, 4%, 0% |
| 🇮🇹 Italië | 22%, 10%, 5%, 4%, 0% |
| 🇵🇹 Portugal | 23%, 13%, 6%, 0% |
| 🇩🇪 Duitsland | 19%, 7%, 0% |
| 🇨🇭 Zwitserland | 8,1%, 2,6%, 0% |


---

## Synchronisatiegeschiedenis bekijken

Ga naar **Instellingen** → **Boekhoudsynchronisatie** → **Geschiedenis** om te zien:
* De lijst van alle gesynchroniseerde documenten
* De status van elke synchronisatie (succes / fout / wachtend)
* Het detail van fouten bij een mislukte synchronisatie

---

## Veelvoorkomende problemen

### "API-sleutel ontbreekt"
De API-sleutel is niet ingevuld of leeg. Controleer of deze correct is ingevoerd in de instellingen en dat de integratie geactiveerd is.

### "Kan Pennylane-klant niet aanmaken/ophalen"
Het contact gekoppeld aan de factuur is niet gevonden of onvolledig. Controleer of de factuur correct gekoppeld is aan een contact in Fotostudio.

### "Factuur niet gesynchroniseerd met Pennylane"
Een betaling is geregistreerd maar de bijbehorende factuur is nog niet gesynchroniseerd. Synchroniseer eerst de factuur, dan de betaling opnieuw.

### Verbindingsfout
Bij een netwerkfout of timeout mislukt de synchronisatie met status "fout". Je kunt handmatig opnieuw synchroniseren vanaf de Geschiedenis-pagina. Als het probleem aanhoudt, controleer of de API-sleutel nog steeds geldig is in Pennylane (deze kan ingetrokken worden in de Pennylane-instellingen).

---

## Veelgestelde vragen

**Worden facturen die al uitgegeven waren vóór activatie gesynchroniseerd?**  
Nee, automatische synchronisatie geldt alleen voor documenten aangemaakt na activatie. Eerdere documenten kunnen handmatig gesynchroniseerd worden vanaf de Boekhoudsynchronisatie-pagina.

**Wat gebeurt er als ik Pennylane uitschakel en weer activeer?**  
Reeds gesynchroniseerde documenten behouden hun link met Pennylane. Nieuwe documenten worden weer automatisch gesynchroniseerd. Er worden geen duplicaten aangemaakt.

**Kan ik Pennylane en een andere boekhoudsoftware tegelijk gebruiken?**  
Nee, slechts één boekhoudsoftware kan tegelijk actief zijn in Fotostudio.

**Is Pennylane beschikbaar voor alle Fotostudio-abonnementen?**  
De Pennylane-integratie is beschikbaar voor alle gebruikers met toegang tot de facturatiemodule.