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.)
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.
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 |
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
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
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
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 %.
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 — Configurar proveedor, valores predeterminados y clave API
- Generación de Facturas — Cómo crear facturas a partir de entradas de tiempo
- Historial de Facturas — Ver y volver a descargar facturas anteriores