Integración Holded: conecta tu ERP con todo lo demás

Qué puedes integrar con Holded

Holded cubre facturación, contabilidad, inventario, CRM, proyectos y equipo. Su API da acceso a casi todo eso, así que la pregunta útil no es si se puede conectar, sino qué flujo te está costando horas o errores hoy.

Estos son los casos que más vemos en pymes que ya trabajan con Holded:

• Tienda online: cada pedido entra como pedido de venta o factura, con su cliente y sus impuestos, y el stock vuelve a la tienda cuando cambia en el almacén.
• CRM externo: cuando el comercial cierra una venta en HubSpot, Pipedrive o tu CRM propio, el cliente aparece en Holded con sus datos fiscales y el presupuesto se convierte en pedido.
• Portal de clientes: tus clientes consultan pedidos, albaranes y facturas en PDF sin llamarte. Lo contamos en portales de clientes.
• App de campo: el técnico cierra un parte en el móvil y en Holded se genera el albarán o la factura, con horas y materiales. Ver apps para técnicos de campo.
• Almacén y compras: albaranes de entrada, pedidos a proveedor y movimientos de stock entre varios almacenes.
• Cuadro de mando: facturación, márgenes, cobros pendientes y tesorería en un panel de gestión que se actualiza solo.

Cómo funciona la API de Holded

Según la documentación para desarrolladores de Holded, la API es REST sobre JSON, con URL base api.holded.com y la versión actual en /api/v2/. Cada petición lleva una clave de API en la cabecera Authorization: Bearer. La clave se genera en Ajustes → API dentro de tu cuenta.

Cada clave tiene permisos por ámbito (por ejemplo, sales:invoices.read). Si la clave no tiene el permiso que pide un endpoint, la API responde 403. Esto permite dar a cada integración solo lo que necesita: una tienda no tiene por qué poder leer nóminas.

Los listados se paginan por cursor: cada respuesta trae los resultados, un cursor y un indicador has_more. Por defecto devuelve 25 elementos por página y como máximo 100.

La referencia de la API cubre, entre otros, facturas, presupuestos, proformas, pedidos de venta, albaranes, compras, pedidos de compra, contactos, productos, almacenes, stock, pagos, cuentas bancarias, contabilidad, proyectos, empleados y control horario, y el CRM de Holded (embudos y oportunidades).

Holded mantiene la API v1 como versión anterior: está obsoleta, pero sigue disponible para integraciones existentes. Si ya tienes algo montado sobre v1, conviene planificar el paso a v2 antes de añadir funciones nuevas.

Webhooks y límites de uso: lo que condiciona el diseño

Holded tiene webhooks: avisos HTTP POST a una URL HTTPS pública cuando ocurre algo en tu cuenta. Se configuran en Ajustes → Webhooks. Hay eventos de creación, cambio y borrado de facturas, pedidos, albaranes, compras, pagos, contactos, productos y almacenes, además de stock.update. Cada aviso va firmado con HMAC-SHA256 y lleva un identificador único que sirve para no procesar el mismo evento dos veces. Si tu sistema no responde con un 2xx, Holded reintenta con espera creciente.

Los límites de uso son el punto que más se pasa por alto. La API aplica a la vez un límite por minuto y una cuota mensual de llamadas que depende del plan, y las comparten todas las claves de la cuenta. Estas son las cifras que publica Holded en su página de límites (consultada el 5 de noviembre de 2026; pueden cambiar):

Con 500 o 2.000 llamadas al mes no puedes preguntar a Holded cada cinco minutos si ha cambiado algo. La integración tiene que apoyarse en webhooks, guardar en caché lo que cambia poco (productos, impuestos, contactos) y vigilar la cuota que queda. Si el volumen no cabe en tu plan, es mejor saberlo antes de empezar.

Conectar Holded con ChatGPT o Claude

Holded publica un servidor MCP oficial para que asistentes de IA como Claude o ChatGPT trabajen con tu cuenta: consultar facturas, buscar contactos, ver stock o crear un pago desde la conversación. Se conecta por OAuth 2.1 y te deja elegir el rol: solo lectura, lectura y escritura, o permisos uno a uno. El asistente nunca puede hacer más que tu propio usuario. Los detalles están en la guía del servidor MCP de Holded.

Para consultas del día a día de una persona, eso suele bastar y no hace falta desarrollar nada. Cuando quieres que la IA trabaje dentro de un proceso (leer pedidos que llegan por correo y crearlos en Holded, o revisar albaranes de proveedor antes de contabilizarlos), hace falta algo más: reglas de negocio, validación humana en los casos dudosos, permisos mínimos y un registro de cada acción. Eso es lo que hacemos en agentes de IA para empresas.

Conector de Holded, Zapier/Make/n8n o integración a medida

Holded ofrece integraciones ya hechas con Shopify, WooCommerce, PrestaShop, Stripe, PayPal y Zapier, entre otras, que se activan desde la app. Su propia guía recomienda empezar por ahí. Nosotros también: si un conector estándar resuelve tu caso, te lo diremos y no tiene sentido pagar un desarrollo.

Riesgos de integrar Holded y cómo se evitan

Casi todos los problemas de una integración aparecen semanas después de ponerla en marcha, cuando nadie mira. Estos son los habituales con Holded:

• Duplicados: un webhook que llega dos veces o un reintento crean dos facturas. Se evita guardando el identificador del evento y una clave externa (el número de pedido de la tienda) antes de escribir.
• Sincronización en dos sentidos: si el precio se puede cambiar en la tienda y en Holded, alguien acaba pisando al otro. Se decide por escrito qué sistema manda en cada dato.
• Maestros de artículos y clientes: SKU distintos, clientes repetidos con y sin NIF, impuestos mal asignados. Se limpian y se emparejan antes de sincronizar, no después.
• Documentos en borrador o aprobados: la API permite crear y aprobar documentos por separado. Hay que acordar cuándo una factura se aprueba sola y cuándo la revisa una persona.
• Errores silenciosos y cuota agotada: si Holded devuelve 429, hay que esperar lo que indica la cabecera Retry-After. Cada envío queda en un registro, los reintentos son automáticos y, si algo no se resuelve, llega una alerta con el dato y el motivo.

Cómo lo hacemos en SocketStack

Empezamos por un descubrimiento corto: qué flujos quieres conectar, qué plan de Holded tienes y cuánta cuota de API consume tu volumen real, qué sistema manda en cada dato y qué conectores ya existen. Si un conector estándar resuelve el caso, te lo decimos ahí.

Si hay proyecto, tienes un único precio cerrado por proyecto. Los cambios de alcance se presupuestan aparte y solo con tu aprobación. Ves una demo funcional cada dos semanas con datos de prueba de tu cuenta, según un calendario por escrito. El código es tuyo: el repositorio está a nombre de tu empresa desde el primer día. Después hay soporte con condiciones por escrito, y si prefieres que lo mantenga otro equipo, te lo entregamos todo documentado.

SocketStack no es partner de Holded. Trabajamos con la API pública que Holded documenta. Si quieres hacerte una idea del coste, lee cuánto cuesta un software a medida. Para ver el servicio completo, entra en integraciones con ERP y CRM. Si tu otro sistema es A3ERP o Sage 200, también tienes su página.