--- title: "Crear Reporte de Labores" method: POST path: "/reporteLabores" tags: ["Transacciones"] --- # Crear Reporte de Labores `POST /reporteLabores` ## Request - Base URL: `https://api.loggro.com/apik/loggro-sipe` - URL: `https://api.loggro.com/apik/loggro-sipe/reporteLabores` - Auth: HTTP bearer Permite registrar, para uno o varios empleados, una o varias novedades de reporte de labores (vacaciones, incapacidad, día libre/permiso, licencia o suspensión) en el sistema. Cada petición puede contener un único empleado o un arreglo de empleados, cada uno con su lista de novedades. Si una novedad presenta un error, no se guardará ninguna de las novedades asociadas al empleado. Sin embargo, el proceso continuará con el siguiente empleado. La compañía se obtiene automáticamente de la sesión del usuario autenticado. ## Request body - union - object - `empleado` string, required: Código del empleado. - `novedades` NovedadReporteLaboresDatosEntrada[], required: Novedades de reporte de labores a insertar para el empleado. - `tipoNovedad` 'V' | 'I' | 'D' | 'L' | 'S', required: Tipo de novedad: V (Vacaciones), I (Incapacidad), D (Día libre-Permiso), L (Licencia), S (Suspensión). - `fechaInicial` string, dd/MM/yyyy, required: Fecha inicial de la novedad (formato dd/MM/yyyy). - `fechaFinal` string, dd/MM/yyyy, required: Fecha final de la novedad (formato dd/MM/yyyy). - `formaLiquidacion` 'P' | 'C': Forma de liquidación: P (Por periodo), C (Completa). Opcional. Si no se informa se asigna P. - `fechaInicialReal` string, dd/MM/yyyy: Fecha inicial real de la novedad (formato dd/MM/yyyy). Opcional. Si no se informa se asigna la fecha inicial de la novedad. - `fechaFinalReal` string, dd/MM/yyyy: Fecha final real de la novedad (formato dd/MM/yyyy). Opcional. Si no se informa se asigna la fecha final de la novedad. - `contingenciaIncapacidad` string: Contingencia de la incapacidad. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad). Si no se informa se asigna ENFGE (Enfermedad general). - `numeroIncapacidad` string: Número de la incapacidad. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad). Si no se informa se asigna 000. - `diagnosticoIncapacidad` string: Diagnóstico de la incapacidad. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad). Si no se informa se asigna uno aleatorio. - `prorrogaIncapacidad` 'S' | 'N': Indica si la incapacidad es una prórroga. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad). S (Si), N (No). Si no se informa se asigna N. - `numeroIncapacidadProrroga` string: Número de la incapacidad que se está prorrogando. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad) y Prórroga de incapacidad es S (Si). - ReporteLaboresEmpleadoDatosEntrada[] - `empleado` string, required: Código del empleado. - `novedades` NovedadReporteLaboresDatosEntrada[], required: Novedades de reporte de labores a insertar para el empleado. - `tipoNovedad` 'V' | 'I' | 'D' | 'L' | 'S', required: Tipo de novedad: V (Vacaciones), I (Incapacidad), D (Día libre-Permiso), L (Licencia), S (Suspensión). - `fechaInicial` string, dd/MM/yyyy, required: Fecha inicial de la novedad (formato dd/MM/yyyy). - `fechaFinal` string, dd/MM/yyyy, required: Fecha final de la novedad (formato dd/MM/yyyy). - `formaLiquidacion` 'P' | 'C': Forma de liquidación: P (Por periodo), C (Completa). Opcional. Si no se informa se asigna P. - `fechaInicialReal` string, dd/MM/yyyy: Fecha inicial real de la novedad (formato dd/MM/yyyy). Opcional. Si no se informa se asigna la fecha inicial de la novedad. - `fechaFinalReal` string, dd/MM/yyyy: Fecha final real de la novedad (formato dd/MM/yyyy). Opcional. Si no se informa se asigna la fecha final de la novedad. - `contingenciaIncapacidad` string: Contingencia de la incapacidad. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad). Si no se informa se asigna ENFGE (Enfermedad general). - `numeroIncapacidad` string: Número de la incapacidad. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad). Si no se informa se asigna 000. - `diagnosticoIncapacidad` string: Diagnóstico de la incapacidad. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad). Si no se informa se asigna uno aleatorio. - `prorrogaIncapacidad` 'S' | 'N': Indica si la incapacidad es una prórroga. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad). S (Si), N (No). Si no se informa se asigna N. - `numeroIncapacidadProrroga` string: Número de la incapacidad que se está prorrogando. Opcional. Se informa solo si Tipo de novedad es I (Incapacidad) y Prórroga de incapacidad es S (Si). ## Response `201` Todas las novedades fueron insertadas correctamente - ReporteLaboresEmpleadoRespuesta[] - `identificacion` string: Código del empleado. - `operacionExitosa` boolean: Indica si todas las novedades del empleado fueron procesadas correctamente. - `mensaje` string: Mensaje general del resultado. Se informa cuando operacionExitosa es true, o cuando es false por un error general no asociado a una novedad específica (p. ej. estructura de JSON inválida o error inesperado del servidor). - `data` NovedadReporteLaboresRespuesta[]: Detalle de las novedades que fallaron. Se informa únicamente cuando operacionExitosa es false y el error está asociado a una o más novedades específicas del empleado. - `identificacion` string, nullable: Tipo de novedad informado. Es nulo cuando el error no puede asociarse a una novedad puntual (p. ej. estructura del JSON inválida). - `operacionExitosa` boolean: Indica si la novedad fue insertada correctamente. - `mensaje` string: Mensaje con el resultado de la inserción de la novedad. ## Other responses - `400`: Error en la validación de los parámetros o una o más novedades fallaron en la inserción - `404`: Recurso no encontrado - `500`: Error interno inesperado en el servidor --- [API](https://skmtc.dev/loggro/apis/n-mina-sipe.md) - [All operations](https://skmtc.dev/loggro/apis/n-mina-sipe/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/n-mina-sipe/revisions/9ba6443587a2?raw)