Insertar Hoja de Vida

Permite registrar la hoja de vida de uno o varios empleados y, opcionalmente, sus documentos personales. Cada petición puede contener una única hoja de vida o un arreglo de hojas de vida. Cada hoja de vida puede incluir sus documentos personales en el campo documentosPersonales, sin el empleado: se toma de numeroIdentificacion. Primero se validan localmente todos los registros (campos requeridos, longitudes, formato de las fechas y empleados repetidos en la solicitud), incluidos los documentos personales; si alguno presenta una inconsistencia en esta validación, no se carga ninguna hoja de vida y las que no tienen inconsistencias se reportan como no guardadas. Si todos la superan, los registros se cargan en tablas temporales y se validan y guardan en la hoja de vida (y en terceros generales, si comparte con el ERP) y en los documentos personales. En esta segunda validación, los empleados sin inconsistencias se guardan aunque otros del mismo lote presenten inconsistencias. El registro de cada empleado se guarda completo o se rechaza: si la hoja de vida o los documentos personales presentan inconsistencias, no se guarda ninguno de los dos y se reportan las inconsistencias de ambos. Cuando la hoja de vida se rechaza por los documentos personales, sus inconsistencias se agregan al mismo mensaje, separadas por punto y coma. Si la hoja de vida no se guarda, los documentos personales informados se reportan como no guardados. Un empleado que ya existe en la hoja de vida, o que ya tiene documentos personales, no se actualiza: se reporta como inconsistencia; si el empleado ya existe en la hoja de vida, solo se reporta ese mensaje. En los mensajes de validación, los campos de los documentos personales se nombran con el prefijo "documentosPersonales." (p. ej. 'documentosPersonales.fechaExpedicion'). El nombre resumido no se recibe: se arma con los apellidos y los nombres. 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

Hoja de vida o arreglo de hojas de vida a insertar.

string
required
length ≤ 11

Número de identificación del empleado.

string
enum
required
length ≤ 2

Tipo de identificación del empleado: CC (Cedula ciudadania), CD (Carnet diplomatico), CE (Cedula extranjeria), DE (Docto identif. extranjero), NI (Nit), NO (NIT otro país), NU (Nro unico id. personal), OT (Otro), PA (Pasaporte), PE (Permiso especial), PP (Permiso protec. temp.), PT (Permiso temporal), RC (Registro civil), TE (Tarjeta extranjería), TI (Tarjeta identidad).

string
required
length ≤ 15

Primer apellido del empleado.

string
length ≤ 15

Segundo apellido del empleado. Opcional.

string
required
length ≤ 20

Nombres del empleado.

string
length ≤ 30

Código alterno. Solo se informa si el tipo de identificación es PE (Permiso especial) o PT (Permiso temporal), y en ese caso es requerido.

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

Fecha de nacimiento del empleado (formato dd/MM/yyyy).

string
required
length ≤ 5

Código de la ciudad de nacimiento del empleado.

string
required
length ≤ 5

Código del departamento de nacimiento del empleado.

string
required
length ≤ 4

Código del país de nacimiento del empleado.

string
enum
required
length ≤ 1

Sexo del empleado: M (Masculino), F (Femenino), O (Otro).

Allowed:
string
enum
required
length ≤ 2

Estado civil del empleado: SO (Soltero(a)), CA (Casado(a)), SE (Separado(a)), VI (Viudo(a)), UL (Unión Libre).

Allowed:
string
enum
required
length ≤ 2

Tipo de vivienda del empleado: PP (Propia), FM (Familiar), AR (Arrendada), AM (En Amortización).

Allowed:
string
enum
required
length ≤ 2

Medio de transporte del empleado: BU (Bus), TA (Taxi), TR (Tren Metropolitano), VE (Vehiculo Propio), BI (Bicicleta), OT (Otro).

Allowed:
string
required
length ≤ 60

Dirección del empleado.

string
length ≤ 30

Barrio del empleado. Opcional.

integer
≤ 99
Defaults to 3

Estrato del empleado (máximo 2 dígitos). Opcional. Si no se informa se asigna 3.

string
required
length ≤ 5

Código de la ciudad de residencia del empleado.

string
required
length ≤ 5

Código del departamento de residencia del empleado.

string
required
length ≤ 4

Código del país de residencia del empleado.

string
length ≤ 22

Teléfono 1 del empleado. Opcional. Si no se informa se asigna 1.

string
length ≤ 22

Teléfono 2 del empleado. Opcional.

string
length ≤ 22

Celular del empleado. Opcional.

string
length ≤ 100

E-mail corporativo del empleado. Opcional.

string
enum
length ≤ 1
Defaults to S

Indica si la hoja de vida del empleado se comparte con el ERP (terceros generales): S (Sí), N (No). Opcional. Si no se informa se asigna S.

Allowed:
documentosPersonales
object

Documentos personales del empleado. Opcional. Si se informan, se guardan solo si la hoja de vida se guardó. No se envía el empleado: se toma de numeroIdentificacion de la hoja de vida. Si el empleado ya tiene documentos personales, no se actualizan.

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