Guia Completo — Fase Envia: Materiais Extrusados (Fase EX)

Audiência: Equipe de Master Data (analistas SAP — sem necessidade de conhecimento técnico de programação) Atualizado em: 2026-05-15 Fixes aplicados: ver docs/fase-envia/CHANGELOG-FIXES.md Spec de referência: Comparativo - Regras Carga Extrusado V1 vs V2.md (Caroline Macedo, 12/05/2026)

Atualizações V2 aplicadas (2026-05-15)

Correções críticas aplicadas (2026-05-08)

1. O que é este sistema e para que serve

O MD Agent Amcor automatiza o cadastro de materiais no SAP. Hoje, preencher os ~80 campos de uma ficha de material no SAP exige que o analista leia o chamado do ServiceNow, consulte planilhas de referência (V21), interprete regras de nomeação PDM e preencha manualmente uma planilha WinShuttle — processo que leva em média 8 dias e é altamente suscetível a erros humanos.

O sistema:

1. Lê os dados do chamado ServiceNow (RITM) e das extrações XLSX que o ServiceNow exporta.
2. Consulta o banco de dados de hierarquia de produto (BD_HIERARQUIA, originado da planilha V21).
3. Resolve automaticamente todos os campos que seguem regras fixas ou derivadas.
4. Sinaliza em amarelo os campos que foram gerados mas precisam de atenção, e em vermelho os que o analista deve preencher manualmente.
5. Gera o arquivo CARGA ENVIA (template V21) pronto para o WinShuttle executar os 6 scripts SAP.

2. Escopo: o que é "Extrusado" (Fase EX)

A fase EX cobre materiais cujo processo produtivo é extrusão — o filme ou chapa é formado por fusão e extrusão de resina plástica, sem impressão ou laminação adicional nesta etapa de cadastro.

O sistema identifica automaticamente um material como EX quando o campo "Tipo de Cadastro" do chamado ServiceNow contém um dos seguintes valores (sem distinção de maiúsculas/minúsculas):

Se o tipo de cadastro for qualquer outro valor (ex.: "Impresso", "Laminado", "FERT Acabado"), o sistema utiliza o pipeline com inteligência artificial (IA), que está fora do escopo deste guia.

3. Inputs necessários

O sistema precisa de três fontes de dados para resolver os campos EX. Todas devem estar carregadas no banco de dados antes de iniciar o pipeline.

3.1 Extração Envia (XLSX ServiceNow — aba EXTRAÇÃO)

Planilha exportada pelo ServiceNow para cada chamado. Carregada via tela Upload RITMs do sistema.

Atenção sobre Centro / Planta: o campo no XLSX pode aparecer como 4015 - Planta Jundiaí ou simplesmente 4015. O sistema extrai apenas os 4 primeiros dígitos numéricos. Se o campo estiver vazio ou em formato inesperado, EX_CENTRO e EX_DEPOSITO ficarão amarelos e precisarão de intervenção.

3.2 Extração PCM (XLSX ServiceNow — aba EXTRAÇÃO2)

Segunda planilha exportada pelo ServiceNow, com dados do PCM (Process & Cost Manager).

Relação RITM ↔ PCM: A Extração PCM é indexada pelo número da TASK (não do RITM). O sistema busca automaticamente a TASK a partir do RITM antes de consultar o PCM.

3.3 BD_HIERARQUIA (banco de dados interno)

Tabela ref_bd_hierarquia, originada da sheet BD_HIERARQUIA&GRAMATURA da planilha V21 (22.343 linhas). A chave de busca é o TCH ID informado no chamado ServiceNow.

O que o sistema retorna por TCH:

O que acontece se o TCH não for encontrado no BD_HIERARQUIA: Os campos construction, description, specification e sled ficarão nulos. Como consequência:

• EX_TEXTO_CURTO e EX_TEXTO_LONGO ficam amarelos (tipo de filme e espessura não identificados).
• EX_PRAZO_VALIDADE fica amarelo.
• EX_TRADENAME fica vermelho (aguarda preenchimento manual). Ver seção 9 (FAQ) para resolução.

4. O que o sistema resolve automaticamente

4.1 Campos fixos (sempre os mesmos para qualquer EX)

Estes valores não dependem de nenhum dado do chamado — são constantes da fase EX Amcor.

Todos aparecem em verde na tela de revisão.

4.2 Campos derivados (calculados com base nos dados do chamado)

4.3 Mapeamento Centro → Depósito

Se o centro não estiver nesta tabela, EX_DEPOSITO ficará amarelo.

4.4 Regra de geração da descrição SAP

A descrição SAP é gerada em dois formatos: Texto Curto (máx. 40 caracteres, para o campo nome do material no SAP) e Texto Longo (sem limite, para campo de descrição completa).

Estrutura Texto Curto:

EX [AMD/AMV/AMP] FLM [TipoFilme] [Cor] [NomeComercial] [Espessura]u [Largura]MM

Estrutura Texto Longo:

EXTRUSAO [AMOSTRA DE DESENVOLVIMENTO/VENDA/PROCESSO] FILME [TipoFilme longo] [Cor] [NomeComercial] [Espessura]MICRA [Largura]MILIMETROS

Como o Tipo de Filme é classificado (a partir do campo construction do BD_HIERARQUIA):

Como a espessura é extraída (a partir do campo description do BD_HIERARQUIA): O sistema busca um padrão como 120µm ou 120 µm no campo description. Exemplos: 120µm → texto curto 120u, texto longo 120MICRA.

Como o Nome Comercial é formatado (a partir do campo specification do BD_HIERARQUIA):

• Especificações iniciadas com A ou S (ex.: A123-45) → corta no primeiro -: resulta em A123
• Especificações iniciadas com X ou W (ex.: X45-67) → remove todos os -: resulta em X4567
• Demais: usa o valor como está

Quando o Texto Curto fica amarelo:

• Se o tipo de filme não foi identificado (construction vazio ou estrutura desconhecida), OU
• Se a espessura não foi encontrada no campo description, OU
• Se o texto gerado ultrapassaria 40 caracteres (o sistema trunca, mas sinaliza para revisão)

O campo Texto Curto é sempre truncado para 40 caracteres se necessário — o analista deve verificar se o truncamento comprometeu o significado.

5. Aplicabilidade dos campos de extração ServiceNow (V2 §5)

A versão V2 da especificação (Caroline Macedo, 12/05/2026) introduz um mapeamento formal de aplicabilidade para os campos das duas extrações do ServiceNow no contexto de materiais extrusados. Fonte: Comparativo - Regras Carga Extrusado V1 vs V2.md.

Para detalhes completos campo a campo consulte docs/fase-envia/APLICABILIDADE-EXTRUSADO.md.

5.1 Resumo EXTRAÇÃO (31 campos)

14 campos aplicáveis — o sistema lê e usa estes campos:

O campo "Material será exportado?" (campo 16 na lista da V2) está entre os 17 não aplicáveis. O sistema força EX_GRUPO_EXP_IMP = DOM para todos os extrusados. Se o chamado vier marcado como exportado=true, a tela de revisão exibe um aviso amarelo mas não altera o valor.

5.2 Resumo EXTRAÇÃO2 (12 campos)

4 campos aplicáveis:

Os 8 campos não aplicáveis incluem: Peso/espessura, Nome do Cliente, TCH1 CFINT, TCH2 CFEXT, NCM1, NCM2, Centro expandido (versão EXTRAÇÃO2) e Diâmetro da Bisnaga.

5.3 Painel "Não Aplicável" na tela de revisão

Os campos filtrados pelo sistema (sentinela ServiceNow-NA, valor \ no XLSX) são exibidos em um painel colapsável "Campos Não Aplicáveis" na tela /revisao-envia. O painel está recolhido por padrão — clique para expandir e verificar quais campos foram filtrados. Atualmente 15 campos compõem este conjunto (inclui campos WinShuttle-NA históricos + campos V2-NA adicionados pelas migrations 005 e 006).

5a. Campos que precisam de preenchimento manual

Apenas dois campos são sinalizados como vermelhos (obrigatoriamente manuais) na fase EX:

Importante: Campos vermelhos impedem a geração do XLSX final. O botão "Aprovar" só fica disponível após todos os campos vermelhos serem preenchidos na tela de revisão.

Nota sobre EX_PRAZO_VALIDADE (V2 §4.43): Este campo é amarelo (não vermelho) — é gerado automaticamente a partir do SLED do BD_HIERARQUIA mas sempre requer confirmação. Quando o SLED está ausente para o TCH, a tela de revisão exibe um callout âmbar com a instrução: "Consultar ERP Entry Report (ERC-721) — Visualizador de Relatórios". Neste caso o analista deve acessar o relatório ERC-721 e preencher o valor manualmente antes de aprovar.

6. Output: o arquivo XLSX gerado

Após aprovação, o sistema gera um arquivo Excel chamado {execId}_CARGA_ENVIA.xlsx, cópia do template oficial 01. TEMPLATE ENVIA CARGA V21.xlsx.

Estrutura do arquivo

O arquivo possui 9 abas (sheets):

Onde os dados EX ficam na aba CARGA ENVIA

Os dados são escritos na linha 3 da aba CARGA ENVIA. As colunas 4 a 9 (D a I) são reservadas para logs do WinShuttle Studio e nunca são modificadas pelo sistema.

7. O sentinela \ do WinShuttle — o que significa

O WinShuttle não entende células vazias da mesma forma que entende um campo "a ser ignorado". Para campos que não se aplicam ao tipo de material EX (como código de cliente, canal de distribuição, texto de vendas, etc.), o sistema preenche com o caractere barra invertida \.

Esse é o sentinela WinShuttle: significa "deixe este campo em branco no SAP, não tente preencher". Se a célula fosse deixada vazia, o WinShuttle poderia interpretar como um erro ou tentar preencher com o valor anterior.

Na tela de revisão do sistema, esses campos aparecem em cinza com o texto "N/A".

Campos que recebem \ na fase EX:

8. Fluxo passo a passo — do RITM ao XLSX

1. Upload dos CSVs/XLSX ServiceNow
   └─ Tela: Upload RITMs
   └─ O sistema carrega Extração Envia (extracao_envia) e Extração PCM (extracao_pcm) no banco

2. Iniciar pipeline para o RITM
   └─ Tela: Painel de RITMs → botão "Gerar Envia"
   └─ O sistema envia requisição para o pipeline

3. Leitura dos dados do ServiceNow [automático]
   └─ Lê extracao_envia e extracao_pcm do banco pelo RITM
   └─ Verifica se é fase EX pelo campo "Tipo de Cadastro"

4. Consulta BD_HIERARQUIA [automático]
   └─ Busca o TCH ID na tabela ref_bd_hierarquia
   └─ Retorna: description, construction, specification, sled, gramatura, machine_type

5. Resolução dos campos EX [automático — sem IA]
   └─ Aplica todas as regras descritas nas seções 4 e 5
   └─ Gera campos com cor verde, amarelo ou vermelho

6. Persistência no banco [automático]
   └─ Salva todos os campos resolvidos na tabela envia_fields
   └─ Estado do RITM muda para ENVIA_PREPARED

7. Tela de revisão
   └─ Tela: Revisão Envia
   └─ Verde: campo ok — sem ação necessária
   └─ Amarelo: campo gerado mas precisa revisão — analista verifica e confirma ou edita
   └─ Vermelho: campo vazio — analista DEVE preencher antes de aprovar
   └─ Cinza (N/A): campo não aplicável para EX — preenchido com \ automaticamente

8. Aprovação
   └─ Botão "Aprovar" disponível somente quando não há campos vermelhos pendentes
   └─ Ao aprovar, o sistema gera o arquivo XLSX

9. Geração do XLSX [automático após aprovação]
   └─ Copia o template V21 (nunca modifica o original)
   └─ Preenche aba EXTRAÇÃO, EXTRAÇÃO2, CRIAÇÃO e CARGA ENVIA
   └─ Salva em output/winshuttle/{execId}_CARGA_ENVIA.xlsx
   └─ Estado do RITM muda para AWAITING_WINSHUTTLE_RUN

10. WinShuttle (manual — fora do sistema)
    └─ Analista abre o XLSX no WinShuttle Studio
    └─ Executa os 6 scripts em sequência:
       1. MM01_FERT_HALB   — cria o material
       2. MM01_EXPANSÃO_CANAL — expande visões de vendas
       3. VD51             — vincula ao cliente
       4. MM01_ZPHM        — preenche dados técnicos
       5. MMSC             — atribui depósito
       6. MM02_ALTERACAO   — alterações complementares
    └─ Após execução, estado vai para ENVIA_DONE

9. FAQ — Problemas comuns

"O TCH não foi encontrado no BD_HIERARQUIA"

Sintoma: EX_TEXTO_CURTO e EX_TEXTO_LONGO aparecem amarelos com descrição incompleta (sem tipo de filme e sem espessura). EX_PRAZO_VALIDADE e EX_TRADENAME ficam amarelos/vermelhos.

Causa: O número TCH informado no chamado ServiceNow não existe na tabela ref_bd_hierarquia.

Resolução:

1. Verificar se o TCH foi digitado corretamente no chamado ServiceNow (sem espaços, sem caracteres extras).
2. Se o TCH for novo (não cadastrado ainda), solicitar ao PCM que inclua na planilha V21 e recarregue o BD_HIERARQUIA (bun run db:seed).
3. Como solução de contorno: preencher os campos amarelos manualmente na tela de revisão.

"EX_CENTRO está amarelo"

Causa: O campo "Centro / Planta" da Extração Envia está vazio ou em formato não reconhecido (não começa com 4 dígitos numéricos).

Resolução: Preencher manualmente na tela de revisão com o código de 4 dígitos da planta (ex.: 4015). O depósito correspondente será derivado automaticamente se o centro fizer parte da tabela de mapeamento.

"EX_DEPOSITO está amarelo mas EX_CENTRO está verde"

Causa: O centro SAP preenchido não consta na tabela de mapeamento Centro → Depósito (seção 4.3).

Resolução: Preencher EX_DEPOSITO manualmente com o código do depósito SAP correspondente. Informar o time técnico para que o mapeamento seja incluído no sistema.

"EX_TEXTO_CURTO está amarelo mesmo com TCH encontrado"

Possíveis causas:

• O campo construction do TCH não contém nenhuma das palavras-chave reconhecidas (PE, PA, PP, EVOH, NYLON, LDPE, LLDPE, HDPE). O sistema não consegue classificar o tipo de filme.
• O campo description do TCH não contém um padrão de espessura em µm. O sistema não consegue extrair a espessura.
• O texto gerado ultrapassa 40 caracteres e foi truncado.

Resolução: Revisar o texto gerado na tela de revisão. Editar se necessário para garantir que o significado técnico foi preservado e que tem no máximo 40 caracteres.

"O campo EX_TRADENAME está vermelho e não sei o que colocar"

Resolução: Abrir a ficha técnica do TCH no sistema SMS, localizar o campo "Tradename" (nome comercial/marca do produto). Preencher exatamente como consta na ficha. Exemplos: LIQUIFLEX HB, POLINEX B40, VERSA X12.

"Como calcular EX_TEMPO_PROCESSAMENTO?"

O sistema converte automaticamente se o Tempo de Cura (em horas) estiver disponível. Quando não está, o analista calcula manualmente:

Fórmula: Dias = ARREDONDAR.PARA.CIMA(Horas ÷ 24) + 1

"Posso rodar o pipeline duas vezes para o mesmo RITM?"

Sim. O sistema detecta se o RITM já foi processado e evita re-execução concorrente (idempotente). Se o RITM já está em estado ENVIA_PREPARED ou posterior, o pipeline retorna o execId existente sem sobrescrever os campos. Para reprocessar do zero, o administrador deve resetar o estado no banco.

"EX_PRAZO_VALIDADE está âmbar com mensagem ERC-721"

Causa: O campo sled da tabela ref_bd_hierarquia está nulo para o TCH do chamado. Isso ocorre quando o prazo de validade ainda não foi cadastrado na planilha V21 para essa especificação técnica.

Resolução (V2 §4.43):

1. Acessar o sistema interno Visualizador de Relatórios.
2. Abrir o relatório ERP Entry Report (ERC-721) para o TCH correspondente.
3. Localizar o campo de prazo de validade (shelf-life em dias).
4. Preencher o valor na tela de revisão antes de aprovar.

Após preencher, o campo muda de âmbar para verde e o botão "Aprovar" se torna disponível (desde que não haja outros campos vermelhos pendentes).

"O arquivo XLSX gerado não abre corretamente no WinShuttle"

Verificar:

• Se o arquivo está em output/winshuttle/ no servidor (não é feito download automático — o analista precisa acessar a pasta compartilhada).
• Se as colunas D a I (4 a 9) da aba CARGA ENVIA não foram modificadas — são logs do WinShuttle e devem permanecer conforme o template original.
• Se há campos \ em células que deveriam ter valor — isso indicaria que o campo foi marcado como N/A incorretamente.

Referências

• Template oficial: data/drive_pull/templates/01. TEMPLATE ENVIA CARGA V21.xlsx
• Código do resolver EX: lib/envia/resolverEX.ts
• Consulta BD_HIERARQUIA: lib/envia/consultarBDHierarquia.ts
• Orquestração do pipeline: app/api/envia/run/route.ts
• Geração do XLSX: lib/envia/fillTemplate.ts
• Plano geral da fase Envia: docs/fase-envia/PLANO-FASE-ENVIA.md
• Fluxo de estados do pipeline: FLUXO.md
• Spec V2 (fonte canônica): Comparativo - Regras Carga Extrusado V1 vs V2.md (Caroline Macedo, 12/05/2026)
• Aplicabilidade detalhada campo a campo: docs/fase-envia/APLICABILIDADE-EXTRUSADO.md
• Regra SLED / fallback ERC-721: docs/fase-envia/SLED-FALLBACK.md
• Filtro aplicabilidade (código): lib/envia/applicability/extrusado.ts
• Migration backfill V2-NA: migrations/005_*.sql, migrations/006_*.sql

Changelog deste guia — 2026-05-15: Alinhado com spec V2 (Caroline Macedo, 12/05/2026). Adicionadas seções §5 (aplicabilidade EXTRAÇÃO/EXTRAÇÃO2), §5.3 (NonApplicablePanel), §5a (nota ERC-721 em EX_PRAZO_VALIDADE), nota de override DOM em EX_GRUPO_EXP_IMP e FAQ ERC-721. Fonte consultada: comparativo V1 vs V2 + PRs #9 (SLED fallback), #10 (applicability filter), #11 (exportado→DOM), migrations 005/006. NotebookLM não estava disponível nesta sessão — spec V2 usada diretamente como fonte de verdade.