Crear Detalles de Vinculación

Permite registrar el detalle de vinculación de uno o varios empleados. Cada petición puede contener un único registro o un arreglo de registros. Un empleado puede tener varios registros (por ejemplo, plazas con dedicación parcial). Cada detalle se asocia a la última vinculación del empleado y la división es el código de la compañía. Los registros se cargan en una tabla temporal y se validan y guardan en los detalles de vinculación, en la planta de cargos (si no existe) y en el detalle de planta de cargos (la plaza).

Validaciones:

  • Primero se validan los campos requeridos, la longitud máxima de cada campo, la cantidad de dígitos enteros y decimales de los campos numéricos y el formato de las fechas (dd/MM/yyyy). Si algún registro presenta una de estas inconsistencias, no se guarda ningún registro de la solicitud; los registros sin inconsistencias se reportan como no guardados.
  • Si todos los registros superan esa validación, se validan en la base de datos los valores de los campos codificados (dependencia, centro, tipo de nómina, régimen salarial, oficios, jornada, pagador, ciudad, riesgos, motivo de desvinculación), las fechas de labores contra las fechas de la vinculación, la dedicación y los datos de riesgos profesionales (requeridos cuando el grupo de planta de cargos exige riesgos). En este punto, los registros sin inconsistencias se guardan aunque otros registros de la misma solicitud presenten inconsistencias.
  • Los registros de un mismo empleado con la misma fecha inicio de labores se tratan como un grupo: si alguno presenta inconsistencias, no se guarda ninguno del grupo y todos se reportan con las inconsistencias del grupo.
  • Las inconsistencias de un registro se unen en un solo mensaje, separadas por '; '. Si el empleado no tiene información laboral o no tiene vinculación, solo se reporta esa inconsistencia.

La respuesta tiene un resultado por registro, en el orden en que fueron enviados. La compañía se obtiene automáticamente de la sesión del usuario autenticado. También se valida la sesión del usuario mediante autenticación Bearer Token.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Detalle de vinculación o arreglo de detalles de vinculación a insertar.

string
required
length ≤ 11

Número de identificación del empleado. Debe tener información laboral y al menos una vinculación: el detalle se asocia a la última.

string
required
length ≤ 18

Código de la dependencia. Debe existir y estar activa. Si la compañía maneja dependencia, debe estar definida para el centro y la división; si no, para el nivel 0.

string
required
length ≤ 15

Código del centro. Debe existir.

string
required
length ≤ 5

Código del tipo de nómina. Debe existir y tener definido el último periodo liquidado.

string
required
length ≤ 5

Código del régimen salarial. Debe existir, estar vigente a la fecha inicial de la vinculación y estar relacionado con el tipo de nómina.

string
required
length ≤ 10

Código del oficio. Debe existir.

string
required
length ≤ 10

Código del oficio para el pago del básico. Debe existir.

string
enum
length ≤ 1

Auxilio de transporte: F (Liquidación Por Defecto), S (Sí tiene derecho), N (No tiene derecho). Opcional: si no se informa se asigna F.

Allowed:
string
required

Fecha inicio de labores, formato dd/MM/yyyy. No puede ser menor que la fecha inicial de la vinculación.

string

Fecha fin de labores, formato dd/MM/yyyy. Opcional. No puede ser menor que la fecha inicio de labores ni mayor que la fecha final de la vinculación.

string
required
length ≤ 5

Código de la jornada. Debe existir.

string
enum
length ≤ 1

Modalidad de salario: F (Fijo), V (Variable), I (Integral). Opcional: si no se informa se asigna F.

Allowed:
number
required

Salario básico. Hasta 9 dígitos enteros y 2 decimales.

string
length ≤ 5

Código del motivo de desvinculación. Opcional. Debe existir.

string
length ≤ 500

Descripción del motivo de desvinculación para el empleado. Opcional.

number
required
0 to 1

Dedicación de la plaza: mayor que 0 y hasta 1, con hasta 3 decimales. La suma con las dedicaciones de los otros detalles del empleado en la misma fecha inicio de labores no puede superar 1.

string
enum
length ≤ 1

Indica si tiene horas extras: S (Sí), N (No). Opcional: si no se informa se asigna S.

Allowed:
string
required
length ≤ 10

Código del pagador de la plaza. Debe existir.

string
required
length ≤ 5

Código de la ciudad de localización del centro. Debe existir y tener definida la localización para el centro.

string
length ≤ 15

Tercero de riesgos profesionales. Opcional, pero es requerido cuando el grupo de planta de cargos del estamento de la vinculación exige riesgos. Debe estar vigente.

string
length ≤ 5

Código de riesgo profesional. Opcional, pero es requerido cuando el grupo de planta de cargos del estamento de la vinculación exige riesgos. Debe existir para el tercero de riesgos.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json