Integración con Pennylane
Pennylane es una plataforma de contabilidad y facturación en línea diseñada para el mercado francés (FR / BE / LU / CH). Cuando está configurada en CADENSA, puedes emitir facturas legalmente válidas directamente desde tus entradas de tiempo registradas, conforme al estándar Factur-X — obligatorio para la e-facturación B2B francesa a partir de septiembre de 2026.
Pennylane está diseñado para empresas en Francia 🇫🇷, Bélgica 🇧🇪, Luxemburgo 🇱🇺 y Suiza 🇨🇭.
Factur-X (PDF/A-3 con XML integrado) será obligatorio en Francia:
- Septiembre 2026 — grandes empresas
- 2027 — implantación gradual para todas las empresas
La integración de CADENSA con Pennylane ya está preparada para este requisito.
Antes de Comenzar
Necesitas:
- Una cuenta activa de Pennylane — plan Essentiel o superior (la API no está disponible en el plan Basique)
- Un token API de Pennylane (ver más abajo)
- Unidad CADENSA con al menos el rol de Administrador
La API Pública de Pennylane solo está disponible en los planes Essentiel (€24/mes) y Premium (€79/mes). El plan Basique (€14/mes) no incluye acceso a la API.
Paso 1 — Crear una Cuenta en Pennylane
- Ve a pennylane.com
- Haz clic en "Démarrer maintenant" (arriba a la derecha)
- Selecciona "Essentiel" y haz clic en "Essayer"
- Regístrate con tu correo y contraseña
- Crea una empresa (obligatorio — los tokens tienen ámbito de empresa)
Se inicia automáticamente un período de prueba gratuito de 15 días. Sin compromiso.
Paso 2 — Obtener tu Token API de Pennylane
- Inicia sesión en app.pennylane.com
- En la barra lateral izquierda, haz clic en Paramètres (Configuración — icono de engranaje, abajo a la izquierda)
- Ve a Intégrations → API
- Haz clic en "Générer un token" (Generar token)
- Copia el Bearer token generado
Nunca compartas tu token ni lo incluyas en sistemas de control de versiones. Cualquier persona con el token puede crear y gestionar facturas en tu nombre.
Para la guía oficial de Pennylane, consulta: pennylane.readme.io/docs/generating-my-api-token
Paso 3 — Configurar en CADENSA
- Abre Configuración → Factura en CADENSA
- Selecciona Pennylane 🇫🇷 como proveedor
- Pega tu token API en el campo Clave API
- Haz clic en Probar Conexión — un
verde confirma que el token es válido y muestra el nombre de tu empresa - Haz clic en Guardar
Paso 4 — Configurar Valores Predeterminados
Configura los valores predeterminados para que el diálogo Generar Factura se pre-rellene con valores adecuados:
| Configuración | Valor recomendado (FR) | Descripción |
|---|---|---|
| Moneda Predeterminada | EUR | Moneda usada en nuevas facturas |
| IVA % Predeterminado | 20 | Tipo de IVA francés estándar (TVA) |
| Días de Plazo de Pago | 30 | Días hasta la fecha de vencimiento (30 días es el estándar en Francia) |
| Tipo de Documento Predeterminado | Factura | Preselecciona "Factura" en el diálogo |
| País del Emisor | FR | País de tu empresa — activa la sugerencia automática de IVA |
- 10% — Tipo reducido (hostelería, transporte)
- 5,5% — Tipo superreducido (alimentos, libros, algunos servicios culturales)
- 0% — Exento (suministro intracomunitario, exportación)
Emitir una Factura vía Pennylane
Una vez configurado, sigue el flujo estándar de generación de facturas:
- Abre Informes → aplica filtros de rango de fechas y proyectos
- Haz clic en Generar Factura
- En el campo Tipo de Documento, selecciona Factura — el canal de salida muestra
Pennylane - Rellena los datos del cliente (nombre, dirección, país, número de IVA si aplica)
- Establece el tipo de IVA (predeterminado: 20%)
- Haz clic en Previsualizar Factura → revisa las partidas y totales
- Haz clic en Emitir Factura (Pennylane)
CADENSA envía la factura a la API de Pennylane. Se busca o crea automáticamente un registro de cliente por coincidencia de nombre. La factura se crea y finaliza, y el PDF se descarga desde Pennylane.
- Se crea una nueva factura de cliente en Pennylane bajo Ventes → Factures clients
- La factura se finaliza inmediatamente (estado:
waiting_payment) - El PDF está disponible para su descarga tanto desde CADENSA (Historial de Facturas) como desde Pennylane
Modo Borrador
Para crear una factura en borrador sin finalizarla:
La integración de Pennylane crea facturas finalizadas de forma predeterminada (draft: false). Con fines de prueba o revisión, contacta con tu cuenta de Pennylane para establecer manualmente las facturas como borrador, o elimina las facturas de prueba desde el panel de Pennylane después de las pruebas.
Como Pennylane no tiene entorno de pruebas, usa los tipos de documento Proforma o Resumen de Trabajo en CADENSA para pruebas — siempre se generan como PDFs internos y nunca se envían a Pennylane.
Códigos de Tipos de IVA
Pennylane usa códigos de tipos de IVA francés específicos internamente:
| Tipo Impositivo | Código Pennylane | Caso de uso |
|---|---|---|
| 20% | FR_200 | IVA estándar (taux normal) |
| 10% | FR_100 | Tipo reducido (taux intermédiaire) |
| 5,5% | FR_055 | Tipo superreducido (taux réduit) |
| 0% | exempt | Exento de IVA, exportación, intra-UE |
CADENSA mapea automáticamente tu tipo impositivo numérico al código correcto de Pennylane.
Enrutamiento de Documentos
| Tipo de Documento | Salida |
|---|---|
| Proforma | PDF interno (nunca enviado a Pennylane) |
| Resumen de Trabajo | PDF interno (nunca enviado a Pennylane) |
| Factura | Enviado a API de Pennylane → PDF devuelto |
Solo los documentos de tipo Factura se envían a Pennylane. Proforma y Resumen de Trabajo siempre se generan internamente, independientemente de la configuración del proveedor.
Historial de Facturas y Descarga de PDF
Después de crear una factura correctamente:
- La factura aparece en Informes → Facturas en CADENSA
- La factura también aparece en tu cuenta de Pennylane bajo Ventes → Factures clients
- Puedes volver a descargar el PDF en cualquier momento desde cualquiera de los dos lugares
Prueba de Conexión
Usa el botón Probar Conexión después de introducir tu token API. CADENSA llama al endpoint /me de Pennylane para verificar:
- Que el token es válido
- Que se devuelve el nombre de la empresa
Una prueba exitosa muestra:
✓ Conexión exitosa — Cuenta Pennylane: Nombre de tu empresa
Resolución de Problemas
Error "401 Unauthorized"
El token API no es válido, ha expirado o pertenece a otra cuenta de Pennylane.
Solución: Genera un nuevo token en Pennylane (Paramètres → Intégrations → API → Générer un token) e introdúcelo de nuevo en CADENSA.
Error "API not available" / error 403
Tu plan de Pennylane no incluye acceso a la API.
Solución: Actualiza al plan Essentiel (€24/mes) o Premium (€79/mes) — el plan Basique no incluye acceso a la API.
Error "INVOICE_NO_ENTRIES"
No se encontraron entradas de tiempo para el rango de fechas y los filtros de proyecto seleccionados.
Solución: Ajusta el rango de fechas o el filtro de proyecto e inténtalo de nuevo.
Cliente no creado / cliente incorrecto asignado
CADENSA busca un cliente existente en Pennylane por nombre de empresa. Si no encuentra ninguna coincidencia, se crea un nuevo cliente. Si el nombre coincide incorrectamente, verifica o actualiza manualmente el cliente en Pennylane.
Solución: Comprueba Contacts en Pennylane y fusiona o corrige registros de cliente duplicados.
La descarga del PDF falla
Pennylane genera los PDF de forma asíncrona. Si el PDF no está disponible de inmediato, CADENSA reintenta durante un breve período.
Solución: Espera un momento y vuelve a descargarlo desde Informes → Facturas.
Ver También
- Configuración del Proveedor de Facturas — Visión general de todos los proveedores
- Generación de Facturas — Cómo crear facturas a partir de entradas de tiempo
- Historial de Facturas — Ver y volver a descargar facturas anteriores