Workbeat API - Posiciones API documentation version v1

https://api.workbeat.com/v1/org/

/posiciones

get post

get

Obtener la información básica de todas las posiciones existentes.

post

Crear una posición (opcionalmente se pueden indicar sus atributos y su plantilla autorizada).

Es requerido tener el permiso para crear posiciones.

Se valida:

  • Que se especifique un nombre para la posición.
  • Que el nombre de la posición no exceda de 80 caracteres.
  • Que no exista otra posición con el mismo nombre en la misma organización.
  • Que se especifique un ID de organización.
  • Que el ID de la organización sea un número entero.
  • Que exista la organización.
  • Si se especifica un ID de posición a la cual reporta, que sea un número entero.
  • Si se especifica un ID de posición a la cual reporta, que exista la posición dentro de la misma organización.
  • Si se especifica un código de posición a la cual reporta, que no exceda de 60 caracteres.
  • Si se especifica un código de posición a la cual reporta, que exista la posición dentro de la misma organización.
  • Si se especifica un código para la posición, que no exceda de 60 caracteres.
  • Si se especifica un código para la posición, que no exista otra posición con el mismo código en la misma organización.
  • Que el tipo de relación laboral tenga alguno de los valores permitidos ("Sindicalizado", "No sindicalizado").
  • Si se especifican atributos para la posición, que cada uno de los atributos que se pretenden asignar existan y apliquen para posiciones.
  • Si se especifica plantilla autorizada para la posición, que cada uno de los tipos de plantilla que se pretenden habilitar existan.
  • Si se especifica un ID de descripción de puesto, que sea un número entero.
  • Si se especifica un ID de descripción de puesto, que exista la descripción de puesto dentro de la misma organización.

Obtener la información básica de todas las posiciones existentes.

Secured by oauth_2_0

Query Parameters

  • pagina: (number )

    Opcional. Numero de página a regresar.

  • tamanoPagina: (number- default: 20 )

    Opcional. Tamaño de la página a regresar. Solo es válido si se especifica el parámetro "pagina".

  • orden: (string- default: id )

    Opcional. Nombre del campo que será el criterio para realizar el paginado de los resultados. Sólo es válido si se especifica el parámetro "pagina"

  • filtro: (string )

    Filtrado de posiciones por código, nombre, atributo default (usualmente "Departamento") o nombre y/o apellidos de alguno de los empleados que la ocupan. Si no se especifica regresa el listado completo de posiciones.

  • idPosicionReporta: (number )

    Opcional. Filtrar por el identificador de la posición a la que reportan estas posiciones dentro de la jerarquía organizacional.

HTTP status code 200

Regresa una colección de posiciones.

Body

Type: application/json

Schema:

[
  { "$schema": "http://json-schema.org/schema",
    "type": "object",
    "description": "Posición",
    "properties": {
     "id": { "type": "number" },
     "nombre": { "type": "string" },
     "nombreOrganizacion": { "type": "string" },
     "codigo": { "type": "string" },
     "idPosicionReporta" : {"type" : "number"},
     "nombrePosicionReporta" : {"type" : "string"},
     "atributoDefault": { "type": "object",
                          "description": "Atributo default de la posición",
                          "properties": {
                                         "nombreAtributo": { "type": "string" },
                                         "referencia": { "type": "string" },
                                         "nombre": { "type": "string" } 
                                        }
                        },
     "fechaCreacion": { "type": "date" },
     "fechaUltimoCambio": { "type": "date" }
    }
  }
]

Example:

[
  {
  "id": 205,
  "nombre": "Analista de Sistemas",
  "nombreOrganizacion": "Servicios ITX, S.C.",
  "codigo": "ANA-SIS",
  "atributoDefault": {
                        "nombreAtributo": "Departamento",
                        "referencia": "D001",
                        "nombre": "Sistemas"
                      },
  "fechaCreacion": "Thu, 01 Jan 2015 00:00:00 GMT",
  "fechaUltimoCambio": "Thu, 01 Jan 2015 00:00:00 GMT"
  },
  {
  "id": 198,
  "nombre": "Gerente de Sistemas",
  "nombreOrganizacion": "Servicios ITX, S.C.",
  "codigo": "GTE-SIS",
  "atributoDefault": {
                        "nombreAtributo": "Departamento",
                        "referencia": "D001",
                        "nombre": "Sistemas"
                      },
  "fechaCreacion": "Thu, 01 Jan 2015 00:00:00 GMT",
  "fechaUltimoCambio": "Thu, 01 Jan 2015 00:00:00 GMT"
  },
  ...
]
    
o cuando es llamado con paginación...
    
{
pagina: 1,
tamanoPagina: 20,
totalRegistros: 60,
data: 
[
  {
  "id": 205,
  "nombre": "Analista de Sistemas",
  "nombreOrganizacion": "Servicios ITX, S.C.",
  "codigo": "ANA-SIS",
  "idPosicionReporta" : 198,
  "nombrePosicionReporta" : "Gerente de Sistemas",
  "atributoDefault": {
                        "nombreAtributo": "Departamento",
                        "referencia": "D001",
                        "nombre": "Sistemas"
                      },
  "fechaCreacion": "Thu, 01 Jan 2015 00:00:00 GMT",
  "fechaUltimoCambio": "Thu, 01 Jan 2015 00:00:00 GMT"
  },
 {
 "id": 198,
 "nombre": "Gerente de Sistemas",
 "nombreOrganizacion": "Servicios ITX, S.C.",
 "codigo": "GTE-SIS",
  "idPosicionReporta" : null,
  "nombrePosicionReporta" : null,
 "atributoDefault": {
                      "nombreAtributo": "Departamento",
                      "referencia": "D001",
                      "nombre": "Sistemas"
                    },
 "fechaCreacion": "Thu, 01 Jan 2015 00:00:00 GMT",
 "fechaUltimoCambio": "Thu, 01 Jan 2015 00:00:00 GMT"
 },
 ...
]  
}

Crear una posición (opcionalmente se pueden indicar sus atributos y su plantilla autorizada).

Es requerido tener el permiso para crear posiciones.

Se valida:

  • Que se especifique un nombre para la posición.
  • Que el nombre de la posición no exceda de 80 caracteres.
  • Que no exista otra posición con el mismo nombre en la misma organización.
  • Que se especifique un ID de organización.
  • Que el ID de la organización sea un número entero.
  • Que exista la organización.
  • Si se especifica un ID de posición a la cual reporta, que sea un número entero.
  • Si se especifica un ID de posición a la cual reporta, que exista la posición dentro de la misma organización.
  • Si se especifica un código de posición a la cual reporta, que no exceda de 60 caracteres.
  • Si se especifica un código de posición a la cual reporta, que exista la posición dentro de la misma organización.
  • Si se especifica un código para la posición, que no exceda de 60 caracteres.
  • Si se especifica un código para la posición, que no exista otra posición con el mismo código en la misma organización.
  • Que el tipo de relación laboral tenga alguno de los valores permitidos ("Sindicalizado", "No sindicalizado").
  • Si se especifican atributos para la posición, que cada uno de los atributos que se pretenden asignar existan y apliquen para posiciones.
  • Si se especifica plantilla autorizada para la posición, que cada uno de los tipos de plantilla que se pretenden habilitar existan.
  • Si se especifica un ID de descripción de puesto, que sea un número entero.
  • Si se especifica un ID de descripción de puesto, que exista la descripción de puesto dentro de la misma organización.
Secured by oauth_2_0

Body

Type: application/json

Schema:

{ "$schema": "http://json-schema.org/schema",
  "type": "object",
  "description": "Posición",
  "properties": {
    "nombre": { "type": "string", "maxLength": 80, "required": true },
    "idOrganizacion": { "type": "number", "required": true },
    "idPosicionReporta": { "type": "number" },
    "codigoPosicionReporta": { "type": "string", "maxLength": 60 },
    "codigoPosicion": { "type": "string", "maxLength": 60 },
    "idRelacionLaboral": { "type": "string", "enum": ["Sindicalizado", "No sindicalizado"] },
    "atributos": [
                  { "type": "object",
                    "description": "Atributo de una posición",
                    "properties": {
                      "idAtributo": { "type": "number", "required": true },
                      "id": { "type": "number" },
                      "referencia": { "type": "string" }
                    }
                  }
                 ],
    "plantillaAutorizada": [
                            { "type": "object",
                              "description": "Plantilla autorizada de una posición",
                              "properties": {
                                "id": { "type": "number", "required": true },
                                "cantidad": { "type": "number", "required": true }
                              }
                            }
                           ],
    "idDescripcionPuesto": { "type": "number" },
    "accesoPRO": { "type": "boolean" }
  }
}

Example:

{
"nombre": "Contador Público",
"idOrganizacion": 1,
"idPosicionReporta": 2,
"codigoPosicionReporta": "DIR-GRAL",
"codigoPosicion": "CP",
"idRelacionLaboral": "No sindicalizado",
"atributos": [
              {
              "idAtributo": 1,
              "id": 1,
              "referencia": "D001"
              },
              {
              "idAtributo": 2,
              "id": 2,
              "referencia": "NJ001"
              },
              {
              "idAtributo": 3,
              "id": 3,
              "referencia": "R001"
              }
             ],
"plantillaAutorizada": [
                        {
                        "id": 1,
                        "cantidad": 1
                        }
                       ],
"idDescripcionPuesto": 4,
"accesoPRO": true
}

HTTP status code 201

La posición se creó correctamente.

Headers

  • Location: (string )

    Url para acceder a la nueva posición.

Body

Type: application/json

Schema:

{ "$schema": "http://json-schema.org/schema",
  "type": "object",
  "description": "Posición",
  "properties": {
    "id": { "type": "number" },
    "nombre": { "type": "string" },
    "idOrganizacion": { "type": "number" },
    "nombreOrganizacion": { "type": "string" },
    "codigo": { "type": "string" },
    "relacionLaboral": { "type": "string" },
    "idPosicionReporta": { "type": "number" },
    "nombrePosicionReporta": { "type": "string" },
    "atributos": [
                  { "type": "object",
                    "description": "Atributo de una posición",
                    "properties": {
                      "idAtributo": { "type": "number" },
                      "nombreAtributo": { "type": "string" },
                      "id": { "type": "number" },
                      "referencia": { "type": "string" },
                      "nombre": { "type": "string" }
                    }
                  }
                 ],
    "plantillaAutorizada": [
                            { "type": "object",
                              "description": "Plantilla autorizada de una posición",
                              "properties": {
                                "id": { "type": "number" },
                                "nombre": { "type": "string" },
                                "cantidad": { "type": "number" }
                              }
                            }
                           ],
    "idDescripcionPuesto": { "type": "number" },
    "descripcionPuesto": { "type": "string" },
    "fechaCreacion": { "type": "date" },
    "accesoPRO": { "type": "boolean" }
  }
}

Example:

{
"id": 205,
"nombre": "Contador Público",
"idOrganizacion": 1,
"nombreOrganizacion": "Servicios ITX, S.C.",
"codigo": "CP",
"relacionLaboral": "No sindicalizado",
"idPosicionReporta": 2,
"nombrePosicionReporta": "Director General",
"atributos": [
              {
              "idAtributo": 1,
              "nombreAtributo": "Departamento",
              "id": 1,
              "referencia": "D001",
              "nombre": "Administración"
              },
              {
              "idAtributo": 2,
              "nombreAtributo": "Nivel jerárquico",
              "id": 2,
              "referencia": "NJ001",
              "nombre": "Empleado"
              },
              {
              "idAtributo": 3,
              "nombreAtributo": "Región",
              "id": 3,
              "referencia": "R001",
              "nombre": "Norte"
              }
             ],
"plantillaAutorizada": [
                        {
                        "id": 1,
                        "nombre": "Planta",
                        "cantidad": 1
                        }
                       ],
"idDescripcionPuesto": 4,
"descripcionPuesto": "Contador",
"fechaCreacion": "Tue, 02 Jun 2015 10:07:00 GMT",
"accesoPRO": true
}

HTTP status code 403

No se tienen los permisos necesarios para crear posiciones.

Body

Type: application/json

Example:

{
  "error": {
    "code": 403,
    "message": "No se tienen los permisos necesarios para crear posiciones."
  }
}

HTTP status code 422

Error de validación en los datos de la posición. Puede ocurrir si no se especificó un nombre, la longitud del nombre excede de 80 caracteres, ya existe una posición con el mismo nombre en la organización, no se especificó un ID de organización, no existe la organización, no existe la posición a la cual reporta, la longitud del código excede de 60 caracteres, la relación laboral no tiene alguno de los valores permitidos, alguno de los atributos no existe, alguno de los tipos de plantilla no existe o la descripción de puesto no existe.

Body

Type: application/json

Example:

{
  "error": {
    "code": 422,
    "message": "Error de validación en los datos de la posición."
  }
}

get post delete

get

Obtener la información básica de una posición.

post

Actualiza la información de una posición.

Es requerido tener el permiso para editar poosiciones.

Se valida:

  • Que se especifique un nombre para la posición.
  • Que el nombre de la posición no exceda de 80 caracteres.
  • Que no exista otra posición con el mismo nombre en la misma organización.
  • Que se especifique un ID de organización.
  • Que el ID de la organización sea un número entero.
  • Que exista la organización.
  • Si se especifica un ID de posición a la cual reporta, que sea un número entero.
  • Si se especifica un ID de posición a la cual reporta, que exista la posición dentro de la misma organización.
  • Si se especifica un código de posición a la cual reporta, que no exceda de 60 caracteres.
  • Si se especifica un código de posición a la cual reporta, que exista la posición dentro de la misma organización.
  • Si se especifica un código para la posición, que no exceda de 60 caracteres.
  • Si se especifica un código para la posición, que no exista otra posición con el mismo código en la misma organización.
  • Que el tipo de relación laboral tenga alguno de los valores permitidos ("Sindicalizado", "No sindicalizado").
  • Si se especifican atributos para la posición, que cada uno de los atributos que se pretenden asignar existan y apliquen para posiciones.
  • Si se especifica plantilla autorizada para la posición, que cada uno de los tipos de plantilla que se pretenden habilitar existan.
  • Si se especifica un ID de descripción de puesto, que sea un número entero.
  • Si se especifica un ID de descripción de puesto, que exista la descripción de puesto dentro de la misma organización.
delete

Borrar una posición.

Es requerido tener el permiso para borrar posiciones.

Se valida:

  • Que la posición no tenga otras posiciones relacionadas (que le reportan).
  • Que no haya empleados que ocupen la posición.

Obtener la información básica de una posición.

Secured by oauth_2_0

URI Parameters

  • id: required (string )

HTTP status code 200

Regresa una posición.

Body

Type: application/json

Schema:

{ "$schema": "http://json-schema.org/schema",
  "type": "object",
  "description": "Posición",
  "properties": {
    "id": { "type": "number" },
    "nombre": { "type": "string" },
    "nombreOrganizacion": { "type": "string" },
    "codigo": { "type": "string" },
    "atributoDefault": { "type": "object",
                         "description": "Atributo default de la posición",
                         "properties": {
                            "nombreAtributo": { "type":"string" },
                           "referencia": { "type": "string" },
                           "nombre": { "type": "string" } 
                          }
                       },
    "fechaCreacion": { "type": "date" },
    "fechaUltimoCambio": { "type": "date" }
  }
}

Example:

{
"id": 205,
"nombre": "Analista de Sistemas",
"nombreOrganizacion": "Servicios ITX, S.C.",
"codigo": "ANA-SIS",
"atributoDefault": {
                    "nombreAtributo": "Departamento",
                    "referencia": "D001",
                    "nombre": "Sistemas"
                   },
"fechaCreacion": "Thu, 01 Jan 2015 00:00:00 GMT",
"fechaUltimoCambio": "Thu, 01 Jan 2015 00:00:00 GMT"
}

HTTP status code 400

La petición no está formada correctamente.

Body

Type: application/json

Example:

{
  "error": {
    "code": 400,
    "message": "La petición no está formada correctamente. El ID de la posición debe ser un número entero."
  }
}

HTTP status code 404

No se encuentra la posición.

Body

Type: application/json

Example:

{
  "error": {
    "code": 404,
    "message": "No se encuentra la posición."
  }
}

Actualiza la información de una posición.

Es requerido tener el permiso para editar poosiciones.

Se valida:

  • Que se especifique un nombre para la posición.
  • Que el nombre de la posición no exceda de 80 caracteres.
  • Que no exista otra posición con el mismo nombre en la misma organización.
  • Que se especifique un ID de organización.
  • Que el ID de la organización sea un número entero.
  • Que exista la organización.
  • Si se especifica un ID de posición a la cual reporta, que sea un número entero.
  • Si se especifica un ID de posición a la cual reporta, que exista la posición dentro de la misma organización.
  • Si se especifica un código de posición a la cual reporta, que no exceda de 60 caracteres.
  • Si se especifica un código de posición a la cual reporta, que exista la posición dentro de la misma organización.
  • Si se especifica un código para la posición, que no exceda de 60 caracteres.
  • Si se especifica un código para la posición, que no exista otra posición con el mismo código en la misma organización.
  • Que el tipo de relación laboral tenga alguno de los valores permitidos ("Sindicalizado", "No sindicalizado").
  • Si se especifican atributos para la posición, que cada uno de los atributos que se pretenden asignar existan y apliquen para posiciones.
  • Si se especifica plantilla autorizada para la posición, que cada uno de los tipos de plantilla que se pretenden habilitar existan.
  • Si se especifica un ID de descripción de puesto, que sea un número entero.
  • Si se especifica un ID de descripción de puesto, que exista la descripción de puesto dentro de la misma organización.
Secured by oauth_2_0

URI Parameters

  • id: required (string )

Body

Type: application/json

Schema:

{ "$schema": "http://json-schema.org/schema",
  "type": "object",
  "description": "Posición",
  "properties": {
    "nombre": { "type": "string", "maxLength": 80, "required": true },
    "idOrganizacion": { "type": "number", "required": true },
    "idPosicionReporta": { "type": "number" },
    "codigoPosicionReporta": { "type": "string", "maxLength": 60 },
    "codigoPosicion": { "type": "string", "maxLength": 60 },
    "idRelacionLaboral": { "type": "string", "enum": ["Sindicalizado", "No sindicalizado"] },
    "atributos": [
                  { "type": "object",
                    "description": "Atributo de una posición",
                    "properties": {
                      "idAtributo": { "type": "number", "required": true },
                      "id": { "type": "number" },
                      "referencia": { "type": "string" }
                    }
                  }
                 ],
    "plantillaAutorizada": [
                            { "type": "object",
                              "description": "Plantilla autorizada de una posición",
                              "properties": {
                                "id": { "type": "number",   "required": true },
                                "cantidad": { "type": "number", "required": true }
                              }
                            }
                           ],
    "idDescripcionPuesto": { "type": "number" },
    "accesoPRO": { "type": "boolean" }
  }
}

Example:

{
"nombre": "Contador Público",
"idOrganizacion": 1,
"idPosicionReporta": 2,
"codigoPosicionReporta": "DIR-GRAL",
"codigoPosicion": "CP",
"idRelacionLaboral": "No sindicalizado",
"atributos": [
              {
              "idAtributo": 1,
              "id": 1,
              "referencia": "D001"
              },
              {
              "idAtributo": 2,
              "id": 2,
              "referencia": "NJ001"
              },
              {
              "idAtributo": 3,
              "id": 3,
              "referencia": "R001"
              }
             ],
"plantillaAutorizada": [
                        {
                        "id": 1,
                        "cantidad": 1
                        }
                       ],
"idDescripcionPuesto": 4,
"accesoPRO": true
}

HTTP status code 200

La posición se actualizó correctamente.

Body

Type: application/json

Schema:

{ "$schema": "http://json-schema.org/schema",
   "type": "object",
   "description": "Posición",
   "properties": {
     "id": { "type": "number" },
     "nombre": { "type": "string" },
     "idOrganizacion": { "type": "number" },
     "nombreOrganizacion": { "type": "string" },
     "codigo": { "type": "string" },
     "relacionLaboral": { "type": "string" },
     "idPosicionReporta": { "type": "number" },
     "nombrePosicionReporta": { "type": "string" },
     "atributos": [
                   { "type": "object",
                     "description": "Atributo de una posición",
                     "properties": {
                       "idAtributo": { "type": "number" },
                       "nombreAtributo": { "type": "string" },
                       "id": { "type": "number" },
                       "referencia": { "type": "string" },
                       "nombre": { "type": "string" }
                     }
                   }
                  ],
     "plantillaAutorizada": [
                             { "type": "object",
                               "description": "Plantilla autorizada de una posición",
                               "properties": {
                                 "id": { "type": "number" },
                                 "nombre": { "type": "string" },
                                 "cantidad": { "type": "number"  }
                               }
                             }
                            ],
     "idDescripcionPuesto": { "type": "number" },
     "descripcionPuesto": { "type": "string" },
     "fechaCreacion": { "type": "date" },
     "fechaUltimoCambio": { "type": "date" },
     "accesoPRO": { "type": "boolean" }
   }
 }

Example:

{
"id": 205,
"nombre": "Contador Público",
"idOrganizacion": 1,
"nombreOrganizacion": "Servicios ITX, S.C.",
"codigo": "CP",
"relacionLaboral": "No sindicalizado",
"idPosicionReporta": 2,
"nombrePosicionReporta": "Director General",
"atributos": [
              {
              "idAtributo": 1,
              "nombreAtributo": "Departamento",
              "id": 1,
              "referencia": "D001",
              "nombre": "Administración"
              },
              {
              "idAtributo": 2,
              "nombreAtributo": "Nivel jerárquico",
              "id": 2,
              "referencia": "NJ001",
              "nombre": "Empleado"
              },
              {
              "idAtributo": 3,
              "nombreAtributo": "Región",
              "id": 3,
              "referencia": "R001",
              "nombre": "Norte"
              }
             ],
"plantillaAutorizada": [
                        {
                        "id": 1,
                        "nombre": "Planta",
                        "cantidad": 1
                        }
                       ],
"idDescripcionPuesto": 4,
"descripcionPuesto": "Contador",
"fechaCreacion": "Tue, 02 Jun 2015 10:07:00 GMT",
"fechaUltimoCambio": "Tue, 02 Jun 2015 11:03:00 GMT",
"accesoPRO": true
}

HTTP status code 403

No se tienen los permisos necesarios para editar posiciones.

Body

Type: application/json

Example:

{
  "error": {
    "code": 403,
    "message": "No se tienen los permisos necesarios para editar posiciones."
  }
}

HTTP status code 422

Error de validación en los datos de la posición. Puede ocurrir si no se especificó un nombre, la longitud del nombre excede de 80 caracteres, ya existe una posición con el mismo nombre en la organización, no se especificó un ID de organización, no existe la organización, no existe la posición a la cual reporta, la longitud del código excede de 60 caracteres, la relación laboral no tiene alguno de los valores permitidos, alguno de los atributos no existe, alguno de los tipos de plantilla no existe o la descripción de puesto no existe.

Body

Type: application/json

Example:

{
  "error": {
    "code": 422,
    "message": "Error de validación en los datos de la posición."
  }
}

Borrar una posición.

Es requerido tener el permiso para borrar posiciones.

Se valida:

  • Que la posición no tenga otras posiciones relacionadas (que le reportan).
  • Que no haya empleados que ocupen la posición.
Secured by oauth_2_0

URI Parameters

  • id: required (string )

HTTP status code 200

La posición se borró correctamente.

HTTP status code 403

No se tienen los permisos necesarios para borrar posiciones.

Body

Type: application/json

Example:

{
  "error": {
    "code": 403,
    "message": "No se tienen los permisos necesarios para borrar posiciones."
  }
}

HTTP status code 405

No es posible borrar la posición.

Body

Type: application/json

Example:

{
  "error": {
    "code": 405,
    "message": "No es posible borrar la posición porque tiene posiciones o empleados relacionados."
  }
}

get

get

Obtener la información detallada de una posición.

Es requerido tener el permiso para consultar posiciones.

Obtener la información detallada de una posición.

Es requerido tener el permiso para consultar posiciones.

Secured by oauth_2_0

URI Parameters

  • id: required (string )

HTTP status code 200

Regresa una posición.

Body

Type: application/json

Schema:

{ "$schema": "http://json-schema.org/schema",
  "type": "object",
  "description": "Posición",
  "properties": {
    "id": { "type": "number" },
    "nombre": { "type": "string" },
    "idOrganizacion": { "type": "number" },
    "nombreOrganizacion": { "type": "string" },
    "codigo": { "type": "string" },
    "relacionLaboral": { "type": "string" },
    "idPosicionReporta": { "type": "number" },
    "nombrePosicionReporta": { "type": "string" },
    "atributos": [
                  { "type": "object",
                    "description": "Atributo de una posición",
                    "properties": {
                      "idAtributo": { "type": "number" },
                      "nombreAtributo": { "type": "string" },
                      "id": { "type": "number" },
                      "referencia": { "type": "string" },
                      "nombre": { "type": "string" }
                    }
                  }
                 ],
    "plantillaAutorizada": [
                            { "type": "object",
                              "description": "Plantilla autorizada de una posición",
                              "properties": {
                                "id": { "type": "number" },
                                "nombre": { "type": "string" },
                                "cantidad": { "type": "number" }
                              }
                            }
                           ],
    "idDescripcionPuesto": { "type": "number" },
    "descripcionPuesto": { "type": "string" },
    "fechaCreacion": { "type": "date" },
    "fechaUltimoCambio": { "type": "date" },
    "accesoPRO": { "type": "boolean" }
  }
}

Example:

{
"id": 205,
"nombre": "Analista de Sistemas",
"idOrganizacion": 1,
"nombreOrganizacion": "Servicios ITX, S.C.",
"codigo": "ANA-SIS",
"relacionLaboral": "No sindicalizado",
"idPosicionReporta": 198,
"nombrePosicionReporta": "Gerente de Sistemas",
"atributos": [
              {
              "idAtributo": 1,
              "nombreAtributo": "Departamento",
              "id": 1,
              "referencia": "D001",
              "nombre": "Sistemas"
              },
              {
              "idAtributo": 2,
              "nombreAtributo": "Nivel jerárquico",
              "id": 2,
              "referencia": "NJ001",
              "nombre": "Empleado"
              },
              {
              "idAtributo": 3,
              "nombreAtributo": "Región",
              "id": 3,
              "referencia": "R001",
              "nombre": "Norte"
              }
             ],
"plantillaAutorizada": [
                        {
                        "id": 1,
                        "nombre": "Planta",
                        "cantidad": 3
                        },
                        {
                        "id": 2,
                        "nombre": "Prácticas profesionales",
                        "cantidad": 2
                        }
                       ],
"idDescripcionPuesto": 45,
"descripcionPuesto": "Analista de Sistemas",
"fechaCreacion": "Thu, 01 Jan 2015 00:00:00 GMT",
"fechaUltimoCambio": "Thu, 01 Jan 2015 00:00:00 GMT",
"accesoPRO": true
}

HTTP status code 400

La petición no está formada correctamente.

Body

Type: application/json

Example:

{
  "error": {
    "code": 400,
    "message": "La petición no está formada correctamente. El ID de la posición debe ser un número entero."
  }
}

HTTP status code 403

No se tienen los permisos necesarios para consultar posiciones.

Body

Type: application/json

Example:

{
  "error": {
    "code": 403,
    "message": "No se tienen los permisos necesarios para consultar posiciones."
  }
}

HTTP status code 404

No se encuentra la posición.

Body

Type: application/json

Example:

{
  "error": {
    "code": 404,
    "message": "No se encuentra la posición."
  }
}