9. API

9.1 Integración nóminas

76 views abril 8, 2022 abril 4, 2024 marta 0

Definición

Desde aTurnos contamos con un API que contiene todos los servicios necesarios para poder obtener y actualizar toda la información de aTurnos según las necesidades del cliente.

Esta funcionalidad solo está disponible para aquellos usuarios que tienen el perfil de  Superusuario, si precisas un usuario de este tipo, contacta con soporte@aturnos.com

Estadística vs método getpayroll

Aplica para los apartados 6.1. “Estadística por periodo” y 6.5 Estadística por periodo de todos los equipos” en cuanto a lo indicado a la forma de calcular los conceptos, que se realiza entre las fechas de inicio y fin.

Los datos necesarios son:

  • url: https://www.aturnos.com/api/getPayroll
  • id_user:XXXXXX: Siendo el id user el informado en ADMINISTRAR>AJUSTES>Pestaña módulos
  • id_aturno:XXXXXX: Siendo el id aturno cualquiera en los que esté creado el usuario con el perfil de Supersusario informado en ADMINISTRAR>AJUSTES>Pestaña módulos
  • token:XXXXXXXXXXXXXXXXXXXX: Siendo el token ADMINISTRAR>AJUSTES>Pestaña módulos
  • ids_users:XXXXXXXXXX, el id de un empleado en concreto. en blanco todos los trabajadores
  • start_date: AAAA-MM-DD. Fecha de inicio de exportación de variables al software de nómina
  • end_date: AAAA-MM-DD. Fecha de fin de exportación de variables al software de nómina
  • mode_download: Indica el estado en el que se debe encontrar el cuadrante y la fecha del último día exportado, las valores disponibles son:
    • valor 0: FConsulta sin recuperación de caches, es decir, no precisa que el cuadrante esté cerrado. No tiene en cuenta las fechas de cierre ni descarga. No actualiza los datos de último día de exportación.
    • valor 1: Consulta sin recuperación de cache. Tiene en cuentas las fechas de cierre y de descarga. No se suele utilizar
    • valor 2: Consulta con recuperación de cache y tiene en cuenta las fechas de cierre y descarga. Actualiza la fecha del último día exportado en el perfil del trabajador. Es el que se debe utilizar en “real”.
    • valor 4: Consulta con recuperación de cache y tiene en cuenta las fechas de cierre y descarga. No actualiza la fecha de exportación. En el caso de que antes de realizar la descarga en productivo se realicen comprobaciones en el software de nómina es el que se debe utilizar.

A través de ADMINISTRAR>AJUSTES>MODULOS, se visualizan los tres primeros campos indicados

Adjuntamos un pantalla del postman del método indicado

Estadística diaria vs método getPayrollAllDaily

Aplica para los apartados 7.1. “Estadística diaria” y 6.6 “Estadística diaria de todos los equipos” en cuanto a lo indicado a la forma de calcular los conceptos, que se realiza día a día, es la recomendada.

Los datos necesarios son:

  • url: https://www.aturnos.com/api/getPayrollAllDaily
  • id_user:XXXXXX: Siendo el id user el informado en ADMINISTRAR>AJUSTES>Pestaña módulos
  • id_aturno:XXXXXX: Siendo el id aturno cualquiera en los que esté creado el usuario con el perfil de Supersusario informado en ADMINISTRAR>AJUSTES>Pestaña módulos
  • token:XXXXXXXXXXXXXXXXXXXX: Siendo el token ADMINISTRAR>AJUSTES>Pestaña módulos
  • ids_users:XXXXXXXXXX, el id de un empleado en concreto. en blanco todos los trabajadores
  • start_date: AAAA-MM-DD. Fecha de inicio de exportación de variables al software de nómina
  • end_date: AAAA-MM-DD. Fecha de fin de exportación de variables al software de nómina
  • mode_download: Indica el estado en el que se debe encontrar el cuadrante y la fecha del último día exportado, las valores disponibles son:
    • valor 0: Consulta sin recuperación de caches, es decir, no precisa que el cuadrante esté cerrado. No tiene en cuenta las fechas de cierre ni descarga. No actualiza los datos de último día de importación.
    • valor 1: Consulta sin recuperación de cache. Tiene en cuentas las fechas de cierre y de descarga. No se suele utilizar
    • valor 2: Consulta con recuperación de cache y tiene en cuenta las fechas de cierre y descarga. Actualiza la fecha del último día exportado en el perfil del trabajador.
    • valor 3: Consulta con recuperación de cache y no tiene en cuenta las fechas de cierre y descarga. No actualiza los datos de último día de importación. Los datos están disponible si el cuadrante está cerrado.
    • valor 4: Consulta con recuperación de cache y tiene en cuenta las fechas de cierre y descarga. No actualiza la fecha de exportación. En el caso de que antes de realizar la descarga en productivo se realicen comprobaciones en el software de nómina es el que se debe utilizar.

A través de ADMINISTRAR>AJUSTES>MODULOS, se visualizan los tres primeros campos indicados

Adjuntamos un pantalla del postman del método indicado

Was this helpful?