Añadir aptitudes

Este endpoint permite registrar una lista de aptitudes para un empleado.

POST /api/v1/import/aptitudes

A continuación, se expone una explicación de cada uno de los campos que conforman el cuerpo de la petición.

Todos los campos de esta petición son obligatorios, por eso están marcados con un asterisco (*).

Cuerpo de la petición

Análisis del JSON 
{
  "business": "string",
  "employeeId": "string",
  "aptitudes": [
    {
      "productId": "string",
      "aptitudes": [
        {
          "locationId": "string",
          "level": 0
        }
      ]
    }
  ]
}
Detalles

  • business*: identificador externo del negocio.

  • employeeId*: identificador externo del empleado.

  • aptitudes*: conjunto de aptitudes que se van a definir para el empleado con respecto a las tareas de un producto.

    • productId*: identificador externo del producto o sección del empleado.

    • aptitudes*: lista de aptitudes. Cada aptitud está conformada por los siguientes campos:

      • locationId*: identificador externo de la tarea a la que hace referencia la aptitud.

      • level*: nivel de competencia en dicha tarea en un rango de 0 (no competente) a 3 (experto).

Ejemplo de la petición

Una vez realizado el análisis de los distintos campos, se muestra un ejemplo de la petición:

POST /api/v1/import/aptitudes
{
  "business": "BUSINESSID",
  "employeeId": "001",
  "aptitudes": [
    {
      "productId": "0001-G",
      "aptitudes": [
        {
          "locationId": "01",
          "level": 3
        },
        {
          "locationId": "02",
          "level": 1
        }
      ]
    }
  ]
}

Si los datos de la petición son correctos, la petición devolverá un estado 200 OK.

Aspectos que tener en cuenta

Si el identificador del empleado no se corresponde con ningún empleado del negocio, la petición devolverá un error 404 Not Found, indicando Employee not found.

El identificador de la tarea (locationId) debe coincidir con el que está configurado en Orquest a nivel de negocio: Diagrama organizativo > Tareas > Id. externo. Si el identificador de la tarea no coincide con el que se ha configurado en Orquest, la petición devolverá un error 404 Not Found, indicando Location not found.

Si en la creación se incluyen aptitudes duplicadas, la petición devolverá un error 409 Conflict, indicando could not execute statement […​].

Los valores admitidos para level son 0, 1, 2 y 3. Con cualquier otro valor, la petición devolverá error.

Enlaces de interés

¿Qué es una aptitud?

¿Qué es una tarea?