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

# Sincronización con Pennylane

# 🔗 Conexión Pennylane a Fotostudio

## ¿Qué es Pennylane?

[Pennylane](https://www.pennylane.com/) es un software de contabilidad francés destinado a TPE/PME y a expertos contables. La conexión con Fotostudio permite sincronizar automáticamente tus documentos contables (facturas, pagos, abonos) hacia Pennylane, sin ninguna reescritura.

---

## Lo que hace la integración

Una vez activada, la integración envía automáticamente hacia Pennylane:

| Lo que se sincroniza | Detalle |
| ---- |
| **Facturas** | Con todas las líneas, los importes sin IVA/con IVA y las tasas de IVA |
| **Pagos** | La factura se marca automáticamente como pagada en Pennylane |
| **Abonos** | Creados en Pennylane y vinculados a la factura original si ya está sincronizada |
| **Clientes** | Creados automáticamente en Pennylane (empresas y particulares) si no existen ya |

---

## Cómo conectar Pennylane

### Paso 1 — Generar tu clave API en Pennylane

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


1. Conéctate a tu cuenta en [app.pennylane.com](https://app.pennylane.com)
2. Ve a **Parámetros** → **Conectividad**
3. Haz clic en la pestaña **Desarrolladores**
4. Haz clic en **Generar un token API**
5. Elige **Ilimitado** para el período de validez y marca la casilla de advertencia
6. En el siguiente paso, en los permisos, marca en lectura y escritura: Gestión de clientes, Gestión de facturas de clientes, Gestión de facturas de proveedores, Gestión de transacciones, Gestión de proveedores
7. Finaliza y copia la clave mostrada (solo será visible una vez)

### Paso 2 — Configurar Pennylane en Fotostudio

1. En Fotostudio, ve a **Contabilidad** → **Parámetros** → **Sincronización contable**
2. Haz clic en el botón **Configurar un servicio**
3. Desplázate hasta la sección **Pennylane**
4. Pega tu clave API en el campo **Clave API**
5. Haz clic en **Probar la conexión** para verificar que la clave es válida
6. Marca **Activar la sincronización con Pennylane**
7. Haz clic en **Guardar**

> ℹ️ Solo puedes activar un software de contabilidad a la vez. Si usabas SevDesk o Lexware, la activación de Pennylane lo desactivará automáticamente.

---

## Funcionamiento de la sincronización

### Sincronización automática

En cuanto Pennylane está activado, la sincronización se activa **automáticamente**:
* Cuando una **factura** se finaliza
* Cuando un **pago** se registra
* Cuando un **abono** se emite y finaliza

No tienes que hacer nada manualmente.

### Sincronización manual

Desde la página **Sincronización contable** (`/app/accounting_sync`), puedes:
* Ver el estado de sincronización de cada documento (éxito, error, en espera)
* Activar manualmente la sincronización de un documento específico
* Re-sincronizar un documento en caso de error

### Idempotencia

La sincronización está **protegida contra duplicados**: si una factura o un abono ya ha sido enviado a Pennylane, Fotostudio lo detecta y no crea un duplicado. Los clientes también se crean una sola vez, identificados de forma única a través de su referencia interna.

---

### Países y tasas de IVA soportados

La integración gestiona los códigos de IVA oficiales de Pennylane para los siguientes países:

| País | Tasas soportadas |
| ---- |
| 🇫🇷 Francia | 20 %, 10 %, 5,5 %, 2,1 %, 0 % |
| 🇧🇪 Bélgica | 21 %, 12 %, 6 %, 0 % |
| 🇪🇸 España | 21 %, 10 %, 4 %, 0 % |
| 🇮🇹 Italia | 22 %, 10 %, 5 %, 4 %, 0 % |
| 🇵🇹 Portugal | 23 %, 13 %, 6 %, 0 % |
| 🇩🇪 Alemania | 19 %, 7 %, 0 % |
| 🇨🇭 Suiza | 8,1 %, 2,6 %, 0 % |


---

## Consultar el historial de sincronizaciones

Ve a **Parámetros** → **Sincronización contable** → **Historial** para ver:
* La lista de todos los documentos sincronizados
* El estado de cada sincronización (éxito / error / en espera)
* El detalle de los errores en caso de fallo

---

## Problemas frecuentes

### "API key faltante"
La clave API no está indicada o está vacía. Verifica que esté bien introducida en los parámetros y que la integración esté activada.

### "Imposible crear/recuperar el cliente Pennylane"
El contacto asociado a la factura no se encuentra o está incompleto. Verifica que la factura esté bien vinculada a un contacto en Fotostudio.

### "Factura no sincronizada con Pennylane"
Se registra un pago pero la factura correspondiente aún no ha sido sincronizada. Sincroniza primero la factura, luego re-sincroniza el pago.

### Error de conexión
En caso de error de red o de timeout, la sincronización falla con el estado "error". Puedes re-sincronizar manualmente desde la página Historial. Si el problema persiste, verifica que la clave API sigue siendo válida del lado de Pennylane (puede ser revocada desde los parámetros de Pennylane).

---

## Preguntas frecuentes

**¿Se sincronizan las facturas ya emitidas antes de la activación?**  
No, la sincronización automática solo se aplica a los documentos creados después de la activación. Los documentos anteriores pueden sincronizarse manualmente desde la página Sincronización contable.

**¿Qué pasa si desactivo Pennylane y luego lo reactivo?**  
Los documentos ya sincronizados conservan su vínculo con Pennylane. Los nuevos documentos se sincronizarán automáticamente de nuevo. No se creará ningún duplicado.

**¿Puedo usar Pennylane y otro software contable al mismo tiempo?**  
No, solo un software de contabilidad puede estar activo a la vez en Fotostudio.

**¿Pennylane está disponible para todas las suscripciones de Fotostudio?**  
La integración Pennylane está disponible para todos los usuarios que tengan acceso al módulo de facturación.