Árbol de páginas

Versiones comparadas

Clave

  • Se ha añadido esta línea.
  • Se ha eliminado esta línea.
  • El formato se ha cambiado.

Glosario de términos

TérminosSignificado
NUSSNúmero de seguridad social
IdentificadorEs el identificador de AFILIACIONES.

Definiciones en el esquema que contiene la lógica de los servicios

...

PlantillaManejadorParámetroBodyTipo autenticaciónComentario
rest/v1.0/private/ce/nuss/consulta/GETIdentificador
Bearer token

Consulta del NUSS asociado a un identificador de afiliaciones.  Requiere autenticación por token previo.  Para la obtención del token se requiere realizar la petición a la url https://daas<ENTORNO>.um.es/ords/zeus/rrhh/open-api-catalog/ss/ pasando un cliente y una contraseña previamente consensuada con el grupo de RRHH. La petición requiere el parámetro identificador de AFILIACIONES. El mensaje de respuesta será un JSON definido de esta forma:    

{    "items": 
        [
            {"nuss": string}
        ],         
    "hasMore": boolean,         
    "limit": integer,         
    "offset": integer,         
    "count": integer     
}

Si encuentra el NUSS asociado al identificador, el objeto items contendrá el elemento nuss con el valor que corresponda. El elemento count valdrá 1. Si no encuentra el NUSS, el objeto items aparecerá vacío y el elemento count aparecerá con valor 0.             

rest/v1.0/private/ce/nuss/gestion/GETIdentificador
Bearer token

Consulta del NUSS asociado a un identificador de afiliaciones.  Requiere autenticación por token previo.  Para la obtención del token se requiere realizar la petición a la url https://daas<ENTORNO>.um.es/ords/zeus/rrhh/open-api-catalog/ss/ pasando un cliente y una contraseña previamente consensuada con el grupo de RRHH. La petición requiere el parámetro identificador de AFILIACIONES. El mensaje de respuesta será un JSON definido de esta forma:    

{    "items": 
        [
            {"nuss": string}
        ],         
    "hasMore": boolean,         
    "limit": integer,         
    "offset": integer,         
    "count": integer     
}

Si encuentra el NUSS asociado al identificador, el objeto items contendrá el elemento nuss con el valor que corresponda. El elemento count valdrá 1. Si no encuentra el NUSS, el objeto items aparecerá vacío y el elemento count aparecerá con valor 0.             

rest/v1.0/private/ce/nuss/gestion/POST

Un JSON:

{
    "identificador": string,
    "nuss": string
}

Bearer token

Crea un registro en SSOCIAL.CE_DATOS_PERSONALES. La petición intenta una inserción de un registro nuevo con los valores pasados (identificador y NUSS).

Requiere autenticación. Url para obtención de token: https://daas<ENTORNO>.um.es/ords/zeus/rrhh/oauth/token?grant_type=client_credentials, donde ENTORNO puede ser: desa, test o nada (para producción). Para la obtención del token se requiere un secreto que debe consensuarse con el grupo de RRHH, responsable del servicio.

La petición manda en el cuerpo un JSON con el siguiente formato:

{
    "identificador": string,
    "nuss": string
}

Si la petición es correcta, devolverá lo siguiente:

{
    "result": "OK",
    "msg": "Registro insertado con éxito";
}

Si no es correcta, el campo result de la respuesta devolverá "Error", con una descripción en el campo msg

rest/v1.0/private/ce/nuss/gestion/PUT

Un JSON:

{
    "identificador": string,
    "nuss": string
}

Bearer token

Modificar un registro en SSOCIAL.CE_DATOS_PERSONALES. Dado un identificador y un NUSS, actualiza el valor del NUSS para ese identificador.

Requiere autenticación. Url para obtención de token: https://daas<ENTORNO>.um.es/ords/zeus/rrhh/oauth/token?grant_type=client_credentials, donde ENTORNO puede ser: desa, test o nada (para producción). Para la obtención del token se requiere un secreto que debe consensuarse con el grupo de RRHH, responsable del servicio.

La petición manda en el cuerpo un JSON con el siguiente formato:

{
    "identificador": string,
    "nuss": string
}

Si la petición es correcta, devolverá lo siguiente:

{
    "result": "OK",
    "msg": "Registro actualizado con éxito"
}

Si no es correcta, el campo result de la respuesta devolverá "Error", con una descripción en el campo msg

rest/v1.0/private/ce/nuss/gestion/DELETE

Un JSON:

{
    "identificador": string,
    "nuss": string
}

Bearer token

Elimina un registro en SSOCIAL.CE_DATOS_PERSONALES. Es necesario indicar el identificador y el NUSS del registro a eliminar.

Requiere autenticación. Url para obtención de token: https://daas<ENTORNO>.um.es/ords/zeus/rrhh/oauth/token?grant_type=client_credentials, donde ENTORNO puede ser: desa, test o nada (para producción). Para la obtención del token se requiere un secreto que debe consensuarse con el grupo de RRHH, responsable del servicio.

La petición manda en el cuerpo un JSON con el siguiente formato:

{
    "identificador": string,
    "nuss": string
}

Si la petición es correcta, devolverá lo siguiente:

{
    "result": "OK",
    "msg": "Registro borrado con éxito"
}

Si no es correcta, el campo result de la respuesta devolverá "Error", con una descripción en el campo msg


Autenticación de los clientes que hacen peticiones a los servicios

Cada cliente que requiera utilizar alguno de estos servicios deberá solicitarlo al grupo de RRHH poniendo un Jira a DJ-AT-RRHH, tal como este:


Alta tarea JIRA
Tipo de tarea:"Petición de Servicio"Aplicación:DJ-AT-RRHH
Resumen:Solicitud acceso y credenciales a servicios web ORDS. Esquema: RS_RRH, Módulo: SS (ce/nuss)
Mensaje:

En el texto de la petición deberá justificar la necesidad del acceso y se especificará a qué plantilla se desea el acceso:

  • Consulta (ce/nuss/consulta/)
  • Gestión (ce/nuss/gestion/)


Una vez se resuelva el Jira y se autorice el acceso, el grupo de RRHH le facilitará un secreto (client_id y secret_id) que usted necesita conservar y que utilizará para poder obtener un token previo a cada petición que realice a los servicios. El token puede obtenerlo a través de estas urls. La duración del token será de una hora y deberá utilizarlo en cada una de las peticiones que realice pasándolo como tipo de autenticación Bearer token.

Acceso a la definición de la API con herramienta swagger

...

Puede utilizar cualquier herramienta, como Postman o Insomnio para probar las peticiones a los servicios. El siguiente archivo json contiene la definición de las peticiones para Insomnio.

View filenamehttps://svn.atica.um.es/svn/PERSONAL/umdp/fuentes/BD/ords/rs_rrhh/Pruebas_llamadas_Insomnia_2024-05-16.jsonheight250