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 

 Sí 

 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) 

 

 

 Verifica que se haya enviado un nombre de puesto. 

 

 

 Construye una consulta GET hacia:  resource/Designation

 

 Con: 

 

 

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

 

 

 fields : ["mof"] 

 

 

 

 

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

 

 

 

 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" 

 }