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

# Sincronizzazione con Pennylane

# 🔗 Connessione Pennylane a Fotostudio

## Cos'è Pennylane?

[Pennylane](https://www.pennylane.com/) è un software di contabilità francese destinato alle TPE/PME e ai commercialisti. La connessione con Fotostudio permette di sincronizzare automaticamente i tuoi documenti contabili (fatture, pagamenti, note di credito) verso Pennylane, senza alcuna digitazione manuale.

---

## Cosa fa l'integrazione

Una volta attivata, l'integrazione invia automaticamente verso Pennylane:

| Cosa viene sincronizzato | Dettaglio |
| ---- |
| **Fatture** | Con tutte le righe, gli importi netto/lordo e le aliquote IVA |
| **Pagamenti** | La fattura viene automaticamente contrassegnata come pagata in Pennylane |
| **Note di credito** | Create in Pennylane e collegate alla fattura originale se già sincronizzata |
| **Clienti** | Creati automaticamente in Pennylane (aziende e privati) se non esistono già |

---

## Come collegare Pennylane

### Passo 1 — Generare la tua chiave API in Pennylane

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


1. Accedi al tuo account su [app.pennylane.com](https://app.pennylane.com)
2. Vai in **Impostazioni** → **Connettività**
3. Clicca sulla scheda **Sviluppatori**
4. Clicca su **Genera un token API**
5. Scegli **Illimitato** per il periodo di validità e spunta la casella di avviso
6. Al passaggio successivo, nei permessi, spunta in lettura e scrittura: Gestione clienti, Gestione fatture clienti, Gestione fatture fornitori, Gestione transazioni, Gestione fornitori
7. Finalizza e copia la chiave visualizzata (sarà visibile solo una volta)

### Passo 2 — Configurare Pennylane in Fotostudio

1. In Fotostudio, vai in **Contabilità** → **Impostazioni** → **Sincronizzazione contabile**
2. Clicca sul pulsante **Configura un servizio**
3. Scorri fino alla sezione **Pennylane**
4. Incolla la tua chiave API nel campo **Chiave API**
5. Clicca su **Testa la connessione** per verificare che la chiave sia valida
6. Spunta **Attiva la sincronizzazione con Pennylane**
7. Clicca su **Salva**

> ℹ️ Puoi attivare solo un software di contabilità alla volta. Se stavi usando SevDesk o Lexware, l'attivazione di Pennylane lo disattiverà automaticamente.

---

## Funzionamento della sincronizzazione

### Sincronizzazione automatica

Non appena Pennylane è attivato, la sincronizzazione si attiva **automaticamente**:
* Quando una **fattura** viene finalizzata
* Quando un **pagamento** viene registrato
* Quando una **nota di credito** viene emessa e finalizzata

Non devi fare nulla manualmente.

### Sincronizzazione manuale

Dalla pagina **Sincronizzazione contabile** (`/app/accounting_sync`), puoi:
* Vedere lo stato di sincronizzazione di ogni documento (successo, errore, in attesa)
* Attivare manualmente la sincronizzazione di un documento specifico
* Ri-sincronizzare un documento in caso di errore

### Idempotenza

La sincronizzazione è **protetta contro i duplicati**: se una fattura o una nota di credito è già stata inviata a Pennylane, Fotostudio lo rileva e non crea duplicati. Anche i clienti vengono creati una sola volta, identificati univocamente tramite il loro riferimento interno.

---

### Paesi e aliquote IVA supportati

L'integrazione gestisce i codici IVA ufficiali Pennylane per i seguenti paesi:

| Paese | Aliquote supportate |
| ---- |
| 🇫🇷 Francia | 20%, 10%, 5,5%, 2,1%, 0% |
| 🇧🇪 Belgio | 21%, 12%, 6%, 0% |
| 🇪🇸 Spagna | 21%, 10%, 4%, 0% |
| 🇮🇹 Italia | 22%, 10%, 5%, 4%, 0% |
| 🇵🇹 Portogallo | 23%, 13%, 6%, 0% |
| 🇩🇪 Germania | 19%, 7%, 0% |
| 🇨🇭 Svizzera | 8,1%, 2,6%, 0% |


---

## Consultare lo storico delle sincronizzazioni

Vai in **Impostazioni** → **Sincronizzazione contabile** → **Storico** per vedere:
* L'elenco di tutti i documenti sincronizzati
* Lo stato di ogni sincronizzazione (successo / errore / in attesa)
* Il dettaglio degli errori in caso di fallimento

---

## Problemi frequenti

### "Chiave API mancante"
La chiave API non è inserita o è vuota. Verifica che sia ben inserita nelle impostazioni e che l'integrazione sia attivata.

### "Impossibile creare/recuperare il cliente Pennylane"
Il contatto associato alla fattura è introvabile o incompleto. Verifica che la fattura sia ben collegata a un contatto in Fotostudio.

### "Fattura non sincronizzata con Pennylane"
Un pagamento è registrato ma la fattura corrispondente non è ancora stata sincronizzata. Sincronizza prima la fattura, poi ri-sincronizza il pagamento.

### Errore di connessione
In caso di errore di rete o timeout, la sincronizzazione fallisce con lo stato "errore". Puoi ri-sincronizzare manualmente dalla pagina Storico. Se il problema persiste, verifica che la chiave API sia ancora valida lato Pennylane (può essere revocata dalle impostazioni Pennylane).

---

## Domande frequenti

**Le fatture già emesse prima dell'attivazione vengono sincronizzate?**  
No, la sincronizzazione automatica si applica solo ai documenti creati dopo l'attivazione. I documenti precedenti possono essere sincronizzati manualmente dalla pagina Sincronizzazione contabile.

**Cosa succede se disattivo Pennylane e poi lo riattivo?**  
I documenti già sincronizzati mantengono il loro collegamento con Pennylane. I nuovi documenti saranno nuovamente sincronizzati automaticamente. Non verranno creati duplicati.

**Posso usare Pennylane e un altro software contabile contemporaneamente?**  
No, può essere attivo solo un software di contabilità alla volta in Fotostudio.

**Pennylane è disponibile per tutti gli abbonamenti Fotostudio?**  
L'integrazione Pennylane è disponibile per tutti gli utenti che hanno accesso al modulo di fatturazione.