Webinar 21 de enero · Las diez decisiones de un plan de incentivos
Inicio › Documentación › API REST
Documentación

API REST

Autenticación

OAuth 2.0 con credenciales de cliente. Solicita un token en /oauth/token con client_id y client_secret; caduca en 60 minutos. Límite: 600 peticiones por minuto por cuenta.

Fuentes

POST /v1/fuentes/{nombre}/cargas con el fichero o el JSON. La respuesta incluye las validaciones de layout y el identificador de carga.

Resultados

GET /v1/periodos/{periodo}/resultados devuelve el resultado por persona e indicador, con la regla y la fecha de cálculo. Paginado de 500 en 500.

Aclaraciones

POST /v1/aclaraciones para abrir una en nombre de una persona; GET para consultar estado. Las categorías son las que configuras en la aplicación.

Webhooks

Suscríbete a periodo.calculado, periodo.aprobado, periodo.liberado y aclaracion.resuelta. Cada evento lleva firma HMAC.

Errores

Códigos HTTP estándar y cuerpo JSON con code, message y, en validaciones, la lista de filas y columnas afectadas.

¿Falta algo? Escribe a docs@incentivia.neitek.com o abre un ticket en Soporte.

PreciosPrueba gratis