Integración con Lexoffice
Lexoffice (Grupo Haufe) es una plataforma de contabilidad y facturación en línea para el mercado germanoparlante (DE / AT / CH). Cuando está configurada en CADENSA, puedes emitir facturas legalmente válidas directamente desde tus entradas de tiempo registradas — incluida la generación automática de E-Rechnung (ZUGFeRD) para facturas B2B alemanas, obligatoria desde 2025.
Lexoffice está diseñado para empresas en Alemania 🇩🇪, Austria 🇦🇹 y Suiza 🇨🇭.
Antes de Comenzar
Necesitas:
- Una cuenta activa de Lexoffice (cualquier plan — la API Pública está disponible en todos los planes de pago)
- Una clave API de Lexoffice (ver más abajo)
- Unidad CADENSA con al menos el rol de Administrador
Paso 1 — Obtener tu Clave API de Lexoffice
- Inicia sesión en app.lexoffice.de
- En la barra lateral izquierda, haz clic en Erweiterungen (Extensiones)
- Bajo la sección Weitere Apps, busca la tarjeta Public API
- Haz clic en Verwalten (Gestionar)
- Haz clic en + API-Schlüssel erstellen (Crear clave API)
- Copia la clave generada inmediatamente — se muestra solo una vez
Nunca compartas tu clave API ni la incluyas en sistemas de control de versiones. Cualquier persona con la clave puede crear y gestionar facturas en tu nombre.
Paso 2 — Configurar en CADENSA
- Abre Configuración → Factura en CADENSA
- Selecciona Lexoffice 🇩🇪 como proveedor
- Aparecerá un cuadro informativo:
Encuentra tu clave API de Lexoffice en: Erweiterungen → Weitere Apps → Public API → Verwalten → + API-Schlüssel erstellen
- Pega tu clave API en el campo Clave API
- Haz clic en Probar Conexión — un
verde confirma que la clave es válida - Haz clic en Guardar
Paso 3 — Configurar Valores Predeterminados
Configura los valores predeterminados para que el diálogo Generar Factura se pre-rellene con valores adecuados:
| Configuración | Valor recomendado (DE) | Descripción |
|---|---|---|
| Moneda Predeterminada | EUR | Moneda usada en nuevas facturas |
| IVA % Predeterminado | 19 | Tipo de IVA alemán estándar (reducido: 7, exento: 0) |
| Días de Plazo de Pago | 14 o 30 | Días hasta la fecha de vencimiento |
| Tipo de Documento Predeterminado | Factura | Preselecciona "Factura" en el diálogo |
- Austria: IVA estándar 20%
- Suiza: IVA estándar 8,1%
Emitir una Factura vía Lexoffice
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
Lexoffice - (Opcional) Usa el selector de socios para seleccionar un cliente de tu libreta de contactos de Lexoffice
- Rellena los datos del cliente, IVA % y fecha de vencimiento
- Haz clic en Previsualizar Factura → revisa las partidas y totales
- Haz clic en Emitir Factura (Lexoffice)
CADENSA envía la factura a la API de Lexoffice, recibe el número de factura y descarga el PDF.
- Se crea una nueva factura en estado borrador, que se finaliza inmediatamente (lo que asigna el número de factura)
- Las facturas finalizadas aparecen en tu lista de facturas de Lexoffice
- Las facturas B2B alemanas incluyen automáticamente un archivo adjunto ZUGFeRD / E-Rechnung en XML
Selector de Socios
Cuando Lexoffice está configurado, el diálogo Generar Factura muestra un selector de socios — un desplegable de búsqueda con tus contactos de Lexoffice.
Seleccionar un contacto rellena automáticamente:
- Nombre de empresa
- Nombre de contacto
- Calle, código postal, ciudad, país
- Número fiscal (Steuernummer / USt-IdNr.)
Esto evita tener que volver a introducir los datos del cliente en facturas recurrentes. Los contactos se obtienen en tiempo real desde la API /contacts de Lexoffice (solo rol de cliente).
Tipos de IVA
Lexoffice aplica tipos de IVA válidos específicos:
| Tipo | Caso de uso |
|---|---|
| 19% | IVA alemán estándar (Regelsteuersatz) |
| 7% | IVA alemán reducido (ermäßigter Steuersatz) |
| 0% | Exento de IVA, suministro intracomunitario, tercer país |
Si introduces un tipo de IVA distinto de 0, 7 o 19, CADENSA lo redondea automáticamente al valor válido de Lexoffice más cercano. Usa 0 para facturas exentas de IVA (p. ej. Kleinunternehmerregelung § 19 UStG).
Enrutamiento de Documentos
| Tipo de Documento | Salida |
|---|---|
| Proforma | PDF interno (nunca enviado a Lexoffice) |
| Resumen de Trabajo | PDF interno (nunca enviado a Lexoffice) |
| Factura | Enviado a API de Lexoffice → PDF devuelto |
Solo los documentos de tipo Factura se envían a Lexoffice. Proforma y Resumen de Trabajo siempre se generan internamente, independientemente de la configuración del proveedor.
Historial de Facturas y Descarga de PDF
Tras la creación exitosa de una factura:
- La factura aparece en Facturación → Historial de Facturas en CADENSA
- La factura también aparece en tu cuenta de Lexoffice bajo Umsätze → Ausgangsrechnungen
- 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 clave API. CADENSA llama al endpoint /profile de Lexoffice para verificar:
- Que la clave API es válida y no ha expirado
- Que la cuenta está activa
Una prueba exitosa muestra:
✓ Conexión exitosa
Resolución de Problemas
Error "401 Unauthorized"
La clave API no es válida o ha sido revocada.
Solución: Genera una nueva clave API en Lexoffice (Erweiterungen → Public API → + API-Schlüssel erstellen) e introdúcela de nuevo en CADENSA.
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.
Factura bloqueada en borrador / sin número de factura
Lexoffice requiere que las facturas se finalicen antes de que se les asigne un número de factura. CADENSA finaliza la factura inmediatamente al crearla (?finalize=true). Si la finalización falla (p. ej., faltan campos obligatorios), la factura puede quedarse en borrador.
Solución:
- Inicia sesión en Lexoffice y comprueba Umsätze → Ausgangsrechnungen para facturas en borrador
- Revisa los campos obligatorios que faltan (normalmente: código de país o número de IVA)
- Completa la factura manualmente en Lexoffice, o elimínala y vuelve a intentarlo desde CADENSA con los datos del cliente completos
La descarga del PDF tarda mucho tiempo
Lexoffice genera los PDF de forma asíncrona. CADENSA consulta la API durante un máximo de 30 segundos esperando el PDF. Si el PDF no está listo a tiempo, se muestra un error.
Solución: Espera un momento y vuelve a descargarlo desde Facturación → Historial de Facturas.
El tipo de IVA no es aceptado
Lexoffice solo acepta 0, 7 y 19 como tipos impositivos válidos.
Solución: En el diálogo Generar Factura, usa uno de estos valores en el campo IVA %.
El código de país del cliente no se reconoce
Lexoffice requiere un código de país válido en formato ISO 3166-1 alfa-2 (p. ej. DE, AT, CH, US). Los nombres de país en texto libre se convierten automáticamente, pero los nombres inusuales pueden fallar.
Solución: Introduce directamente el código de país ISO de 2 letras en el campo País (p. ej. DE en lugar de Alemania).
Lexoffice vs. Billingo
| Función | Lexoffice 🇩🇪 | Billingo 🇭🇺 |
|---|---|---|
| Mercado | DE / AT / CH | Hungría |
| Estándar legal | ZUGFeRD / E-Rechnung | NAV Online Számla 3.0 |
| Autenticación | Bearer token (clave API) | Clave API (v3) |
| Modo sandbox |  No disponible | Disponible |
| Selector de socios | Endpoint /contacts | Endpoint /partners |
| Generación de PDF | Asíncrona (polling) | Síncrona |
| Finalización de factura | Explícita (?finalize=true) | Automática |
Ver También
- Configuración del Proveedor de Facturas — configura el proveedor, los valores predeterminados y la clave API
- Generación de Facturas — cómo generar facturas a partir de entradas de tiempo
- Facturación — Planes de Suscripción — qué plan de CADENSA se requiere