→ Abrir en la app — Accede directamente a esta sección desde tu cuenta.
Holded conecta Hotelgest PMS con el ERP Holded para enviar facturas y cobros de forma semi-automática. El PMS crea las facturas en Holded, registra los pagos y los asigna a la cuenta bancaria configurada.
Dónde está
Marketplace → categoría Contabilidad → Holded
Exportación operativa: informe Contabilidad → botón de envío a Holded
Requisitos
Cuenta Holded con plan que incluya API.
API key de Holded (se obtiene en Holded → Ajustes → API).
Rol Administrador con permiso Marketplace.
Catálogo de artículos con cuenta contable asignada por producto.
Addon Contabilidad activo en el plan del hotel.
Activación
Paso 1: Solicita integración
Marketplace → Holded → Solicitar integración.
Paso 2: Configuración de cuentas
Soporte configura la API key de Holded y el mapeo contable:
Campo | Descripción |
API key | Clave de acceso a la API de Holded (obligatoria) |
Cuenta principal | Cuenta contable por defecto para ventas |
Cuenta de cliente | Cuenta contable del deudor |
Cuentas por régimen | Alojamiento, desayuno, media pensión, pensión completa, todo incluido |
Cuentas de cobro | Una cuenta por forma de pago (efectivo, tarjeta, transferencia, etc.) |
Tasa turística | Cuenta específica para la tasa |
Exclusiones | Artículos o formas de pago excluidos del envío |
Paso 3: Prueba un periodo
Exporta un mes test y comprueba totales en Holded vs Facturas del PMS.
Qué envía a Holded
Facturas
Por cada factura del periodo seleccionado, el PMS:
Crea o actualiza el contacto (cliente) en Holded con NIF, dirección y país.
Crea la factura con las líneas desglosadas: artículo, cantidad, precio, IVA y cuenta contable.
Guarda la referencia de Holded en la factura del PMS para control de duplicados.
Cobros
Por cada pago asociado a la factura:
Registra el pago en Holded vinculado a la factura.
Asigna la cuenta bancaria según la forma de pago (efectivo → cuenta de caja, tarjeta → cuenta de banco, etc.).
Guarda la referencia del pago en el PMS.
Rectificativas
Las facturas rectificativas se procesan con el mismo flujo. Si una factura ya existe en Holded, el PMS la elimina y la recrea con los datos actualizados.
Modos de operación
Modo | Comportamiento |
Envío | Crea facturas y cobros en Holded (modo normal) |
Vista previa | Muestra las facturas y cobros que se enviarían sin ejecutar el envío |
Test | Igual que envío pero para validación inicial |
Troubleshooting
Síntoma | Qué revisar |
"No data Holded" | La conexión con Holded no está configurada. Contactar soporte |
"Not import holded" + detalle | Error al crear la factura — revisar si el contacto tiene NIF válido y las cuentas contables existen en Holded |
"Holded invoice created without valid document id" | Holded aceptó la factura pero no devolvió ID — posible timeout o error en Holded. Reintentar |
"Holded payment bank assign failed" | La cuenta bancaria configurada para esa forma de pago no existe en Holded. Verificar mapeo |
Facturas duplicadas en Holded | El sistema controla duplicados automáticamente. Si una factura se envió antes, se borra y recrea. Verificar que no se importó manualmente en Holded |
Totales no cuadran | Algunos artículos pueden estar excluidos del envío. Comparar con el informe de Facturas del mismo periodo y revisar las exclusiones con soporte |
¿Holded o exportación por fichero?
Holded envía facturas y cobros directamente — no genera un fichero intermedio. Es más automatizado que Sage/A3/Clavecon pero requiere API key de Holded y configuración de cuentas en ambos sistemas.
¿Puedo reenviar un periodo?
Sí. El PMS elimina las facturas existentes en Holded y las recrea. Los cobros asociados también se regeneran. No se duplican si usas el flujo estándar del PMS.