Saltar al contenido
APFerrer
M-HOL-01 · MóduloFinanzas y facturación

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.

Código fuenteIntegrableOEM

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.

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.

FAQ

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.

Responsable: APFerrer. Finalidad: responder a tu solicitud. Puedes ejercer tus derechos según la política de privacidad.

Precio a consultar según modalidad y alcance. El mantenimiento y el soporte se contratan aparte.