Ya sea que sea un cliente de Spendesk o un socio que desea comenzar a usar la API de Spendesk para construir una integración, este artículo es para usted:
Para clientes, para conectar Spendesk a su pila de herramientas financieras y empresariales.
Para socios, para crecer y expandir su oferta con Spendesk.
Descubrir nuestro portal de desarrolladores API
Primero puede consultar nuestro portal de desarrolladores dedicado a la API de Spendesk donde puede encontrar toda la información relevante:
Documentación
Changelog
Colección Postman
Administración de webhooks
Si está buscando específicamente construir una integración contable para recuperar datos de gastos de Spendesk, aquí están las siguientes funcionalidades que necesitaría:
Retrieve payables
Retrieve payable attachments
Retrieve settlements
Retrieve bank fees
Retrieve wallet loads
Retrieve wallet summary
Retrieve members
Retrieve suppliers
Retrieve analytical fields and values
Retrieve cost centers
Retrieve expense categories
Crear credenciales API
Una vez que haya consultado nuestro portal de desarrolladores, necesita contactar al equipo de ventas de Spendesk directamente o a través de nuestro soporte al cliente. Ellos le autorizarán para obtener acceso a la API. Luego, podrá gestionar sus credenciales API en Configuración > Integraciones > Gestión de acceso API.
Las credenciales API permiten a los desarrolladores conectarse a su entidad de Spendesk, recuperar y editar información según los permisos que otorgue.
Requisitos previos:
Debe estar bajo el plan de precios 'Premium' o 'Enterprise'.
Debe ser el Propietario de la cuenta en Spendesk para crear credenciales API.
Implementar acceso API
Para crear un nuevo client ID y client secret de API, asegúrese de cumplir con los requisitos previos y luego siga estos pasos:
Haga clic en Crear nueva clave.
Introduzca un nombre y una descripción para este acceso API. Es importante mencionar el propósito de estas credenciales para que cualquiera pueda identificarlas fácilmente más adelante.
Elija una fecha de vencimiento. La fecha de vencimiento no puede ser posterior a un año desde hoy. Pero si está compartiendo estas credenciales con un equipo de desarrollo externo, hágala tan corta como sea prácticamente posible. Si no está seguro, siempre comience con períodos de validez más cortos (por ejemplo, un mes) - siempre puede crear nuevas credenciales API más adelante, con el mismo período de validez o más largo. Sin embargo, no es posible extender la validez de las credenciales API existentes - se deben crear nuevas.
Seleccione los permisos que desea otorgar a este conjunto de credenciales.
Marque la casilla para reconocer que las nuevas credenciales API proporcionarán acceso a las funcionalidades y datos seleccionados anteriormente. Es importante señalar que los permisos deben alinearse estrictamente con las necesidades de uso para minimizar el riesgo y garantizar operaciones API seguras.
Una vez que haga clic en Crear clave API, verá una ventana modal con un client ID y un client secret. Este es el único momento en que verá el client secret en texto claro - no es posible recuperarlo de nuevo.
Notas importantes:
Si pierde el client secret, necesitará generar un nuevo conjunto de credenciales.
Almacene las credenciales API en una bóveda de contraseñas segura y nunca las comparta por mensajería/correo electrónico. Además, se recomienda realizar revisiones periódicas de las credenciales almacenadas y revocar aquellas que ya no estén en uso.