Pack SAP PM — Manutenção
O pack de manutenção tem dois usos bem diferentes, e vale escolher qual interessa antes de instalar:
- Manutenção reativa — a linha quebra, o operador abre uma notificação do tablet, o técnico aponta o tempo gasto e a notificação é encerrada.
- Manutenção preventiva por medição — o horímetro do ativo, o contador de peças ou a temperatura do sensor viram documento de medição no SAP, e o SAP dispara o plano preventivo sozinho.
O segundo é o que mais impressiona, e é onde o CMS faz algo que uma integração comum não faz.
Antes de instalar, leia Packs SAP — o assistente e os parâmetros são comuns aos três packs.
Medição sem escrever código
O CMS já lê OPC UA, Modbus, PI Web API e MQTT. O pack PM fecha o outro lado. Junte os dois e o caminho fica assim:
Você configura a Coleta da tag, encaminha para a Interface de medição do pack, e o horímetro do ativo passa a alimentar a manutenção preventiva do SAP. Sem uma linha de código.
Duas receitas de medição — qual usar
| Integração MES do EAM | Por ponto de medição | |
|---|---|---|
| Função | EAM_MES_CREATE_MEASUREM_DOCUM | MEASUREM_DOCUM_RFC_SINGLE_001 |
| Você informa | O equipamento | O número do ponto de medição |
| Quando usar | O MES conhece o ativo, não a estrutura de medição do SAP | O MES já foi cadastrado com os números dos pontos |
| Extra | — | Pode abrir notificação automática quando a leitura estoura o limite |
A primeira é mais simples e a recomendada para começar. Ela exige o código do papel da medição, que identifica qual grandeza está sendo apontada — confirme com o time de manutenção e preencha no passo 3 do assistente.
Não existe BAPI de medição neste release do SAP. As funções são módulos clássicos
(MEASUREM_*), sem o prefixo BAPI_. Uma delas faz o próprio commit, e por isso é a única
Entrega do pack com “commit após chamada” desligado — ligar os dois faria commit em dobro.
Notificação de manutenção
O tipo da notificação (M1 avaria, M2 solicitação, M3 atividade) é um parâmetro do pack.
Confirme quais estão ativos no Customizing da sua planta antes de instalar.
Assim como no QM, criar sozinho não persiste: BAPI_ALM_NOTIF_CREATE só monta a notificação na
memória da sessão RFC. Por isso a receita Abrir notificação chama BAPI_ALM_NOTIF_SAVE em
seguida, na mesma sessão, e faz o commit — ver
chamadas seguintes. O número definitivo
é o que o SAVE devolve (NOTIFHEADER.NOTIF_NO); o do CREATE é provisório (%00000000001).
Duas Entregas não fazem o par. Encaminhar a resposta de “Abrir” para “Gravar” parece funcionar e não grava nada: cada mensagem abre a sua conexão RFC, e a nota criada na primeira não existe na segunda. É a mesma sessão ou nada.
É esta receita que o Help Desk usa para abrir nota a partir de um alerta.
O ciclo completo disponível é: abrir → gravar → em processamento → encerrar, mais adiar e concluir
tarefa. Note que não existe BAPI_ALM_NOTIF_COMPLETE neste release — o par real é
PUTINPROGRESS e CLOSE.
Pegadinhas deste pack
Contador só cresce. Apontar uma leitura menor que a última falha. Se houve troca de
instrumento ou zeragem, use leitura diferencial (leituraDiferencial) em vez do valor absoluto.
Volume. A Interface de medição nasce com pacote de 50 mensagens e alerta em 2000, contra 10 e 500 das demais: medição costuma ser, de longe, o maior volume do pack. Se você vai apontar por minuto, revise o agendamento da Interface antes de ativar.
Equipamento sem ponto de medição. Se o ativo não tem ponto cadastrado para aquela grandeza, o SAP recusa. O pack mapeia o erro; o cadastro é do time de manutenção.
Resumo
31 receitas — 14 coleta, 17 entrega — das quais 12 essenciais.
Receitas
Ordem
| Receita | Direção | Função SAP | Resolve |
|---|---|---|---|
| Detalhe da ordem de manutenção ·essencial | Coleta | BAPI_ALM_ORDER_GET_DETAIL | Cabeçalho, operações e componentes de uma ordem PM — o que o técnico precisa ver no tablet antes de ir a campo. |
| Carteira de ordens de manutenção ·essencial | Coleta | BAPI_ALM_ORDERHEAD_GET_LIST | Lista as ordens PM por faixa de seleção — a carteira que alimenta o painel da manutenção. |
| Confirmação de tempo da ordem PM ·essencial | Entrega | BAPI_ALM_CONF_CREATE | O técnico aponta o tempo gasto na operação da ordem de manutenção direto do tablet. |
| Distribuir ordem PM para o MES | Coleta | EAM_MES_DISTRIBUTE_PMORD | Distribuir ordem PM para o MES. Receita gerada a partir da assinatura de EAM_MES_DISTRIBUTE_PMORD no SAP. |
| Confirmações PM | Coleta | BAPI_ALM_CONF_GETLIST | Confirmações PM. Receita gerada a partir da assinatura de BAPI_ALM_CONF_GETLIST no SAP. |
| Detalhe da confirmação PM | Coleta | BAPI_ALM_CONF_GETDETAIL | Detalhe da confirmação PM. Receita gerada a partir da assinatura de BAPI_ALM_CONF_GETDETAIL no SAP. |
| Estorno de confirmação | Entrega | BAPI_ALM_CONF_CANCEL | Estorno de confirmação. Receita gerada a partir da assinatura de BAPI_ALM_CONF_CANCEL no SAP. |
Notificação
| Receita | Direção | Função SAP | Resolve |
|---|---|---|---|
| Detalhe da notificação de manutenção ·essencial | Coleta | BAPI_ALM_NOTIF_GET_DETAIL | Item, causa, atividade e textos longos de uma notificação — o histórico do problema. |
| Abrir notificação de manutenção ·essencial | Entrega | BAPI_ALM_NOTIF_CREATE | Quebra ou anomalia detectada na linha vira notificação PM na hora, já amarrada ao equipamento — sem ninguém abrir o SAP. |
| Gravar notificação de manutenção ·essencial | Entrega | BAPI_ALM_NOTIF_SAVE | Persiste a notificação criada no passo anterior. |
| Encerrar notificação de manutenção ·essencial | Entrega | BAPI_ALM_NOTIF_CLOSE | Fecha a notificação quando o reparo termina — o outro extremo do ciclo aberto na linha. |
| Notificações de um equipamento | Coleta | BAPI_ALM_NOTIF_LIST_EQUI | Notificações de um equipamento. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_LIST_EQUI no SAP. |
| Notificações de um local de instalação | Coleta | BAPI_ALM_NOTIF_LIST_FUNCLOC | Notificações de um local de instalação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_LIST_FUNCLOC no SAP. |
| Complementar notificação | Entrega | BAPI_ALM_NOTIF_DATA_ADD | Complementar notificação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_DATA_ADD no SAP. |
| Alterar dados da notificação | Entrega | BAPI_ALM_NOTIF_DATA_MODIFY | Alterar dados da notificação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_DATA_MODIFY no SAP. |
| Colocar notificação em processamento | Entrega | BAPI_ALM_NOTIF_PUTINPROGRESS | Colocar notificação em processamento. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_PUTINPROGRESS no SAP. |
| Adiar notificação | Entrega | BAPI_ALM_NOTIF_POSTPONE | Adiar notificação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_POSTPONE no SAP. |
| Concluir tarefa da notificação | Entrega | BAPI_ALM_NOTIF_TASK_COMPLETE | Concluir tarefa da notificação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_TASK_COMPLETE no SAP. |
Ativos
| Receita | Direção | Função SAP | Resolve |
|---|---|---|---|
| Equipamento ·essencial | Coleta | BAPI_EQUI_GETDETAIL | Dados cadastrais do ativo — o que o MES espelha para amarrar linha, máquina e ordem. |
| Local de instalação ·essencial | Coleta | BAPI_FUNCLOC_GETDETAIL | Posição do ativo na hierarquia técnica da planta — usada para agrupar indicadores por área ou linha. |
| Ponto de medição do ativo ·essencial | Coleta | MEASUREM_POINT_RFC_SINGLE_002 | Dados do ponto de medição: grandeza, unidade e limites. É o que o SCADA precisa saber para apontar a leitura certa no lugar certo. |
| Lista de equipamentos | Coleta | BAPI_EQUI_GETLIST | Lista de equipamentos. Receita gerada a partir da assinatura de BAPI_EQUI_GETLIST no SAP. |
| Lista de locais de instalação | Coleta | BAPI_FUNCLOC_GETLIST | Lista de locais de instalação. Receita gerada a partir da assinatura de BAPI_FUNCLOC_GETLIST no SAP. |
| Instalar equipamento | Entrega | BAPI_EQUI_INSTALL | Instalar equipamento. Receita gerada a partir da assinatura de BAPI_EQUI_INSTALL no SAP. |
| Desmontar equipamento | Entrega | BAPI_EQUI_DISMANTLE | Desmontar equipamento. Receita gerada a partir da assinatura de BAPI_EQUI_DISMANTLE no SAP. |
| Alterar equipamento | Entrega | BAPI_EQUI_CHANGE | Alterar equipamento. Receita gerada a partir da assinatura de BAPI_EQUI_CHANGE no SAP. |
Ponto de medição
| Receita | Direção | Função SAP | Resolve |
|---|---|---|---|
| Apontar medição pela integração MES do EAM ·essencial | Entrega | EAM_MES_CREATE_MEASUREM_DOCUM | Leitura de contador ou sensor vira documento de medição no SAP. Combinada com uma Coleta OPC UA, Modbus ou PI, é o horímetro do ativo alimentando a manutenção preventiva sem uma linha de código. |
| Apontar medição por ponto de medição ·essencial | Entrega | MEASUREM_DOCUM_RFC_SINGLE_001 | Alternativa à receita anterior quando o MES conhece o número do ponto de medição em vez do equipamento. Permite também abrir notificação automática quando a leitura estoura o limite. |
| Lista de entrada de medições | Coleta | MEASUREM_ENTRYLIST_READ_DB | Lista de entrada de medições. Receita gerada a partir da assinatura de MEASUREM_ENTRYLIST_READ_DB no SAP. |
| Apontar documento de medição — variante | Entrega | MEASUREM_DOCUM_RFC_SINGLE_002 | Apontar documento de medição — variante. Receita gerada a partir da assinatura de MEASUREM_DOCUM_RFC_SINGLE_002 no SAP. |
| Estornar documento de medição | Entrega | MEASUREM_DOCUM_RFC_CANCEL | Estornar documento de medição. Receita gerada a partir da assinatura de MEASUREM_DOCUM_RFC_CANCEL no SAP. |
Contratos de campo
Detalhe da ordem de manutenção
PREFIXO_PM_ORDEM_DETALHE — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
ordem | sim | NUMBER |
Carteira de ordens de manutenção
PREFIXO_PM_ORDEM_LISTA — O seu sistema informa estes campos ao chamar a URL da Coleta.
Precisa de revisão antes de ativar. Criada inativa e com uma faixa de seleção de exemplo em IT_RANGES. Ajuste o campo e o valor da faixa ao recorte da sua planta antes de ativar — a lista sem filtro pode ser enorme.
Sem campos de entrada: a receita roda pelo agendador, com os valores fixados nos parâmetros do pack.
Detalhe da notificação de manutenção
PREFIXO_PM_NOTIF_DETALHE — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
notificacao | sim | NUMBER |
Equipamento
PREFIXO_PM_EQUIPAMENTO — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
equipamento | sim | EQUIPMENT |
Local de instalação
PREFIXO_PM_LOCAL_INSTALACAO — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
localInstalacao | sim | FUNCTLOCATION |
Ponto de medição do ativo
PREFIXO_PM_PONTO_MEDICAO — O seu sistema informa estes campos ao chamar a URL da Coleta.
Precisa de revisão antes de ativar. Módulo clássico, não BAPI: nome sem prefixo BAPI_ e leitura em modo somente-consulta (EDIT_MODE vazio). Não existe BAPI_MEASUREMENTPOINT_* neste release — ver §19 do plano.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
pontoMedicao | sim | MEASUREMENT_POINT |
Abrir notificação de manutenção
PREFIXO_PM_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 numa só chamada: BAPI_ALM_NOTIF_CREATE e, na mesma sessão, BAPI_ALM_NOTIF_SAVE (em “Chamar em seguida”), com commit. O número definitivo vem em BAPI_ALM_NOTIF_SAVE.NOTIFHEADER.NOTIF_NO — o de NOTIFHEADER_EXPORT é temporário (%00000000001).
| Campo | Obrigatório | Campo SAP |
|---|---|---|
descricao | sim | NOTIFHEADER.SHORT_TEXT |
equipamento | — | NOTIFHEADER.EQUIPMENT |
localInstalacao | — | NOTIFHEADER.FUNCT_LOC |
prioridade | — | NOTIFHEADER.PRIORITY |
dataInicioDesejada | — | NOTIFHEADER.DESSTDATE |
Gravar notificação de manutenção
PREFIXO_PM_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 |
|---|---|---|
notificacao | sim | NUMBER |
Encerrar notificação de manutenção
PREFIXO_PM_NOTIF_ENCERRAR — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
notificacao | sim | NUMBER |
dataEncerramento | — | SYSTSTAT.REFDATE |
horaEncerramento | — | SYSTSTAT.REFTIME |
Apontar medição pela integração MES do EAM
PREFIXO_PM_MEDICAO_EAM — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. A Interface nasce com pacote de 50 mensagens e alerta em 2000: medição costuma ser o maior volume do pack. Confirme o código do papel da medição com o time de manutenção.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
equipamento | sim | IV_EQUIPMENT |
valor | sim | IV_RECORDED_VALUE |
dataLeitura | — | IV_READING_DATE |
horaLeitura | — | IV_READING_TIME |
responsavel | — | IV_READER |
leituraDiferencial | — | IV_DIFFERENCE_READING |
Apontar medição por ponto de medição
PREFIXO_PM_MEDICAO_PONTO — O seu sistema envia estes campos no corpo da mensagem.
Precisa de revisão antes de ativar. Módulo clássico, não BAPI: ele mesmo faz o commit via COMMIT_WORK=‘X’, por isso esta é a única Entrega do pack com “commit após chamada” desligado — ligar os dois faria commit em dobro.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
pontoMedicao | sim | MEASUREMENT_POINT |
valor | sim | RECORDED_VALUE |
unidade | — | RECORDED_UNIT |
dataLeitura | — | READING_DATE |
horaLeitura | — | READING_TIME |
responsavel | — | READER |
observacao | — | SHORT_TEXT |
leituraDiferencial | — | DIFFERENCE_READING |
Confirmação de tempo da ordem PM
PREFIXO_PM_CONF_TEMPO — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
ordem | sim | TIMETICKETS.ORDERID |
operacao | sim | TIMETICKETS.OPERATION |
trabalhoRealizado | sim | TIMETICKETS.ACT_WORK |
unidadeTrabalho | sim | TIMETICKETS.UN_WORK |
apontamentoFinal | — | TIMETICKETS.FIN_CONF |
dataLancamento | — | TIMETICKETS.POSTG_DATE |
observacao | — | TIMETICKETS.CONF_TEXT |
Notificações de um equipamento
PREFIXO_PM_ALM_NOTIF_LIST_EQUI — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
equipamento | sim | EQUIPMENT |
Notificações de um local de instalação
PREFIXO_PM_ALM_NOTIF_LIST_FUNCLOC — O seu sistema informa estes campos ao chamar a URL da Coleta.
Sem campos de entrada: a receita roda pelo agendador, com os valores fixados nos parâmetros do pack.
Lista de equipamentos
PREFIXO_PM_EQUI_GETLIST — O seu sistema informa estes campos ao chamar a URL da Coleta.
Sem campos de entrada: a receita roda pelo agendador, com os valores fixados nos parâmetros do pack.
Lista de locais de instalação
PREFIXO_PM_FUNCLOC_GETLIST — O seu sistema informa estes campos ao chamar a URL da Coleta.
Sem campos de entrada: a receita roda pelo agendador, com os valores fixados nos parâmetros do pack.
Lista de entrada de medições
PREFIXO_PM_ENTRYLIST_READ_DB — O seu sistema informa estes campos ao chamar a URL da Coleta.
Sem campos de entrada: a receita roda pelo agendador, com os valores fixados nos parâmetros do pack.
Distribuir ordem PM para o MES
PREFIXO_PM_MES_DISTRIBUTE_PMORD — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
itOrders | sim | IT_ORDERS |
Confirmações PM
PREFIXO_PM_ALM_CONF_GETLIST — O seu sistema informa estes campos ao chamar a URL da Coleta.
Sem campos de entrada: a receita roda pelo agendador, com os valores fixados nos parâmetros do pack.
Detalhe da confirmação PM
PREFIXO_PM_ALM_CONF_GETDETAIL — O seu sistema informa estes campos ao chamar a URL da Coleta.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numeroConfirmacao | sim | CONFIRMATION |
contadorConfirmacao | sim | CONFIRMATIONCOUNTER |
Complementar notificação
PREFIXO_PM_ALM_NOTIF_DATA_ADD — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Alterar dados da notificação
PREFIXO_PM_ALM_NOTIF_DATA_MODIFY — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Colocar notificação em processamento
PREFIXO_PM_ALM_NOTIF_PUTINPROGRESS — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Adiar notificação
PREFIXO_PM_ALM_NOTIF_POSTPONE — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
Concluir tarefa da notificação
PREFIXO_PM_ALM_NOTIF_TASK_COMPLETE — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numero | sim | NUMBER |
taskKey | sim | TASK_KEY |
Apontar documento de medição — variante
PREFIXO_PM_DOCUM_RFC_SINGLE_002 — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
measurementDocument | sim | MEASUREMENT_DOCUMENT |
Estornar documento de medição
PREFIXO_PM_DOCUM_RFC_CANCEL — 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 IT_CANCEL_REQUESTS. Abra a Definição, use o popup “Parâmetros Função SAP” para preencher e ative.
Sem campos de entrada: a receita roda pelo agendador, com os valores fixados nos parâmetros do pack.
Estorno de confirmação
PREFIXO_PM_ALM_CONF_CANCEL — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
numeroConfirmacao | sim | CONFIRMATION |
contadorConfirmacao | sim | CONFIRMATIONCOUNTER |
Instalar equipamento
PREFIXO_PM_EQUI_INSTALL — 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_INSTALL. Abra a Definição, use o popup “Parâmetros Função SAP” para preencher e ative.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
equipamento | sim | EQUIPMENT |
Desmontar equipamento
PREFIXO_PM_EQUI_DISMANTLE — O seu sistema envia estes campos no corpo da mensagem.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
equipamento | sim | EQUIPMENT |
Alterar equipamento
PREFIXO_PM_EQUI_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_GENERAL; preencher a estrutura DATA_GENERALX; preencher a estrutura DATA_SPECIFIC; preencher a estrutura DATA_SPECIFICX. Abra a Definição, use o popup “Parâmetros Função SAP” para preencher e ative.
| Campo | Obrigatório | Campo SAP |
|---|---|---|
equipamento | sim | EQUIPMENT |