Saltar al contenido

Codificación de documentos técnicos de ingeniería: estructura, estándares y ejemplos

La codificación de documentos técnicos de ingeniería es la regla que da a cada plano, especificación o memoria de cálculo un número único y legible. Esta guía muestra qué campos componen el código, cómo los organizan la norma N-1710 de Petrobras y la ISO 19650 y cómo armar la tabla de codificación de su proyecto.

Respuesta corta

La codificación de documentos técnicos de ingeniería es el sistema que asigna a cada documento un identificador único, formado por campos en orden fijo: proyecto o instalación, área o unidad, disciplina, tipo de documento y número correlativo. La hoja y la revisión suelen ir junto al código. La regla se define antes del proyecto, en un procedimiento.

¿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:

CampoQué identificaValor de ejemploObservación
Proyecto o instalaciónEl proyecto, la planta o el contratoP123Lo define el mandante y es igual para todas las empresas del proyecto
Área o unidadLa parte física o funcional de la plantaU200, unidad de serviciosSale de la lista de áreas del proyecto
DisciplinaQuién elaboró el contenido técnicoME para mecánica, EL para eléctricaLista cerrada, de una o dos letras
Tipo de documentoLa naturaleza del documentoDE para plano, ET para especificación técnica, FD para hoja de datosLista cerrada, con definición de cada tipo
CorrelativoEl orden dentro de la serie0012Sin significado propio, solo para distinguir
HojaUna página de un documento de varias hojas02/05Casi siempre fuera del código, en el rótulo
RevisiónEl estado del documentoB o 1Fuera 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:

GrupoNombre en la N-1710, traducidoFormatoQué identifica
0IdiomaASolo para documentos que no están en portugués; por ejemplo E para español, I para inglés
1Categoría del documento según anexo ABBDos letras, por ejemplo DE plano, MA manual, RM requisición de material
2Instalación según anexo BCDDD.EEÁrea de negocio, instalación y código de diferenciación geográfica
3Área de actividad según anexos C o EFGGGGUnidad, sistema o edificio; la F distingue unidades repetidas
4Clase de servicio, materiales y equipos según anexos D o FHHHDisciplina, equipo o servicio, por ejemplo 200 cañerías
5Origen del documentoIIIQuién lo emitió: una unidad de Petrobras o una empresa contratista
6CorrelativoJJJOrden 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:

CampoNombre en el anexo nacional del Reino Unido de 2021Qué identifica
1ProyectoCódigo único del proyecto, usado por todo el equipo
2OriginadorLa organización que efectivamente produjo el contenido
3División funcional, antes “volumen/sistema”Sistema, zona o paquete funcional
4División espacial, antes “nivel/ubicación”Piso, tramo, sección o ubicación
5FormaCómo se presenta la información: M modelo, D plano, T texto, I imagen
6DisciplinaLa disciplina a la que se refiere el contenedor
7NúmeroCorrelativo 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?

  1. Liste los documentos previstos. Parta de la lista de entregables del contrato. Muestra qué tipos y disciplinas debe cubrir el código.
  2. 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.
  3. Cierre las listas de valores. Cada campo tiene una lista de valores permitidos, con descripción. El texto libre genera variantes como MEC, ME y MECAN.
  4. Defina largo y separador. Los campos de largo fijo ordenan bien en planillas; el guion como separador facilita la lectura.
  5. Decida qué queda fuera del código. Hoja, revisión, estado y número del proveedor suelen ser atributos.
  6. Publique y controle el procedimiento. El procedimiento de codificación es un documento controlado, con revisión propia.
  7. 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ónCampoN.º de caracteresValores permitidosEjemploQuién mantiene la lista
1Proyecto4Lista de contratosP123Control documental del mandante
2Área o unidad4Lista de áreas del proyectoU200Ingeniería de procesos
3Disciplina2Lista de disciplinasMECoordinación de ingeniería
4Tipo de documento2Lista de tipos con definiciónDEControl documental
5Correlativo40001 a 99990012Generado por el EDMS o la lista maestra
AtributoHojalibre01/0502/05Autor del documento
AtributoRevisión1 a 2Según procedimiento de revisionesBControl 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 .

Preguntas frecuentes

¿La revisión forma parte del código del documento?

En la mayoría de los procedimientos, no. El código identifica el documento y la revisión identifica su estado. La N-1710 de Petrobras define el número codificado sin la revisión y remite la emisión y revisión a la norma N-2064. La ISO 19650 trata estado y revisión como metadatos. Vea la guía de control de revisiones.

¿Puedo usar la estructura de la N-1710 fuera de Petrobras?

Puede inspirarse en ella, pero la propia N-1710 indica que no se permite usar la estructura como si fuera N-1710 sin aplicar los códigos de sus anexos. Con otros mandantes, arme una tabla de codificación propia y documente cada campo.

¿Qué hago con el número del proveedor?

Mantenga el número original del proveedor como atributo y asigne al documento el código del proyecto. Así la búsqueda funciona con ambos números y la lista maestra no queda con duplicados.

¿Cómo corrijo códigos errados en un archivo antiguo?

Haga una tabla de equivalencia entre el código antiguo y el nuevo, guarde el antiguo como atributo y corrija en lote, idealmente durante una migración de EDMS con validación documento por documento.

¿Listo para la próxima auditoría?

30 minutos de conversación. Sin pitch. Queremos entender su realidad documental antes de hablar de cualquier solución.

Respondemos en 1 día hábil. Sus datos no se comparten.