Ir al contenido principal

Rol de usuario - [rolUsuario]

🧾 Descripción

Valida si un usuario tiene el rol "Supervisor Nacional" dentro del ERP.
Busca en la tabla tabHas Role un registro cuya columna role = 'Supervisor Nacional' y parent = {name_usuario}.


🚀 Endpoint


POST /rol-usuario

La ruta exacta depende de tu archivo routes/api.php.


🔐 Seguridad

  • Recibe el nombre del usuario sin autenticación adicional.

  • Se recomienda incluir autenticación JWT o token de aplicación para mayor seguridad.


📥 Request Body

JSON

{ "name": "string" }

Campos

Campo Tipo Requerido Descripción
name string Nombre interno del usuario en ERPNext (us.name).

🧩 Lógica Interna del Servicio (resumen)

  1. Toma name desde el request.

  2. Construye una consulta SQL hacia ERP que busca:

    • El usuario (rol.parent)

    • El rol "Supervisor Nacional" (rol.role)

  3. Ejecuta:

    • dbErp("POST", body, method/send-query-database)

  4. Si encuentra el rol → retorna verdadero

  5. Si no lo encuentra → indica que no es supervisor

  6. Maneja errores con try/catch.


📤 Responses

✔️ 200 – Usuario es Supervisor Nacional

{ "value": true, "msn": "Listado exitoso", "data": true }

❌ 200 – Usuario NO es supervisor

{ "value": false, "msn": "Usuario no es supervisor", "data": false }

❌ 500 – Error interno al procesar

{ "value": false, "msn": "Mensaje de excepción" }

📚 Schemas

Request

{ "name": "string" }

Response

{ "value": "boolean", "msn": "string", "data": "boolean (solo en éxito o denegado)" }

🧪 Ejemplo de uso (curl)

curl -X POST https://midominio.com/api/rol-usuario \ -H "Content-Type: application/json" \ -d '{"name":"jhon.doe@empresa.com"}'