Ir al contenido principal

Verifica los documentos descargados (1, 2) - [verifyDownloadedDocuments]

Descripción

Este servicio valida si un empleado ha completado la descarga obligatoria de documentos institucionales dentro del aplicativo.
Además, verifica si el empleado ha registrado previamente sus documentos de ingreso (elección de banco, declaración de AFP/ONP, etc.).

El proceso consulta tanto ERPNext como la base de datos MySQL2 para construir un resumen de los documentos descargados y determinar si el empleado tiene todos los documentos obligatorios descargados.


Parámetros

Parámetro Tipo Descripción
$employee string Código del empleado (Employee.name) que se va a validar.

Proceso general

  1. Validación inicial de datos del empleado

    • Realiza una consulta a ERPNext para obtener los campos:

      • eleccion_banco

      • afiliado_fondo_pensiones

      • elección_fondo_pensiones

    • Si el empleado no existe, devuelve un error.

  2. Validación de documentos de ingreso

    • Antes de validar documentos descargados, se comprueba que el empleado ya subió sus documentos de ingreso.

    • Si falta alguno de estos:

      • Elección de banco

      • Si está afiliado o no al fondo de pensiones

      • Selección AFP u ONP

      → Se retorna:
      "Primero suba los documentos de ingreso"

  3. Obtención del historial de descargas

    • Consulta la tabla historial_procesos_app en MySQL2.

    • Se recuperan registros para los procesos:

      • descargaContratoTrabajo

      • descargaReglamentoInternoTrabajo

      • descargaRecomentacionesSST

      • descargaConvenioDescuento

      • descargaDeclaracionJuradaDomicilio

      • descargadeclaracionJuradaSNPSPP

      • descargaPoliticasSalariales

      • registroEPP

      • descargaPETSAlmacenamiento

      • descargaPETSManipulacion

      • descargaMOF

      • descargaPoliticasDescuentosPorDanios

  4. Construcción del resumen por empleado

    • Cada documento es asignado como:

      • 1 → descargado

      • 0 → pendiente

  5. Validación del 100% de documentos

    • Si todos los procesos están registrados → total_documentos = true

    • Si falta alguno → total_documentos = false

  6. Validación adicional: Cambio de modalidad

    • Si el empleado tiene alguna "Solicitud de Cambio de Modalidad" aprobada (docstatus != 2), se considera descargado automáticamente el contrato de trabajo.

  7. Retorno final del estado del empleado


Respuesta exitosa

{ "valor": true, "data": { "empleado": "EMP-001", "descargaContratoTrabajo": 1, "descargaReglamentoInternoTrabajo": 1, "descargaRecomendacionesSST": 0, "descargaConvenioDescuento": 1, "descargaDeclaracionJuradaDomicilio": 1, "descargaDeclaracionJuradaSNPSPP": 0, "descargaPoliticasSalariales": 1, "registroEPP": 1, "descargaPETSAlmacenamiento": 1, "descargaPETSManipulacion": 1, "descargaMOF": 1, "descargaPoliticasDescuentosPorDanios": 1, "total_documentos": false } }


Posibles respuestas con error

● Empleado no encontrado

{ "valor": false, "msn": "Empleado sin datos" }

● Documentos de ingreso no completados

{ "valor": false, "msn": "Primero suba los documentos de ingreso" }