Crear una novedad.

Crear una nueva novedad para un empleado.

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

Crea una novedad para un empleado (devengo, deducción, incapacidad, vacaciones, libranza).

Reglas de negocio

  • El vinculado debe existir; si no, se responde no encontrado.
  • Novedades de pensión: si el concepto lo requiere y el empleado no tiene vigencia de AFP registrada, se rechaza indicando el nombre del empleado.
  • Conceptos extralegales: solo se permiten si la organización tiene plan Plus o superior; en otros planes se rechaza indicando la descripción del concepto.
  • Calendario comercial y día 31: si la compañía liquida con calendario comercial y la novedad inicia el día 31, no se puede registrar de forma atrasada.
  • La fecha final no puede ser anterior a la fecha inicial.
  • Si la fecha de inicio es anterior o igual a la fecha del último pago del empleado, se rechaza — esa novedad correspondería a un período ya liquidado.
  • El comportamiento concreto depende del tipo de captura del concepto (días, horas, valor, rango de fechas): cada uno valida campos distintos del body.
Body Params

DTO que representa una novedad de nómina.

string

UUID del vinculado, este valor puede ser consultado desde el endpoint /vinculados

string

UUID de la novedad a actualizar

string

ID del concepto de la novedad, este valor puede ser consultado desde el endpoint /conceptosNovedad

string

Tipo de captura, más documentación en la definición del concepto en el endpoint /conceptosNovedad

string

Tipo de concepto

double

Valor de la novedad

double

Días u horas de la novedad

int32

Número de veces que ocurre la novedad

string

Código de periodicidad.

  • P: Todos los periodos
  • 1P: Primer periodo del mes
  • 2P: Segundo periodo del mes
  • UP: Ultimo periodo del mes
string

Información en.

  • HOR: Horas
  • VLR: Valor
  • SAL: Saldo
  • FEC: Rango de fechas
  • DIA: Dias
string

UUID del tercero. Este valor puede ser consultado desde el endpoint /api/v1/contactos.

date-time

Fecha inicial de la novedad

date-time

Fecha final de la novedad

string

Código de la novedad

string

UUID de la novedad base

double

Saldo de la novedad

string

Código de la Forma de pago para novedad de vacaciones.

  • CO: Completas
  • PP: Por Periodos
  • AD: Adelanto
int32

Excluir periodo

double

Ajuste de la novedad

boolean

Indica si es un pago especial

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