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,
          "excludedZones": ["string"]
        }
      ]
    }
  ]
}
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).

      • excludedZones: identificadores externos de las zonas que se excluirán de esta aptitud. Si no se especifican, la aptitud se aplica a todas las zonas del producto.

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": "EMPLOYEEID",
  "aptitudes": [
    {
      "productId": "0001-G",
      "aptitudes": [
                {
                    "locationId": "02",
                    "level": 3,
                    "excludedZones": ["Z1"]
                }
      ]
    }
  ]
}

Si los datos son correctos, la petición devolverá un estado 200 OK y todas las aptitudes del empleado en el producto indicado se sustituirán por las de la petición.

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.

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

Los valores definidos para level son 0, 1, 2 y 3. Si se envían valores con decimales, se truncarán a su número entero.

Se establecerá el mismo nivel de competencia para todas las zonas del producto que tengan habilitada la tarea, salvo que se incluya alguna zona en el campo excludedZones. En las zonas excluidas, se definirá nivel 0.

Si el empleado tiene aptitudes definidas en otros productos, estas permanecerán inalteradas.

Enlaces de interés

¿Qué es una aptitud?

¿Qué es una tarea?