Pular para o conteúdo

Codificação de documentos técnicos de engenharia: estrutura, padrões e exemplos

A codificação de documentos técnicos de engenharia é a regra que dá a cada desenho, especificação ou memorial um número único e legível. Este guia mostra quais campos compõem o código, como a norma Petrobras N-1710 e a ISO 19650 organizam esses campos e como montar a tabela de codificação do seu projeto.

Resposta curta

Codificação de documentos técnicos de engenharia é o sistema que atribui a cada documento um identificador único, formado por campos em ordem fixa: projeto ou instalação, área ou unidade, disciplina, tipo de documento e número sequencial. Folha e revisão costumam ficar ao lado do código. A regra é definida antes do projeto e registrada num procedimento.

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:

CampoO que identificaExemplo de valorObservação
Projeto ou instalaçãoO empreendimento, a planta ou o contratoP123Definido pelo contratante e igual para todas as empresas do projeto
Área ou unidadeA parte física ou funcional da plantaU200, unidade de utilidadesVem da lista de áreas do projeto
DisciplinaQuem produziu o conteúdo técnicoME para mecânica, EL para elétricaLista fechada, com uma ou duas letras
Tipo de documentoA natureza do documentoDE para desenho, ET para especificação técnica, FD para folha de dadosLista fechada, com definição de cada tipo
SequencialA ordem dentro da série0012Sem significado próprio, só para distinguir
FolhaA página de um documento com várias folhas02/05Quase sempre fora do código, no carimbo
RevisãoO estado do documentoB ou 1Fora 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:

GrupoNome na N-1710FormatoO que identifica
0Identificação do idiomaASó para documentos fora do português, por exemplo I para inglês
1Categoria do documento conforme anexo ABBDuas letras, por exemplo DE desenho, MA manual, RM requisição de material
2Identificação da instalação conforme anexo BCDDD.EEÁrea de atuação, instalação e código de diferenciação geográfica
3Área de atividade conforme anexos C ou EFGGGGUnidade, sistema ou edificação. O F diferencia unidades repetidas
4Classe de serviço, materiais e equipamentos conforme anexos D ou FHHHDisciplina, equipamento ou serviço, por exemplo 200 tubulação
5Origem do documentoIIIQuem emitiu: órgão da Petrobras ou empresa contratada
6SequencialJJJOrdem 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:

CampoNome no anexo nacional do Reino Unido de 2021O que identifica
1ProjetoCódigo único do projeto, usado por toda a equipe
2OriginadorA organização que de fato produziu o conteúdo
3Divisão funcional, antes “volume/sistema”Sistema, zona ou pacote funcional
4Divisão espacial, antes “nível/localização”Pavimento, trecho, seção ou local
5FormaComo a informação é apresentada: M modelo, D desenho, T texto, I imagem
6DisciplinaA disciplina a que o contêiner se refere
7NúmeroSequencial 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?

  1. Liste os documentos previstos. Comece pela lista de documentos do contrato. Ela mostra quais tipos e disciplinas o código precisa cobrir.
  2. 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.
  3. Feche as listas de valores. Cada campo tem uma lista de valores permitidos, com descrição. Valores livres geram variações como MEC, ME e MECAN.
  4. Defina comprimento e separador. Campos de tamanho fixo ordenam bem em planilhas. O traço como separador facilita a leitura.
  5. Decida o que fica fora do código. Folha, revisão, status e número do fornecedor costumam ser atributos.
  6. Publique e controle o procedimento. O procedimento de codificação é um documento controlado, com revisão própria.
  7. 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çãoCampoNº de caracteresValores permitidosExemploQuem mantém a lista
1Projeto4Lista de contratosP123Controle de documentos do contratante
2Área ou unidade4Lista de áreas do projetoU200Engenharia de processo
3Disciplina2Lista de disciplinasMECoordenação de projeto
4Tipo de documento2Lista de tipos com definiçãoDEControle de documentos
5Sequencial40001 a 99990012Gerado pelo EDMS ou pela lista mestra
AtributoFolhalivre01/0502/05Autor do documento
AtributoRevisão1 a 2Conforme procedimento de revisãoBControle 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 .

Perguntas frequentes

A revisão faz parte do código do documento?

Na maioria dos procedimentos, não. O código identifica o documento e a revisão identifica o estado dele. A norma Petrobras N-1710 define o número codificado sem a revisão e remete a emissão e a revisão à norma N-2064. A ISO 19650 trata status e revisão como metadados. Veja o guia de controle de revisão.

Posso usar a estrutura da N-1710 em projetos fora da Petrobras?

Dá para se inspirar na estrutura, mas a própria N-1710 diz que não é permitido usar o formato como se fosse N-1710 sem observar os códigos dos seus anexos. Em projetos de outros clientes, crie uma tabela de codificação própria e documente cada campo.

O que fazer com o número do fornecedor?

Mantenha o número original do fornecedor como atributo e atribua ao documento o código do projeto. Assim a busca funciona pelos dois números e a lista mestra não fica com duplicatas.

Como corrigir códigos errados num acervo antigo?

Faça um mapeamento do código antigo para o novo, guarde o código antigo como atributo e corrija em lote, de preferência durante uma migração de EDMS com validação documento a documento.

Pronto para a próxima auditoria?

30 minutos de conversa. Sem pitch. Queremos entender sua realidade documental antes de falar sobre qualquer solução.

Respondemos em até 1 dia útil. Seus dados não são compartilhados.