Ir al contenido principal

Consulta si existe documento del puesto (1, 2,3) - [getDocumentPuesto]

🧾 Descripción

Permite obtener el documento MOF (Manual de Organización y Funciones) asociado a un puesto específico registrado en el ERP, consultando el Doctype Designation.

Este servicio se utiliza para mostrar o validar documentación laboral relacionada al cargo del trabajador.


🚀 Endpoint


GET /get-document-puesto/{puesto}

También puede enviarse como parámetro directo según cómo se defina en routes:


GET /getDocumentPuesto?puesto=OPERADOR

🔐 Seguridad

  • El endpoint no exige autenticación explícita en el código.

  • Se recomienda protegerlo mediante API Token o Middleware según la arquitectura.


📥 Parámetros de Entrada

Query / Path Parameter

Parámetro Tipo Requerido Descripción
puesto string Nombre del Designation cuyo MOF se desea obtener.

📤 Responses

✔️ 200 – Documento encontrado

{ "valor": true, "msn": "Documento encontrado", "data": "<url_o_contenido_del_mof>" }

  • data contiene el valor del campo mof del Doctype Designation.


404 – Documento no encontrado

Se devuelve cuando el puesto no existe o no tiene MOF asociado.

{ "valor": false, "msn": "Documento no encontrado", "data": "" }


🧠 Lógica Interna (Resumen)

  1. Verifica que se haya enviado un nombre de puesto.

  2. Construye una consulta GET hacia: resource/Designation

    Con:

    • filters: [["name","=", puesto]]

    • fields: ["mof"]

  3. Envía la solicitud mediante: ServiceErp("GET", null, body, APICAPACITACION."resource/Designation")

  4. Evalúa la respuesta:

    • Si encuentra registros → devuelve el mof.

    • Si no encuentra → error.


📚 Schema

Response

{ "valor": "boolean", "msn": "string", "data": "string" }


🧪 Ejemplo de Uso (curl)

curl -X GET "https://midominio.com/getDocumentPuesto?puesto=OPERADOR"

Respuesta esperada:

{ "valor": true, "msn": "Documento encontrado", "data": "/files/mof_operador.pdf" }