Pack SAP QM — Qualidade
O pack de qualidade resolve o caminho que vai do lote de inspeção criado pelo SAP até a decisão de uso que libera o material — passando pelo que o laboratório ou o operador de linha mede.
Antes de instalar, leia Packs SAP — o assistente e os parâmetros são comuns aos três packs.
O fluxo que ele resolve
O ponto mais valioso do pack está no passo C: o MES não precisa ter o plano de inspeção cadastrado. Ele pergunta ao SAP quais características medir, com nominal, tolerâncias, unidade e catálogo de códigos — e monta a tela do operador com isso. Mudou o plano no SAP, mudou a tela.
Decisões que você vai precisar tomar
Resultado por operação ou por característica?
| Por operação (em lote) | Por característica | |
|---|---|---|
| Mensagens | Uma por operação, com um array de resultados | Uma por medição |
| Quando usar | O operador preenche um formulário e envia tudo junto | O instrumento envia medição a medição |
| Volume | Menor | Maior |
A recomendação é por operação. É a única receita do pack em que o seu sistema envia uma
lista — o campo resultados é um array, um objeto por característica.
Ponto de inspeção
Só faz sentido quando o plano de inspeção está configurado para inspeção durante a produção (por hora, por pallet, por batelada). Se a operação não estiver configurada assim no SAP, a criação do ponto falha — o pack mapeia esse erro com essa explicação.
Os campos livres do ponto (USERC1 e afins) são úteis para carimbar turno, equipe ou lote de
produção. A receita já abre o turno.
Decisão de uso
A decisão de uso exige o conjunto de códigos (SELECTED SET) do Customizing de QM da sua planta, junto com grupo e código. Não há valor padrão universal — preencha o parâmetro Conjunto de códigos da decisão de uso no passo 3 do assistente, com o que o time de qualidade informar.
A decisão de uso é o que movimenta o estoque: aprovar tira do estoque de inspeção e joga para livre utilização. É a receita com maior impacto do pack — vale ativá-la por último, depois de os resultados estarem confiáveis.
Pegadinhas deste pack
Característica obrigatória sem resultado bloqueia a decisão de uso. É a causa mais comum de a UD falhar. O pack mapeia o erro; a solução é garantir que o MES gravou tudo antes de decidir.
Notificação de qualidade é um par create/save — na mesma sessão. BAPI_QUALNOT_CREATE só monta
a notificação na memória da sessão RFC. A receita Abrir notificação já chama BAPI_QUALNOT_SAVE
em seguida, na mesma sessão e com commit (ver
chamadas seguintes). A receita avulsa
Gravar notificação não grava uma nota criada por outra mensagem: cada mensagem abre a sua
conexão, e a nota da primeira não existe na segunda.
O pack não cria lote de inspeção: quem cria é o SAP, a partir do movimento de material ou da ordem. Se a sua planta precisa de inspeção avulsa, isso é configuração do QM, não do CMS.
Resumo
26 receitas — 12 coleta, 14 entrega — das quais 11 essenciais.
Receitas
Inspeção
| Receita | Direção | Função SAP | Resolve |
|---|---|---|---|
| Carteira de lotes de inspeção ·essencial | Coleta | BAPI_INSPLOT_GETLIST | Lista os lotes de inspeção do centro que ainda esperam decisão de uso — a fila de trabalho do laboratório. |
| Detalhe do lote de inspeção ·essencial | Coleta | BAPI_INSPLOT_GETDETAIL | Dados gerais do lote: material, ordem de origem, quantidades e status — o cabeçalho da tela de inspeção do MES. |
| Operações de inspeção do lote ·essencial | Coleta | BAPI_INSPOPER_GETLIST | As operações do plano de inspeção dentro do lote — cada uma agrupa as características que o operador vai medir. |
| Características a medir ·essencial | Coleta | BAPI_INSPCHAR_GETREQUIREMENTS | Nominal, tolerâncias, unidade e catálogo de uma característica. É o que o MES precisa para montar o formulário de coleta de qualidade sem ninguém redigitar o plano. |
| Pontos de inspeção do lote ·essencial | Coleta | BAPI_INSPPOINT_GETLIST | Lista os pontos de inspeção já criados numa operação — usada para o MES saber o que já foi apontado no turno. |
| Operações do lote de inspeção | Coleta | BAPI_INSPLOT_GETOPERATIONS | Operações do lote de inspeção. Receita gerada a partir da assinatura de BAPI_INSPLOT_GETOPERATIONS no SAP. |
| Status do lote de inspeção | Coleta | BAPI_INSPLOT_GETSTATUS | Status do lote de inspeção. Receita gerada a partir da assinatura de BAPI_INSPLOT_GETSTATUS no SAP. |
Resultados
| Receita | Direção | Função SAP | Resolve |
|---|---|---|---|
| Resultados da operação, em lote ·essencial | Entrega | BAPI_INSPOPER_RECORDRESULTS | Grava vários resultados de uma vez para uma operação de inspeção. É o caminho recomendado para MES: uma mensagem por operação, não uma por característica. |
| Resultado por característica ·essencial | Entrega | BAPI_INSPCHAR_SETRESULT | Grava o resultado de uma característica só. Útil quando o instrumento envia medição a medição, em vez de fechar a operação inteira. |
| Criar ponto de inspeção ·essencial | Entrega | BAPI_INSPPOINT_CREATEFROMDATA | Apontamento de qualidade durante a produção — por hora, por pallet, por batelada. Cria o ponto ao qual os resultados serão amarrados. |
| Detalhe da operação de inspeção | Coleta | BAPI_INSPOPER_GETDETAIL | Detalhe da operação de inspeção. Receita gerada a partir da assinatura de BAPI_INSPOPER_GETDETAIL no SAP. |
| Características da operação | Coleta | BAPI_INSPOPER_GETCHAR | Características da operação. Receita gerada a partir da assinatura de BAPI_INSPOPER_GETCHAR no SAP. |
| Resultados já gravados | Coleta | BAPI_INSPCHAR_GETRESULT | Resultados já gravados. Receita gerada a partir da assinatura de BAPI_INSPCHAR_GETRESULT no SAP. |
| Requisitos do ponto de inspeção | Coleta | BAPI_INSPPOINT_GETREQUIREMENTS | Requisitos do ponto de inspeção. Receita gerada a partir da assinatura de BAPI_INSPPOINT_GETREQUIREMENTS no SAP. |
| Encerrar operação de inspeção | Entrega | BAPI_INSPOPER_ACKNOWLEDGE | Encerrar operação de inspeção. Receita gerada a partir da assinatura de BAPI_INSPOPER_ACKNOWLEDGE no SAP. |
| Alterar ponto de inspeção | Entrega | BAPI_INSPPOINT_CHANGE | Alterar ponto de inspeção. Receita gerada a partir da assinatura de BAPI_INSPPOINT_CHANGE no SAP. |
Decisão de uso
| Receita | Direção | Função SAP | Resolve |
|---|---|---|---|
| Decisão de uso do lote ·essencial | Entrega | BAPI_INSPLOT_SETUSAGEDECISION | Aprova ou reprova o lote de inspeção e movimenta o estoque bloqueado. É o passo que libera o material para uso. |
Notificação
| Receita | Direção | Função SAP | Resolve |
|---|---|---|---|
| Abrir notificação de qualidade ·essencial | Entrega | BAPI_QUALNOT_CREATE | Registra um desvio detectado no chão de fábrica como notificação de qualidade, já vinculada ao material e ao lote. |
| Gravar notificação de qualidade ·essencial | Entrega | BAPI_QUALNOT_SAVE | Persiste a notificação criada no passo anterior. É o segundo tempo obrigatório do par create/save das BAPIs de notificação. |
| Notificação de qualidade | Coleta | BAPI_QUALNOT_GETDETAIL | Notificação de qualidade. Receita gerada a partir da assinatura de BAPI_QUALNOT_GETDETAIL no SAP. |
| Complementar notificação | Entrega | BAPI_QUALNOT_ADD_DATA | Complementar notificação. Receita gerada a partir da assinatura de BAPI_QUALNOT_ADD_DATA no SAP. |
| Alterar dados da notificação | Entrega | BAPI_QUALNOT_MODIFY_DATA | Alterar dados da notificação. Receita gerada a partir da assinatura de BAPI_QUALNOT_MODIFY_DATA no SAP. |
| Liberar / colocar em processamento | Entrega | BAPI_QUALNOT_RELSTAT | Liberar / colocar em processamento. Receita gerada a partir da assinatura de BAPI_QUALNOT_RELSTAT no SAP. |
| Concluir notificação | Entrega | BAPI_QUALNOT_COMPLSTAT | Concluir notificação. Receita gerada a partir da assinatura de BAPI_QUALNOT_COMPLSTAT no SAP. |
| Alterar status do usuário | Entrega | BAPI_QUALNOT_CHANGEUSRSTAT | Alterar status do usuário. Receita gerada a partir da assinatura de BAPI_QUALNOT_CHANGEUSRSTAT no SAP. |
| Alterar status da tarefa | Entrega | BAPI_QUALNOT_CHANGETSKSTAT | Alterar status da tarefa. Receita gerada a partir da assinatura de BAPI_QUALNOT_CHANGETSKSTAT no SAP. |
Contratos de campo
Carteira de lotes de inspeção
PREFIXO_QM_LOTE_LISTA — O seu sistema informa estes campos ao chamar a URL da Coleta.
Precisa de revisão antes de ativar. Criada inativa: varre a carteira do centro a cada execução, limitada a 200 lotes. Ajuste o agendamento da Interface antes de ativar.
Sem campos de entrada: a receita roda pelo agendador, com os valores fixados nos parâmetros do pack.
Detalhe do lote de inspeção
PREFIXO_QM_LOTE_DETALHE — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | NUMBER |
Operações de inspeção do lote
PREFIXO_QM_OPERACOES — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | INSPLOT |
Características a medir
PREFIXO_QM_CARACTERISTICAS — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | INSPLOT |
operacaoInspecao | sim | INSPOPER |
caracteristica | sim | INSPCHAR |
Pontos de inspeção do lote
PREFIXO_QM_PONTOS_INSPECAO — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | INSPLOT |
operacaoInspecao | sim | INSPOPER |
Resultados da operação, em lote
PREFIXO_QM_RES_OPERACAO — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. O campo “resultados” é um ARRAY de objetos, um por característica, no formato da estrutura BAPI2045D2 (INSPCHAR, MEAN_VALUE, EVALUATION, CLOSED…). É a única receita do pack em que o MES envia uma lista.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | INSPLOT |
operacaoInspecao | sim | INSPOPER |
resultados | sim | CHAR_RESULTS |
Resultado por característica
PREFIXO_QM_RES_CARACT — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | INSPLOT |
operacaoInspecao | sim | INSPOPER |
caracteristica | sim | INSPCHAR |
valorMedido | sim | CHAR_RESULT.MEAN_VALUE |
avaliacao | — | CHAR_RESULT.EVALUATION |
encerrar | — | CHAR_RESULT.CLOSED |
inspetor | — | CHAR_RESULT.INSPECTOR |
quantidadeDefeitos | — | CHAR_RESULT.DEFECTS |
Criar ponto de inspeção
PREFIXO_QM_PONTO_INSPECAO — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | DATA.INSPLOT |
operacaoInspecao | sim | DATA.INSPOPER |
quantidade | — | DATA.QUANTITY |
unidade | — | DATA.UNIT |
equipamento | — | DATA.EQUIPMENT |
material | — | DATA.MATERIAL |
observacao | — | DATA.REMARK |
turno | — | DATA.USERC1 |
Decisão de uso do lote
PREFIXO_QM_DECISAO_USO — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. Preencha o binding “Conjunto de códigos da decisão de uso” com o SELECTED SET do seu Customizing de QM — sem ele o SAP recusa a decisão.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | NUMBER |
grupoCodigo | sim | UD_DATA.UD_CODE_GROUP |
codigoDecisao | sim | UD_DATA.UD_CODE |
observacao | — | UD_DATA.UD_TEXT_LINE |
Abrir notificação de qualidade
PREFIXO_QM_NOTIF_ABRIR — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. Cria E grava a notificação de qualidade numa só chamada: BAPI_QUALNOT_CREATE e, na mesma sessão, BAPI_QUALNOT_SAVE (em “Chamar em seguida”), com commit. O número definitivo vem em BAPI_QUALNOT_SAVE.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
descricao | sim | NOTIFHEADER.SHORT_TEXT |
material | — | NOTIFHEADER.MATERIAL |
lote | — | NOTIFHEADER.BATCH |
prioridade | — | NOTIFHEADER.PRIORITY |
dataOcorrencia | — | NOTIFHEADER.NOTIF_DATE |
Gravar notificação de qualidade
PREFIXO_QM_NOTIF_GRAVAR — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. Só grava uma notificação que ainda está na memória da MESMA sessão RFC — como cada mensagem do CMS abre a sua conexão, esta Entrega sozinha não grava a nota criada por “Abrir notificação”. Use “Abrir notificação”, que já cria e grava na mesma chamada.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numeroNotificacao | sim | NUMBER |
Operações do lote de inspeção
PREFIXO_QM_INSPLOT_GETOPERATIONS — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Status do lote de inspeção
PREFIXO_QM_INSPLOT_GETSTATUS — O seu sistema informa estes campos ao chamar a URL da Coleta.
Precisa de revisão antes de ativar. Criada INATIVA: o pack não tem como adivinhar o conteúdo — preencher a estrutura LANGUAGE. Abra a Definição, use o popup “Parâmetros Função SAP” para preencher e ative.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Detalhe da operação de inspeção
PREFIXO_QM_INSPOPER_GETDETAIL — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | INSPLOT |
operacaoInspecao | sim | INSPOPER |
Características da operação
PREFIXO_QM_INSPOPER_GETCHAR — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | INSPLOT |
operacaoInspecao | sim | INSPOPER |
Resultados já gravados
PREFIXO_QM_INSPCHAR_GETRESULT — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
caracteristica | sim | INSPCHAR |
loteInspecao | sim | INSPLOT |
operacaoInspecao | sim | INSPOPER |
Requisitos do ponto de inspeção
PREFIXO_QM_INSPPOINT_GETREQUIREMENTS — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | INSPLOT |
operacaoInspecao | sim | INSPOPER |
Notificação de qualidade
PREFIXO_QM_QUALNOT_GETDETAIL — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Encerrar operação de inspeção
PREFIXO_QM_INSPOPER_ACKNOWLEDGE — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. Criada INATIVA: o pack não tem como adivinhar o conteúdo — preencher a tabela HANDHELD_WORKLIST. Abra a Definição, use o popup “Parâmetros Função SAP” para preencher e ative.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
handheldApplication | sim | HANDHELD_APPLICATION |
Alterar ponto de inspeção
PREFIXO_QM_INSPPOINT_CHANGE — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. Criada INATIVA: o pack não tem como adivinhar o conteúdo — preencher a estrutura DATA. Abra a Definição, use o popup “Parâmetros Função SAP” para preencher e ative.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
loteInspecao | sim | INSPLOT |
operacaoInspecao | sim | INSPOPER |
pontoInspecao | sim | INSPPOINT |
Complementar notificação
PREFIXO_QM_QUALNOT_ADD_DATA — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Alterar dados da notificação
PREFIXO_QM_QUALNOT_MODIFY_DATA — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Liberar / colocar em processamento
PREFIXO_QM_QUALNOT_RELSTAT — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Concluir notificação
PREFIXO_QM_QUALNOT_COMPLSTAT — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. Criada INATIVA: o pack não tem como adivinhar o conteúdo — preencher a estrutura SYSTSTAT. Abra a Definição, use o popup “Parâmetros Função SAP” para preencher e ative.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Alterar status do usuário
PREFIXO_QM_QUALNOT_CHANGEUSRSTAT — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. Criada INATIVA: o pack não tem como adivinhar o conteúdo — preencher a estrutura USR_STATUS. Abra a Definição, use o popup “Parâmetros Função SAP” para preencher e ative.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Alterar status da tarefa
PREFIXO_QM_QUALNOT_CHANGETSKSTAT — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
taskCode | sim | TASK_CODE |
taskKey | sim | TASK_KEY |