Qué es la API de Holded
La API de Holded (Interfaz de Programación de Aplicaciones) te permite conectar tu cuenta con otras aplicaciones para intercambiar información automáticamente.
Es el sistema que hace posible que diferentes programas trabajen juntos e intercambien datos de forma estructurada.
Por ejemplo, puedes:
Crear contactos desde otro CRM.
Generar facturas desde un e-commerce.
Sincronizar productos o stock.
La API funciona mediante peticiones que permiten:
Obtener información (GET).
Crear datos (POST).
Actualizar datos (PUT).
Eliminar datos (DELETE).
Estas acciones se realizan sobre un endpoint específico (URL que determina la operación). Por ejemplo:
https://api.holded.com/api/invoicing/v1/documents/invoice
Aunque Holded cuenta con integraciones nativas con distintas aplicaciones, si necesitas una automatización a medida, puedes utilizar la API para conectar Holded con cualquier otro software que utilice tu empresa.
Quién puede usar la API
La API está disponible en todos los planes de pago. No está disponible en el plan Free. Para generar una API Key debes:
Ser Owner o Administrador de la cuenta.
Tener un plan activo distinto a Free.
☝🏼 Los usuarios con roles personalizados no pueden generar ni visualizar API Keys.
Cómo generar una API Key
Una API Key es la clave que identifica tu cuenta de Holded en cada petición.
Debe incluirse en todas las llamadas a la API para indicar a qué cuenta pertenece la operación.
Para generarla, sigue estos pasos:
Ve a tu cuenta (arriba a la izquierda) y haz clic en Configuración.
En el apartado Más, haz clic en Desarrolladores.
Pulsa + Nueva API Key.
Introduce un nombre en el campo Descripción.
☝🏼 Te recomendamos que el nombre haga referencia a la aplicación que quieres integrar con Holded (por ejemplo, "Shopify").
Haz clic en Guardar.
Se generará un código alfanumérico que podrás copiar.
⚠️ La API Key es un dato privado. No debes compartirla ni hacerla pública.
¿Se pueden crear varias API Keys?
Sí. Pero debes tener en cuenta que:
Solo la primera API Key creada permite sincronización bidireccional (leer y escribir datos).
Las siguientes API Keys solo permiten obtener información (lectura).
Cómo consultar la documentación de la API
Una vez generada la API Key, puedes consultar la documentación técnica para conocer los endpoints y acciones disponibles.
Para acceder:
Ve a Menú > Configuración.
En el apartado Más, haz clic en Desarrolladores.
Haz clic en </> Documentación de la API.
Desde ahí podrás consultar:
Endpoints disponibles en los distintos módulos de Holded:
Facturación: Contactos, Grupos de contactos, Productos, Almacenes, Impuestos, Tesorería, Líneas de numeración, Cuentas de gasto, Canales de venta, Pagos, Documentos, Remesas y Servicios.
CRM: Embudos, Eventos y Leads.
Proyectos: Proyectos, Tareas y Registros horarios.
Equipo: Empleados y Control horario.
Contabilidad: Libro diario y Cuadro de cuentas.
Parámetros obligatorios.
Ejemplos de llamadas.
Respuestas y códigos de error.
Cómo probar la API antes de integrarla
Antes de realizar una integración definitiva, es recomendable probar la API para verificar que las acciones que necesitas funcionan correctamente.
Puedes hacerlo desde:
La documentación interactiva de la API.
Herramientas externas como Postman.
1. Probar desde la documentación
Accede al endpoint que quieras utilizar.
Introduce tu API Key en el Header.
Completa los parámetros obligatorios.
Haz clic en Try It.
Si la respuesta devuelve:
status: 1→ la operación se ha realizado correctamente.status: 0o error 400 → existe un error en la petición y debes revisar los parámetros enviados.
2. Probar mediante Postman
Postman es una herramienta de testeo que permite enviar peticiones a la API y comprobar su funcionamiento antes de integrarla en un desarrollo definitivo.
Para probarla:
Descarga e instala la aplicación Postman.
Selecciona el método correspondiente (GET, POST, PUT o DELETE).
Introduce el endpoint que quieras utilizar.
En el apartado Headers, añade:
key→ tu API KeyContent-Type→application/json
Añade en el Body los parámetros obligatorios.
Envía la petición y revisa la respuesta.
Si todo funciona correctamente, podrás realizar la integración definitiva en tu sistema.
Preguntas frecuentes sobre la API de Holded
¿La API tiene límite de llamadas?
Según condiciones comerciales, puede existir un límite según el plan contratado.
Actualmente no existe un límite técnico activo ni un contador visible desde la cuenta.
¿La API tiene los mismos permisos que mi rol?
No. La API Key no hereda permisos por rol ni permite configurar accesos personalizados.
Cualquier persona que tenga acceso a la API Key podrá acceder, mediante la API, a todos los endpoints disponibles para esa cuenta según la documentación.
Por este motivo, es importante no compartir la API Key y limitar su acceso únicamente a personas o sistemas de confianza..
¿En qué formato se envían los datos?
La API utiliza formato JSON.
Las fechas deben enviarse en formato Unix (timestamp).
¿Qué soporte ofrece Holded para desarrollos con API?
Las integraciones mediante API deben ser realizadas por un desarrollador.
El equipo de soporte puede resolver dudas sobre campos o endpoints, pero no desarrolla integraciones personalizadas.
Si no dispones de un técnico, puedes contactar con un Solution Partner.