LOloggro
Novedades

Crear una novedad de libranza.

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.

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

Headers

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.

Request body

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.
identificacionstring

Corresponde a la identificación del empleado al que se le va a ingresar la novedad de libranza.

valornumber double

Corresponde al valor de la cuota de la libranza del empleado.

numeroVecesinteger

Corresponde a la cantidad de veces que se le cobrara el valor de la cuota de la libranza al empleado.

terceroNitstring

Corresponde a la identificación del contacto de la libranza.

fechaInicioDescuentostring

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
periodoDeduccionstring

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).

Example request

{
  "tipoIdentificacion": "CC",
  "identificacion": "123456789",
  "valor": 1500,
  "numeroVeces": 12,
  "terceroNit": "900123456",
  "fechaInicioDescuento": "01/02/2022",
  "periodoDeduccion": "1P"
}

Response

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

Example response

{
  "contenido": {
    "tipoIdentificacion": "CC",
    "identificacion": "123456789",
    "valor": 1500,
    "numeroVeces": 12,
    "terceroNit": "900123456",
    "fechaInicioDescuento": "01/02/2022",
    "periodoDeduccion": "1P"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.