O que é codificação de documentos técnicos?
A codificação de documentos técnicos de engenharia é a regra que transforma informações sobre o documento em um número único. Cada campo do código responde a uma pergunta: a que empreendimento o documento pertence, a que parte da planta se refere, qual disciplina o produziu, que tipo de documento é e qual é a sua ordem na série.
Um bom código cumpre três funções. Ele identifica o documento sem ambiguidade, inclusive quando duas disciplinas fazem documentos com o mesmo título. Ele ordena o acervo, porque documentos parecidos ficam lado a lado em qualquer listagem. E ele liga os controles entre si: a lista mestra, a GRD, o carimbo do desenho e o registro no EDMS usam o mesmo número.
A codificação é a primeira decisão da gestão de documentos de engenharia. Ela precisa existir antes do primeiro desenho e fica registrada num procedimento de codificação, que faz parte do plano de controle de documentos de engenharia do projeto.
Quais campos compõem o código de um documento técnico?
Não existe um código universal. Cada contratante define o seu. Mesmo assim, os procedimentos de engenharia costumam usar os mesmos blocos, em ordem do mais geral para o mais particular:
| Campo | O que identifica | Exemplo de valor | Observação |
|---|---|---|---|
| Projeto ou instalação | O empreendimento, a planta ou o contrato | P123 | Definido pelo contratante e igual para todas as empresas do projeto |
| Área ou unidade | A parte física ou funcional da planta | U200, unidade de utilidades | Vem da lista de áreas do projeto |
| Disciplina | Quem produziu o conteúdo técnico | ME para mecânica, EL para elétrica | Lista fechada, com uma ou duas letras |
| Tipo de documento | A natureza do documento | DE para desenho, ET para especificação técnica, FD para folha de dados | Lista fechada, com definição de cada tipo |
| Sequencial | A ordem dentro da série | 0012 | Sem significado próprio, só para distinguir |
| Folha | A página de um documento com várias folhas | 02/05 | Quase sempre fora do código, no carimbo |
| Revisão | O estado do documento | B ou 1 | Fora do código, como atributo |
Juntando os campos, o desenho mecânico número 12 da unidade de utilidades do projeto P123 ficaria assim, num exemplo fictício:
P123-U200-ME-DE-0012, folha 02, revisão B.
Repare que folha e revisão aparecem ao lado do código, não dentro dele. Se a revisão fizesse parte do número, cada nova revisão criaria um “documento novo” na lista mestra e o histórico se perderia.
Como a norma Petrobras N-1710 organiza o código?
A N-1710, “Codificação de Documentos Técnicos de Engenharia”, é a norma técnica da Petrobras para esse tema. A revisão consultada para este guia é a Rev. N, de abril de 2020, publicada no Canal Fornecedor da Petrobras. A norma se aplica aos documentos técnicos de engenharia das instalações da companhia, nas fases de projeto, construção, montagem, comissionamento, operação, inspeção, manutenção e descomissionamento, e deve ser usada pelos fornecedores conforme as condições do contrato.
O “número codificado” da N-1710 tem sete grupos básicos, ordenados do mais geral para o mais particular e separados por traços:
| Grupo | Nome na N-1710 | Formato | O que identifica |
|---|---|---|---|
| 0 | Identificação do idioma | A | Só para documentos fora do português, por exemplo I para inglês |
| 1 | Categoria do documento conforme anexo A | BB | Duas letras, por exemplo DE desenho, MA manual, RM requisição de material |
| 2 | Identificação da instalação conforme anexo B | CDDD.EE | Área de atuação, instalação e código de diferenciação geográfica |
| 3 | Área de atividade conforme anexos C ou E | FGGGG | Unidade, sistema ou edificação. O F diferencia unidades repetidas |
| 4 | Classe de serviço, materiais e equipamentos conforme anexos D ou F | HHH | Disciplina, equipamento ou serviço, por exemplo 200 tubulação |
| 5 | Origem do documento | III | Quem emitiu: órgão da Petrobras ou empresa contratada |
| 6 | Sequencial | JJJ | Ordem numérica dentro da mesma combinação de grupos |
A própria norma traz exemplos completos. Um deles é DE-5285.00-22212-550-PPC-001: categoria DE, de desenho; instalação 5285.00, a REVAP; área de atividade 22212, a segunda unidade de coqueamento retardado; classe 550, de torres; origem PPC, o CENPES; e sequencial 001. Outro, I-FD-3010.95-1220-451-PEP-002, mostra o grupo 0 em uso: a letra I indica uma folha de dados emitida em inglês.
Três pontos da N-1710 costumam gerar dúvida:
- Os códigos vêm dos anexos. A norma diz que não é permitido usar a estrutura do número codificado como se fosse N-1710 sem observar o uso correto dos anexos.
- A revisão não está no número. A N-1710 trata do número codificado e cita a N-2064, “Emissão e Revisão de Documentos de Projeto”, como referência normativa.
- Transferências reiniciam a revisão. Quando equipamentos ou sistemas mudam de instalação, a última revisão dos documentos envolvidos deve ser emitida como revisão 0, a emissão original, com o código da instalação de destino.
Para quem atua em óleo e gás, dominar a N-1710 é pré-requisito para entregar documentos à Petrobras.
Como a ISO 19650 identifica documentos?
A ISO 19650 trata da gestão da informação com BIM em edificações e obras civis. A parte 2, que cobre a fase de entrega dos ativos, chama cada arquivo de “contêiner de informação”. A orientação publicada pelo UK BIM Framework resume o que o ambiente comum de dados (CDE) deve garantir: cada contêiner tem um identificador único, baseado numa convenção acordada e documentada, formada por campos separados por um delimitador, e cada campo recebe um valor de uma codificação também acordada.
O anexo nacional britânico é a referência mais citada para esses campos. Na versão de 2021, os sete campos são:
| Campo | Nome no anexo nacional do Reino Unido de 2021 | O que identifica |
|---|---|---|
| 1 | Projeto | Código único do projeto, usado por toda a equipe |
| 2 | Originador | A organização que de fato produziu o conteúdo |
| 3 | Divisão funcional, antes “volume/sistema” | Sistema, zona ou pacote funcional |
| 4 | Divisão espacial, antes “nível/localização” | Pavimento, trecho, seção ou local |
| 5 | Forma | Como a informação é apresentada: M modelo, D desenho, T texto, I imagem |
| 6 | Disciplina | A disciplina a que o contêiner se refere |
| 7 | Número | Sequencial que torna o identificador único |
A versão de 2021 do anexo britânico removeu os limites recomendados de tamanho dos campos e trocou o antigo campo “tipo” pela “forma” de apresentação. Por isso materiais anteriores, que usam códigos como DR para desenho e M3 para modelo 3D, ainda circulam. A orientação para anexos nacionais publicada pelo Centre for Digital Built Britain mostra o código completo em uma linha: 123456-ORG-A1-ZZ-MO-A-0001. Os valores ZZ, para todos, e XX, para nenhum, servem para campos que não se aplicam.
Uma diferença importante para quem vem da indústria: na ISO 19650, status e revisão são metadados, não partes do nome. O mesmo material de orientação recomenda revisões com prefixo e dois dígitos, como P01 para versões preliminares e C01 para versões contratuais. O guia de controle de revisão compara essa convenção com a de letras e números usada na engenharia brasileira.
Como montar a tabela de codificação do seu projeto?
- Liste os documentos previstos. Comece pela lista de documentos do contrato. Ela mostra quais tipos e disciplinas o código precisa cobrir.
- Escolha os campos e a ordem. Do mais geral para o mais particular. Quanto menos campos, mais fácil de usar. Cada campo precisa ter uma razão de busca ou de controle.
- Feche as listas de valores. Cada campo tem uma lista de valores permitidos, com descrição. Valores livres geram variações como
MEC,MEeMECAN. - Defina comprimento e separador. Campos de tamanho fixo ordenam bem em planilhas. O traço como separador facilita a leitura.
- Decida o que fica fora do código. Folha, revisão, status e número do fornecedor costumam ser atributos.
- Publique e controle o procedimento. O procedimento de codificação é um documento controlado, com revisão própria.
- Configure o EDMS. Os campos viram atributos com listas de valores, e o sistema monta o código ou valida o que foi digitado.
Modelo de tabela de codificação
Copie esta estrutura para o procedimento ou para a planilha de apoio:
| Posição | Campo | Nº de caracteres | Valores permitidos | Exemplo | Quem mantém a lista |
|---|---|---|---|---|---|
| 1 | Projeto | 4 | Lista de contratos | P123 | Controle de documentos do contratante |
| 2 | Área ou unidade | 4 | Lista de áreas do projeto | U200 | Engenharia de processo |
| 3 | Disciplina | 2 | Lista de disciplinas | ME | Coordenação de projeto |
| 4 | Tipo de documento | 2 | Lista de tipos com definição | DE | Controle de documentos |
| 5 | Sequencial | 4 | 0001 a 9999 | 0012 | Gerado pelo EDMS ou pela lista mestra |
| Atributo | Folha | livre | 01/05 | 02/05 | Autor do documento |
| Atributo | Revisão | 1 a 2 | Conforme procedimento de revisão | B | Controle de documentos |
Quais são os erros mais comuns?
- Dar significado ao sequencial. Se o número 0100 “quer dizer” alguma coisa, a série acaba antes do projeto.
- Colocar a revisão no nome do arquivo e no código. O resultado são cópias com nomes diferentes para o mesmo documento.
- Reaproveitar códigos. Um documento cancelado mantém o seu código. O número não volta para a fila.
- Usar letras parecidas com números. A N-1710, em alguns campos, exclui as letras I e O, justamente para evitar confusão com 1 e 0.
- Recodificar o fornecedor sem guardar o número original. A rastreabilidade com o fabricante se perde.
- Mudar a regra no meio do projeto sem tabela de equivalência. Documentos antigos e novos deixam de se encontrar na busca.
Codificação e migração de EDMS
O código é o principal metadado de um acervo de engenharia. Numa migração entre plataformas, como do Meridian para o ProjectWise ou para o Greendocs, cada campo do código precisa de um destino definido no sistema novo. Códigos fora do padrão aparecem justamente nessa hora.
No pipeline de migração de EDMS da 29docs, os metadados são extraídos da origem, normalizados e validados documento a documento contra regras de qualidade antes da carga. Só segue para o destino o lote que atinge os limites definidos, e os relatórios de comparação mostram o que mudou entre origem e destino. Foi esse tipo de trabalho de organização e padronização que a 29docs fez para a Petrobras, ao reunir num só ambiente Accruent Meridian a engenharia de três fábricas de fertilizantes, como descrito no caso de fertilizantes.
Atualizado em .