Ir al contenido principal

Obtiene combos (1) - [combosJobApplicant]

🧾 Descripción

Este servicio obtiene y devuelve todos los combos (listas de valores) necesarios para el registro o postulación de un Job Applicant (Postulante) dentro del sistema.

Los datos se obtienen directamente desde el ERP mediante el método interno getCombo(), que consulta tablas maestras como Country, Branch, Department y Gender.

Además, incluye una lista estática de tipos de documentos admitidos (DNI, Pasaporte, Carnet de Extranjería).

🚀 Endpoint

GET /combos-job-applicant

No requiere parámetros.

🔐 Seguridad

Requiere autenticación válida en la API del ERP, ya que las consultas internas se realizan mediante: $this->getCombo("<Doctype>")

🧠 Flujo del Servicio (resumen real)

  1. Inicializa un arreglo vacío $combo.

  2. Obtiene desde el ERP las siguientes listas:

    • Países → Doctype: Country

    • Sucursales → Doctype: Branch

    • Departamentos → Doctype: Department

    • Género → Doctype: Gender

  3. Agrega una lista fija de tipos de documentos:


    ["DNI", "Pasaporte", "Carnet de Extranjeria"]

  4. Retorna la estructura completa con todos los combos.

  5. En caso de error, devuelve una respuesta controlada.

📥 Request Body

Este servicio no recibe body, ni parámetros.


{}

📤 Response 200 – Ejemplo

{ "valor": true, "msn": "Combos generados correctamente", "data": { "paises": [ { "name": "Peru" }, { "name": "Chile" } ], "sucursales": [ { "name": "Lima" } ], "departamento": [ { "name": "Recursos Humanos" } ], "genero": [ { "name": "Masculino" }, { "name": "Femenino" } ], "documentos": [ "DNI", "Pasaporte", "Carnet de Extranjeria" ] } }

❗ Posibles Errores

1. Error de ejecución o conexión con el ERP

{ "valor": false, "msn": "Error del servidor", "data": { "message": "detalle del error" } }

📚 Schemas (estructuras usadas)

Resultado de getCombo()

El servicio asume que getCombo() devuelve una estructura similar a:

[ { "name": "string" } ]

Lista fija de tipos de documentos:

[ "DNI", "Pasaporte", "Carnet de Extranjeria" ]

🗃 Lógica en pseudo-código

combo = {} combo["paises"] = getCombo("Country") combo["sucursales"] = getCombo("Branch") combo["departamento"] = getCombo("Department") combo["genero"] = getCombo("Gender") combo["documentos"] = ["DNI", "Pasaporte", "Carnet de Extranjeria"] return { valor: true, msn: "Combos generados correctamente", data: combo }

No hay comentarios para mostrar

Volver arriba