Conecta Spendesk con otras herramientas de tu empresa o crea una integración de partner utilizando la API de Spendesk. Este artículo explica los recursos para desarrolladores, la configuración de credenciales y los requisitos previos.
Para: Propietarios de cuenta de clientes con el plan Premium y partners tecnológicos que crean integraciones con Spendesk.
Antes de empezar
Requisito | Detalle |
Rol | Solo el Propietario de cuenta puede crear credenciales de API |
Plan | Disponible únicamente con el plan Premium |
Configuración | Spendesk debe autorizarte para acceder a la API antes de que puedas crear credenciales |
👥 Solo los Propietarios de cuenta pueden crear y gestionar credenciales de API en Spendesk.
Descubre el portal de desarrolladores de la API
Empieza explorando el portal de desarrolladores específico de la API de Spendesk. Allí encontrarás:
Documentación
Registro de cambios
Colección de Postman
Gestión de webhooks
Si estás creando una integración contable para recuperar datos de gasto de Spendesk, necesitarás acceso a estas funciones:
Consultar cuentas por pagar
Consultar archivos adjuntos de cuentas por pagar
Consultar liquidaciones
Consultar comisiones bancarias
Consultar cargas de monedero
Consultar el resumen del monedero
Consultar miembros
Consultar proveedores
Consultar campos analíticos y valores
Consultar centros de costes
Consultar categorías de gasto
Crea credenciales de API
Ponte en contacto con el equipo comercial de Spendesk, directamente o a través del soporte de Spendesk, para solicitar acceso a la API. Una vez autorizado, gestiona las credenciales de API en Configuración > Integraciones > Gestión de acceso a la API.
Las credenciales de API permiten a los desarrolladores conectarse a tu entidad de Spendesk y consultar o editar información, según los permisos que concedas.
🔒 El acceso a la API solo está disponible con el plan Premium.
Implementa el acceso a la API
Sigue estos pasos para crear un nuevo Client ID y un nuevo Client Secret de API:
Ve a Configuración > Integraciones > Gestión de acceso a la API.
Haz clic en Crear una nueva clave.
Introduce un nombre para este acceso a la API.
Introduce una descripción para este acceso a la API e indica su finalidad para poder identificarlo fácilmente más adelante.
Selecciona una fecha de vencimiento, hasta un año desde hoy.
Selecciona los permisos (scopes) que quieres conceder a este conjunto de credenciales.
Marca la casilla para confirmar que estas credenciales accederán a las funciones y los datos seleccionados.
Haz clic en Crear clave API.
Una vez que hagas clic en Crear clave API, se mostrará una ventana con tu Client ID y tu Client Secret.
⚠️ Solo podrás ver el Client Secret en texto sin cifrar una vez. No podrás recuperarlo de nuevo. Si lo pierdes, deberás generar un nuevo conjunto de credenciales.
💡 Al compartir credenciales con un equipo de desarrollo externo, elige el periodo de vencimiento práctico más corto posible, por ejemplo, un mes. Siempre podrás crear nuevas credenciales más adelante con el mismo periodo de validez o con uno más largo. Las credenciales existentes no se pueden ampliar. Debes crear otras nuevas.
Resolución de problemas
Síntoma: No puedes ver la opción Gestión de acceso a la API en Configuración > Integraciones.
Causa: Tu empresa no tiene el plan Premium o todavía no se te ha autorizado el acceso a la API.
Solución: Ponte en contacto con el soporte de Spendesk o con tu Account Manager para solicitar acceso a la API. Confirma el plan de tu empresa en Configuración > Facturación.
Síntoma: Has perdido tu Client Secret.
Causa: El Client Secret solo se muestra una vez, durante su creación, y no se puede recuperar posteriormente.
Solución: Genera un nuevo conjunto de credenciales de API repitiendo los pasos de la sección «Implementa el acceso a la API». Revoca las credenciales antiguas que ya no utilices.
Síntoma: No puedes crear una nueva clave API.
Causa: No eres el Propietario de cuenta de tu entidad de Spendesk.
Solución: Pide al Propietario de cuenta actual que cree las credenciales o que te transfiera el rol de Propietario de cuenta.
📋 Guarda las credenciales de API en una bóveda segura de contraseñas y nunca las compartas por mensajes o correo electrónico. Revisa periódicamente las credenciales almacenadas y revoca las que ya no estén en uso.