Crear empleado

Registrar un nuevo empleado en el sistema.

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

Crea un empleado en la nómina: registra la persona (EmpleadoNomina) y su vinculación con la compañía de la sesión, en una sola transacción.

Reglas de negocio

  • El empleado se crea siempre en la compañía de la sesión; no se toma del body.
  • Si ya existe un vinculado con esa combinación de tipoDocumento + identificacion con contrato vigente, se rechaza indicando que el empleado ya existe.
  • Si existe pero sin contrato vigente, se rechaza con un error distinto (empleado desvinculado): hay que reincorporarlo, no crearlo de nuevo.
  • Se valida el número de empleados activos contra las licencias contratadas. Si se supera, se rechaza; el mensaje difiere según el plan sea Enterprise o no.
  • Si la identificación ya corresponde a un contacto de la organización (proveedor, tercero), se rechaza: primero hay que resolver ese contacto.
  • El empleado no queda activo automáticamente. Al guardar se evalúa si la información está completa (datos básicos, laborales, salariales y de seguridad social):
    • Información completa y licencias disponibles → queda Vinculado (activo).
    • Información incompleta y no estaba activo → queda En proceso de vinculación.
    • Información incompleta habiendo estado activo → queda inactivo con Error en la información.
  • Al crear se genera automáticamente el elemento contable del empleado, considerando si está inscrito en el RUT.
  • Toda la operación es transaccional: si algo falla al guardar, no queda el empleado a medias.
Body Params
string

Uuid del empleado (para creación no se envia).

string

Uuid del vinculado asociado al empleado.

string
required

Uuid de la compañía asociada al empleado.

string
required

Tipo de documento (CC/TI/CE/NIT/PS/DE/SIDIAN/PEP).

string
required

Número de identificación.

boolean
required

Indica si esta inscrito en el RUT.

string
required

Primer nombre.

string

Segundo nombre.

string
required

Primer apellido.

string

Segundo apellido.

integer

Mes de nacimiento (1-12).

integer

Dia de nacimiento (1-31).

integer

Anio de nacimiento.

string
required

Código DIVIPOLA de ciudad de nacimiento.

string
required

Código de genero.

string

Foto del empleado.

string
required

Dirección de residencia.

string
required

Código DIVIPOLA de ciudad de residencia.

string
required

Indicativo telefonico.

string
required

Teléfono.

string

Indicativo telefonico adicional.

string

Teléfono adicional.

string
required

Correo electrónico.

string
required

Nombre del contacto de emergencia.

string
required

Indicativo telefonico del contacto de emergencia.

string
required

Teléfono del contacto de emergencia.

string

Correo del contacto de emergencia.

string

Mensaje informativo.

boolean

Indica si el empleado tiene pagos en proceso (informativo).

string
required

Código de tipo de empleado.

Headers
string
required

Bearer token para la autorización. Consulte la documentación inicial del módulo de nómina para obtener instrucciones sobre cómo generar el token de autenticación.

Responses

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