Conecta Spendesk con tus otras herramientas empresariales o crea una integración de partner usando la API de Spendesk. Este artículo cubre los recursos para desarrolladores, la configuración de credenciales y los requisitos previos.
Para : Propietarios de cuenta con el plan Premium (clientes) y partners tecnológicos que desarrollan integraciones con Spendesk.
Tabla de contenidos
Antes de empezar
Descubre el portal para desarrolladores de la API
Crea credenciales de la API
Implementa el acceso a la API
Solución de problemas
Antes de empezar
👥 Solo los Propietarios de cuenta pueden crear y gestionar credenciales de la API en Spendesk.
Descubre el portal para desarrolladores de la API
Empieza explorando el portal para desarrolladores dedicado a la API de Spendesk. Allí encontrarás :
Documentación
Registro de cambios (changelog)
Colección de Postman
Gestión de webhooks
Si estás creando una integración contable para obtener datos de gasto desde Spendesk, necesitarás acceso a estas funciones :
Obtener cuentas por pagar (payables)
Obtener adjuntos de cuentas por pagar
Obtener liquidaciones (settlements)
Obtener comisiones bancarias
Obtener cargas de la cuenta (wallet loads)
Obtener el resumen de la cuenta (wallet summary)
Obtener miembros
Obtener proveedores
Obtener campos y valores analíticos
Obtener centros de coste
Obtener categorías de gasto
Crea credenciales de la API
Ponte en contacto con el equipo de ventas de Spendesk, ya sea directamente o a través del servicio de atención al cliente de Spendesk, para solicitar acceso a la API. Una vez autorizado, gestiona tus credenciales de la API en Configuración > Integraciones > Gestionar acceso a la API.
Las credenciales de la API permiten a los desarrolladores conectarse a tu entidad de Spendesk y obtener o editar información, según los permisos que concedas.
🔒 El acceso a la API solo está disponible en el plan Premium.
Implementa el acceso a la API
Sigue estos pasos para crear un nuevo Client ID y Client Secret de la API :
Ve a Configuración > Integraciones > Gestionar acceso a la API
Haz clic en Crear nueva clave
Introduce un nombre para este acceso a la API
Introduce una descripción para este acceso a la API, indicando su finalidad para poder identificarlo fácilmente más adelante
Selecciona una fecha de caducidad (hasta un año a partir de hoy)
Selecciona los permisos (scopes) que se concederán a este conjunto de credenciales
Marca la casilla para confirmar que estas credenciales tendrán acceso a las funciones y los datos seleccionados
Haz clic en Crear clave de API
Una vez que hagas clic en Crear clave de API, se mostrará una ventana con tu Client ID y tu Client Secret.
⚠️ Solo verás el Client Secret en texto claro una vez. No se puede recuperar de nuevo; si lo pierdes, deberás generar un nuevo conjunto de credenciales.
💡 Al compartir credenciales con un equipo de desarrollo externo, elige el período de caducidad más corto posible (por ejemplo, un mes). Siempre puedes crear nuevas credenciales más adelante con la misma validez o una validez más larga. Las credenciales existentes no se pueden prorrogar: debes crear unas nuevas.
Solución de problemas
Síntoma : No ves la opción "Gestionar acceso a la API" en Configuración > Integraciones.
Causa : Tu empresa no tiene el plan Premium o aún no se te ha autorizado el acceso a la API.
Solución : Ponte en contacto con el servicio de atención al cliente de Spendesk o con tu gestor de cuenta 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, en el momento de su creación, y no se puede recuperar después.
Solución : Genera un nuevo conjunto de credenciales de la API repitiendo los pasos de la sección Implementa el acceso a la API. Revoca las credenciales antiguas que ya no uses.
Síntoma : No puedes crear una nueva clave de API.
Causa : No eres el Propietario de cuenta de tu entidad de Spendesk.
Solución : Pide a tu Propietario de cuenta actual que cree las credenciales, o que te transfiera el rol de Propietario de cuenta.
📋 Guarda las credenciales de la API en un gestor de contraseñas seguro y nunca las compartas por mensajería o correo electrónico. Revisa periódicamente las credenciales almacenadas y revoca las que ya no estén en uso.