Descripción General para Autenticación

{urlBase}/html/token/autenticacion.json
urlBase es la url de cada empresa que cambia segun su subdominio

autenticacion.json es un endpoint de autenticación POST utilizado para validar las credenciales del usuario contra la plataforma Talento Cloud y obtener un token bearer JWT.

Tras una autenticación exitosa, el servicio devuelve una carga útil (payload) JSON con un campo tokenBearer (una cadena Bearer) que se utiliza para las solicitudes autorizadas posteriores. El script de prueba de Postman para esta solicitud procesa la respuesta y almacena el JWT puro (sin el prefijo Bearer) en la variable de colección Token_JWT para su reutilización en toda la colección.

Solicitud

Método: POST

URL: {}/html/token/autenticacion.json

Parámetros de Consulta (Query Parameters)

• - Identificador del usuario (ej. número de documento/ID) utilizado para autenticarse. El usuario, normalmente la cédula

• - Contraseña del usuario en texto plano o según lo requiera el backend. StartFragmentLa contraseña del usuarioEndFragment

• tipoDocumento (número/cadena, obligatorio) - Código del tipo de documento asociado con el usuario (ej. `53`). Siempre 53

• token (cadena, obligatorio) - Token de cliente Es un MD5 creado con usuario*clave*tipoDocumento

Estos parámetros se envían como valores de la cadena de consulta (query string) en la URL de la solicitud.

Ejemplo de Respuesta Exitosa (HTTP 200)

Una autenticación exitosa devuelve una respuesta 200 OK similar a:

{
 "coderror": null,
 "message": "Ingreso exitoso",
 "tokenBearer": "Bearer <JWT_TOKEN>",
 "success": true
}

• coderror: null cuando no hay error.

• message: Mensaje de estado legible por humanos (ej. "Ingreso exitoso").

• tokenBearer: Cadena del token Bearer que incluye el prefijo Bearer seguido del JWT.

• success: Booleano que indica si la autenticación tuvo éxito.

Uso de la Variable de Colección Token_JWT

El script de prueba posterior a la respuesta analiza la respuesta JSON y actualiza la variable de colección Token_JWT con la parte del JWT de tokenBearer:

var res = JSON.parse(responseBody);
pm.collectionVariables.set("Token_JWT", res.tokenBearer.replace('Bearer ', ''));

• El script elimina el prefijo "Bearer " y guarda solo el JWT puro.

• Token_JWT puede entonces ser referenciado en otras solicitudes usando {}, típicamente en encabezados de Autorización (ej. Authorization: Bearer {}).

Manejo de errores

Los errores habituales pueden incluir:

• 400 Bad Request: Parámetros requeridos faltantes o con formato inválido.

• 401 Unauthorized: Token JWT inválido, expirado o ausente.

• 403 Forbidden: El usuario autenticado no tiene permisos suficientes.

• 404 Not Found: El recurso solicitado no existe.

• 500 Internal Server Error: Error inesperado en el servidor.

Cuando sea posible, cada endpoint detallará sus códigos de error específicos y estructura de respuesta en su propia descripción.

Para solicitar llave necesaria para poder cambiar la contraseña de un usuario, esta llave se envia por email al usuario dueño de la cuenta

Para cambiar la contraseña de un usuario dado

A diferencia del estándar que solo carga una pregunta por vez para el acordeón cargaremos varias.

Al elegir un colaborador a evaluar se listará las competencias y comportamientos asociados para que el frontend elija si mostrará por competencia o todo en una sola hoja.
Necesitamos un JWT, accedemos al servicio REST tipo GET en la url endpoint
{urlBaseTalento}/html/valoracion360/acordeon/listar-preguntas/{{codEvaluacion360}}/
{{codAsignacion2}}/{{idDuenio}}.json

Lo anterior listará las competencias a evaluar al usuario, donde por cada competencia también se
tendrá las preguntas/comportamientos asociados y por cada comportamiento los niveles de
calificación que aplica, inclusive si ya estaba calificado el nivel elegido tendrá una marca sobre esto.
También nos dirá si el comportamiento ya tiene fortalezas, oportunidades u observaciones
registradas.
En la raíz del json de respuesta también nos dirá si debe usar selección múltiple normal o con estrellas
con la propiedad “descriptorEstrellas”

Para guardar la respuesta a una pregunta dada por el evaluador.
Necesitamos un JWT, accedemos al servicio REST tipo GET en la url endpoint
{urlBaseTalento}/html/valoracion360/acordeon/guardar-cuestionario.json

Cuando el evaluador ya terminó de calificar todas las preguntas debe terminar la evaluación indicando unas observaciones generales.
Necesitamos un JWT, accedemos al servicio REST tipo POST en la url endpoint
{urlBaseTalento}/html/valoracion360/acordeon/terminar-evaluacion/{{codAsignacion2}}.json

Endpoint Description

This endpoint retrieves the total number of questions evaluated for a specific process identified by codProceso360.

Request

• Method: GET

• URL: {{urlBaseTalento}}/html/operativos/cantidadPreguntasEvaluacion/{{codProceso360}}.json

• Headers:

  • Content-Type: application/json

Response

• Status Code: 200 OK

• Content-Type: application/json

• Response Body:

  • totalCalificados: Integer representing the total number of questions that have been evaluated.

  • totalPorCalificar: Integer representing the total number of questions that are yet to be evaluated.

Example Response

{
  "totalCalificados": 0,
  "totalPorCalificar": 0
}

This response indicates that there are currently no questions evaluated and none pending evaluation for the specified process.

Endpoint Description

This endpoint retrieves the total number of questions evaluated for a specific process identified by codProceso360.

Request

• Method: GET

• URL: {{urlBaseTalento}}/html/operativos/cantidadPreguntasEvaluacion/{{codProceso360}}.json

• Headers:

  • Content-Type: application/json

Response

• Status Code: 200 OK

• Content-Type: application/json

• Response Body:

  • totalCalificados: Integer representing the total number of questions that have been evaluated.

  • totalPorCalificar: Integer representing the total number of questions that are yet to be evaluated.

Example Response

{
  "totalCalificados": 0,
  "totalPorCalificar": 0
}

This response indicates that there are currently no questions evaluated and none pending evaluation for the specified process.

Endpoint Description

This endpoint retrieves the total number of questions evaluated for a specific process identified by codProceso360.

Request

• Method: GET

• URL: {{urlBaseTalento}}/html/operativos/cantidadPreguntasEvaluacion/{{codProceso360}}.json

• Headers:

  • Content-Type: application/json

Response

• Status Code: 200 OK

• Content-Type: application/json

• Response Body:

  • totalCalificados: Integer representing the total number of questions that have been evaluated.

  • totalPorCalificar: Integer representing the total number of questions that are yet to be evaluated.

Example Response

{
  "totalCalificados": 0,
  "totalPorCalificar": 0
}

This response indicates that there are currently no questions evaluated and none pending evaluation for the specified process.

Endpoint Description

This endpoint retrieves the total number of questions evaluated for a specific process identified by codProceso360.

Request

• Method: GET

• URL: {{urlBaseTalento}}/html/operativos/cantidadPreguntasEvaluacion/{{codProceso360}}.json

• Headers:

  • Content-Type: application/json

Response

• Status Code: 200 OK

• Content-Type: application/json

• Response Body:

  • totalCalificados: Integer representing the total number of questions that have been evaluated.

  • totalPorCalificar: Integer representing the total number of questions that are yet to be evaluated.

Example Response

{
  "totalCalificados": 0,
  "totalPorCalificar": 0
}

This response indicates that there are currently no questions evaluated and none pending evaluation for the specified process.

Endpoint Description

This endpoint retrieves the total number of questions evaluated for a specific process identified by codProceso360.

Request

• Method: GET

• URL: {{urlBaseTalento}}/html/operativos/cantidadPreguntasEvaluacion/{{codProceso360}}.json

• Headers:

  • Content-Type: application/json

Response

• Status Code: 200 OK

• Content-Type: application/json

• Response Body:

  • totalCalificados: Integer representing the total number of questions that have been evaluated.

  • totalPorCalificar: Integer representing the total number of questions that are yet to be evaluated.

Example Response

{
  "totalCalificados": 0,
  "totalPorCalificar": 0
}

This response indicates that there are currently no questions evaluated and none pending evaluation for the specified process.

Endpoint Description

This endpoint retrieves the total number of questions evaluated for a specific process identified by codProceso360.

Request

• Method: GET

• URL: {{urlBaseTalento}}/html/operativos/cantidadPreguntasEvaluacion/{{codProceso360}}.json

• Headers:

  • Content-Type: application/json

Response

• Status Code: 200 OK

• Content-Type: application/json

• Response Body:

  • totalCalificados: Integer representing the total number of questions that have been evaluated.

  • totalPorCalificar: Integer representing the total number of questions that are yet to be evaluated.

Example Response

{
  "totalCalificados": 0,
  "totalPorCalificar": 0
}

This response indicates that there are currently no questions evaluated and none pending evaluation for the specified process.

Endpoint Description

This endpoint retrieves the total number of questions evaluated for a specific process identified by codProceso360.

Request

• Method: GET

• URL: {{urlBaseTalento}}/html/operativos/cantidadPreguntasEvaluacion/{{codProceso360}}.json

• Headers:

  • Content-Type: application/json

Response

• Status Code: 200 OK

• Content-Type: application/json

• Response Body:

  • totalCalificados: Integer representing the total number of questions that have been evaluated.

  • totalPorCalificar: Integer representing the total number of questions that are yet to be evaluated.

Example Response

{
  "totalCalificados": 0,
  "totalPorCalificar": 0
}

This response indicates that there are currently no questions evaluated and none pending evaluation for the specified process.

Endpoint Description

This endpoint retrieves the total number of questions evaluated for a specific process identified by codProceso360.

Request

• Method: GET

• URL: {{urlBaseTalento}}/html/operativos/cantidadPreguntasEvaluacion/{{codProceso360}}.json

• Headers:

  • Content-Type: application/json

Response

• Status Code: 200 OK

• Content-Type: application/json

• Response Body:

  • totalCalificados: Integer representing the total number of questions that have been evaluated.

  • totalPorCalificar: Integer representing the total number of questions that are yet to be evaluated.

Example Response

{
  "totalCalificados": 0,
  "totalPorCalificar": 0
}

This response indicates that there are currently no questions evaluated and none pending evaluation for the specified process.

Endpoint Description

This endpoint retrieves the total number of questions evaluated for a specific process identified by codProceso360.

Request

• Method: GET

• URL: {{urlBaseTalento}}/html/operativos/cantidadPreguntasEvaluacion/{{codProceso360}}.json

• Headers:

  • Content-Type: application/json

Response

• Status Code: 200 OK

• Content-Type: application/json

• Response Body:

  • totalCalificados: Integer representing the total number of questions that have been evaluated.

  • totalPorCalificar: Integer representing the total number of questions that are yet to be evaluated.

Example Response

{
  "totalCalificados": 0,
  "totalPorCalificar": 0
}

This response indicates that there are currently no questions evaluated and none pending evaluation for the specified process.

Evaluaciones Publicadas

Request name: EvaluacionesPublicadas
Descripción: Lista los procesos en los que el usuario es evaluador activo y debe valorar competencias de otros usuarios.

Método y URL

GET {urlBaseTalento}/html/    versionesevaluacionpublicadas.json

• {urlBaseTalento}: Variable de entorno/colección que define la URL base del backend de Talento.

Parámetros

Parámetros de consulta (query params)

Ejemplo de URL con query param:

GET {urlBaseTalento}/html/    versionesevaluacionpublicadas.json?    movil=false

Variables relevantes

Headers de ejemplo

Authorization: Bearer {Token_JWT} Content-Type: application/jsonAccept: application/json

• Authorization: use un JWT válido almacenado en la variable {Token_JWT}.

Ejemplo de respuesta

Código de estado: 200 OK
Content-Type: application/json

{    "datos": [        {            "activo": "s",            "codigo": 249,            "descripcion": "Valoracion                 Agosto",            "descripcionLarga": "dfgdfg",            "fecha_creacion": 1754079171567,            "fecha_terminacion": null,            "porcentajeAutoevaluacion": 20,            "porcentajeMisPares": 20,            "porcentajeMisColaboradores": 20,            "porcentajeMiJefe": 20,            "porcentajeClienteProveedores":                 20,            "totalEvaluacionesProgramadas":                 368,            "totalEvaluacionesHechas": 1,            "estado": 3,            "camponosabenoresponde": true,            "porCargoActual": true,            "porCargoProyectado": true,            "porNivelOrganizacional": true,            "porCorporativas": true,            "porArea": true,            "porRol": true,            "urlTransient": "http://base.                local:8889/",            "label": "Valoracion Agosto",            "empresaStr": "TODAS",            "estadoStr":                 "VAL_estado_enprogreso",            "...": "Object truncated"        },        {            "activo": "s",            "codigo": 239,            "descripcion": "CLON: Valoración                 DEC operativos!",            "fecha_creacion": 1744391183385,            "fecha_terminacion":                 1663384106131,            "totalEvaluacionesProgramadas":                 11,            "totalEvaluacionesHechas": 0,            "estado": 3,            "urlTransient": "https://demo.                talento-dev.cloud/",            "label": "CLON: Valoración DEC                 operativos!",            "empresaStr": "TODAS",            "estadoStr":                 "VAL_estado_enprogreso",            "...": "Object truncated"        }        // ... otros procesos de valoración    ],    "...": "Object truncated"}

<p >Nota: La respuesta real incluye más campos y objetos. Aquí se muestra una versión truncada solo para referencia.</p>

Notas de uso / flujo típico

1. Obtén un JWT válido (por ejemplo, mediante el endpoint de autenticación correspondiente) y guárdalo en la variable {Token_JWT} del entorno.

2. Configura la variable {urlBaseTalento} en el entorno Talento Environment con la URL base adecuada para el ambiente (dev, qa, prod, etc.).

3. Envía la petición GET a {urlBaseTalento}/html/versionesevaluacionpublicadas.json con el header Authorization: Bearer {Token_JWT}.

4. Verifica que el arreglo datos contenga los procesos de evaluación donde el usuario actual es evaluador activo, junto con sus atributos de configuración (porcentajes, fechas de apertura/cierre, banderas, etc.).

Posibles variaciones

• GET {urlBaseTalento}/html/ versionesevaluacionpublicadas.json? movil=false

• Ambientes diferentes: cambia el valor de {urlBaseTalento} en el entorno para apuntar a distintos ambientes (por ejemplo, demo, producción del cliente, etc.).

• Filtros adicionales: si en futuras versiones se añaden más parámetros de query, deberán documentarse aquí (por ejemplo, filtros por estado, fechas, empresa, etc.).

Manejo de errores

Los errores habituales pueden incluir:

• 400 Bad Request: Parámetros requeridos faltantes o con formato inválido.

• 401 Unauthorized: Token JWT inválido, expirado o ausente.

• 403 Forbidden: El usuario autenticado no tiene permisos suficientes.

• 404 Not Found: El recurso solicitado no existe.

• 500 Internal Server Error: Error inesperado en el servidor.

Cuando sea posible, cada endpoint detallará sus códigos de error específicos y estructura de respuesta en su propia descripción.

Para listar los usuarios que el usuario en sesión debe evaluar de un proceso elegido. (Usado en el
formulario estandar)
Necesitamos una sesión activa previa, accedemos al servicio REST tipo GET en la url end point
{urlBaseTalento}/html/valoracion360/personasAEvaluar/{{codEvaluacion}}.json

Parámetros tipo query:

• query Para filtrar por nombre si se desea NO

• estado Para filtrar por estados si se desea, ej: PENDIENTE, ENCURSO,FINALIZADA, ECHAZADA. NO es obligatorio

La foto del usuario se toma a partir de su código con la url: ../html/foto/descargaralt/[cod_usuario]/2
estadoCalificacion nos indica la bandera de si el usuario a calificar esta: pendiente(0), en progreso (3),
rechazado(2) o finalizado (1)
El codAsignacion es importante más adelante

Total de evaluaciones a realizar

En el formulario estándar (tipo wizard) existe un endpoint que te da los detalles de preguntas una a la
vez según se va respondiendo y avanzando cuando se le da al botón siguiente.
Necesitamos una sesión activa previa, accedemos al servicio REST tipo GET en la url endpoint
{urlBaseTalento}/html/valoracion360/cargar-informacion-pregunta/{{codAsignacion}}/-1.json

Parámetros tipo query:

• primer_pregunta: Si se quiere devolver a la primera pregunta se manda con true y dirección ATRAS. No es obligatorio

El -1 es si es la primera vez que entramos, se puede cambiar por SIGUIENTE o ATRAS para movernos
entre preguntas. El servicio siempre tratará de entregarnos la ultima pregunta/comportamiento sin
responder.

El resultado es la pregunta con su competencia asociada, además tiene la escala
con que se puede calificar y si ya estaba respondida la pregunta indicará cual fue la
opción seleccionada previamente.

Para consultar la cantidad de preguntas respondidas y totales de un evaluado por parte del evaluador
en sesión.
Necesitamos una sesión activa previa, accedemos al servicio REST tipo GET en la url end point
{urlBaseTalento}/html/valoracion360/totalPrceso/{{codEvaluacion}}/{{codEvaluado}}/
{{codAsignacion}}.json

Donde codEvaluacion es el código del proceso, codEvaluado es el mismo codUsuario
que obtenemos al listar evaluados, de esa misma lista sacamos el codAsignacion

Para guardar la calificación a una pregunta dada:
Necesitamos una sesión activa previa, accedemos al servicio REST tipo POST en la url endpoint
{urlBaseTalento}/html/valoracion360/guardarCalificacionIndividual/{{codAsignacion}}/
{{codReferencia}}/{{calificacion}}.json

Path param:

CodAsignacion, codReferencia y calificacion se tomán según el endpoint anterior, donde
codReferencia es el mismo campo codigo en la pregunta (no confundir con codPregunta), y
calificación es uno de los valores de la escala

Para guardar las fortalezas, oportunidades u observaciones de una pregunta/comportamiento
indicado. Esos campos son configurables de si se ven, o son obligatorios o tienen límite de caracteres.
Necesitamos una sesión activa previa, accedemos al servicio REST tipo POST en la url end point
{urlBaseTalento}/html/valoracion360/guardarComentarios/{{codAsignacion}}/{{codReferencia}}.json

Query params:

• observacion Texto

• fortalezas Texto

• oprortunidad Texto

Donde codAsignacion la tomamos de la lista de evaluados y codReferencia es el codigo en pregunta
que no es codPregunta.
Si codReferencia es igual a -1 se debe mandar un parametro adicional llamado copiaPregunta. Esto
puede pasar en el acordeón.

Para guardar las observaciones finales sobre el usuario que se termina de calificar
Necesitamos una sesión activa previa, accedemos al servicio REST tipo POST en la url endpoint
{urlBaseTalento}/html/valoracion360/guardar-observaciones/{{codAsignacion}}.json

Query params:

• datas: Observaciones en formato json, ejem: {"observacion":"Esta es la observaciones final del evaluados que es la retroalimentaci\u00f3n tambien."}. Es obligatorio

• finalizar: Si true indica que esa evaluación se debe finalizar, por tanto no se podrá modificar después y ya puede hacer los cálculos de los resultados por debajo. No es obligatorio

El evaluador puede decir que no tiene criterio para evaluar a un colaborador de la empresa, para esto
usa el siguiente endpont: {urlBaseTalento}/html/valoracion360/rechazarEvaluacion.json

Lista los años activos registrados de OKR en talento cloud. El cliente web podria elegir el primer año que encuentre en la lista pues viene ordenada de la más reciente a la más antigua.

Lista los periodos OKR

Para listar los objetivos de resultado clave (OKR) de un usuario dado

Para listar los objetivos de resultado clave (OKR) de un usuario dado

Para listar los objetivos de resultado clave (OKR) de un usuario dado

Para crear o editar un OKR

Para eliminar un OKR, inactiva por que es eliminado lógico

Para listar los resultados clave de un OKR dado

Para crear o editar un KR o resultado clave

Para eliminar un KR, inactiva por que es eliminado lógico

Para cargar evidencias a un KR

Listar evidencias de un KR

Guardar lista de acciones clave de un KR

Guardar lista de acciones clave de un KR

Para registrar valor logrado de un KR por parte del Lider del colaborador

Para notificar a jefe de que ya puede aprobar

Lista los usuarios colaboradores activos que tienen licencia de plan de desarrollo y cuyo jefe sea el usuario en sesión, si esta activo lo de lider funcional tambien se tiene en cuenta. En caso de que el usuario en sesión sea adminstrador de sistema no filtraría por jefe. Si esta activo lo de grupos tambien los listaría