Integración con Holded para facturas, rectificativas y cobros
Conector en los dos sentidos con Holded: emite las facturas desde tu aplicación y recibe las rectificativas, los cobros y los cambios de estado sin duplicados.
Muchas aplicaciones de sector emiten la factura en Holded y necesitan saber después qué pasa allí: rectificativas, abonos y cobros. Esta integración con Holded hace las dos cosas. Emite las facturas desde tu aplicación y recibe los cambios que se hacen en Holded, sin duplicados.
Para quién es
Empresas de software de sector cuyos clientes facturan con Holded, integradores y empresas con aplicación propia.
Qué resuelve una integración con Holded
- Facturas tecleadas dos veces. La factura se crea en Holded con los datos de tu aplicación.
- Descuadres entre sistemas. Antes de aprobarla, se comprueba que el total de Holded coincide con el tuyo.
- Emisiones cortadas a medias. Si algo falla, se reintenta y continúa donde se quedó.
- Cambios que no llegan. Las rectificativas y los cobros hechos en Holded vuelven a tu aplicación.
Qué hace
- Conecta cada cuenta con su clave de API, que se guarda cifrada, comprueba los permisos y da de alta los avisos de Holded.
- Emite por pasos que se pueden repetir sin duplicar: busca o da de alta el contacto por NIF, crea el borrador con los impuestos de cada línea, compara totales y aprueba. El número y el PDF son los de Holded.
- Traduce los impuestos españoles a los de la cuenta del cliente: IVA, IGIC, IPSI, exento y no sujeto.
- Recibe los avisos de Holded, comprueba su firma, descarta los repetidos y responde al momento.
- Incorpora las rectificativas creadas en Holded, repartiendo el importe entre las órdenes facturadas, y sincroniza cobros, estados y vencimientos.
- Repasa cada cierto tiempo lo que no haya llegado por aviso.
- Reintenta cuando Holded limita las peticiones o no responde, e incluye un modo simulado para desarrollo.
Beneficios
- Tienes en tu aplicación el mismo estado de cobro que en Holded.
- No creas facturas duplicadas aunque falle la conexión.
Contexto del sector
Datos generales del sector con su fuente pública. No son resultados de este producto.
- Los sistemas informáticos de facturación tienen que cumplir el reglamento VERI*FACTU antes del 1 de enero de 2027 en el caso de los contribuyentes del Impuesto sobre Sociedades y antes del 1 de julio de 2027 en el resto de obligados. Fuente: BOE, «Real Decreto 1007/2023, de 5 de diciembre», disposición final cuarta, texto consolidado de diciembre de 2025.
Qué recibes según la modalidad
Precio a consultar según modalidad y alcance. El soporte para integrarlo y el mantenimiento se contratan aparte.
- El código del módulo, con la documentación para adaptarlo a tu modelo de facturas y órdenes.
- Ejemplos de integración y el modo simulado.
- Garantía frente a defectos durante el periodo pactado.
- Todo lo anterior, con derecho a adaptarlo y mantenerlo dentro de tu producto.
- Derecho a integrar el activo en un producto comercial propio, identificado en el contrato.
- Derecho a distribuirlo como parte de ese producto a tus clientes, sin pedir autorización por cada instalación y sin límite de clientes finales, salvo pacto.
- No incluye revenderlo ni sublicenciarlo por separado.
- No es exclusiva, salvo pacto.
- El mantenimiento, el soporte y las adaptaciones se contratan aparte.
Ficha técnica
Lenguaje y entorno de ejecución: TypeScript 5.9 sobre Node.js. Versión mínima compatible: Node.js 20.9 (la que declara Next.js 16).
Frameworks: Next.js 16.4. Acceso a datos con Prisma 7.8.
Base de datos: PostgreSQL.
Sistemas operativos: Servidor con Node.js.
Idiomas de la interfaz: Español.
Infraestructura necesaria:
- PostgreSQL.
- Publicación en una dirección HTTPS para recibir los avisos de Holded.
- Planificador de tareas periódicas (cron) para el repaso de estados.
- Holded, con clave de API de cada cuenta (requiere cuenta propia del comprador).
Despliegue privado: Funciona en tu infraestructura, pero necesita conexión con la API de Holded, que es el objeto del módulo.
Bibliotecas principales:
| Biblioteca | Versión | Licencia |
|---|---|---|
| next | 16.4.2 | MIT |
| @prisma/client | 7.8.0 | Apache-2.0 |
| @prisma/adapter-pg | 7.8.0 | Apache-2.0 |
| pg | 8.21.0 | MIT |
| zod | 3.25.76 | MIT |
Dependencias con condiciones de licencia específicas:
- @img/sharp-libvips-* 1.3 (binarios de libvips, dependencia opcional de Next.js): LGPL-3.0-or-later; @img/sharp-win32-* y @img/sharp-wasm32 0.35: Apache-2.0 AND LGPL-3.0-or-later.
Compatibilidades e integraciones: Holded API v2 y webhooks de Holded para facturas, rectificativas y cobros.
Condiciones de redistribución
El código propio admite integración en productos comerciales del licenciatario en las modalidades de módulo integrable, licencia de código y licencia OEM, en los términos del contrato. Tienen condiciones específicas los binarios de libvips que instala Next.js como dependencia opcional (LGPL-3.0-or-later); ver la lista de la Ficha técnica.
Requisitos de instalación
Una aplicación Node.js con PostgreSQL, publicada en HTTPS para recibir los avisos de Holded, y una tarea periódica de repaso. Cada cliente necesita su cuenta de Holded con clave de API.
Preguntas frecuentes
¿Qué permisos necesita la clave de Holded?
Lectura de contactos, series, servicios e impuestos, alta de avisos y escritura de facturas. Al conectar se comprueban los permisos de lectura y de avisos; el de escritura se confirma con la primera emisión.
¿Cumple VERI\*FACTU?
El módulo no numera ni registra facturas por su cuenta: la factura la crea, la numera y la aprueba Holded. El cumplimiento de VERI\*FACTU corresponde al programa que emite la factura. Confírmalo con Holded y con tu asesor.
¿Admite IGIC?
Sí, además de IVA e IPSI, emparejados con los impuestos configurados en la cuenta.
¿El mantenimiento está incluido?
No. Si Holded cambia su API, adaptar el módulo forma parte del mantenimiento, que se contrata aparte, igual que el soporte.
Solicitud
Solicita información sobre M-HOL-01
Rellena el formulario con la referencia del activo y la modalidad que te interesa. Te respondo por escrito. Si necesitas revisar el código, marca la casilla del NDA y lo preparamos antes de enseñar nada.