Ir al contenido principal

Cambio Salarial Administrativo(Actualizar Salario (1)) - [updateSalarialbyEmployee]

🧾 Descripción

Este servicio registra una solicitud de actualización salarial para un empleado.
Envía al ERP los nuevos valores de:

  • Sueldo

  • Movilidad

  • Bono nocturno

  • Fecha de actualización

El servicio solo valida la estructura y los datos requeridos, mientras que el proceso interno de aprobación o registro es manejado por el ERP a través del recurso Cambio Salarial Administrativo.

🚀 Endpoint

POST /update-salarial-by-employee

📥 Request Body (JSON)

Todos los campos son obligatorios.

Campo Tipo Descripción
empleado string ID del empleado
sueldo number Nuevo sueldo propuesto
movilidad number Nuevo monto de movilidad
bono_nocturno number Monto de bono nocturno
fecha string (YYYY-MM-DD) Fecha de aplicación del cambio salarial

Ejemplo de entrada

{ "empleado": "EMP-00123", "sueldo": "1500", "movilidad": "200", "bono_nocturno": "150", "fecha": "2025-01-15" }

🔐 Seguridad

Requiere token válido del ERP (interno), administrado desde:

$this->general->ServiceErp()

🧠 Flujo del Servicio (resumen real)

  1. Valida que se hayan enviado todos los campos requeridos.
    Si falta alguno, retorna error.

  2. Valida formato de fecha usando validateDate().

  3. Construye el body que será enviado al ERP:

{ "empleado": "<id>", "nuevo_sueldo": "<sueldo>", "nueva_movilidad": "<movilidad>", "nuevo_bono_nocturno": "<bono nocturno>", "fecha_de_actualizacion_date": "<fecha>" }

  1. Envía la solicitud al ERP: POST resource/Cambio Salarial Administrativo

  1. Devuelve al cliente el resultado, incluyendo la respuesta del ERP.

📤 Response 200 – Ejemplo exitoso

{ "valor": true, "msn": "¡Excelente! Se ha registrado exitosamente tu solicitud.", "data": { "name": "CSA-00045", "empleado": "EMP-00123", "nuevo_sueldo": "1500", "nueva_movilidad": "200", "nuevo_bono_nocturno": "150", "fecha_de_actualizacion_date": "2025-01-15" } }

❗ Posibles Errores

1. Campos faltantes

{ "valor": false, "msn": "Ingrese los campos requeridos" }

2. Empleado vacío

{ "valor": false, "msn": "Ingrese el empleado" }

3. Sueldo vacío

{ "valor": false, "msn": "Ingrese el sueldo" }

4. Movilidad vacío

{ "valor": false, "msn": "Ingrese la movilidad" }

5. Bono nocturno vacío

{ "valor": false, "msn": "Ingrese el Bono Nocturno" }

6. Fecha inválida

{ "valor": false, "msn": "Ingrese la fecha de actualizacion" }

📚 Schemas

Cambio Salarial Administrativo (ERP)

Body enviado:

{ "empleado": "string", "nuevo_sueldo": "number", "nueva_movilidad": "number", "nuevo_bono_nocturno": "number", "fecha_de_actualizacion_date": "YYYY-MM-DD" }

🗃 Lógica en Pseudocódigo

required = [empleado, sueldo, movilidad, bono_nocturno, fecha] if falta alguno: return error if fecha no válida: return error body = { empleado, nuevo_sueldo: sueldo, nueva_movilidad: movilidad, nuevo_bono_nocturno: bono_nocturno, fecha_de_actualizacion_date: fecha } response = POST ERP Cambio Salarial Administrativo return success with response

No hay comentarios para mostrar

Volver arriba