Permisos de obra
El módulo Permisos de obra permite registrar qué posiciones o tramos de una obra están autorizados, durante qué período y cómo evolucionó la gestión administrativa. El registro global ayuda a detectar vencimientos sin perder la historia de ampliaciones y renovaciones.
Cada permiso se registra para una orden de trabajo (OT). Una OT puede tener varios permisos y el cliente del permiso se obtiene automáticamente de esa relación.
Conceptos principales
| Concepto | Qué representa |
|---|---|
| Permiso | La identidad estable del instrumento: OT, cliente derivado, emisor, formulario, ID SAP y contratista |
| Posición | El tramo o ítem autorizado dentro del permiso |
| Revisión | Una versión que conserva una foto de las ubicaciones, vigencias y documentación |
| Solicitud de renovación | La gestión previa a extender una o más posiciones |
| Permiso relacionado | Un nuevo instrumento emitido como resultado de renovar otro permiso |
Las fechas de vigencia se registran por posición. Por eso un mismo permiso puede tener una posición vigente y otra vencida o próxima a vencer.
Estados visibles
Permiso
| Estado | Significado |
|---|---|
| Borrador | La revisión inicial todavía no fue emitida |
| Activo | Tiene una revisión original emitida y admite nuevas revisiones o solicitudes |
| Anulado | Queda disponible para consulta, sin nuevas revisiones, envíos o resoluciones |
Vigencia de una posición
| Estado | Significado |
|---|---|
| Próximo | La vigencia todavía no comenzó |
| Vigente | Está dentro del período autorizado |
| Próximo a vencer | Está vigente y vence dentro de los próximos 10 días |
| Vencido | La fecha de fin ya pasó |
| Reemplazado | Una revisión posterior sustituyó esa vigencia |
| Sin vigencia | La posición no tiene fechas efectivas disponibles |
El estado siempre aparece acompañado por texto, fechas y días restantes; no depende solamente del color.
Registro global
Ingresá desde Órdenes > Permisos de obra. El listado muestra una fila por posición y vigencia efectiva, con datos del permiso, la OT, la ubicación y el período autorizado.
Podés combinar filtros por:
- OT, nombre o referencia externa;
- cliente, emisor y jurisdicción;
- contratista, formulario o ID SAP;
- posición, tramo, calle y afectación;
- estado de vigencia y próximos vencimientos;
- fechas de inicio, fin y gestión.
Al ingresar, el grupo Marcar próximo a vencer usa por defecto un horizonte de 10 días. Se puede cambiar a 30, 15, 10 o 5 días. Esta selección no agrega ni quita filas: únicamente vuelve a calcular el Estado de vigencia del registro global para destacar las posiciones que vencen dentro del plazo elegido.
Fuera del registro global, una posición se considera Próximo a vencer cuando le quedan 10 días o menos.
La paginación conserva los filtros activos. Los borradores sin una vigencia emitida no aparecen como filas operativas.
En el mismo listado, Borradores pendientes permite recuperar permisos todavía no emitidos, incluso si no tienen posiciones. Tiene búsqueda por formulario o ID SAP y paginación propias, independientes de los filtros de vigencia efectiva. Seleccioná Completar borrador para abrir su detalle. Sólo se muestran permisos de la organización y los clientes a los que tenés acceso.
Registrar un permiso
Antes de comenzar debe existir un emisor activo.
El alta contiene Datos del permiso, incluida la Fecha de envío. Se guarda un borrador vacío, sin posiciones: las ubicaciones y vigencias se completan después desde el detalle, manualmente o con Excel.
- Ir a Órdenes > Permisos de obra.
- Seleccionar Registrar permiso.
- Buscar y seleccionar la OT por Número de Obra, nombre o cliente. El sistema completa el cliente a partir de la OT.
- Seleccionar el emisor activo y completar formulario, ID SAP y contratista cuando correspondan.
- Completar, si se conoce, la Fecha de envío con la fecha en que el emisor envió el archivo con las vigencias de las posiciones. Es opcional y no corresponde al envío de una solicitud al emisor.
- Seleccionar Guardar borrador.
- Desde el detalle, usar Agregar posición o Importar Excel para completar las posiciones.
- Completar las vigencias y adjuntar la documentación requerida para la emisión inicial.
- Resolver los Pendientes para emitir, elegir Revisar y emitir y confirmar con Emitir revisión.
El buscador sólo muestra OTs autorizadas para la organización y los clientes accesibles de la persona usuaria.
El inicio de gestión ocurre al crear el permiso con Guardar borrador; no se carga manualmente. La autorización comienza al Revisar y emitir la revisión, sin ingresar una fecha de autorización. Ese momento es distinto del período de vigencia de cada posición: emitir la revisión no significa que todas sus posiciones estén vigentes ese día.
La OT seleccionada no puede reemplazarse ni quitarse después del alta.
Completar el borrador original
La carga manual y la importación requieren Gestionar e importar posiciones del borrador original. Están disponibles únicamente mientras tanto el permiso como su revisión Original sigan en Borrador. No sirven para modificar revisiones emitidas ni borradores de ampliaciones, renovaciones, correcciones o anulaciones.
Agregar o editar posiciones manualmente
- Abrir el permiso desde Completar borrador o desde la OT.
- Seleccionar Agregar posición en las acciones del permiso, o Agregar manualmente dentro de la card vacía Posiciones del borrador. Esa card también ofrece Importar Excel.
- Completar las filas de la tabla con código, tramo, calle, alturas y afectación. Usar Agregar posición para incorporar más filas y Quitar para descartar una fila antes de guardar.
- Completar Vigencia general desde y Vigencia general hasta, y seleccionar Aplicar a todas para asignar el período a las filas cargadas. Las filas agregadas después toman esa vigencia. Para una excepción, usar Personalizar en la fila; las observaciones se despliegan por separado.
- Seleccionar Guardar posiciones para guardar todo el lote y volver al detalle. Si alguna fila tiene errores, no se guarda ninguna y el formulario conserva los datos para corregirlos.
Para corregir una posición ya guardada, seleccionar Editar posición junto a su código y confirmar con Guardar posición en el formulario individual.
Afectación se elige en un selector con las opciones Vereda, Calzada y Tuneleo; puede dejarse sin seleccionar. El mismo selector se utiliza en las posiciones de revisiones y resoluciones de renovación. Los valores importados en mayúsculas, como VEREDA, se reconocen al editar sin modificar el dato guardado hasta confirmar los cambios.
La posición se identifica con un número entero positivo, obligatorio y único dentro del permiso. No admite letras, decimales, cero ni negativos. Se omiten los espacios externos y los ceros iniciales: 001 y 1 identifican la misma posición. Si agregás un número que ya existe, se actualiza esa posición en lugar de duplicarla. En Editar posición el número es de sólo lectura: no se puede renombrar. Los campos que dejás vacíos borran sus valores anteriores; las demás posiciones se conservan. Este flujo no permite eliminar posiciones. El filtro Posición del registro global y de la OT busca por número exacto.
Podés guardar posiciones con fechas incompletas y retomarlas después. Se admiten vigencias históricas sin límite de antigüedad, tanto al agregar posiciones como al editarlas en el borrador. Si informás ambas fechas, el fin debe ser igual o posterior al inicio. Estas reglas también se aplican al importar.
En el detalle, Posiciones del borrador muestra los datos guardados con estado Borrador y la indicación Sin emitir, no como vigencias efectivas.
La tabla de posiciones del detalle y la tabla de posiciones de cada revisión del Historial de revisiones muestran hasta 10 posiciones por página, con paginadores independientes y orden numérico (1, 2, 10). Cambiar de página en una tabla no cambia las otras ni cierra la revisión que estás consultando. El total de posiciones de la cabecera corresponde al permiso completo.
Pendientes para emitir
Guardar posiciones o confirmar una importación no emite el permiso. Para emitir la revisión original necesitás al menos una posición, un período válido con inicio y fin en todas sus posiciones y cumplir los requisitos documentales de emisión inicial del emisor. La documentación obligatoria no se reemplaza con la planilla de posiciones.
El historial muestra Pendientes para emitir y mantiene Revisar y emitir deshabilitado mientras falten posiciones, fechas válidas o documentación. La pantalla de revisión también bloquea Emitir revisión si quedan pendientes. La validación se repite al emitir, por lo que abrir una URL directa no evita estos controles.
Eliminar un borrador
Si registraste un permiso por error, podés descartarlo con la acción Eliminar borrador mientras siga en Borrador. Necesitás Eliminar borradores de permisos de obra y acceso a su organización y cliente; poder editarlo no habilita por sí solo la eliminación.
- Abrir el permiso desde Borradores pendientes > Completar borrador.
- Seleccionar Eliminar borrador en la cabecera.
- Revisar la confirmación: ¿Eliminar este borrador de permiso de obra? Se eliminarán sus posiciones y documentos adjuntos. La operación quedará registrada en auditoría.
- Seleccionar Continuar, o Cancelar para conservarlo.
Al confirmar se eliminan el permiso, sus posiciones, vigencias en borrador, revisiones en borrador y documentos adjuntos que correspondan a ese borrador, y se vuelve al listado con el mensaje Borrador de permiso de obra eliminado correctamente.
La eliminación se bloquea cuando el permiso ya no está en condiciones de descartarse como borrador. Por ejemplo, no se puede completar si:
- alguna revisión ya no está en borrador;
- existen documentos formalizados;
- existen solicitudes de renovación;
- existen relaciones operativas incompatibles con la eliminación.
Si algo impide completar la operación, se conserva el conjunto completo. Si otra persona ya emitió el permiso, la eliminación se rechaza. Los permisos Activos y Anulados no pueden eliminarse, tampoco con un rol de sistema.
La eliminación queda registrada en Auditoría, disponible para superadministradores, con la persona responsable, fecha y datos de los registros eliminados. Se conserva la auditoría anterior. Esto no es una papelera: los archivos adjuntos eliminados no quedan guardados como copias recuperables en la auditoría.
Importar posiciones desde Excel
Usá esta opción para agregar o actualizar posiciones del borrador original, no para importar la identidad del permiso ni modificar permisos ya emitidos.
Preparar el archivo
La pantalla Importar posiciones sigue la misma organización que la importación de ítems de baremo: una guía desplegable Qué debe contener el archivo, el Paso 1: Descargar la plantilla y el Paso 2: Seleccionar el archivo. Usá Descargar plantilla para obtener el Excel con los encabezados preparados.
- Se admiten XLSX y XLS, hasta 10 MB; no CSV ni imágenes.
- Se lee únicamente la primera hoja, con encabezados en la fila 1 y hasta 1000 filas de datos a continuación, con un máximo de 100 columnas.
- Incluí Posición y sólo las columnas que quieras completar o modificar, en cualquier orden.
- Las filas vacías en todas las columnas reconocidas se omiten. Debe quedar al menos una posición para importar.
- Cada fila con datos debe tener un número de posición entero positivo; no se admiten posiciones repetidas, incluso si se escriben distinto (
001y1). - En las columnas reconocidas, reemplazá las fórmulas por sus valores. Cada texto admite hasta 2000 caracteres.
Estos son los encabezados admitidos; también podés usar sus equivalentes en inglés:
| Encabezado en español | Alternativa admitida | Dato |
|---|---|---|
| Posición | Pos., line_code | Código de posición, obligatorio |
| Tramo | segment | Tramo |
| Calle | street | Calle |
| Altura desde | Alt. Ini, height_from | Altura inicial |
| Altura hasta | Alt. Fin, height_to | Altura final |
| Vigencia desde | Fecha de Inicio Apertura, valid_from | Inicio de vigencia |
| Vigencia hasta | Fecha de Fin Apertura, valid_until | Fin de vigencia |
| Afectación | affectation | Afectación |
| Observaciones | observations | Observaciones |
Los encabezados se reconocen sin distinguir mayúsculas, acentos, espacios, saltos de línea o puntuación. Por ejemplo, Posición, POSICION y posición identifican el mismo dato, al igual que Afectación y AFECTACION. No incluyas dos columnas para el mismo dato, por ejemplo Posición y Pos.: se rechazan como duplicadas. N° Obra, Contingencia / Programado, Contratista, Formulario, ID, Plazo y cualquier columna no reconocida se ignoran; no modifican los datos del permiso. El número de posición se puede cargar como número o como texto numérico en Excel; los ceros iniciales no se conservan.
Fechas del archivo
No es necesario elegir un formato en la pantalla. Cuando la celda contiene una fecha de Excel, el sistema lee su valor automáticamente, independientemente de que Excel la muestre como día/mes/año o mes/día/año.
Si la celda contiene texto, se interpreta como DD/MM/YYYY: 04/05/2026 significa 4 de mayo de 2026. También se aceptan guiones en ese orden (04-05-2026) y texto en formato AAAA-MM-DD. No se adivina el orden de fechas de texto ambiguas. Para importar texto escrito como mes/día/año, convertí esas celdas a fechas reales de Excel o reescribilas como día/mes/año.
Se admiten fechas históricas sin límite de antigüedad, tanto para posiciones nuevas como para actualizar las existentes. Se mantienen los controles de fechas inválidas y fin anterior al inicio. Las fechas pueden quedar incompletas en el borrador, pero deben completarse antes de emitir. La vista previa muestra las fechas como día/mes/año para facilitar su revisión.
Previsualizar y confirmar
- Desde el detalle del borrador, seleccionar Importar Excel.
- Elegir el Archivo Excel en Seleccionar el archivo.
- Seleccionar Previsualizar cambios. Si hay errores, corregir el archivo y volver a cargarlo; la pantalla conserva las instrucciones y el botón de descarga de plantilla.
- En Revisar importación, elegir Nuevas, Con cambios o Sin cambios. Sólo aparecen las categorías presentes en el archivo. La planilla muestra una fila compacta por posición con Tramo, Calle / altura, Vigencia, Afectación y un extracto de Observaciones. Las celdas modificadas están resaltadas y muestran el valor propuesto; las altas no se comparan contra valores vacíos. Todavía no se guardó ningún cambio.
- Usar Buscar código o calle dentro de la categoría elegida y Anterior / Siguiente para recorrer páginas de hasta 20 posiciones. Seleccionar el código de una posición para abrir sus datos completos en un panel fuera de la tabla: lateral en escritorio y encima del listado en móvil. El panel incluye las observaciones completas y, para los campos modificados, los valores Anterior y Propuesto. Cerrar detalle conserva la página y la búsqueda.
- Seleccionar Confirmar importación para aplicar todo el archivo, independientemente de la categoría, búsqueda o página visible, y volver al detalle. Usar Cambiar archivo para volver a la carga y elegir otro Excel, o Cancelar para salir sin aplicarlo. Navegar por la vista previa no renueva su vencimiento.
Qué se conserva y qué se reemplaza
| Contenido del archivo | Resultado al confirmar |
|---|---|
| Posición coincide con un código existente | Actualiza esa posición |
| Posición es un código nuevo | Agrega una posición |
| No se incluye una columna | Conserva el dato existente; no aparece como cambio en el detalle |
| Se incluye una columna con una celda vacía | Borra ese dato; el detalle muestra Vaciar si había un valor guardado |
| No se incluye una posición existente | La conserva sin cambios |
La importación no renombra códigos ni elimina posiciones. Cambiar Posición en la planilla crea otra posición y deja intacta la anterior. Por ejemplo, un archivo con sólo Posición y Calle actualiza la calle de las posiciones indicadas sin tocar sus fechas ni los datos de otras posiciones; una calle vacía borra la calle guardada.
La vista previa está firmada y vence a los 20 minutos. Sólo puede confirmarla la misma persona para el mismo permiso. El sistema comprueba una huella de los datos del borrador: si el permiso, sus posiciones o revisiones cambiaron desde la vista previa, la rechaza como obsoleta y debés volver a cargar el archivo. También rechaza vistas previas alteradas o vencidas y vuelve a comprobar tus permisos y que el original siga en borrador.
La confirmación vuelve a validar los datos. Si alguna posición no cumple las reglas, no se aplica ninguna parte del lote. Revisá el error, corregí el archivo y generá una nueva vista previa.
Posiciones y revisiones
El tipo de revisión o trámite describe cómo evoluciona un permiso; no clasifica el permiso en sí. La revisión inicial es Original. Las revisiones posteriores pueden registrar una Ampliación, Renovación, Corrección o Anulación.
Cada revisión muestra:
- fecha de envío del archivo del emisor con las vigencias;
- persona que la creó y, cuando corresponde, quién la emitió;
- posiciones incluidas, con su ubicación y vigencia;
- documentos y requisitos aplicados en ese momento.
No se solicita cargar el inicio de gestión ni la fecha de autorización al registrar una revisión. El inicio de gestión corresponde a la creación del permiso y la autorización de la revisión comienza al revisarla y emitirla; las fechas de vigencia se registran por posición.
En la carga manual múltiple del borrador original y en los formularios de revisiones posteriores que incluyen varias posiciones, la vigencia general permite asignar el mismo período a todas en una sola acción. Aplicar a todas reemplaza las fechas que tuvieran cargadas; después se pueden editar excepciones con Personalizar en la fila correspondiente. Las posiciones nuevas toman como punto de partida la vigencia general visible. Esto no forma parte del alta vacía ni de la edición individual de una posición.
Las revisiones emitidas no se reemplazan ni se editan. Una modificación se registra mediante otra revisión, de modo que el historial anterior siga disponible.
Una Ampliación puede incorporar nuevas posiciones. Una renovación parcial actualiza solamente las posiciones seleccionadas; las demás conservan su vigencia efectiva.
Editar la fecha de envío de un borrador
La Fecha de envío se edita desde Editar datos, en la cabecera del permiso, junto con formulario, ID SAP y contratista. El campo aparece para las revisiones en Borrador sólo si además de Editar permisos de obra tenés Editar fecha de envío de revisiones de permisos de obra en borrador. Poder editar datos generales o crear y emitir revisiones no habilita por sí solo a cambiar esta fecha.
- Abrir el detalle del permiso.
- Seleccionar Editar datos en la cabecera. No hay un acceso separado desde el historial.
- Ingresar o corregir la fecha, o dejar el campo vacío para borrar la fecha guardada: es opcional.
- Seleccionar Guardar cambios para guardar la fecha junto con los demás datos y volver al detalle. Cancelar vuelve sin guardar cambios.
Si hay varios borradores, cada fecha identifica el número de revisión al que pertenece. Los datos y las fechas se guardan juntos: si una validación falla, no se guarda parcialmente el formulario. Las revisiones siguen en borrador y no cambian sus posiciones, vigencias ni documentos. Para emitirlas se usa por separado Revisar y emitir, con el permiso correspondiente.
Las revisiones emitidas no muestran un campo editable y su fecha de envío no puede modificarse, incluso con un rol de sistema. Sin el permiso específico de fecha, Editar datos permite guardar los datos generales sin alterar las fechas existentes.
Renovar posiciones
- Abrir un permiso activo y seleccionar Solicitar renovación.
- Elegir una o más posiciones y guardar el borrador.
- Mientras siga en Borrador, editar las notas o cambiar las posiciones seleccionadas.
- Adjuntar la documentación requerida para el envío.
- Seleccionar Marcar como enviada. Desde ese momento notas, posiciones y documentos quedan formalizados.
- Cuando llegue la respuesta administrativa, seleccionar Resolver solicitud.
- Elegir un único resultado:
- Revisión del mismo permiso, si el instrumento conserva su identidad.
- Nuevo permiso relacionado, si el organismo emitió otro instrumento.
Enviar una solicitud no modifica las vigencias. Las fechas cambian únicamente cuando la solicitud se resuelve.
Una solicitud puede cancelarse en borrador o después del envío. La cancelación exige un motivo, conserva la trazabilidad y no permite reenviar la misma solicitud; si la gestión debe retomarse, se crea otra.
Documentos protegidos
Para cargar documentación, podés usar Tomar foto desde celular o tablet, o Seleccionar archivos para elegir un PDF o una imagen guardada. Cada campo admite un archivo; una nueva selección reemplaza la anterior antes de guardar. Las fotos deben ser PNG o JPEG y respetar el límite de 10 MB. La cámara está disponible tanto en la carga desde el detalle como en los campos de documentación de revisiones y solicitudes.
Los documentos se cargan dentro del borrador de una revisión o solicitud. Al emitir o enviar:
- se valida la categoría, cantidad, formato y tamaño;
- los requisitos aplicados quedan guardados junto con la operación;
- los archivos se formalizan y ya no pueden reemplazarse, quitarse ni eliminarse;
- la descarga se realiza desde el detalle autorizado del permiso.
Todos los documentos admiten PDF, PNG y JPEG, hasta 10 MB por archivo. Esta política es global: no hay restricciones de formato o tamaño por requisito y las restricciones antiguas ya no se aplican, sin modificar el historial guardado. La categoría, la etapa y la cantidad de archivos siguen dependiendo del requisito. Un rol puede tener acceso al permiso sin tener permiso para cargar o descargar sus documentos.
Configurar emisores y requisitos
Desde Emisores y requisitos se administran organismos de CABA, Provincia o privados y la documentación exigida en cada etapa.
Podés ingresar desde el menú lateral, en Ordenes de Trabajo > Emisores y requisitos, junto a Permisos de obra, o desde el botón Emisores y requisitos del registro global. Ambos accesos se muestran si tenés permiso para listar emisores.
Los emisores nuevos se crean activos. Los formularios de alta y edición permiten completar el nombre y la jurisdicción; editar esos datos no cambia el estado del emisor.
Para cambiar su disponibilidad, abrí el menú de la fila del listado y elegí Desactivar o Activar, según su estado actual. Esta acción requiere el permiso independiente Activar/desactivar emisores de permisos de obra: poder editar un emisor no habilita el cambio de estado. Desactivar impide usarlo en nuevas altas y resoluciones, sin eliminar los permisos ni la historia existente; activar vuelve a habilitarlo.
Cada emisor puede exigir uno o más documentos para estas etapas:
- emisión inicial;
- envío de renovación;
- resolución de renovación.
Para crear o editar un requisito, completá su Nombre, Etapa, Mínimo de archivos, Máximo de archivos y Orden de aparición. Usá un mínimo de 0 si es opcional y dejá el máximo vacío si no tiene límite. Los requisitos nuevos se crean activos; editar sus datos conserva el estado actual.
Para dejar de exigir un requisito, abrí el detalle del emisor y el menú de la fila del requisito en la tabla. Elegí Desactivar; para volver a exigirlo, usá Activar en el mismo menú. El sistema confirma el cambio y vuelve al detalle del emisor. Esta acción requiere el permiso independiente Activar/desactivar requisitos documentales de permisos de obra: poder crear o editar requisitos no habilita el cambio de estado. Para acceder a esta pantalla también necesitás Ver detalle de emisor de permisos de obra.
La clasificación interna la administra el sistema y no se edita en este formulario. Los formatos admitidos y el límite de 10 MB son los mismos para todos los requisitos. Al seleccionar un requisito para cargar documentos, se muestra únicamente su nombre. Cambiar el nombre no desvincula los archivos ya cargados.
Los emisores y requisitos usados se desactivan en lugar de eliminarse. Los cambios afectan borradores y operaciones futuras: una revisión o solicitud formalizada conserva los requisitos que estaban vigentes cuando se emitió o envió.
Alertas de vencimiento
Pehuen genera notificaciones dentro de la aplicación cuando una posición vence en 10, 5, 3 o 0 días. El aviso de 0 días corresponde al mismo día del vencimiento.
Los destinatarios son la persona que creó el permiso y los suscriptores actuales de la OT que todavía tengan acceso al cliente y al permiso. La autorización se vuelve a verificar antes de cada entrega.
No se generan alertas para:
- registros históricos sin OT;
- OTs completadas o abortadas;
- contratos finalizados;
- vigencias reemplazadas;
- personas que ya no tengan acceso.
Cada alerta incluye un acceso al permiso dentro de la organización correspondiente y no se duplica para la misma posición, persona y plazo.
Permisos y alcance de datos
Los permisos de obra tienen acciones independientes para consultar, crear, editar datos del permiso, gestionar e importar posiciones del borrador original, emitir revisiones, gestionar renovaciones, cargar o descargar documentos y administrar configuración. Crear o editar el permiso no habilita por sí solo la carga de posiciones; gestionar posiciones tampoco habilita emitir ni cargar documentación.
Además de esas acciones, la visibilidad siempre se limita a la organización activa y a los clientes asignados al rol. Ocultar un botón en la pantalla no es la única protección: una URL directa no permite acceder a datos de otra organización o cliente.
Consultá Roles y permisos para ver el catálogo completo de acciones.
Relación con la OT
El detalle de una OT incluye la sección Permisos de obra con todos sus permisos y posiciones. Los filtros de esa sección son independientes de los usados para órdenes de ejecución y materiales.
Desde allí se puede abrir el detalle de cada permiso. La administración completa, la búsqueda transversal y los permisos todavía no asignados se consultan desde el registro global.