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/v2/invoices
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 o trial con un límite mensual según el plan de pago. Para generar una API Key debes:
Tener acceso al apartado de Desarrolladores.
Tener un plan activo distinto a Free.
☝🏼 Puedes dar acceso a usuarios con el rol de desarrollador, o bien con un rol personalizado con acceso al apartado Desarrolladores para que puedan acceder y editar la API.
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 Desarrolladores, haz clic en Credenciales.
Pulsa Agregar API Token.
Podrás seleccionar qué permisos tiene esa API Key.
☝🏼 Si necesitas acceder a la API v1 podrás acceder mediante el banner que Ir a la Api Keys v1.
Haz clic en Crear Token.
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 Token?
Sí, puedes crear tantas API Token como necesites.
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.
Haz clic en Desarrolladores > Credenciales
Haz clic en </> Documentación de la API.
Desde ahí podrás consultar:
Endpoints disponibles en los distintos módulos de Holded: Ventas, inventario, Contabilidad, Tesorería, Contactos, CRM, Proyectos.
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 herramientas externas como Postman.
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 Autthorization, añade:
Auth Type > Bearer Token
Token > Api Token generada en Holded.
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, existe un límite mensual según el plan contratado.
Puedes revisar los límites aquí: https://www.holded.com/es/desarrolladores/limite-de-tasa .
¿La API tiene los mismos permisos que mi rol?
No. La API Key no hereda permisos por rol de usuario. Sí es posible limitar la API a algunas acciones, dado que en la creación del Api Token, podemos escoger si el acceso de la API a esos módulos será de escritura, lectura o todo.
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..
¿Qué roles pueden acceder a la API?
Aquellos roles que tengan acceso al apartado de Desarrolladores, como por ejemplo el rol predeterminado de Desarrollador.
Para los roles personalizados también podrás activar la opción de Desarrolladores, con acceso a API Token o Webhooks.
⚠️ Ten en cuenta que esta opción solo aplica al acceso o edición de API V2. Cualquier usuario con rol de propietario o administrador tendrá acceso a la API V1.
¿Cómo puedo consultar mi uso mensual de la API?
Puedes revisar tu uso mensual de la API en tu misma cuenta de Holded.
Ve a Menú > Configuración.
Haz clic en Desarrolladores > Uso de la API.
Podrás revisar las llamadas realizadas y el límite que tienes en tu cuenta.
¿En qué formato se envían los datos?
La API utiliza formato JSON.
¿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.