---
title: "Crear una novedad."
method: POST
path: "/novedades"
tags: ["Novedades"]
---

# Crear una novedad.

`POST /novedades`

## Request

- Base URL: `https://api.loggro.com/apik/loggro-nomina`
- URL: `https://api.loggro.com/apik/loggro-nomina/novedades`
- Auth: none declared. Required headers: `Authorization`

Crear una nueva novedad para un empleado.

## Request body

- NovedadDTO: DTO que representa una novedad de nómina.
  - `vinculadoUuid` string: UUID del vinculado, este valor puede ser consultado desde el endpoint /vinculados
  - `uuid` string: UUID de la novedad a actualizar
  - `conceptoNovedadId` string: ID del concepto de la novedad, este valor puede ser consultado desde el endpoint /conceptosNovedad
  - `tipoCaptura` string: Tipo de captura, más documentación en la definición del concepto en el endpoint /conceptosNovedad
  - `tipoConcepto` string: Tipo de concepto
  - `valor` number, double: Valor de la novedad
  - `diasHoras` number, double: Días u horas de la novedad
  - `numeroVeces` integer: Número de veces que ocurre la novedad
  - `periodicidadCode` string: Código de periodicidad. - P: Todos los periodos - 1P: Primer periodo del mes - 2P: Segundo periodo del mes - UP: Ultimo periodo del mes
  - `informaEn` string: Información en. - HOR: Horas - VLR: Valor - SAL: Saldo - FEC: Rango de fechas - DIA: Dias
  - `terceroUuid` string: UUID del tercero. Este valor puede ser consultado desde el endpoint /api/v1/contactos.
  - `fechaInicialNovedad` string, date-time: Fecha inicial de la novedad
  - `fechaFinalNovedad` string, date-time: Fecha final de la novedad
  - `codigo` string: Código de la novedad
  - `novedadBaseUuid` string: UUID de la novedad base
  - `saldo` number, double: Saldo de la novedad
  - `formaDePago` string: Código de la Forma de pago para novedad de vacaciones. - CO: Completas - PP: Por Periodos - AD: Adelanto
  - `excluirPeriodo` integer: Excluir periodo
  - `ajusteNovedad` number, double: Ajuste de la novedad
  - `pagoEspecial` boolean: Indica si es un pago especial

## Response `200`

Solicitud exitosa. La novedad se ha registrado correctamente en la nómina.

- NovedadDTO: DTO que representa una novedad de nómina.
  - `vinculadoUuid` string: UUID del vinculado, este valor puede ser consultado desde el endpoint /vinculados
  - `uuid` string: UUID de la novedad a actualizar
  - `conceptoNovedadId` string: ID del concepto de la novedad, este valor puede ser consultado desde el endpoint /conceptosNovedad
  - `tipoCaptura` string: Tipo de captura, más documentación en la definición del concepto en el endpoint /conceptosNovedad
  - `tipoConcepto` string: Tipo de concepto
  - `valor` number, double: Valor de la novedad
  - `diasHoras` number, double: Días u horas de la novedad
  - `numeroVeces` integer: Número de veces que ocurre la novedad
  - `periodicidadCode` string: Código de periodicidad. - P: Todos los periodos - 1P: Primer periodo del mes - 2P: Segundo periodo del mes - UP: Ultimo periodo del mes
  - `informaEn` string: Información en. - HOR: Horas - VLR: Valor - SAL: Saldo - FEC: Rango de fechas - DIA: Dias
  - `terceroUuid` string: UUID del tercero. Este valor puede ser consultado desde el endpoint /api/v1/contactos.
  - `fechaInicialNovedad` string, date-time: Fecha inicial de la novedad
  - `fechaFinalNovedad` string, date-time: Fecha final de la novedad
  - `codigo` string: Código de la novedad
  - `novedadBaseUuid` string: UUID de la novedad base
  - `saldo` number, double: Saldo de la novedad
  - `formaDePago` string: Código de la Forma de pago para novedad de vacaciones. - CO: Completas - PP: Por Periodos - AD: Adelanto
  - `excluirPeriodo` integer: Excluir periodo
  - `ajusteNovedad` number, double: Ajuste de la novedad
  - `pagoEspecial` boolean: Indica si es un pago especial

## Other responses

- `400`: No fue posible procesar la solicitud: los datos enviados son inválidos o el recurso referenciado no existe.
- `401`: No autorizado para el uso del servicio. **Posibles causas:** - Falta agregar el Bearer Token en la petición. - Tenant no existe o está inactivo.
- `404`: No se encontró el registro. No se encontró el vinculado en el proceso.
- `417`: Error de validación de negocio. **Posibles causas:** - El usuario no tiene un rol con permisos a este recurso. - Datos de la solicitud incorrectos. - No se encontró el vinculado en el proceso. - Error en el proceso de nómina. **Posibles causas adicionales:** - Para el empleado {Nombre Empleado}, no es posible ingresar la novedad {Tipo Concepto Novedad}, ya que está definido como {Tipo Cotizante Descripción}. - Para el empleado {Nombre Empleado}, no es posible ingresar la novedad en días para el concepto de {Novedad Descripción}, ya que está definido como {Tipo Cotizante Descripción}. - Para el empleado {Nombre Empleado}, no es posible ingresar la novedad {Novedad Descripción}, ya que no tiene registrada una entidad de pensión. - No es posible ingresar la novedad atrasada solo del día 31, por favor elija otro rango de fechas para su ingreso. - Actualmente cuentas con un plan que no te permite pagar {Novedad Descripción}. Para pagar esta novedad puedes modificar tu plan actual de Loggro a través de la opción Mis Planes y Pagos.
- `500`: Error interno del servidor. Ocurrió un error inesperado en el servidor.

---

[API](https://skmtc.dev/loggro/apis/n-mina-servicios-del-m-dulo-de-n-mina.md) - [All operations](https://skmtc.dev/loggro/apis/n-mina-servicios-del-m-dulo-de-n-mina/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/n-mina-servicios-del-m-dulo-de-n-mina/revisions/50f1d437c8b6?raw)