Skip to Content
IntegraçõesSAPPack PM — Manutenção

Pack SAP PM — Manutenção

O pack de manutenção tem dois usos bem diferentes, e vale escolher qual interessa antes de instalar:

  1. 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.
  2. 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 EAMPor ponto de medição
FunçãoEAM_MES_CREATE_MEASUREM_DOCUMMEASUREM_DOCUM_RFC_SINGLE_001
Você informaO equipamentoO número do ponto de medição
Quando usarO MES conhece o ativo, não a estrutura de medição do SAPO 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

ReceitaDireçãoFunção SAPResolve
Detalhe da ordem de manutenção ·essencialColetaBAPI_ALM_ORDER_GET_DETAILCabeç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 ·essencialColetaBAPI_ALM_ORDERHEAD_GET_LISTLista as ordens PM por faixa de seleção — a carteira que alimenta o painel da manutenção.
Confirmação de tempo da ordem PM ·essencialEntregaBAPI_ALM_CONF_CREATEO técnico aponta o tempo gasto na operação da ordem de manutenção direto do tablet.
Distribuir ordem PM para o MESColetaEAM_MES_DISTRIBUTE_PMORDDistribuir ordem PM para o MES. Receita gerada a partir da assinatura de EAM_MES_DISTRIBUTE_PMORD no SAP.
Confirmações PMColetaBAPI_ALM_CONF_GETLISTConfirmações PM. Receita gerada a partir da assinatura de BAPI_ALM_CONF_GETLIST no SAP.
Detalhe da confirmação PMColetaBAPI_ALM_CONF_GETDETAILDetalhe da confirmação PM. Receita gerada a partir da assinatura de BAPI_ALM_CONF_GETDETAIL no SAP.
Estorno de confirmaçãoEntregaBAPI_ALM_CONF_CANCELEstorno de confirmação. Receita gerada a partir da assinatura de BAPI_ALM_CONF_CANCEL no SAP.

Notificação

ReceitaDireçãoFunção SAPResolve
Detalhe da notificação de manutenção ·essencialColetaBAPI_ALM_NOTIF_GET_DETAILItem, causa, atividade e textos longos de uma notificação — o histórico do problema.
Abrir notificação de manutenção ·essencialEntregaBAPI_ALM_NOTIF_CREATEQuebra 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 ·essencialEntregaBAPI_ALM_NOTIF_SAVEPersiste a notificação criada no passo anterior.
Encerrar notificação de manutenção ·essencialEntregaBAPI_ALM_NOTIF_CLOSEFecha a notificação quando o reparo termina — o outro extremo do ciclo aberto na linha.
Notificações de um equipamentoColetaBAPI_ALM_NOTIF_LIST_EQUINotificaçõ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çãoColetaBAPI_ALM_NOTIF_LIST_FUNCLOCNotificações de um local de instalação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_LIST_FUNCLOC no SAP.
Complementar notificaçãoEntregaBAPI_ALM_NOTIF_DATA_ADDComplementar notificação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_DATA_ADD no SAP.
Alterar dados da notificaçãoEntregaBAPI_ALM_NOTIF_DATA_MODIFYAlterar dados da notificação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_DATA_MODIFY no SAP.
Colocar notificação em processamentoEntregaBAPI_ALM_NOTIF_PUTINPROGRESSColocar notificação em processamento. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_PUTINPROGRESS no SAP.
Adiar notificaçãoEntregaBAPI_ALM_NOTIF_POSTPONEAdiar notificação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_POSTPONE no SAP.
Concluir tarefa da notificaçãoEntregaBAPI_ALM_NOTIF_TASK_COMPLETEConcluir tarefa da notificação. Receita gerada a partir da assinatura de BAPI_ALM_NOTIF_TASK_COMPLETE no SAP.

Ativos

ReceitaDireçãoFunção SAPResolve
Equipamento ·essencialColetaBAPI_EQUI_GETDETAILDados cadastrais do ativo — o que o MES espelha para amarrar linha, máquina e ordem.
Local de instalação ·essencialColetaBAPI_FUNCLOC_GETDETAILPosição do ativo na hierarquia técnica da planta — usada para agrupar indicadores por área ou linha.
Ponto de medição do ativo ·essencialColetaMEASUREM_POINT_RFC_SINGLE_002Dados 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 equipamentosColetaBAPI_EQUI_GETLISTLista de equipamentos. Receita gerada a partir da assinatura de BAPI_EQUI_GETLIST no SAP.
Lista de locais de instalaçãoColetaBAPI_FUNCLOC_GETLISTLista de locais de instalação. Receita gerada a partir da assinatura de BAPI_FUNCLOC_GETLIST no SAP.
Instalar equipamentoEntregaBAPI_EQUI_INSTALLInstalar equipamento. Receita gerada a partir da assinatura de BAPI_EQUI_INSTALL no SAP.
Desmontar equipamentoEntregaBAPI_EQUI_DISMANTLEDesmontar equipamento. Receita gerada a partir da assinatura de BAPI_EQUI_DISMANTLE no SAP.
Alterar equipamentoEntregaBAPI_EQUI_CHANGEAlterar equipamento. Receita gerada a partir da assinatura de BAPI_EQUI_CHANGE no SAP.

Ponto de medição

ReceitaDireçãoFunção SAPResolve
Apontar medição pela integração MES do EAM ·essencialEntregaEAM_MES_CREATE_MEASUREM_DOCUMLeitura 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 ·essencialEntregaMEASUREM_DOCUM_RFC_SINGLE_001Alternativa à 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çõesColetaMEASUREM_ENTRYLIST_READ_DBLista de entrada de medições. Receita gerada a partir da assinatura de MEASUREM_ENTRYLIST_READ_DB no SAP.
Apontar documento de medição — varianteEntregaMEASUREM_DOCUM_RFC_SINGLE_002Apontar documento de medição — variante. Receita gerada a partir da assinatura de MEASUREM_DOCUM_RFC_SINGLE_002 no SAP.
Estornar documento de mediçãoEntregaMEASUREM_DOCUM_RFC_CANCELEstornar 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.

CampoObrigatórioCampo SAP
ordemsimNUMBER

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.

CampoObrigatórioCampo SAP
notificacaosimNUMBER

Equipamento

PREFIXO_PM_EQUIPAMENTO — O seu sistema informa estes campos ao chamar a URL da Coleta.

CampoObrigatórioCampo SAP
equipamentosimEQUIPMENT

Local de instalação

PREFIXO_PM_LOCAL_INSTALACAO — O seu sistema informa estes campos ao chamar a URL da Coleta.

CampoObrigatórioCampo SAP
localInstalacaosimFUNCTLOCATION

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.

CampoObrigatórioCampo SAP
pontoMedicaosimMEASUREMENT_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).

CampoObrigatórioCampo SAP
descricaosimNOTIFHEADER.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.

CampoObrigatórioCampo SAP
notificacaosimNUMBER

Encerrar notificação de manutenção

PREFIXO_PM_NOTIF_ENCERRAR — O seu sistema envia estes campos no corpo da mensagem.

CampoObrigatórioCampo SAP
notificacaosimNUMBER
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.

CampoObrigatórioCampo SAP
equipamentosimIV_EQUIPMENT
valorsimIV_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.

CampoObrigatórioCampo SAP
pontoMedicaosimMEASUREMENT_POINT
valorsimRECORDED_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.

CampoObrigatórioCampo SAP
ordemsimTIMETICKETS.ORDERID
operacaosimTIMETICKETS.OPERATION
trabalhoRealizadosimTIMETICKETS.ACT_WORK
unidadeTrabalhosimTIMETICKETS.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.

CampoObrigatórioCampo SAP
equipamentosimEQUIPMENT

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.

CampoObrigatórioCampo SAP
itOrderssimIT_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.

CampoObrigatórioCampo SAP
numeroConfirmacaosimCONFIRMATION
contadorConfirmacaosimCONFIRMATIONCOUNTER

Complementar notificação

PREFIXO_PM_ALM_NOTIF_DATA_ADD — O seu sistema envia estes campos no corpo da mensagem.

CampoObrigatórioCampo SAP
numerosimNUMBER

Alterar dados da notificação

PREFIXO_PM_ALM_NOTIF_DATA_MODIFY — O seu sistema envia estes campos no corpo da mensagem.

CampoObrigatórioCampo SAP
numerosimNUMBER

Colocar notificação em processamento

PREFIXO_PM_ALM_NOTIF_PUTINPROGRESS — O seu sistema envia estes campos no corpo da mensagem.

CampoObrigatórioCampo SAP
numerosimNUMBER

Adiar notificação

PREFIXO_PM_ALM_NOTIF_POSTPONE — O seu sistema envia estes campos no corpo da mensagem.

CampoObrigatórioCampo SAP
numerosimNUMBER

Concluir tarefa da notificação

PREFIXO_PM_ALM_NOTIF_TASK_COMPLETE — O seu sistema envia estes campos no corpo da mensagem.

CampoObrigatórioCampo SAP
numerosimNUMBER
taskKeysimTASK_KEY

Apontar documento de medição — variante

PREFIXO_PM_DOCUM_RFC_SINGLE_002 — O seu sistema envia estes campos no corpo da mensagem.

CampoObrigatórioCampo SAP
measurementDocumentsimMEASUREMENT_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.

CampoObrigatórioCampo SAP
numeroConfirmacaosimCONFIRMATION
contadorConfirmacaosimCONFIRMATIONCOUNTER

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.

CampoObrigatórioCampo SAP
equipamentosimEQUIPMENT

Desmontar equipamento

PREFIXO_PM_EQUI_DISMANTLE — O seu sistema envia estes campos no corpo da mensagem.

CampoObrigatórioCampo SAP
equipamentosimEQUIPMENT

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.

CampoObrigatórioCampo SAP
equipamentosimEQUIPMENT