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

# Crear una novedad de libranza.

`POST /novedades/integracion/libranza`

## Request

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

Crea una nueva novedad de libranza para un empleado. Una libranza es un descuento que se realiza directamente de la nómina del empleado para pagar una deuda o compromiso financiero. El endpoint requiere un payload JSON con los datos necesarios para registrar la libranza.

## Request body

- LibranzaExternaDTO: DTO para información de préstamos externos de nómina
  - `tipoIdentificacion` 'CC' | 'TI' | 'CE' | 'NIT' | 'PS' | 'DE' | 'SIDIAN' | 'PEP': Tipo de identificación - TI: Tarjeta de Identidad. - CC: Cédula de Ciudadanía. - TE: Tarjeta de Extranjería. - CE: Cédula de Extranjería. - NIT: Número de Identificación Tributaria. - PS: Pasaporte. - DE: Tipo de documento extranjero. - SIDIAN: Sin identificación del exterior o uso exclusivo de la DIAN. - PEP: Permiso Especial de Permanencia.
  - `identificacion` string: Corresponde a la identificación del empleado al que se le va a ingresar la novedad de libranza.
  - `valor` number, double: Corresponde al valor de la cuota de la libranza del empleado.
  - `numeroVeces` integer: Corresponde a la cantidad de veces que se le cobrara el valor de la cuota de la libranza al empleado.
  - `terceroNit` string: Corresponde a la identificación del contacto de la libranza.
  - `fechaInicioDescuento` string: Corresponde a la fecha de inicio de periodo en la cual se empezará a realizar el descuento. - Pago de nómina mensual, la fechaInicioDescuento es 01/02/2022 - Pago de nómina decadal: - 01/02/2022 - 11/02/2022 - 21/02/2022 - Pago de nómina quincenal: - 01/02/2022 - 16/02/2022
  - `periodoDeduccion` string: Período de deducción - P: Todos los periodos (nómina mensual, quincenal y decadal). - 1P: Primer periodo del mes (1ra Década, 1ra. Quincena). - 2P: Segundo periodo del mes (2da. Década). - UP: Último periodo del mes (3ra. Década, 2da. Quincena).

## Response `200`

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

- RespuestaSimpleLibranzaExternaDTO: Clase que representa una respuesta simple con contenido y error del proceso de resgistro de una libranza.
  - `contenido` LibranzaExternaDTO: DTO para información de préstamos externos de nómina
    - `tipoIdentificacion` 'CC' | 'TI' | 'CE' | 'NIT' | 'PS' | 'DE' | 'SIDIAN' | 'PEP': Tipo de identificación - TI: Tarjeta de Identidad. - CC: Cédula de Ciudadanía. - TE: Tarjeta de Extranjería. - CE: Cédula de Extranjería. - NIT: Número de Identificación Tributaria. - PS: Pasaporte. - DE: Tipo de documento extranjero. - SIDIAN: Sin identificación del exterior o uso exclusivo de la DIAN. - PEP: Permiso Especial de Permanencia.
    - `identificacion` string: Corresponde a la identificación del empleado al que se le va a ingresar la novedad de libranza.
    - `valor` number, double: Corresponde al valor de la cuota de la libranza del empleado.
    - `numeroVeces` integer: Corresponde a la cantidad de veces que se le cobrara el valor de la cuota de la libranza al empleado.
    - `terceroNit` string: Corresponde a la identificación del contacto de la libranza.
    - `fechaInicioDescuento` string: Corresponde a la fecha de inicio de periodo en la cual se empezará a realizar el descuento. - Pago de nómina mensual, la fechaInicioDescuento es 01/02/2022 - Pago de nómina decadal: - 01/02/2022 - 11/02/2022 - 21/02/2022 - Pago de nómina quincenal: - 01/02/2022 - 16/02/2022
    - `periodoDeduccion` string: Período de deducción - P: Todos los periodos (nómina mensual, quincenal y decadal). - 1P: Primer periodo del mes (1ra Década, 1ra. Quincena). - 2P: Segundo periodo del mes (2da. Década). - UP: Último periodo del mes (3ra. Década, 2da. Quincena).
  - `error` Error: Clase que representa un error con varios detalles.
    - `fecha` string: La fecha del error.
    - `campo` string: El campo asociado con el error.
    - `codigo` string: El código del error.
    - `codigoEstado` integer: El código de estado asociado con el error.
    - `error` string: La descripción del error.
    - `masInfo` object[]: Información adicional sobre el error.
    - `mensaje` string
  - `advertencia` Error: Clase que representa un error con varios detalles.
    - `fecha` string: La fecha del error.
    - `campo` string: El campo asociado con el error.
    - `codigo` string: El código del error.
    - `codigoEstado` integer: El código de estado asociado con el error.
    - `error` string: La descripción del error.
    - `masInfo` object[]: Información adicional sobre el error.
    - `mensaje` string

## 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:** - El tercero Nit no puede aplicarse a la libranza, revisa que sea valido. - El periodo de deducción no puede aplicarse en la periodicidad de pago... - La fecha de inicio novedad debe ser mayor que el último pago del empleado...
- `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)