Skip to main content

Roles y permisos

El sistema de roles te permite controlar quién puede hacer qué dentro de Pehuen. Cada usuario puede tener uno o más roles, y cada rol agrupa un conjunto de acciones que definen los permisos disponibles.

Los roles operan dentro de la organización activa. La misma persona puede tener combinaciones distintas de roles según el tenant desde el que esté trabajando.

Conceptos clave​

Roles​

Un rol es un conjunto de acciones agrupadas bajo un nombre descriptivo. Los usuarios heredan todos los permisos de los roles que tienen asignados.

Ejemplos de roles:

  • Gestor de OT: puede crear, ver y editar órdenes de trabajo
  • Gestor de materiales: acceso completo a stock y movimientos
  • Solo lectura: únicamente ver información sin modificar

Acciones​

Las acciones son los permisos atómicos del sistema. Cada acción representa una operación específica sobre un módulo:

AcciónQué permite
ListarVer el listado de registros
LeerVer el detalle de un registro
CrearAgregar nuevos registros
ActualizarModificar registros existentes
EliminarBorrar registros

Algunos módulos tienen acciones adicionales según su funcionalidad (ej: recibir en movimientos de material, exportar en listados).

El Control de certificación tiene el permiso Ver control de certificación dentro del área Certificación y cobro. Se puede asignar sin habilitar el listado, detalle o edición de PDC; sigue respetando los clientes autorizados en la organización activa.

tip

Al crear un rol, podés usar el botón "Seleccionar todos" en cada módulo para asignar rápidamente todas las acciones de esa sección.

Tipos de roles​

Roles regulares​

Son los que creás y gestionás libremente. Podés:

  • Crear nuevos roles con cualquier combinación de acciones
  • Editar el nombre y las acciones asignadas
  • Activar o desactivar roles
  • Eliminar roles que ya no necesites

Perfil Supervisor​

Al crear un rol, marcá Perfil Supervisor. Este perfil permite ver sus propias órdenes de ejecución (OE), registrar consumos y devoluciones en ellas, crear requerimientos y consultar únicamente los requerimientos que creó. No permite editar OE, procesar requerimientos ni informar pérdidas.

Un administrador debe vincular el usuario al miembro de personal con actividad supervisor de orden, desde Personal → Miembros → Editar → Usuario vinculado. El usuario debe pertenecer a la misma organización y sólo puede tener un miembro de personal activo vinculado por organización.

Al ingresar, el supervisor accede al listado de sus OE. En un requerimiento nuevo, su nombre se asigna automáticamente y no puede cambiarlo. Sin la vinculación de personal no puede crear requerimientos ni acceder a OE asignadas.

Este perfil permite seleccionar cualquier OT de la organización activa al crear requerimientos, sin necesitar un cliente asociado al rol ni una OE asignada. La cuadrilla puede elegirse para el nuevo requerimiento; esto no habilita acceso a otras OE de esa cuadrilla.

No hace falta seleccionar acciones para este perfil. El límite se aplica aunque el usuario tenga otros roles regulares en la organización activa. Los administradores con un rol de sistema conservan su acceso completo. Las restricciones también se verifican al acceder por URL o enviar formularios.

Roles de sistema​

Son roles protegidos, identificados con el badge Sistema. Tienen restricciones especiales:

Operación¿Permitida?
Cambiar nombre❌ No
Modificar acciones❌ No
Desactivar✅ Sí
Eliminar❌ No
Crear nuevos roles de sistema❌ No

Los usuarios que tienen un rol de sistema activo son considerados Super Admin y tienen acceso total a todas las funciones de la aplicación mediante una habilitación automática. Los roles de sistema no necesitan ni conservan acciones asociadas.

Importante

Si se desactiva un rol de sistema, las personas que lo tengan asignado pasarán a contar sólo con los permisos de sus otros roles activos.

Cómo funcionan los permisos​

  1. El sistema verifica qué roles activos tiene el usuario
  2. Recopila todas las acciones de esos roles
  3. Para cada pantalla o botón, verifica si el usuario tiene la acción requerida
  4. Si tiene un rol de sistema activo, tiene acceso total automáticamente

Alcance por organización​

  • El listado y la gestión de roles viven dentro de la organización activa (/organizations/:organization_id/roles).
  • Un rol regular se asigna por organización. Cambiar de organización cambia también el conjunto de roles efectivos del usuario.
  • Los usuarios Super Admin son globales: pueden entrar en cualquier organización, crear nuevas organizaciones y administrar memberships.

Alcance por cliente (autorización)​

Además del alcance por organización, los roles pueden estar asociados a clientes específicos. Esto define el alcance real de los datos dentro del tenant activo:

  • Si un usuario no está autorizado para un cliente, no verá sus contratos, baremos, OTs, OEs y recursos asociados.
  • Aunque tenga permiso de Crear, no podrá crear recursos para clientes no autorizados.
  • Los selectores (por ejemplo, clientes, contratos, baremos u OTs) se filtran automáticamente a los clientes autorizados.

Los usuarios Super Admin no tienen esta restricción.

Ejemplos de alcance en Stock​

  • En movimientos manuales, el selector de depósito origen se limita a depósitos habilitados por permisos y a depósitos con materiales visibles para el usuario.
  • En movimientos de stock, el listado y el detalle dependen de los permisos del módulo y la visibilidad de depósitos/materiales.
  • En movimientos de material, además de los registros ligados a las OTs u OEs autorizadas, se incluyen los movimientos con depósitos de proveedor asociados o atribuidos a clientes permitidos por el rol.
  • Cuando un acceso es rechazado, la pantalla informa el código y la descripción de la acción requerida. Si esa acción ya está asignada, la causa es el alcance del recurso (organización, cliente o registro) y agregar la acción no resolverá el acceso.

Ejemplo práctico​

Un usuario con dos roles:

  • Rol A: Órdenes de trabajo → Listar, Leer
  • Rol B: Órdenes de trabajo → Crear, Actualizar

Resultado: el usuario puede listar, leer, crear y actualizar órdenes de trabajo (la suma de ambos roles).

Gestión de roles​

Crear un rol​

  1. Ir a Administración > Roles
  2. Click en Nuevo rol
  3. Ingresar nombre descriptivo
  4. Seleccionar las acciones por módulo
  5. Guardar

Tutorial: crear un rol y asignar permisos por módulo​

Asignar roles a usuarios​

  1. Elegir primero la organización activa con la que querés trabajar
  2. Ir a Administración > Usuarios
  3. Seleccionar el usuario
  4. En la sección de roles, agregar o quitar los roles necesarios

Tutorial: asignar un rol a un usuario​

note

La pertenencia del usuario a una organización no se resuelve desde esta pantalla. Ese alta o baja se hace desde la vista de organizaciones del usuario y sólo la puede operar un Super Admin.

Editar o eliminar roles​

  • Desde el listado de roles podés acceder al detalle de cada uno
  • El botón Editar permite modificar nombre y acciones de roles regulares. En un rol de sistema sólo se puede cambiar el estado activo
  • El botón Eliminar aparece solo para roles regulares que no estén en uso

Referencia de acciones por módulo​

A continuación se listan todas las acciones disponibles en el sistema, agrupadas por módulo. Estas son las opciones que verás al crear o editar un rol.

Administración​

Usuarios​

PermisoPermite
Ver listado de usuariosAcceder al listado de todos los usuarios del sistema
Ver detalle de usuarioAbrir la ficha completa de un usuario
Editar usuariosModificar datos y roles de usuarios existentes

Exportaciones​

PermisoPermite
Ver listado de exportacionesVer el historial de exportaciones generadas
Ver detalle de exportaciónAcceder a una exportación específica
Crear exportacionesGenerar nuevas exportaciones de datos
Eliminar exportacionesBorrar exportaciones del historial

Localidades​

PermisoPermite
Ver listado de localidadesConsultar las localidades cargadas
Importar localidadesCargar localidades desde un archivo

Clientes​

Clientes​

PermisoPermite
Ver listado de clientesAcceder al listado de clientes
Ver detalle de clienteAbrir la ficha de un cliente
Crear clientesDar de alta nuevos clientes
Editar clientesModificar datos de clientes existentes
Eliminar clientesDar de baja clientes

Centros operativos​

PermisoPermite
Ver listadoConsultar los centros operativos
Ver detalleAbrir la ficha de un centro operativo
CrearDar de alta nuevos centros operativos
EditarModificar centros operativos existentes
EliminarDar de baja centros operativos

Centros de costo​

PermisoPermite
Ver listadoConsultar los centros de costo
Ver detalleAbrir la ficha de un centro de costo
CrearDar de alta nuevos centros de costo
EditarModificar centros de costo existentes
EliminarDar de baja centros de costo

Contactos​

PermisoPermite
Ver listado de contactosAcceder al padrón de contactos de la organización activa
Ver detalle de contactoAbrir la ficha de un contacto
Crear contactosDar de alta nuevos contactos reutilizables
Editar contactosModificar contactos existentes

Contratos​

Contratos​

PermisoPermite
Ver listado de contratosAcceder al listado de contratos
Ver detalle de contratoAbrir la ficha de un contrato
Crear contratosDar de alta nuevos contratos
Editar contratosModificar contratos existentes
Eliminar contratosDar de baja contratos

Seguimiento contractual​

PermisoPermite
Formalizar adendas contractualesRegistrar una nueva adenda con su documentación
Anular adendas contractualesAnular una adenda con motivo y trazabilidad
Finalizar contratosCerrar o rescindir formalmente un contrato
Ver historial contractualConsultar y filtrar los eventos del contrato, incluidas las altas de multas de contrato y OT
Ver y descargar documentación contractual protegidaAcceder a los documentos contractuales autorizados

Multas​

PermisoPermite
Ver listado de multasAcceder al listado dentro de la organización y los clientes autorizados
Ver detalle de multaConsultar datos, importes y trazabilidad de una multa
Crear multasRegistrar multas sobre OE, OT o contratos autorizados
Editar multasCorregir datos antes del primer cambio de estado o asociación con una PDP
Cerrar multasCerrar manualmente una multa Abierta con motivo
Reabrir multasReabrir manualmente una multa Cerrada con motivo
Ver y descargar documentación protegida de multasAcceder a los archivos adjuntos de una multa autorizada

Baremos cliente​

PermisoPermite
Ver listado de baremosConsultar los baremos del cliente
Ver detalle de baremoAbrir un baremo específico con sus items
Crear baremosDar de alta nuevos baremos
Editar baremosModificar baremos existentes
Importar items de baremoCargar items de baremo desde Excel
Eliminar baremosDar de baja baremos

Baremos cuadrilla​

PermisoPermite
Ver listado de baremos de cuadrillaConsultar los baremos para cuadrillas
Ver detalle de baremo de cuadrillaAbrir un baremo de cuadrilla con sus items
Crear baremos de cuadrillaDar de alta nuevos baremos de cuadrilla
Editar baremos de cuadrillaModificar baremos de cuadrilla existentes
Importar itemsCargar items desde Excel
Crear revisiones de baremoGenerar nuevas versiones de un baremo
Gestionar precios por cuadrillaConfigurar, copiar, exportar e importar precios específicos para cada cuadrilla
Eliminar baremos de cuadrillaDar de baja baremos de cuadrilla

Órdenes​

Órdenes de trabajo (OT)​

PermisoPermite
Ver listado de órdenes de trabajoAcceder al listado de OTs
Ver detalle de orden de trabajoAbrir la ficha completa de una OT
Crear órdenes de trabajoDar de alta nuevas OTs
Editar órdenes de trabajoModificar datos de OTs existentes
Eliminar órdenes de trabajoDar de baja OTs
Iniciar órdenes de trabajoPasar una OT de borrador a "En Proceso"
Finalizar órdenes de trabajoMarcar una OT como completada
Abortar órdenes de trabajoCancelar una OT
Actualizar itemsModificar los items de trabajo de una OT
Gestionar personalAsignar o quitar personal de una OT
Gestionar referencias externasAdministrar referencias de sistemas externos

Permisos de obra​

PermisoPermite
Ver listado de permisos de obraConsultar el registro global y los borradores pendientes, incluso sin posiciones, dentro de la organización y los clientes autorizados
Ver detalle de permiso de obraAbrir posiciones, vigencias, revisiones, solicitudes y relaciones de un permiso
Crear permisos de obraRegistrar los datos del permiso y su revisión original en borrador, sin exigir posiciones en el alta
Editar permisos de obraModificar los datos editables y realizar la primera asignación a una OT
Eliminar borradores de permisos de obraDescartar permisos que todavía estén en borrador, siempre que no tengan documentación formalizada ni relaciones operativas que deban conservarse
Gestionar e importar posiciones del borrador originalAgregar o editar posiciones manualmente y previsualizar y confirmar importaciones Excel, sólo mientras el permiso y su revisión original sigan en borrador
Crear y emitir revisiones de permisos de obraGuardar ampliaciones, renovaciones, correcciones o anulaciones y formalizar revisiones
Editar fecha de envío de revisiones de permisos de obra en borradorCargar, corregir o borrar la fecha opcional desde Editar datos, junto con Editar permisos de obra, sin emitir la revisión ni modificar posiciones o documentos
Cargar documentos de permisos de obraAdjuntar archivos a revisiones o solicitudes en borrador
Ver y descargar documentos de permisos de obraConsultar archivos protegidos de permisos autorizados
Crear solicitudes de renovación de permisos de obraSeleccionar posiciones e iniciar una gestión de renovación
Ver solicitudes de renovación de permisos de obraAbrir el detalle y la trazabilidad de una solicitud
Editar solicitudes de renovación de permisos de obraCambiar notas y posiciones mientras la solicitud esté en borrador
Enviar solicitudes de renovación de permisos de obraFormalizar el borrador cuando posiciones y documentos estén completos
Cancelar solicitudes de renovación de permisos de obraCerrar una solicitud en borrador o enviada, indicando un motivo
Resolver solicitudes de renovación de permisos de obraRegistrar una nueva revisión o un permiso nuevo relacionado
Ver listado de emisores de permisos de obraConsultar emisores y sus requisitos documentales
Ver detalle de emisor de permisos de obraAbrir la configuración de un emisor
Crear emisores de permisos de obraRegistrar emisores de CABA, Provincia o privados
Editar emisores de permisos de obraModificar nombre y jurisdicción sin cambiar el estado
Activar/desactivar emisores de permisos de obraCambiar la disponibilidad desde el menú del listado sin eliminar la historia
Crear requisitos documentales de permisos de obraDefinir documentos por emisor y etapa
Editar requisitos documentales de permisos de obraModificar los datos del requisito sin cambiar su estado
Activar/desactivar requisitos documentales de permisos de obraCambiar si se exige un requisito desde el menú de su fila, sin modificar el historial

La gestión de posiciones requiere Gestionar e importar posiciones del borrador original, independientemente de crear o editar el permiso y de crear o editar revisiones. No habilita renombrar códigos, eliminar posiciones, cargar documentos, emitir ni eliminar el borrador completo. Para completar el recorrido desde el listado, asigná también acceso al listado y al detalle; para adjuntar documentación, emitir o descartar borradores, asigná sus acciones respectivas. Consultá Completar el borrador original, Importar posiciones desde Excel y Eliminar un borrador.

Disponibilidad de la nueva acción

La acción Gestionar e importar posiciones del borrador original forma parte del catálogo de permisos. Al actualizar una instalación, el equipo técnico debe sincronizar las acciones antes de asignarla a los roles regulares que deban completar borradores. Los roles de sistema no necesitan acciones asociadas, pero tampoco pueden editar posiciones por este flujo después de la emisión.

La edición de la fecha de envío de una revisión en borrador se integra en Editar datos y requiere tanto Editar permisos de obra como su permiso específico de fecha. Crear y emitir revisiones de permisos de obra no los reemplaza. Las revisiones emitidas siguen siendo inmutables, incluso para roles de sistema. Consultá el recorrido para editar la fecha de envío.

Órdenes de ejecución (OE)​

PermisoPermite
Ver listado de órdenes de ejecuciónAcceder al listado de OEs
Ver detalle de orden de ejecuciónAbrir la ficha completa de una OE
Crear órdenes de ejecuciónDar de alta nuevas OEs asignando trabajo a cuadrillas
Editar órdenes de ejecuciónModificar datos de OEs existentes
Eliminar órdenes de ejecuciónDar de baja OEs
Iniciar órdenes de ejecuciónPasar una OE de borrador a "En Proceso"
Finalizar órdenes de ejecuciónMarcar una OE como completada
Abortar órdenes de ejecuciónCancelar una OE
Editar datos e items de órdenes de ejecución completadasJunto con Editar órdenes de ejecución, corregir la cabecera y gestionar los ítems de una OE completada

Personal y cuadrillas​

Personal​

PermisoPermite
Ver listado de personalAcceder al listado de miembros del personal
Ver detalle de personalAbrir la ficha de una persona
Crear personalDar de alta nuevos miembros
Editar personalModificar datos de personal existente
Eliminar personalDar de baja miembros

Cuadrillas​

PermisoPermite
Ver listado de cuadrillasAcceder al listado de cuadrillas
Ver detalle de cuadrillaAbrir la ficha de una cuadrilla con sus miembros
Crear cuadrillasDar de alta nuevas cuadrillas
Editar cuadrillasModificar cuadrillas existentes
Eliminar cuadrillasDar de baja cuadrillas

Actividades de cuadrilla​

PermisoPermite
Ver listado de actividadesConsultar las categorías de actividades
Crear actividadesAgregar nuevas actividades o subcategorías
Editar actividadesModificar actividades existentes
Eliminar actividadesDar de baja actividades

Propuestas de pago de producción​

PDP​

PermisoPermite
Ver listado de propuestas de pago de producciónConsultar las PDP autorizadas
Ver detalle de propuesta de pago de producciónAbrir una PDP, sus líneas y adjuntos
Crear propuestas de pago de producciónPreparar una PDP en Borrador e incluir descuentos de multas dentro de los clientes autorizados, sin requerir permiso de detalle de multas
Editar propuestas de pago de producciónModificar una PDP mientras permanezca en Borrador, incluidos sus descuentos de multas autorizadas
Eliminar propuestas de pago de producciónDar de baja una PDP
Cerrar propuestas de pago de producciónPasar una PDP revisada a Cerrada
Marcar propuestas de pago de producción como pagadasRegistrar el pago cuando las facturas cumplen la cobertura requerida
Anular propuestas de pago de producciónAnular la propuesta y liberar sus reservas
Descargar PDF de propuestas de pago de producciónObtener el PDF de una PDP autorizada

Materiales​

Proveedores​

PermisoPermite
Ver listado de proveedoresAcceder al listado de proveedores
Ver detalle de proveedorAbrir la ficha de un proveedor
Crear proveedoresDar de alta nuevos proveedores
Editar proveedoresModificar proveedores existentes
Eliminar proveedoresDar de baja proveedores
Importar materialesCargar materiales masivamente para un proveedor

Categorías de materiales​

PermisoPermite
Ver listado de categoríasConsultar el árbol de categorías
Ver detalle de categoríaAbrir la ficha de una categoría
Crear categoríasAgregar nuevas categorías o subcategorías
Editar categoríasModificar categorías existentes
Eliminar categoríasDar de baja categorías
Activar/desactivar categoríasCambiar el estado activo de una categoría

Materiales​

PermisoPermite
Ver listado de materialesAcceder al listado de materiales
Ver detalle de materialAbrir la ficha de un material
Crear materialesDar de alta nuevos materiales
Editar materialesModificar materiales existentes
Eliminar materialesDar de baja materiales
Activar/desactivar materialesCambiar el estado activo de un material
Procesar materiales a granelTransformar materiales bulk (ej: bobina a tramos)

Unidades​

PermisoPermite
Ver listado de unidadesConsultar las unidades de medida
Ver detalle de unidadAbrir la ficha de una unidad
Crear unidadesAgregar nuevas unidades de medida
Editar unidadesModificar unidades existentes
Eliminar unidadesDar de baja unidades
Activar/desactivar unidadesCambiar el estado activo de una unidad

Gestión de stock​

Depósitos​

PermisoPermite
Ver listado de depósitosAcceder al listado de todos los depósitos
Ver detalle de depósitos físicosAbrir la ficha de depósitos de almacenamiento
Ver detalle de depósitos de cuadrillaVer el inventario de una cuadrilla
Ver detalle de depósitos de OTVer los materiales asignados a una OT
Crear depósitos físicosDar de alta nuevos depósitos de almacenamiento
Editar depósitos físicosModificar depósitos existentes
Eliminar depósitos físicosDar de baja depósitos
Gestionar zonasCrear, editar o eliminar zonas dentro de un depósito

Movimientos de material​

PermisoPermite
Ver listado de movimientosAcceder al listado de movimientos de material
Ver detalle de movimientoAbrir la ficha de un movimiento
Crear asignacionesAsignar materiales desde proveedor hacia depósitos y declarar allí las nuevas unidades seriadas
Crear solicitudesSolicitar retiro de materiales para una cuadrilla
Crear movimientos manualesRealizar transferencias libres entre depósitos
Crear registros de pérdidasDocumentar materiales extraviados o dañados
Crear registros de consumoRegistrar materiales instalados o consumidos
Crear devolucionesDevolver materiales no utilizados
Editar movimientosModificar movimientos existentes
Eliminar movimientosDar de baja movimientos
Recibir materialesConfirmar recepción de materiales de un movimiento y generar su remito
Cerrar movimientosCerrar un movimiento y bloquear nuevas entregas/recepciones
Subir PDF firmado de remitosAdjuntar o reemplazar el PDF firmado de un remito
Firmar remitos en pantalla táctilFirmar desde la pantalla y generar el PDF firmado del remito

Movimientos de stock​

PermisoPermite
Ver listado de movimientos de stockAcceder al historial de transferencias individuales
Ver detalle de movimiento de stockVer los datos de una transferencia específica
Ver movimientos de stock valorizadosConsultar y exportar el historial valorizado por período y lote

Otros​

Reportar problema​

PermisoPermite
Reportar un problemaEnviar un reporte de problema desde la aplicación