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

# Synchronization with Pennylane

# 🔗 Pennylane Connection to Fotostudio

## What is Pennylane?

[Pennylane](https://www.pennylane.com/) is a French accounting software for SMEs and accountants. The connection with Fotostudio allows you to automatically synchronize your accounting documents (invoices, payments, credit notes) to Pennylane, without any re-entry.

---

## What the integration does

Once activated, the integration automatically sends to Pennylane:

| What is synchronized | Detail |
| ---- |
| **Invoices** | With all lines, pre-tax/total amounts and VAT rates |
| **Payments** | The invoice is automatically marked as paid in Pennylane |
| **Credit notes** | Created in Pennylane and linked to the original invoice if it's already synchronized |
| **Clients** | Automatically created in Pennylane (companies and individuals) if they don't already exist |

---

## How to connect Pennylane

### Step 1 — Generate your API key in Pennylane

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


1. Log in to your account on [app.pennylane.com](https://app.pennylane.com)
2. Go to **Settings** → **Connectivity**
3. Click on the **Developers** tab
4. Click on **Generate an API token**
5. Choose **Unlimited** for the validity period and check the warning box
6. At the next step, in permissions, check read and write: Customer management, Customer invoice management, Supplier invoice management, Transaction management, Supplier management
7. Finalize and copy the displayed key (it will only be visible once)

### Step 2 — Configure Pennylane in Fotostudio

1. In Fotostudio, go to **Accounting** → **Settings** → **Accounting synchronization**
2. Click on the **Configure a service** button
3. Scroll down to the **Pennylane** section
4. Paste your API key in the **API Key** field
5. Click on **Test connection** to verify the key is valid
6. Check **Enable synchronization with Pennylane**
7. Click on **Save**

> ℹ️ You can only enable one accounting software at a time. If you were using SevDesk or Lexware, activating Pennylane will automatically disable it.

---

## How synchronization works

### Automatic synchronization

As soon as Pennylane is activated, synchronization triggers **automatically**:
* When an **invoice** is finalized
* When a **payment** is recorded
* When a **credit note** is issued and finalized

You don't have to do anything manually.

### Manual synchronization

From the **Accounting synchronization** page (`/app/accounting_sync`), you can:
* See the synchronization status of each document (success, error, pending)
* Manually trigger synchronization of a specific document
* Re-synchronize a document in case of error

### Idempotence

Synchronization is **protected against duplicates**: if an invoice or credit note has already been sent to Pennylane, Fotostudio detects it and doesn't create a duplicate. Clients are also created only once, uniquely identified via their internal reference.

---

### Supported countries and VAT rates

The integration handles official Pennylane VAT codes for the following countries:

| Country | Supported rates |
| ---- |
| 🇫🇷 France | 20%, 10%, 5.5%, 2.1%, 0% |
| 🇧🇪 Belgium | 21%, 12%, 6%, 0% |
| 🇪🇸 Spain | 21%, 10%, 4%, 0% |
| 🇮🇹 Italy | 22%, 10%, 5%, 4%, 0% |
| 🇵🇹 Portugal | 23%, 13%, 6%, 0% |
| 🇩🇪 Germany | 19%, 7%, 0% |
| 🇨🇭 Switzerland | 8.1%, 2.6%, 0% |


---

## View synchronization history

Go to **Settings** → **Accounting synchronization** → **History** to see:
* The list of all synchronized documents
* The status of each synchronization (success / error / pending)
* Error details in case of failure

---

## Common issues

### "Missing API key"
The API key is not provided or empty. Check that it's properly entered in the settings and that the integration is activated.

### "Unable to create/retrieve Pennylane client"
The contact associated with the invoice cannot be found or is incomplete. Check that the invoice is properly linked to a contact in Fotostudio.

### "Invoice not synchronized with Pennylane"
A payment is recorded but the corresponding invoice hasn't been synchronized yet. Synchronize the invoice first, then re-synchronize the payment.

### Connection error
In case of network error or timeout, synchronization fails with "error" status. You can re-synchronize manually from the History page. If the problem persists, check that the API key is still valid on the Pennylane side (it can be revoked from Pennylane settings).

---

## Frequently asked questions

**Are invoices already issued before activation synchronized?**  
No, automatic synchronization only applies to documents created after activation. Previous documents can be synchronized manually from the Accounting synchronization page.

**What happens if I disable Pennylane and then reactivate it?**  
Documents already synchronized keep their link with Pennylane. New documents will be automatically synchronized again. No duplicates will be created.

**Can I use Pennylane and another accounting software at the same time?**  
No, only one accounting software can be active at a time in Fotostudio.

**Is Pennylane available for all Fotostudio subscriptions?**  
The Pennylane integration is available for all users with access to the billing module.