Cómo exportar los datos de Holded por API: casos de uso para reporting

Integraciones·◷ 8 min de lectura·Publicado 11 Jun 2026·Actualizado 4 Nov 2026·Por David González

Holded guarda toda la operativa de un negocio — facturas, contactos, productos, asientos contables —, pero ese valor se multiplica cuando sacas esos datos y los conviertes en análisis: ingresos por cliente, márgenes, tesorería, KPIs. La vía oficial para extraerlos de forma programática es la API de Holded.

En esta guía vemos qué se puede exportar, qué necesitas antes de empezar, cómo hacer las llamadas paso a paso (con ejemplos), los casos de uso de reporting más habituales y cuándo conviene hacerlo a mano o con una herramienta que ya lo automatiza.

En pocas palabras: No necesitas programar para entender el objetivo: llevar los datos de Holded al informe que utilizas para decidir. La guía conserva las opciones y los pasos de referencia para que puedas valorar el alcance y pedir a tu proveedor una exportación completa, periódica y comprobable.

Qué datos puedes exportar de Holded

La API de Holded da acceso a prácticamente toda la plataforma. En su versión actual (v2) cubre cientos de endpoints repartidos en varias áreas. Para reporting financiero, estos son los recursos que más se exportan:

Lo que necesitas antes de empezar

Tres cosas, todas rápidas de resolver:

Cómo exportar datos paso a paso

El patrón es siempre el mismo: autenticas con tu API key en la cabecera Authorization: Bearer, llamas a un endpoint con GET y recibes JSON. Por ejemplo, para listar las facturas de venta:

# Las facturas de venta en formato JSON
curl -X GET "https://api.holded.com/api/v2/invoices?limit=100" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Accept: application/json"

Dos detalles de la v2 que conviene tener presentes: la respuesta no es una lista pelada sino un sobre con items, cursor y has_more, y el límite por página es de 100 registros. Si en lugar de descargar cada cierto tiempo prefieres que Holded te avise cuando algo cambia, la alternativa son los webhooks de la API de Holded.

Cambiando el recurso final extraes otros datos: /contacts para clientes y proveedores, /products para el catálogo, o los endpoints de contabilidad para los asientos. Para descargar todo el histórico, la v2 pagina por cursor: cada respuesta trae un cursor y un has_more, y vas encadenando llamadas hasta que has_more sea falso.

# Página siguiente: se pasa el cursor que devolvió la llamada anterior
curl -X GET "https://api.holded.com/api/v2/invoices?limit=100&cursor=EL_CURSOR" \
  -H "Authorization: Bearer TU_API_KEY"

El flujo completo, de la fuente al informe, es este:

Holded

Guarda facturas, contactos, productos y contabilidad.

La fuente

API REST

GET con tu API key → respuesta en JSON, paginada.

La extracción

Reporting

Transformas el JSON en KPIs, estados y dashboards.

El valor

El dato vive en Holded; la API es la tubería; el valor está en lo que construyes con él.

4 casos de uso de reporting

Una vez tienes los datos fuera, esto es lo que la mayoría construye con ellos:

A mano o automatizado

Exportar por API a mano es perfectamente viable, pero tiene un coste de mantenimiento que conviene tener claro antes de elegir camino:

A mano

Tu propio script

Control total, pero tú mantienes la autenticación, la paginación, los cambios de versión y la transformación a informe. Tiempo de desarrollo y de mantenimiento.

Automatizado

Con Numio

Conectas la API key una vez y Numio extrae, mantiene y transforma los datos en estados financieros y KPIs — sin programar y sin preocuparte por las versiones de la API.

Cómo lo resuelve Numio, sin programar

Numio es, en esencia, esa capa de extracción y reporting ya construida sobre la API de Holded. Pegas la API key del cliente y, sin escribir una línea de código:

Preguntas frecuentes

Conclusión

Exportar los datos de Holded por API es el primer paso para convertir tu contabilidad en análisis útil: ingresos por cliente, estados financieros, tesorería y KPIs. El patrón es sencillo —autenticar, llamar, paginar, transformar—, pero el mantenimiento (versiones, límites, cálculos) es lo que de verdad cuesta a largo plazo.

Por eso muchas asesorías y pymes prefieren que esa capa ya esté hecha. Hacerlo a mano te da control; automatizarlo te devuelve el tiempo. Si además quieres consultarlos conversando, mira cómo conectar Claude a Holded.