Configuración del Proveedor de Facturas
Ruta: Configuración → Factura
Configura qué proveedor utiliza CADENSA cuando generas facturas a partir de entradas de tiempo.
El PDF Interno está disponible en todos los planes (FREE/PRO/ENTERPRISE). Los proveedores de facturación externos (Billingo, Lexoffice, Pennylane, Holded, SmartBill) requieren un plan PRO o ENTERPRISE.
Proveedores
PDF Interno (predeterminado)
No requiere integración externa. CADENSA genera un documento PDF con marca local.
Funciona sin configuración — no se necesita clave API- Adecuado para facturas proforma y resúmenes de trabajo
No es una factura fiscal legalmente válida- Sin cumplimiento NAV / e-factura
Billingo
Billingo es una plataforma de facturación en línea húngara, conforme con NAV Online Számla 3.0.
- Factura fiscal húngara legalmente válida
- Conforme con NAV Online Számla 3.0
- Sincronización de lista de socios — selecciona clientes de tu libreta de direcciones de Billingo
- Numeración automática de facturas desde Billingo
- PDF sellado con el número de factura de Billingo
- Requiere: Clave API de Billingo (v3)
- 📖 Guía de configuración de Billingo
Lexoffice
Plataforma de facturación alemana (Grupo Haufe) compatible con ZUGFeRD / E-Rechnung.
- Factura legalmente válida para Alemania / Austria / Suiza
- ZUGFeRD / E-Rechnung (obligatorio para B2B alemán desde 2025)
- Sincronización de contactos — selecciona clientes de tu libreta de Lexoffice
- Numeración automática de facturas desde Lexoffice
- Requiere: Clave API de Lexoffice (Bearer token)
- 📖 Guía de configuración de Lexoffice
Pennylane
Plataforma de facturación francesa compatible con Factur-X (PDF/A-3 con XML integrado), orientada a los mercados FR, BE, LU, CH.
- Factura francesa legalmente válida (Factur-X)
- Factur-X obligatorio desde septiembre 2026 (grandes empresas) — implantación gradual hasta 2027
- Búsqueda o creación automática de clientes
- Códigos de tipo de IVA francés (20% / 10% / 5.5% / exento)
- Modo borrador — crea borradores primero, finaliza bajo demanda
- Sin entorno de pruebas — usa el modo borrador para testear
- Requiere: Token API de Pennylane (Bearer)
- 📖 Guía de configuración de Pennylane
Holded
Plataforma de facturación española compatible con e-facturación FacturaE, orientada a los mercados ES, PT, IT, FR, DE.
- Factura española legalmente válida (compatible con FacturaE)
- Búsqueda o creación automática de contactos (por NIF o nombre)
- Mapeo de tipos de IVA español (21% / 10% / 4% / exento)
- Facturas multilingüe (ES, EN, FR, DE, PT)
- Anulación de facturas vía API de Holded
- Sin entorno de pruebas — usa contactos de prueba para desarrollo
- Requiere: Clave API de Holded
- 📖 Guía de configuración de Holded
SmartBill
Plataforma de facturación rumana con cumplimiento e-Factura / ANAF, diseñada para empresas registradas en Rumanía.
- Factura rumana legalmente válida (factură fiscală)
- Cumplimiento e-Factura / ANAF (transmisión obligatoria B2B)
- Mapeo de tipos de TVA rumano (
Normala19% /Redusa9% /Redusa15% /Scutit0%) - Anulación de facturas (anulare) vía API de SmartBill
- Sin selector de socios — la API REST de SmartBill no tiene endpoint de lista de clientes; rellena los campos del cliente manualmente
- Sin entorno de pruebas — usa una serie de facturas de prueba en SmartBill Cloud para desarrollo
- Requiere: Token API de SmartBill + correo de cuenta + CIF/CUI de empresa
- 📖 Guía de configuración de SmartBill
Otros proveedores
| Proveedor | Mercado | Estado |
|---|---|---|
| Számlázz.hu | Hungría (NAV) | Próximamente |
| Fakturoid | República Checa / Eslovaquia | Próximamente |
| Moneybird | Países Bajos (Peppol) | Próximamente |
| e-conomic | Dinamarca / Noruega / Suecia | Próximamente |
Configuración de Billingo
1. Obtener la clave API de Billingo
- Inicia sesión en app.billingo.hu
- Ve a Integráció → API en el menú
- Haz clic en + Új API kulcs létrehozása (Crear nueva clave API)
- Copia la clave API v3 generada
Mantén tu clave API en secreto. No la compartas ni la incluyas en sistemas de control de versiones.
2. Configurar en CADENSA
- Abre Configuración → Factura en CADENSA
- Selecciona Billingo como proveedor
- Pega tu clave API en el campo Clave API
- Haz clic en Probar Conexión — un ✓ verde confirma que la clave es válida
- (Opcional) Activa el Modo Sandbox para probar sin emitir facturas reales
- Haz clic en Guardar
El botón Guardar permanece inactivo hasta que la clave API se pruebe con éxito. No se puede guardar una clave fallida o sin probar. Esto evita que una integración mal configurada rompa silenciosamente la generación de facturas.
3. Configurar valores predeterminados
| Configuración | Descripción |
|---|---|
| Moneda Predeterminada | Moneda usada en nuevas facturas (p. ej., HUF, EUR) |
| IVA % Predeterminado | Tipo impositivo pre-rellenado en el diálogo (p. ej., 27 para Hungría) |
| Días de Plazo de Pago | Número de días hasta la fecha de vencimiento (p. ej., 30) |
| Tipo de Documento Predeterminado | Tipo de documento preseleccionado (proforma / resumen de trabajo / factura) |
| País del Emisor | País de tu empresa como código ISO 3166-1 alfa-2 (p. ej., HU, DE, AT). Necesario para la sugerencia automática de IVA. |
El campo País del Emisor activa las sugerencias inteligentes de IVA en el diálogo Generar Factura.
4. Configurar ajustes específicos de Billingo
| Configuración | Descripción |
|---|---|
| ID de Bloque de Facturas | Bloque de facturas de Billingo a utilizar (en Ajustes → Bloques en Billingo) |
| ID de Cuenta Bancaria | ID de tu cuenta bancaria de Billingo (opcional — aparece en la factura) |
| Método de Pago | Método de pago predeterminado en las facturas emitidas |
| Idioma | Idioma de la factura (hu, en, de, …) |
5. (Opcional) Configurar detalles del emisor
La sección de emisor (los datos de tu empresa) en el PDF se toma de Configuración de la Unidad → Facturación:
- Nombre de la empresa
- Calle, Ciudad, Código Postal, País
- NIF / número de IVA
- Correo de facturación
El campo País del Emisor (configurado en esta misma página de ajustes) también se usa para la sugerencia automática del tipo de IVA en el diálogo Generar Factura — es independiente del país de la dirección de facturación.
Enrutamiento por Tipo de Documento
| Tipo de Documento | Configuración | Salida |
|---|---|---|
| Proforma | Solo PDF interno | PDF interno |
| Resumen de Trabajo | Solo PDF interno | PDF interno |
| Factura | pdf_interno | PDF interno |
| Factura | Billingo | Enviado a API de Billingo → PDF devuelto |
| Factura | Lexoffice | Enviado a API de Lexoffice → PDF devuelto |
| Factura | Pennylane | Enviado a API de Pennylane → PDF devuelto |
| Factura | Holded | Enviado a API de Holded → PDF devuelto |
| Factura | SmartBill | Enviado a API de SmartBill → PDF devuelto |
Cuando se selecciona un proveedor externo (Billingo, Lexoffice, etc.), el tipo de documento cambia automáticamente a Factura Legal y las opciones Proforma / Resumen de Trabajo no están disponibles. Estos tipos solo son compatibles con el proveedor PDF interno.
Comparación de Proveedores
| Función | PDF Interno | Billingo 🇭🇺 | Lexoffice 🇩🇪 | Pennylane 🇫🇷 | Holded 🇪🇸 | SmartBill 🇷🇴 |
|---|---|---|---|---|---|---|
| Mercado | Cualquiera | Hungría | DE / AT / CH | FR / BE / LU / CH | ES / PT / IT | Rumanía |
| Factura legal | | NAV 3.0 | ZUGFeRD | Factur-X | FacturaE | e-Factura / ANAF |
| Clave API necesaria | | | | | | |
| Modo sandbox | — | | | (usar modo borrador) | | |
| Selector de socios | | | | (auto) | (auto) | |
Prueba de Conexión
Usa el botón Probar Conexión después de introducir las credenciales. CADENSA llama a la API del proveedor y verifica:
- Que la clave API es válida
- Que la cuenta está activa
- Que están disponibles los permisos necesarios (leer + escribir facturas)
Una prueba exitosa muestra:
✓ Conexión exitosa — Cuenta Billingo: Tu Empresa Kft.
Una prueba fallida muestra el motivo del error (clave inválida, expirada, permiso denegado, etc.).
El botón Guardar permanece desactivado hasta que la prueba de conexión sea exitosa. No puedes guardar una clave API no probada o fallida. Si solo cambias otros ajustes (moneda, % de IVA, condiciones de pago) sin volver a introducir la clave, no es necesario repetir la prueba.
Resolución de Problemas
Error "INVOICE_NO_BILLABLE_ITEMS"
Todas las partidas del rango de fechas seleccionado tienen amount = 0. Ocurre cuando no hay tarifas por hora configuradas para tus proyectos.
Solución: Ve a Configuración → Tarifas y configura tarifas por hora para tus proyectos.
Error "Partner not found"
Los datos del cliente no coinciden con un socio existente en Billingo y la creación automática falló.
Solución: Crea el socio manualmente en Billingo primero y usa el selector de socios en el diálogo Generar Factura.
El PDF no tiene número de factura
La llamada a la API de Billingo tuvo éxito, pero falló la regeneración del PDF con el número de factura externo.
Solución: Descarga el PDF de nuevo desde Facturación → Historial de Facturas — el registro almacenado tiene el número de factura correcto.
Modo Sandbox
Activa Sandbox en los ajustes del proveedor para probar sin emitir facturas reales. Las facturas de sandbox no aparecen en la NAV ni en tu lista oficial de facturas de Billingo.
Próximas Integraciones
Las siguientes integraciones están en desarrollo:
- Számlázz.hu — Sistema húngaro NAV Online Számla (alternativa a Billingo)
- Fakturoid — República Checa y Eslovaquia
- Moneybird — Países Bajos y Bélgica
- e-conomic — Escandinavia (Dinamarca, Suecia, Noruega)
Si una integración concreta es importante para ti, escríbenos a support@cadensa.io.