Crear Información Laboral

Permite registrar la información laboral de uno o varios empleados. Cada petición puede contener un único registro o un arreglo de registros. Los registros se cargan en una tabla temporal y se validan y guardan en la información laboral y en el histórico de entidades administradoras (salud, pensión y caja de compensación).

Validaciones:

  • Primero se validan los campos requeridos, la longitud máxima de cada campo, el formato de las fechas (dd/MM/yyyy) y que un empleado no esté repetido en la solicitud. 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 campos requeridos según otro campo (entidad y fecha de pensión o salud, datos de la cuenta bancaria) y los valores de los campos codificados (empleado, entidades, banco, tipo de cuenta, etc.). En este punto, los registros sin inconsistencias se guardan aunque otros registros de la misma solicitud presenten inconsistencias.
  • Las inconsistencias de un empleado se unen en un solo mensaje, separadas por '; '. Si el empleado no existe en la hoja de vida o ya existe en la información laboral, solo se reporta esa inconsistencia.

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

Información laboral o arreglo de información laboral a insertar.

string
required
length ≤ 11

Número de identificación del empleado.

string
required
length ≤ 1

Indica si el empleado cotiza pensión: S (Sí), N (No).

string
required
length ≤ 1

Indica si el empleado cotiza salud: S (Sí), N (No).

string
required
length ≤ 1

Indica si el empleado cotiza fondo: S (Sí), N (No).

string
length ≤ 1

Indica si el empleado reside en el exterior: S (Sí), N (No). Opcional. Si no se informa se asigna N.

string
length ≤ 1

Indica si el empleado pertenece al régimen subsidiado: S (Sí), N (No). Opcional. Si no se informa se asigna N.

string
length ≤ 15

Entidad (tercero) de pensión. Requerida cuando cotizaPension es S.

string

Fecha de cambio de la entidad de pensión, formato dd/MM/yyyy. Requerida cuando cotizaPension es S.

string
length ≤ 15

Entidad (tercero) de pensión para aportes voluntarios. Opcional. Se informa cuando cotizaPension es S.

string
length ≤ 5

Tarifa especial de pensión. Opcional.

string
length ≤ 15

Entidad (tercero) de salud. Requerida cuando cotizaSalud es S.

string

Fecha de cambio de la entidad de salud, formato dd/MM/yyyy. Requerida cuando cotizaSalud es S.

string
required
length ≤ 15

Entidad (tercero) de caja de compensación.

string
required

Fecha de cambio de la entidad de caja de compensación, formato dd/MM/yyyy.

string
enum
required
length ≤ 2

Tipo de pago: CH (Cheque), EF (Efectivo), CO (Consignación).

Allowed:
string
length ≤ 3

Banco. Requerido cuando tipoPago es CO.

string
length ≤ 6

Oficina de la cuenta bancaria. Requerida cuando tipoPago es CO y el banco exige oficina.

string
length ≤ 30

Número de la cuenta bancaria. Requerido cuando tipoPago es CO.

string
enum
length ≤ 2

Tipo de cuenta: AL (Ahorros local), AN (Ahorros nacional), CL (Corriente local), CN (Corriente nacional). Requerido cuando tipoPago es CO.

Allowed:
string
enum
length ≤ 1

Tipo de propietario de la cuenta: P (Propia), O (Otro). Requerido cuando tipoPago es CO.

Allowed:
string
length ≤ 30

Nombre del propietario de la cuenta. Requerido cuando tipoPago es CO y tipoPropietarioCuenta es O.

string
length ≤ 1

Indica si el empleado tiene embargo: S (Sí), N (No). Opcional. Si no se informa se asigna N.

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