¿Qué es la codificación de documentos técnicos?
La codificación de documentos técnicos de ingeniería es la regla que convierte información sobre el documento en un número único. Cada campo del código responde una pregunta: a qué proyecto pertenece el documento, a qué parte de la planta se refiere, qué disciplina lo elaboró, qué tipo de documento es y qué lugar ocupa en su serie.
Un buen código cumple tres funciones. Identifica el documento sin ambigüedad, incluso cuando dos disciplinas hacen documentos con el mismo título. Ordena el archivo, porque documentos parecidos quedan juntos en cualquier listado. Y conecta los controles entre sí: la lista maestra, el transmittal, el rótulo del plano y el registro en el EDMS usan el mismo número.
La codificación es la primera decisión de la gestión documental de ingeniería. Debe existir antes del primer plano y queda escrita en un procedimiento de codificación, parte del plan de control documental de ingeniería del proyecto.
¿Qué campos componen el código de un documento técnico?
No existe un código universal. Cada mandante define el suyo. Aun así, los procedimientos de ingeniería suelen usar los mismos bloques, del más general al más particular:
| Campo | Qué identifica | Valor de ejemplo | Observación |
|---|---|---|---|
| Proyecto o instalación | El proyecto, la planta o el contrato | P123 | Lo define el mandante y es igual para todas las empresas del proyecto |
| Área o unidad | La parte física o funcional de la planta | U200, unidad de servicios | Sale de la lista de áreas del proyecto |
| Disciplina | Quién elaboró el contenido técnico | ME para mecánica, EL para eléctrica | Lista cerrada, de una o dos letras |
| Tipo de documento | La naturaleza del documento | DE para plano, ET para especificación técnica, FD para hoja de datos | Lista cerrada, con definición de cada tipo |
| Correlativo | El orden dentro de la serie | 0012 | Sin significado propio, solo para distinguir |
| Hoja | Una página de un documento de varias hojas | 02/05 | Casi siempre fuera del código, en el rótulo |
| Revisión | El estado del documento | B o 1 | Fuera del código, como atributo |
Al juntar los campos, el plano mecánico número 12 de la unidad de servicios del proyecto P123 quedaría así, en un ejemplo ficticio:
P123-U200-ME-DE-0012, hoja 02, revisión B.
La hoja y la revisión van junto al código, no dentro de él. Si la revisión fuera parte del número, cada nueva revisión crearía un “documento nuevo” en la lista maestra y el historial se perdería.
¿Cómo estructura el código la norma N-1710 de Petrobras?
La N-1710, “Codificação de Documentos Técnicos de Engenharia”, es la norma técnica de Petrobras sobre este tema y una referencia obligada para contratistas y proveedores que trabajan en petróleo y gas en Brasil. La revisión consultada para esta guía es la Rev. N, de abril de 2020, publicada en el portal de proveedores de Petrobras. Se aplica a los documentos técnicos de ingeniería de las instalaciones de la compañía en las fases de proyecto, construcción, montaje, puesta en marcha, operación, inspección, mantenimiento y desmantelamiento, y los proveedores deben usarla según las condiciones de su contrato.
El “número codificado” de la N-1710 tiene siete grupos básicos, ordenados de lo general a lo particular y separados por guiones:
| Grupo | Nombre en la N-1710, traducido | Formato | Qué identifica |
|---|---|---|---|
| 0 | Idioma | A | Solo para documentos que no están en portugués; por ejemplo E para español, I para inglés |
| 1 | Categoría del documento según anexo A | BB | Dos letras, por ejemplo DE plano, MA manual, RM requisición de material |
| 2 | Instalación según anexo B | CDDD.EE | Área de negocio, instalación y código de diferenciación geográfica |
| 3 | Área de actividad según anexos C o E | FGGGG | Unidad, sistema o edificio; la F distingue unidades repetidas |
| 4 | Clase de servicio, materiales y equipos según anexos D o F | HHH | Disciplina, equipo o servicio, por ejemplo 200 cañerías |
| 5 | Origen del documento | III | Quién lo emitió: una unidad de Petrobras o una empresa contratista |
| 6 | Correlativo | JJJ | Orden numérico dentro de la misma combinación de grupos |
La norma trae ejemplos completos. Uno es DE-5285.00-22212-550-PPC-001: categoría DE, de plano; instalación 5285.00, la refinería REVAP; área de actividad 22212, la segunda unidad de coquización retardada; clase 550, de torres; origen PPC, el CENPES; y correlativo 001. Otro, I-FD-3010.95-1220-451-PEP-002, muestra el grupo 0 en uso: la I indica una hoja de datos emitida en inglés.
Tres puntos de la N-1710 suelen generar dudas:
- Los códigos salen de los anexos. La norma indica que no se permite usar la estructura como si fuera N-1710 sin aplicar correctamente sus anexos.
- La revisión no está en el número. La N-1710 trata del número codificado y cita la N-2064, “Emissão e Revisão de Documentos de Projeto”, sobre emisión y revisión de documentos de proyecto, como referencia normativa.
- Los traspasos reinician la revisión. Cuando equipos o sistemas pasan de una instalación a otra, la última revisión de los documentos involucrados debe emitirse como revisión 0, la emisión original, con el código de la instalación de destino.
Para empresas de Chile, Perú, México o Colombia que entran al mercado de petróleo y gas en Brasil, conocer la N-1710 es requisito para entregar documentos a Petrobras.
¿Cómo identifica documentos la ISO 19650?
La ISO 19650 trata de la gestión de la información con BIM en edificación y obras civiles. La parte 2, sobre la fase de entrega de los activos, llama “contenedor de información” a cada archivo. La guía publicada por el UK BIM Framework resume lo que el entorno común de datos (CDE) debe garantizar: cada contenedor tiene un identificador único, basado en una convención acordada y documentada, formada por campos separados por un delimitador, y cada campo toma un valor de una codificación también acordada.
El anexo nacional británico es la referencia más citada para esos campos. En su versión de 2021, los siete campos son:
| Campo | Nombre en el anexo nacional del Reino Unido de 2021 | Qué identifica |
|---|---|---|
| 1 | Proyecto | Código único del proyecto, usado por todo el equipo |
| 2 | Originador | La organización que efectivamente produjo el contenido |
| 3 | División funcional, antes “volumen/sistema” | Sistema, zona o paquete funcional |
| 4 | División espacial, antes “nivel/ubicación” | Piso, tramo, sección o ubicación |
| 5 | Forma | Cómo se presenta la información: M modelo, D plano, T texto, I imagen |
| 6 | Disciplina | La disciplina a la que se refiere el contenedor |
| 7 | Número | Correlativo que hace único el identificador |
La versión de 2021 del anexo británico eliminó los largos recomendados de los campos y cambió el antiguo campo “tipo” por la “forma” de presentación. Por eso todavía circula material anterior con códigos como DR para plano y M3 para modelo 3D. La guía para anexos nacionales del Centre for Digital Built Britain muestra un identificador completo en una línea: 123456-ORG-A1-ZZ-MO-A-0001. Los valores ZZ, para todos, y XX, para ninguno, cubren campos que no aplican.
Una diferencia importante para quien viene de la industria de procesos: en la ISO 19650, estado y revisión son metadatos, no partes del nombre. La misma guía recomienda revisiones con prefijo y dos dígitos, como P01 para versiones preliminares y C01 para versiones contractuales. La guía de control de revisiones compara esta convención con la de letras y números habitual en la ingeniería brasileña.
¿Cómo armar la tabla de codificación de su proyecto?
- Liste los documentos previstos. Parta de la lista de entregables del contrato. Muestra qué tipos y disciplinas debe cubrir el código.
- Elija los campos y su orden. De lo general a lo particular. Menos campos es más fácil de usar; cada campo necesita una razón de búsqueda o de control.
- Cierre las listas de valores. Cada campo tiene una lista de valores permitidos, con descripción. El texto libre genera variantes como
MEC,MEyMECAN. - Defina largo y separador. Los campos de largo fijo ordenan bien en planillas; el guion como separador facilita la lectura.
- Decida qué queda fuera del código. Hoja, revisión, estado y número del proveedor suelen ser atributos.
- Publique y controle el procedimiento. El procedimiento de codificación es un documento controlado, con revisión propia.
- Configure el EDMS. Los campos pasan a ser atributos con listas de valores, y el sistema arma el código o valida lo que se digita.
Plantilla de tabla de codificación
Copie esta estructura en el procedimiento o en la planilla de apoyo:
| Posición | Campo | N.º de caracteres | Valores permitidos | Ejemplo | Quién mantiene la lista |
|---|---|---|---|---|---|
| 1 | Proyecto | 4 | Lista de contratos | P123 | Control documental del mandante |
| 2 | Área o unidad | 4 | Lista de áreas del proyecto | U200 | Ingeniería de procesos |
| 3 | Disciplina | 2 | Lista de disciplinas | ME | Coordinación de ingeniería |
| 4 | Tipo de documento | 2 | Lista de tipos con definición | DE | Control documental |
| 5 | Correlativo | 4 | 0001 a 9999 | 0012 | Generado por el EDMS o la lista maestra |
| Atributo | Hoja | libre | 01/05 | 02/05 | Autor del documento |
| Atributo | Revisión | 1 a 2 | Según procedimiento de revisiones | B | Control documental |
¿Cuáles son los errores más comunes?
- Dar significado al correlativo. Si el 0100 “quiere decir” algo, la serie se acaba antes que el proyecto.
- Poner la revisión en el nombre del archivo y en el código. El resultado son copias con nombres distintos para el mismo documento.
- Reutilizar códigos. Un documento anulado mantiene su código; el número no vuelve a la fila.
- Usar letras que se confunden con números. La N-1710 excluye en algunos campos las letras I y O, justamente para no confundirlas con 1 y 0.
- Recodificar documentos del proveedor sin guardar el número original. Se pierde la trazabilidad con el fabricante.
- Cambiar la regla a mitad del proyecto sin tabla de equivalencia. Documentos antiguos y nuevos dejan de encontrarse en la búsqueda.
Codificación y migración de EDMS
El código es el metadato principal de un archivo de ingeniería. En una migración entre plataformas, como de Meridian a ProjectWise o a Greendocs, cada campo del código necesita un destino definido en el sistema nuevo. Los códigos fuera de estándar aparecen justamente en ese momento.
En el pipeline de migración de EDMS de 29docs, los metadatos se extraen del origen, se normalizan y se validan documento por documento contra reglas de calidad antes de la carga. Solo pasa al destino el lote que cumple los umbrales definidos, y los informes de comparación muestran qué cambió entre origen y destino. Es el tipo de trabajo de organización y estandarización que 29docs hizo para Petrobras al reunir en un solo ambiente Accruent Meridian la ingeniería de tres plantas de fertilizantes, como se describe en el caso de fertilizantes.
Actualizado el .