Integración Billingo
Billingo es una plataforma húngara de facturación en línea conforme con NAV Online Számla 3.0. Una vez configurada en CADENSA, puedes emitir facturas fiscales húngaras legalmente v álidas directamente desde tus entradas de tiempo — con declaración automática a NAV y sincronización desde tu libreta de contactos de Billingo.
Requisitos Previos
- Una cuenta Billingo activa (con acceso a API)
- Una clave API Billingo v3 (ver abajo)
- Al menos un bloque de facturas (számlablokk) configurado en Billingo
- Rol Admin mínimo en la unidad de CADENSA
Paso 1 — Obtener tu Clave API de Billingo
- Inicia sesión en app.billingo.hu
- En el menú izquierdo, haz clic en Beállítások (Configuración)
- Haz clic en API en el menú de configuración
- Haz clic en + Új API kulcs létrehozása (Crear nueva clave API)
- Asigna un nombre (p.ej.,
CADENSA) - Copia la clave generada inmediatamente — solo se muestra una vez
Nunca compartas tu clave API ni la incluyas en el control de versiones. Cualquiera con la clave puede crear facturas en tu nombre.
Paso 2 — Configurar en CADENSA
- Abre Configuración → Factura en CADENSA
- Selecciona Billingo 🇭🇺 como proveedor
- Aparecerá un mensaje informativo:
Encuentra tu clave API de Billingo en: app.billingo.hu → Beállítások → API → API kulcs létrehozása
- Pega tu clave API en el campo API Key
- Haz clic en Probar Conexión — un
verde confirma la validez - Haz clic en Guardar
El botón Guardar permanece desactivado hasta que la prueba de conexión sea exitosa.
Paso 3 — Establecer Valores por Defecto
| Configuración | Valor recomendado (HU) | Descripción |
|---|---|---|
| Moneda por defecto | HUF | Moneda usada en nuevas facturas |
| IVA % por defecto | 27 | Tipo estándar húngaro (ÁFA) |
| Días de vencimiento | 8 o 30 | Días hasta la fecha de vencimiento |
| Tipo de documento por defecto | Factura | Preseleccionado en el diálogo de generación |
| País del emisor | HU | Código de país ISO 3166-1 alpha-2 de tu empresa |
Paso 4 — Configuración Específica de Billingo
| Configuración | Descripción |
|---|---|
| ID de Bloque de Facturas | El bloque de facturas de Billingo a usar. CADENSA selecciona automáticamente el primer bloque activo si se deja vacío. Para un bloque específico, introduce el ID desde Billingo → Beállítások → Bizonylattömbök. |
| ID de Cuenta Bancaria | Opcional. El ID de tu cuenta bancaria de Billingo — aparece en la factura. |
| Método de Pago | Método de pago por defecto (wire_transfer, cash, bankcard, etc.). |
| Idioma de la Factura | Idioma de emisión (hu, en, de, es, etc.). |
Paso 5 — (Opcional) Modo Sandbox / Prueba
Activa el modo Sandbox para probar la generación de facturas sin emitir facturas reales declaradas a NAV. Las facturas sandbox:
- No aparecen en tu lista oficial de Billingo
- No se declaran a NAV
- Se descartan después de las pruebas
Interruptor: Configuración → Factura → Sandbox / Modo de prueba
Emitir una Factura vía Billingo
- Abre Informes → aplica el rango de fechas y filtros de proyecto
- Haz clic en Generar Factura
- En el campo Tipo de Documento, selecciona Factura — el canal de salida muestra
Billingo - (Opcional) Usa el selector de socios para elegir un cliente de tu libreta de Billingo
- Completa los datos del cliente, el tipo de IVA y la fecha de vencimiento
- Haz clic en Vista Previa → revisa las líneas y totales
- Haz clic en Emitir Factura (Billingo)
- Se crea una nueva factura y se finaliza inmediatamente (asignando el número de factura de Billingo)
- La factura se declara automáticamente a NAV Online Számla 3.0
- La factura aparece en Billingo bajo Számlák → Kimenő számlák
Selector de Socios
Cuando Billingo está configurado, el diálogo de generación muestra un selector de socios — una lista desplegable con búsqueda de tus contactos de Billingo.
Al seleccionar un contacto, se rellenan automáticamente:
- Nombre de la empresa
- Dirección (calle, código postal, ciudad, país)
- Número de identificación fiscal
- Dirección de correo electrónico
Si el cliente no existe en tu libreta de Billingo, CADENSA lo crea automáticamente.
Tipos de IVA
| Tipo | Uso |
|---|---|
| 27% | IVA estándar húngaro (ÁFA) |
| 5% | Tipo reducido (ciertos alimentos, medicamentos) |
| 0% | Exento, suministro intracomunitario, exportación |
| AAM | Exención general de impuestos |
| TAM | Exención objetiva |
| EU | Suministro intracomunitario de bienes |
| F.AFA | Inversión del sujeto pasivo (reverse charge) |
| K.AFA | IVA de caja |
| KBAUK | Exportación fuera de la UE |
Facturas en Moneda Extranjera
Billingo funciona nativamente en HUF. Para facturas en otras monedas (EUR, USD, GBP, etc.):
- CADENSA obtiene automáticamente el tipo de cambio HUF actual de la API Frankfurter (datos del BCE)
- El tipo de cambio (
conversion_rate) se incluye en la solicitud como requiere Billingo - El tipo se registra en el registro de facturas de CADENSA a efectos de auditoría
Cancelación de Factura (Storno)
Para cancelar una factura de Billingo desde CADENSA:
- Abre Facturación → Historial de Facturas
- Busca la factura y haz clic en Cancelar Factura
- Confirma la cancelación
CADENSA llama a POST /documents/{id}/cancel. Se crea automáticamente una factura de cancelación en Billingo y se declara a NAV.
Las facturas canceladas no pueden recuperarse.
Solución de Problemas
"Clave API inválida" / 401 No autorizado
La clave API es inválida, ha expirado o ha sido revocada.
Solución: Genera una nueva clave en Billingo (Beállítások → API → + Új API kulcs) y vuelve a introducirla en CADENSA.
"No se encontraron bloques de facturas"
No hay ningún bloque de facturas configurado en Billingo.
Solución: En Billingo, ve a Beállítások → Bizonylattömbök y crea al menos un bloque activo.
Error "INVOICE_NO_BILLABLE_ITEMS"
Todas las líneas tienen amount = 0 — no hay tarifas por hora configuradas.
Solución: Ve a Configuración → Tarifas y configura tarifas horarias para tus proyectos.
Páginas Relacionadas
- Configuración del Proveedor de Facturas — comparar todos los proveedores, configurar clave API y valores por defecto
- Generación de Facturas — cómo generar facturas desde entradas de tiempo
- Planes de Suscripción — qué plan de CADENSA se requiere