Crear Vinculaciones

Permite registrar la vinculación de uno o varios empleados. Cada petición puede contener un único registro o un arreglo de registros, con un registro por empleado. Primero se validan localmente todos los registros (campos requeridos, longitudes, formato de las fechas y empleados repetidos en la solicitud); si alguno presenta una inconsistencia en esta validación, no se carga ningún registro y los que no tienen inconsistencias se reportan como no guardados. Si todos la superan, los registros se cargan en una tabla temporal y se validan y guardan en las vinculaciones, en los códigos de aportación de autoliquidación del empleado, en el histórico de estamentos y en el histórico de entidades administradoras. En esta segunda validación, los registros sin inconsistencias se guardan aunque otros del mismo lote presenten inconsistencias. Las inconsistencias de un empleado se unen en un solo mensaje, separadas por punto y coma; si el empleado no tiene información laboral, solo se reporta ese mensaje. Los campos requeridos según otro campo o parámetro (fecha final y fecha final del contrato según la duración del tipo de vinculación, sucursal de autoliquidación, datos de cesantías, continua vinculación) y los valores de los campos codificados se validan en la base de datos. Si no se informa el tipo de vinculación, se asigna INDEF (Indefinido). La compañía se obtiene automáticamente de la sesión del usuario autenticado.

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

Vinculación o arreglo de vinculaciones a insertar.

string
required
length ≤ 11

Número de identificación del empleado. Debe tener información laboral.

string
required
length ≤ 5

Tipo de empleado. Debe existir y estar activo junto con la clase tipo empleado.

string
required
length ≤ 5

Clase tipo empleado. Debe existir y estar activa para el tipo de empleado.

string
length ≤ 5

Tipo de vinculación. Debe existir y estar activo. Opcional: si no se informa se asigna INDEF (Indefinido).

string
required
^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/\d{4}$

Fecha inicial de la vinculación, formato dd/MM/yyyy.

string
^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/\d{4}$

Fecha final de la vinculación, formato dd/MM/yyyy. Opcional. No puede ser menor que la fecha inicial. Requerida cuando la duración del tipo de vinculación no es indefinida.

string
^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/\d{4}$

Fecha final del contrato de la vinculación, formato dd/MM/yyyy. Opcional. Se informa cuando el tipo de vinculación no es INDEF (Indefinido), y en ese caso es requerida y no puede ser menor que la fecha final.

string
enum
length ≤ 1

Indica si la vinculación continúa: S (Sí), N (No). Opcional. Solo se informa si en las variables globales (CONTIVINCU) se maneja continua vinculación.

Allowed:
string
^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/\d{4}$

Fecha de retiro de continua vinculación, formato dd/MM/yyyy. Opcional. Puede ser informada si continuaVinculacion es S; no puede ser menor que la fecha inicial ni que la fecha final.

string
length ≤ 10

Sucursal de autoliquidación. Opcional. Solo se informa, y en ese caso es requerida, si en los parámetros generales de autoliquidación la forma de liquidación es por Sucursal.

string
length ≤ 3

Régimen de cesantías. Opcional. Debe existir.

string
length ≤ 15

Tercero de cesantías. Opcional. Solo se informa, y en ese caso es requerido, si regimenCesantia no es nulo.

string
^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/\d{4}$

Fecha de cambio del tercero de cesantías, formato dd/MM/yyyy. Opcional. Solo se informa, y en ese caso es requerida, si regimenCesantia no es nulo.

string
length ≤ 15

Número de cuenta de cesantías. Opcional. Solo se informa, y en ese caso es requerido, si regimenCesantia no es nulo.

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