Documentação das Interfaces de PM

Interfaces disponíveis em PED e PEP em junho de 2014

Relacionamos, neste documento, as Interfaces (BAPIs) em uso pelo Módulo PM do SAP na

Petrobras, até junho de 2014, de cujo desenvolvimento participou o profissional Gilberto Adamatti
(DP58).

Conceitos Básicos
As BAPIs aqui relacionadas foram desenvolvidas para atender interfaces entre sistemas legados
(mencionados junto a cada uma – iniciando pelo APLAT, que é o mais recente), e, em sua maioria,
usam Webservices. Mas há também interfaces desenvolvidas para uso em ETL e outras que ainda
não tem Webservices.
Caso alguém deseje utilizar alguma interface que não tem Webservices e precise de Webservice, o
procedimento atual consiste em a Agilidade responsável pelo sistema legado solicitar à equipe de
CCI o desenvolvimento de Webservice, informando um projeto para apontamento de horas. Os
custos do desenvolvimento do Webservice recaem sobre o projeto do sistema legado que pretende
utilizar as interfaces.
Para saber mais sobre o CCI: http://wiki.petrobras.com.br/display/cci/CCI

Sobre o processo de usar um serviço já existente,existe o padrão PE-2T0-00255-A

Quanto a visualizar detalhes das BAPIs relacionadas neste documento, em ambiente SAP, o mesmo
poderá ser feito via transação SE37, no ambiente PED ou PE2, conforme telas demonstrativas,
ilustradas a seguir:

Figura 1 – Tela onde se informa a BAPI que se pretende consultar ou executar.

Se clicarmos no botão “Exibir”, seremos reportados à tela a seguir:

Página 1 de 29
Figura 2 – Clicando no botão Exibir, somos levados a uma tela com várias abas, onde podemos obter
informações úteis sobre a BAPI

Para a maioria das BAPIs, os campos de saída poderão ser visualizados na aba “Tabelas”, onde se
faz necessário dar um duplo click sobre eventuais tabelas lá relacionadas. Mas a forma de
construção de algumas BAPIs, como as do APLAT não mostra esta informação lá. Só pode ser
vista lendo o código ou executando.
Vejamos a aba “Tabelas” de uma BAPI que permite visualizar os campos de saída:

Página 2 de 29
 Figura 3 – Tabelas que englobam os campos de saída

Um duplo click sobre cada uma das tabelas mostrará os campos constituintes de cada uma, como
pode ser visto na figura abaixo, que ilustra um duplo click sobre “YSE_MODOS_FALHA_OPER”:

Página 3 de 29
 Figura 4 – Resultado do duplo click sobre o primeiro “Tipo Referência” da figura 3

Vejamos, agora, alguns detalhes sobre o processo de “Executar” uma BAPI via transação SE37
(veja, na figura 1, o botão “Executar” para uma BAPI).
Na próxima tela apresentaremos a primeira tela resultante após clicar sobre o botão “Executar” da
BAPI utilizada neste exemplo, que é a BAPI_YMODO_YFALHAS_OPER:

Figura 5 – Tela resultado do click feito sobre o botão “executar” mostrado na figura 1

Notar que, na BAPI acima, o campo intitulado LOCALIZAÇÃO, na verdade é para ser informado o
Local de Instalação.
E que, nesta BAPI se preenche ou o Local de Instalação ou o Equipamento (ver na documentação,
mais abaixo, que estes campos são mutuamente exclusivos – se preenchemos os dois, ele só exibe
os dados de equipamento).
A próxima tela exibirá a tela resultante da execução da tela acima para o equipamento número

Página 4 de 29
35246:

Figura 6 – Tela resultado do click feito sobre o botão “executar” mostrado na figura 5

Na próxima figura apresentaremos a tela resultante de se clicar sobre o ícone de tabela à direita de
“GRUPO_CODES” da tela da figura 6.

Figura 7 – Tela resultado do click feito sobre o ícone ao lado de “resultados de grupos de codes”

Qualquer registro destas saídas pode ser visto na vertical com o nome completo dos campos
exibidos (notar que na saída acima, para saídas pequenas o nome do campo fica truncado).

Página 5 de 29
Vejamos, abaixo, a tela resultado de se clicar no ícone que mostra registros na vertical, na tela da
figura 7.

Figura 8 – Janela com exibição de um registro de saída na vertical

Agora vamos descrever o “Botão de Diretório de Dados de Teste” exibido na tela apresentada na
Figura 5 acima.
Tal botão é muito útil para se salvar variantes de teste de Bapis, em especial em BAPIs que tenham
muitas entradas, às vezes de preenchimento relativamente complexo. Para isto o usuário preenche
uma BAPI, a executa, e, em ela funcionando ou causando algum erro que precise ser reportado para
alguém para tomar providências relativas ao mesmo, salva uma variante da mesma. Ao se chamar a
variante, a BAPI aparecerá preenchida, facilitando os testes subsequentes.
Para salvar uma dada variante, basta estar na tela de preenchimento de dados e clicar no botão
“Salvar” ( ) que fica na linha de ícones da barra de ferramentas.
O sistema apresentará a tela abaixo, onde o usuário informará o nome da variante e clicará em
“Aceitar”.

Figura 9 – Tela para informar o nome da variante de testes de BAPI a ser gravada.

Já, para executar uma variante de teste de Bapis gravada, basta clicar no “Botão de Diretório de
Dados de Teste”, e abrirá uma tela com a relação das variantes gravadas. Executando um duplo
click sobre a variante escolhida, a mesma será carregada e estará pronta para ser executada.

Nas próximas páginas exibiremos as BAPIs de PM que foram desenvolvidas para sistemas legados
no período de 2009 a 2014, iniciando pelas desenvolvidas para o APLAT.

Página 6 de 29
 Relação das Interfaces de PM
Interfaces disponíveis em PED e PEP em junho de 2014

BAPI_YPLANOS_YGETLIST - Bapi que emula a transação IP24, listando a

programação dos planos de manutenção, bem como a ordem gerada (quando for o caso) e a
última ordem.
As informações de saída permitem identificar se o plano está atrasado, em dia ou adiantado. Foi
desenvolvida para o APLAT e já tem Webservice disponível, cujo WSDL pode ser obtido no
seguinte link:
http://bst.petrobras.com.br/sbresource?PROXY/PLAMAN_1.0/Services/ProxyServices/PlanoManutencao_1

Principais parâmetros de Entrada:

Categoria do plano: sempre PM
Campo de seleção de plano
Plano de Manutenção: Número do plano (pode colocar n planos)
Item de Manutenção
Estratégia
Local de instalação (pode colocar um conjunto de locais)
Equipamento (pode colocar um conjunto de equipamentos)
Nota (multivalorado)
Ordem (multivalorado)
Tipo de ordem
Centro planejamento
Grupo de Planejamento de PM
Centro de localização
Localização
Campo de seleção (É o tag do equipamento)
Área operacional
Status
Data de criação
Data de modificação
Sala
Campos de saída: São os mesmos da transação IP24.

BAPI_YLOC_INST_YGETLIST - Bapi desenvolvida para selecionar, no SAP, um

conjunto de Locais de Instalação, de forma análoga à listagem fornecida pela transação
YSPM_IH06 (com os mesmos campos de saída). Foi desenvolvida para o APLAT e já tem
Webservice disponível, cujo WSDL pode ser obtido no seguinte link:
http://bst.petrobras.com.br/sbresource?PROXY/LOCINS/Services/ProxyServices/LocalInstalacao_1

Principais parâmetros de Entrada:

Local de Instalação (pode informar vários)
Local Pai
Denominação do local de instalação
Código da estrutura do local de instalação
Categoria local (C ou A ou P ou L ou T ou R)
Perfil do catálogo
Impacto Falha
Centro de localização (obrigatório)

Página 7 de 29
 Localização do imobilizado
Área operacional
Status inclusivos
Status exclusivos
Grupo de planejamento (obrigatório, e aceita *)
Centro de planejamento de manutenção (obrigatório e aceita *)
Código ABC para o objeto técnico
Campo de seleção
Área de contabilidade de custos
Centro de custo
Tipo de classe (para local colocar sempre 003)
Código da classe (pode indicar várias)
Fabricante do imobilizado
Número de Série do Fabricante
Campo que marcando "X" permite invocar a BAPI_YCLASSE_CARACT
Marcando "X" busca o "Texto Descritivo do Equipamento"
Data da última modificação do local (obrigatório com range máximo de 90 dias)
Data de criação do local (se preenchido o range máximo é de 90 dias).

BAPI_YEQUIPAMENTO_YGETLIST - Bapi desenvolvida para selecionar, no SAP,

um conjunto de Equipamentos, de forma análoga à listagem fornecida pela transação YSPM_IH08
(com os mesmos campos de saída). Foi desenvolvida para o APLAT e já tem Webservice
disponível, cujo WSDL pode ser obtido no seguinte link:
http://bst.petrobras.com.br/sbresource?PROXY/EQUIPAM_1.0/Services/ProxyServices/Equipamento_1

Principais parâmetros de Entrada:

Local de instalação (pode informar vários)
Número de equipamento (pode informar vários)
Centro de localização
Localização do imobilizado
Área operacional
Centro de planejamento de manutenção (obrigatório)
Grupo de planejamento (obrigatório mas aceita *)
Grupo de autorizações referente ao objeto
Status inclusivos
Status exclusivos
Centro de custo
Campo de seleção
Categoria de equipamento
Fabricante do imobilizado
Denominação do objeto técnico
Tipo de classe
Código da classe (pode colocar várias)
Denominação do tipo atribuído pelo fabricante (Modelo)
Nº de série de acordo com o fabricante
Nº identificação técnica
Campo que marcando "X" permite invocar a BAPI_YCLASSE_CARACT
Marcando "X" busca o "Texto Descritivo do Equipamento"
Data da última modificação do equipamento (obrigatório com range máximo de 90 dias)
Data de criação do equipamento (se preenchido o range máximo é de 90 dias).

Campos Obrigatórios: Centro de Planejamento, Grupo de Localização e(permite valores

múltiplos) e data de última modificação (que traz também os criados no período) com um range

Página 8 de 29
máximo de 90 dias.

BAPI_YNOTAS_YGETLIST - Bapi desenvolvida para selecionar, no SAP, um conjunto de

Notas, de forma análoga à listagem fornecida pela transação IW29 (com os mesmos campos de
saída). Foi desenvolvida para o APLAT e já tem Webservice disponível, cujo WSDL pode ser
obtido no seguinte link:
http://bst.petrobras.com.br/sbresource?PROXY/NOTMAN_1.0/Services/ProxyServices/NotaManutencao_1

Principais parâmetros de Entrada:

Nota (Número da nota – pode ser multivalorado)
Ordem (Número da Ordem – pode ser multivalorado)
Tipo de Nota (tipos ZF, ZS, ZE, ZI, ZR, ZC).
Local de Instalação da Nota
Equipamento da Nota
Status Inclusivo da Nota
Status Exclusivo da Nota
Centro de Localização da Nota
Centro de Planejamento da Nota
Grupo de Planejamento da Nota
Data de Criação da Nota
Data de Referência da Nota
Data de Criação do Item de Recomendação
Data de Início Desejado da Nota
Data de Conclusão Desejada da Nota
Área Operacional da Nota
Prioridade da Nota
Tipo de Intervenção da Nota
Impacto de Falha da Nota
Campo de Seleção da Nota

Campos obrigatórios:
- Tipo de Nota, centro de planejamento, e uma data (Data de criação ou Data de
referência ou Data de conclusão, etc.) com intervalo máximo de 90 dias.

BAPI_YORDENS_YGETLIST - Bapi desenvolvida para selecionar, no SAP, um conjunto

de Ordens, de forma análoga à listagem fornecida pela transação IW39 (com os mesmos campos
de saída). Foi desenvolvida para o APLAT e já tem Webservice disponível, cujo WSDL pode ser
obtido no seguinte link:
http://bst.petrobras.com.br/sbresource?PROXY/ORDMAN_1.0/Services/ProxyServices/OrdemManutencao_1

Principais parâmetros de Entrada:

Número da Nota no Cabeçalho da Ordem (multivalorado)
Número da Ordem (multivalorado)
Tipo de Ordem (pode ser multivalorado - ZM01, ZM02, etc.)
Centro de Localização da Ordem
Centro de Planejamento da Ordem
Grupo de Planejamento da Ordem
Equipamento da Ordem
Local de Instalação da Ordem

Página 9 de 29
 Prioridade da Ordem
Status Inclusivo da Ordem
Status Exclusivo da Ordem
Data de Criação da Ordem
Última Data de Modificação da Ordem
Data Base de Início da Ordem
Data Base de Fim da Ordem
Status inclusivo e status exclusivo
Tipo de Intervenção da Ordem
Tipo de Atividade da Ordem
Código de Planejamento da Ordem
Código ABC da Ordem
Plano de Manutenção da Ordem
Área Operacional da Ordem
Campo de Seleção da Ordem
Sala da Ordem
Impacto de Falha da Ordem
Campos obrigatórios: Tipo de Ordem e Centro de Planejamento, e um campo de
Data, com intervalo máximo de 60 dias.

BAPI_YMEDIDAS_YGETLIST - Bapi desenvolvida para selecionar, no SAP, um

conjunto de Medidas de notas ZR, de forma análoga à listagem fornecida pela transação IW67
(com os mesmos campos de saída). Foi desenvolvida para o APLAT e já tem Webservice
disponível, cujo WSDL pode ser obtido no seguinte link:
http://bst.petrobras.com.br/sbresource?PROXY/MEDINS_1.0/Services/ProxyServices/MedidaInspecao_1

Principais entradas:
Número da Nota (ZR)
Número da Ordem
Centro de Planejamento da Nota
Grupo de Planejamento da Nota
Centro para Centro de Trabalho da Nota
Centro de Trabalho Responsável da Nota
Prioridade da Nota
Tipo de Intervenção da Nota
Impacto de Falha da Nota
Local de Instalação da Nota
Status inclusivo e status exclusivo
Data de Criação da Nota
Data de Início Desejado da Nota
Data de Conclusão Desejada da Nota
Centro de Localização da Nota
Localização do Objeto da Nota
Área Operacional da Nota
Numerador da Medida
Código da Medida
Apenas Medidas Não Concluídas
Função Parceiro Responsavel Medida
Parceiro Responsável pela Medida (código do centro de trabalho responsável)

Campos obrigatórios:

Página 10 de 29
- Tipo de Nota (obviamente ZR), centro de planejamento, e uma data com faixa
máxima de 90 dias.
BAPI_YOPERACOES_YGETLIST - Bapi desenvolvida para selecionar, no SAP, um
conjunto de Operações de Ordens, de forma análoga à listagem fornecida pela transação IW49
(com os mesmos campos de saída). Foi desenvolvida para o APLAT e já tem Webservice
disponível, cujo WSDL pode ser obtido no seguinte link:
http://bst.petrobras.com.br/sbresource?PROXY/OPEORD_1.0/Services/ProxyServices/OperacaoOrdem_1

Parâmetros de Entrada
Ordem (Campo multivalorado, obrigatório)
Centro de planejamento
Chave controle
Status Exclusivo
Status Inclusivo
Com rede de precedência: (marcar “X” se deseja também dados de rede de precedência,
que é as dependências entre operações).
Com descrição longa na saída

BAPI_YREDEPREC_YGETLIST - Esta Bapi apenas lista as dependências entre

operações e o único parâmetro de entrada é o Número da Ordem (Multivalorado). Pode
ser chamada de dentro da Bapi de Operações. Também foi desenvolvida para o APLAT e
tem Webservice disponível, cujo WSDL pode ser obtido no seguinte link:
http://bst.petrobras.com.br/sbresource?PROXY/REDPRO_1.0/Services/ProxyServices/RedePrecedencia_1

BAPI_YCLASSE_CARACT_YGETLIST - Bapi desenvolvida para selecionar, no SAP, as

Características Técnicas de um Equipamento ou de um Local de instalação, com seus respectivos
valores e unidades de medida. Esta BAPI pode também ser chamada de dentro de uma Bapi de
Local de Instalação ou de Equipamento, marcando com “X” um campo específico dos parâmetros
de entrada daquela Bapi. Neste caso trará todas as características de todos os objetos
selecionados naquelas Bapis. A transação que exibe dados de forma semelhante é a IE02 para
equipamentos, na opção “Síntese de Classes” e IL02 para Local de Instalação, na opção
“Síntese de Classes”. Foi desenvolvida para o APLAT e já tem Webservice disponível.
O WSDL do Webservice pode ser obtido com a equipe do CCI ou com uma das seguintes três
pessoas:
- Luiz Philip Wennerstrom
- Leonardo Rodrigues Lemos
- Marlon Alves da Silva

Parâmetros de Entrada
Equipamento (multivalorado) ou Local de Instalação (Multivalorado). É obrigatório
preencher pelo menos um, mas não pode colocar valores nos dois campos
simultaneamente).

Os campos que são listados na saída desta Bapi são os seguintes:

Equipamento
Local de instalação
Classe (código)
Denominação da classe
Código da Característica Técnica
Denominação da característica

Página 11 de 29
 Valor da característica.
Denominação do valor da característica
Unidade da característica

BAPI_YCREATE_IE01 - Cadastro Mestre de Equipamento (Emula transação IE01)

– Permite cadastrar equipamentos no SAP a partir de um sistema externo como, por
exemplo, o MAXIMO, ou de um Portal WEB. Emula a transação IE01, cobrando os
mesmos campos da transação IE01.
– Não tem WebService, mas, por ter alteração de dados no SAP pode ser que requeira RFC.

Parâmetro de entrada: FORMA_DE_PROCESSAMENTO =

'N' - Nunca exibe execução da transação
'E' - Exibe se ocorrer erro
'A' - Sempre exibe execução da transação

BAPI_YCREATE_IE02 - Cadastro Mestre p/ Substituir o Local pai de um dado Equipamento

(IE02)
– Permite alterar o local onde um equipamento está montado a partir de um sistema externo
como, por exemplo, o MAXIMO. Emula a transação IE02, cobrando o novo local onde o
equipamento será montado.
– Não tem WebService, mas, por ter alteração de dados no SAP pode ser que requeira RFC.

Parâmetro de entrada: FORMA_DE_PROCESSAMENTO =

'N' - Nunca exibe execução da transação
'E' - Exibe se ocorrer erro
'A' - Sempre exibe execução da transação

BAPI_YCREATE_IL01 - Cadastro Mestre de Local de Instalação (IL01)

– Permite cadastrar locais de instalação no SAP a partir de um sistema externo como, por
exemplo, o MAXIMO, ou de um Portal WEB. Emula a transação IL01, cobrando os
mesmos campos da IL01.
– Não tem WebService, mas, por ter alteração de dados no SAP pode ser que requeira RFC.

Parâmetro de entrada: FORMA_DE_PROCESSAMENTO =

'N' - Nunca exibe execução da transação
'E' - Exibe se ocorrer erro
'A' - Sempre exibe execução da transação

BAPI_YCREATE_IL02 - Cadastro Mestre p/ Substituir o Local pai de um dado local de

instalação (IL02)
– Permite trocar o local pai de um dado local no SAP a partir de um sistema externo ou de
um portal WEB. Emula a transação IL02, cobrando os mesmos campos da IL02 para troca
de local pai.
– Não tem WebService, mas, por ter alteração de dados no SAP pode ser que requeira RFC.

Parâmetro de entrada: FORMA_DE_PROCESSAMENTO =

'N' - Nunca exibe execução da transação
'E' - Exibe se ocorrer erro
'A' - Sempre exibe execução da transação

BAPI_YCREATE_IP04 - Cadastro Mestre p/ Incluir novos itens em planos de manutenção já

cadastrados. (IP04)

Página 12 de 29
 – Permite cadastrar novos itens de plano no SAP a partir de um sistema externo, ou de um
Portal WEB. Emula a transação IP04, cobrando os mesmos campos desta transação.
Notar que esta BAPI apenas cria os itens sem associá-los a nenhum plano. A associação
deve ser feita depois, pelo usuário, no SAP.
– Não tem WebService, mas, por ter alteração de dados no SAP pode ser que requeira RFC.

Parâmetro de entrada: FORMA_DE_PROCESSAMENTO =

'N' - Nunca exibe execução da transação
'E' - Exibe se ocorrer erro
'A' - Sempre exibe execução da transação

BAPI_YCREATE_IP41 - Cadastro Mestre de Planos c/ um item (transação IP41-ciclo

individual) - Permite cadastrar Planos de Preventiva de Ciclo Simples no SAP a partir de um
sistema externo, ou de um Portal WEB. Emula a transação IP41, cobrando os mesmos campos
da respectiva transação. Cabe notar que não tem WebService

Parâmetro de entrada: FORMA_DE_PROCESSAMENTO =

'N' - Nunca exibe execução da transação
'E' - Exibe se ocorrer erro
'A' - Sempre exibe execução da transação

BAPI_YCREATE_IP42 - Cadastro Mestre de Planos c/ Estratégia e um item (Transação IP42 –

criação de planos de estratégia)
– Permite cadastrar Planos de Preventiva tipo Estratégia no SAP a partir de um sistema
externo, ou de um Portal WEB. Emula a transação IP42, cobrando os mesmos campos da
respectiva transação.
– Não tem WebService, mas, por ter alteração de dados no SAP pode ser que requeira RFC.

Parâmetro de entrada: FORMA_DE_PROCESSAMENTO =

'N' - Nunca exibe execução da transação
'E' - Exibe se ocorrer erro
'A' - Sempre exibe execução da transação

BAPI_YEQUI_YGET_DETAIL2 – Esta BAPI retorna dados técnicos de um ou mais

equipamentos com suas respectivas características técnicas e respectivos valores. Foi
desenvolvida para o MCC-NET, mas pode ser usada para outros sistemas. Foi desenvolvido
serviço para esta BAPI, chamado pelo nome de osEquipmentGetDetail2 que ainda está em
PEQ pois o MCC-NET não fez ainda o lado legado da interface.

Parâmetros de entrada:
Número do Equipamento
Campo de Seleção
Centro de Localização (obrigatório)
Grupo de Planejamento

Parâmetros de saída:
Dados Cadastrais dos Equipamentos que atendem às condições de filtro, equivalentes à
transação YSPM_IH08.
Valores das características técnicas atribuídas aos equipamentos.

Página 13 de 29
BAPI_YLIST_YCATALOG_LOCAL – Esta BAPI, a partir da informação de um dado
equipamento ou um dado Local de Instalação, com base em seu perfil de catálogo, informa todos
os tipos de catálogos, groups codes, descrições dos groups codes, códigos dos catálogos e
descrição dos catálogos que uma nota de falha vinculada a este objeto poderia de receber. Foi
desenvolvida para o MCC-NET, mas pode ser usada para outros sistemas. Foi desenvolvido
webservice para esta BAPI, chamado pelo nome de osCatalogGetList que ainda está em PEQ
pois o MCC-NET não fez ainda o lado legado da interface. É obrigatório informar um local de
instalação ou equipamento.

Parâmetros de entrada:
Número do Equipamento
Código do Local de Instalação
Perfil de Catálogo
Tipo de Catálogo

Parâmetros de saída:
Perfil de Catálogo, tipo de catálogo, group code, descrição do group code, código de
catálogo e descrição do código.

BAPI_YREAD_CENT_WORK – Esta BAPI, a partir da informação de um Centro de

Planejamento, retorna os centros de trabalho vinculados a este centro, com vários atributos
cadastrais importantes. Foi desenvolvida para o MCC-NET, mas pode ser usada para outros
sistemas. Foi desenvolvido serviço para esta BAPI, chamado pelo nome de
osWorkCenterGetDetail que ainda está em PEQ pois o MCC-NET não fez ainda o lado legado
da interface. É obrigatório informar um centro.

Parâmetros de entrada:
Centro de Planejamento (obrigatório)
Tipo de Centro de Trabalho
Data Fim de Validade do centro de Trabalho

Parâmetros de saída desta BAPI:

Centro
Tipo de Centro de Trabalho (os de manutenção são Z005)
Centro de trabalho
Data do início
Data do fim
Chave de controle
Centro de custo
Tipo de atividade
Chave de fórmula para cálculo de custo
Denominação breve
Número de capacidades individuais
Tipo de capacidade
Grau de utilização em porcentagem

BAPI_YNOTIFICATIONS_YGET_LIST2 – Esta BAPI retorna uma lista de notas com todos os

atributos exibidos na IW29, a partir de um filtro um pouco mais elaborado, detalhado abaixo. Foi
desenvolvido serviço para esta BAPI, chamado pelo nome de osNotificationsGetList2 que ainda
está em PEQ pois o MCC-NET não fez ainda o lado legado da interface..

Página 14 de 29
Parâmetros de entrada:
Centro de Localização (obrigatório)
Local de Instalação
Equipamento
Data inicial de pesquisa de notas
Data final de pesquisa de notas
Tipo de Nota
Status Inclusivos
Status Exclusivos

Parâmetros de saída:
Atributos de notas exibidos na transação IW29.

BAPI_YMODO_YFALHAS_OPER – Esta BAPI, com base em um equipamento ou um local de

instalação informado, lê o “Perfil de Catálogo” do equipamento ou local de instalação na
respectiva tabela. Se não encontrou perfil de catálogo, assume o valor “PM_GERAL” para perfil de
catálogo. Com o perfil de catálogo, o sistema devera realizar uma consulta entre as tabelas T352C
e QPCD para os catálogos tipo “R”, retornando o Grupo de Codes, Texto breve do Grupo de
Codes, o Código e o Texto Breve do Código associados ao Perfil de Catálogo encontrado. Foi
desenvolvida para o GIOM, e como tal sistema é executado no ambiente MII, não houve
necessidade de desenvolver Webservice. Se algum outro sistema que dependa de Webservive
precisar utilizar esta BAPI, a Agilidade Responsável deverá contatar o CCI, conforme explicado na
página 1 deste documento.

Entrada:
Local de Instalação (TPLNR):
Equipamento (EQUNR):
Deve ser informado ou um Local de Instalação ou um Equipamento (mutuamente exclusivo).

Saída:
Relação dos Modos de Falha (tipo de código, grupo de código, código e descrição) que
podem ser atribuídos para o local de instalação ou equipamento informado.

BAPI_YFUNCLOC_YGETH_CENTRO_OP - BAPI para Listar os Locais de Instalação que

pertençam a um determinado Centro de Localização, uma determinada Área Operacional e por
Categoria do Local de Instalação.
Foi desenvolvida para o GIOM, e como tal sistema é executado no ambiente MII, não houve
necessidade de desenvolver Webservice. Se algum outro sistema que dependa de Webservive
precisar utilizar esta BAPI, a Agilidade Responsável deverá contatar o CCI, conforme explicado na
página 1 deste documento.

Entrada:
Centro de Localização (SWERK):
Área Operacional (BEBER):
Categoria do Local de Instalação (FLTYP)
É obrigatório preencher o centro e, pelo menos, mais um atributo de entrada.

Saída:
Relação de locais que atendem ao requisito de filtro solicitado, com os principais campos
da YSPM_IH06. Indica também se estes locais tem filhos.
A BAPI pode ser lenta quando tem muitos registros.

Página 15 de 29
BAPI_YBNOTE_YSAVE_OPER - Permite criar notas, encapsulando a BAPI standard
BAPI_ALM_NOTIF_CREATE e acrescentando os campos de Tipo de Intervenção
(YYTIPO_INTERV), Severidade de Meio Ambiente (YYSEVER_MEIOAMB), Severidade de
Segurança (YYSEVER_SEGUR), Severidade de Produção (YYSEVER_PRODUCAO), Efeito
Falha (YYEFEITO_FALHA), Origem da Falha (YYORIGEM_FALHA), Campo de SMS denominado
“Área de Aplicação” (YYAREA_AP), Objetivo Setorial (YYOBJ_SET) e Sub-tipo de Ordem SMS
(YYGRP_ORD). Com isto, temos a BAPI standard que cria notas devidamente encapsulada, e
também garantimos a gravação dos campos exigidos no desenho Petrobras de Notas.

Entrada:
Todos os campos relevantes para nota da transação IW21.

A tela inicial de entrada tem os seguintes campos (negritei os obrigatórios):

REF_USER (usuário – chave do usuário que está criando a nota).
P_LANGU (idioma – sempre PT)
P_COMMIT (sempre deve conter “X”).
P_COMMIT_WAIT (sempre em branco)
P_NOTIF_NO (número da nota – estamos criando, então deve ficar em branco).
P_HEADER (conjunto de campos do cabeçalho da nota, listados abaixo).
P_PARTNER (campos de parceiro), comentados abaixo).
P_ADD_INF (campos de inicialização).
P_LT_HEADER (campo de texto longo da nota)
P_LT_PROCED (campo de texto longo do procedimento)
P_LT_ANOMALIA (campo de texto longo de informações sobre anomalia).
P_LT_OBS (campo de texto longo de observações).
P_LT_PONTO_REF (campo de texto longo de referência).

Campos do P_HEADER (os campos importantes foram negritados):

MANDT - Mandante
QMNUM – Número da Nota (fica em branco porque é criação)
IWERK – Centro de Planejamento
ILOAN – Localização / Classif. Contábil.
ILOAI – ILOA individual
EQUNR – Número do equipamento (obrigatório o equipamento ou o Local – TPLNR)
BAUTL - Conjunto
EBORT – Local de montagem (não usado na Petrobras)
MSAUS – Código de Parada (quando tem parada, enviar “X”).
AUSVN – Data início avaria/parada
AUSBS – Data fim avaria / parada.
AUZTV – Hora de Início da Avaria
AUZTB – Hora de término da avaria.
AUSZT – Duração da Parada (o sistema calcula se início e fim da avaria estão preenchidos e
Parada marcado).
MAUEH - Unidade de tempo da duração.
BTPLN – Local afetado.
BEQUI – Equipamento afetado.
AUSWK - Consequência para o funcionamento
VERFV - Disponibilidade da instalação antes da avaria
VERFN - Disponibilidade da instalação depois da avaria
VERFM - Disponibilidade após encerramento da medida
ANLZV - Condições da instalação antes da avaria
ANLZN - Condições da instalação depois da avaria
ANLZE - Condições da instalação após a medida de manutenção
INSPK - Nome do responsável pelo controle técnico (não usado no PM)
DATAN - Data de controle técnico (não usado no PM).
INGRP – Grupo de Planejamento (com base no equipamento ou local o sistema assume o Grupo

Página 16 de 29
de Planejamento).
WARPL – Plano de Manutenção associado à nota.
ABNUM - Nº da solicitação de manutenção (não usado em PM).
WAPOS – Número de Item de manutenção
SCREENTY - Cenário ou ctg.subtela (não usado em PM na Petrobras).
REVNR - Revisão manutenção e serviço de cliente (ainda não usado em PM)
QMART - Tipo de nota (Obrigatório = ZC ou ZS ou ZF ou ZI ou ZE ou ZR).
QMTXT - Texto breve da Nota (obrigatório, no máximo 40 caracteres).
ARTPR - Tipo de prioridade (não usado em PM)
PRIOK – Prioridade (em PM é gravada automaticamente a partir de impacto falha x
tipo intervenção).
ERNAM – Responsável pela criação da nota.
ERDAT – Data de Criação (preench. Automático)
AENAM – Responsável pela última atualização
AEDAT – Data da última modificação
MZEIT – Hora da Nota
QMDAT – Data da nota
QMNAM – Autor da nota (Obrigatório em PM).
STRMN – Data de início desejada
STRUR – Hora de início desejada
LTRMN – Data de Conclusão desejada
LTRUR – Hora de Conclusão desejada
WAERS – Código da Moeda (não usado em PM)
AUFNR – Número da Ordem (quando cria nota este campo está sempre em branco).
VERID – Versão de Produção (não usado em PM)
RM_MATNR - Nº de material da versão de produção (não usado em PM)
RM_WERKS - Centro da versão de produção (não usado em PM)
SA_AUFNR - Nº ordem de produção repetitiva (não usado em PM)
MATNR – Número do Material – não usado em PM
REVLV – Nível de Revisão – não usado em PM
MATKL - Grupo de mercadorias (não usado em PM)
PRDHA - Hierarquia de produtos (não usado em PM)
KZKRI - Código: peça crítica (não usado em PM)
KZDKZ - Código para documentação obrigatória (não usado em PM)
KUNUM - Nº conta do cliente (não usado em PM)
FEKNZ - Existem registros de erros (não usado em PM)
MAKNZ - Registros de medidas existentes (não usado em PM)
OBJNR - Nº objeto para administração de status (não usado em PM)
QMDAB - Data de encerramento da nota (automático)
QMZAB - Hora de encerramento da nota (automático)
RBNR - Perfil do catálogo (o sistema copia do local ou equipamento)
RBNRI - Origem do perfil de catálogo p/e notas
INDTX - Existe texto descritivo para o objeto
KZMLA - Código: Segmento de texto em idioma principal
HERKZ - Origem da nota (não usado em PM)
BEZDT - Data de referência da nota PM
BEZUR - Hora de referência da nota
LIFNUM - Nº conta do fornecedor (não usado em PM)
BUNAME - Autor de uma nota QM/PM (não usado em PM)
VBELN - Nº ordem do cliente BSTNK (não usado em PM)
BSTNK - Nº pedido do cliente
BSTDK - Data do pedido do cliente
SPART - Setor de atividade
VKORG - Organização de vendas
VTWEG - Canal de distribuição
ADRNR - Endereços: nº do endereço
AEZEIT - Hora de modificação (automático)
ERZEIT - Hora da criação do registro (automático)

Página 17 de 29
MAWERK - Centro para material (não usado em PM)
QMKAT - Tipo de catálogo – codificação (pode ser preenchido)
QMGRP - Grupo de codes – codificação (Grupo de Modos de Falha)
QMCOD - Codificação (Modo de Falha – obrigatório p/ZF)
AUSWIRK - Chave para um cenário
TEILEV - Utilização de partes
PRUEFLOS - Nº lote de controle
CHARG - Número do lote
LGORTCHARG - Depósito do lote
LICHN - Nº lote do fornecedor
HERSTELLER - Nº fabricante
EMATNR - Nº material para nº peça de fabricante
EKORG - Organização de compras
BKGRP - Grupo de compradores
LGORTVORG - Depósito para estoque de lote de controle
FERTAUFNR - Nº ordem (ordem de produção)
FERTAUFPL - Nº roteiro para operações na ordem (ordem de produção)
EBELN - Nº do documento de compras
EBELP - Nº item do documento de compra
MJAHR - Ano do documento do material
MBLNR - Nº documento de material
MBLPO - Item no documento do material
LS_KDAUF - Nº ordem do cliente
LS_KDPOS - Nº item do documento de vendas e distribuição
LS_VBELN - Fornecimento
LS_POSNR - Item de remessa
CROBJTY - Categoria de objeto para recurso CIM
ARBPL - ID-objeto do centro trabalho
ARBPLWERK - Centro para centro de trabalho
FEART - Tipo de catálogo para entrada de defeitos
PNLKN - Nº nó sequencial do numerador de ordens QPLZL
MGEIG - Qtd.defeituosa interna
MGFRD - Qtd.defeituosa externa
MGEIN - Unidade de medida
BZMNG - Qtd.de referência geral
RKMNG - Qtd.reclamada
RGMNG - Qtd.devolvida
RKDAT - Data da devolução
COAUFNR - Nº ordem (ordem QM)
QWRNUM - Nº modelo da nota
REFNUM - Nº de referência externo
KDMAT - Nº material usado pelo cliente
IDNLF - Nº material atribuído pelo fornecedor
SERIALNR - Nº de série
KZLOESCH - Código: eliminar registro de dados
PRODDAT - Data de produção
DEVICEID - Dds.adics.dispos.
VKBUR - Escritório de vendas
VKGRP - Grupo de vendedores
AUTKZ - Reg.de dados foi criado através da função 'Criar com modelo'
BEDID - ID do registro de necessidade de capacidade
PROFIL_TYP - Tipo de objeto
PROFIL_ID - ID objeto
HANDLE - Chave unívoca mundial (conexão segmento de datas, etc.)
TSEGFL - Segmento de tempo existente
TSEGTP - Modelo
TZONSO - Fuso horário para a nota
TZONID - Origem do fuso horário da nota

Página 18 de 29
YYIMPACTO_FALHA - Identificador do Impacto da Falha
YYTIPO_INTERV - Identificador do Tipo de Intervenção
YYLGORT - Depósito
YYFLAG_CRIACAO - Flag que Indica se Nota foi criada a partir da Ordem
YYSEVER_MEIOAMB - Severidade Meio Ambiente a no Menu confiab. Nota
YYSEVER_SEGUR - Severidade Segurança no Menu confiabilidade Nota
YYSEVER_PRODUCAO - Severidade Produção no Menu confiabilidade Nota
YYATENDIMENTO_RI - Numeração para relação de RTI
YYLEIT_HORIMETRO - Numeração para Leitura de Horímetro Confiabilidade
Nota PM
YYLEIT_CONT_PART - Leitura do contador de partida menu confiabilidade
nota PM
YYEFEITO_FALHA - Codificação de Efeito da falha para nota de manutenção
YYATEND_PRAZOS - Avaliação do Prazo para o Serviço
YYATEND_QUALID - Avaliação da Qualidade para o Serviço
YYATEND_ATENDIM - Avaliação do Atendimento para o Serviço
YYUNAME - Nome do usuário
YYATEND_CUSTO - Avaliação do Custo para o Serviço
YYPEDIDO - Número do Pedido de Análise
YYBATELADA - Batelada
YYVOLUME - Volume Reposto em Litros
YYCOLETA - Data de Coleta
YYUSO - Período de Uso
YYMEINS - Unidade do Período de Uso
YYLUBEXP - Determina Impressão do Cert. Qual. Lubrax Express
YYCONTROLE - Controle do Cliente
YYDT_INIPREVAT - Previsão de Atendimento RT - data de início
YYHR_INIPREVAT - Previsão de Atendimento RT - hora de início
YYDT_FIMPREVAT - Previsão de Atendimento RT - data de fim
YYHR_FIMPREVAT - Previsão de Atendimento RT - hora de fim
YYDT_INIREALAT - Realização de Atendimento RT - data de início
YYHR_INIREALAT - Realização de Atendimento RT - hora de início
YYDT_FIMREALAT - Realização de Atendimento RT - data de fim
YYHR_FIMREALAT - Realização de Atendimento RT - hora de fim
YYTEMPO - Tempo (em decimais)
YYCONSUMO - Consumo
YYUNICONS - Unidade de medida do registro
YYPMD - Peso Máximo de Decolagem
YYPBO - Peso básico operacional
YYCENARIO - Cenário
YYTIPOPER - Tipo operação programação aérea
YYEFEITO_SOLO - Efeito solo para programação aérea
YYPLANO_DE_VOO - Plano de Vôo
YYLOCAL_ALTERN - Local de instalação
YYNV_IDA - Nível de vôo de ida
YYNV_VOLTA - Nível de vôo de volta
YYNVEU - Nível de Vôo entre Unidades
YYTEMPERATURA - Temperatura
YYFATREDINDPAR - Fator de redução Ind. Parcial
YYGRP_ORD - Sub-tipo de Ordem
YYOBJ_SET - Objetivo Setorial
YYAREA_AP - Área de Aplicação
YYCODTRA - Modal de Transporte
YYPORTE - Porte equipamento
YYCOMANDANTE - Comandante ou Piloto
YYSEG_CMDTE - Segundo Piloto
YYCOMISSARIO - Comissário
YYMOTORISTA - Motorista/Operador

Página 19 de 29
YYVERSAO - Numero da versão do atendimento
YYPONTO_COLETA - Ponto de Coleta
YYHORA_COLETA - Hora da Coleta
YYPOCO - Local de Instalação - Poço
YYCAMPO - Campo
YYINTERVALO - Intervalo
YYZONA - Zona
YYTOPO - Altura do topo de um intervalo no poço
YYALTBASE - Altura da base de um intervalo no poço
YYCD_GRUPO - Código do grupo de ensaio do SIRR
YYTESTE - Teste
YYFORMACAO - Formação
YYAT_EVENTO - Pagamento por evento
YYPRCONJ - Flag de programação de conjunto de transporte
YYATENDIMENTO - Número do atendimento.
YYAMOSTRADOR - Nome do amostrador
YYCONF - Configuração Padrão
YYKOSTL - Centro de custo
YYQM_KOSTL - Centro de Custo
YYQUEBRA_AT - Flag indic Atendimento gerado por quebra Equipamento
YYUN_INTERV - Unid.medida do intervalo
YYTRANSBORDO - Transbordo
YYDESPACHANTE - Despachante Operacional ou Coordenação de Vôo
YYORIGEM_FALHA - Lista de opções de origem de falha
YYORDEM_ORIGEM - Ordem Origem
YYNOTA_ORIGEM - Nota Origem
YYETIQUETA - Etiqueta de intervenção
YYCODANALIRISCO - Código de Análise de Risco
YYPLAQUETA - Plaqueta de Intervenção
YYCAMPANHA - Em campanha
YYTRAB_ALTURA - Trabalho em altura
YYESPACO_CONF - Espaço Confinado
YYINSTR_CRITICO - Instrumento Crítico
YYCODMATRIZLIBRA - Matriz Libra
YYMLIBRANOTAPPLY - Matriz Libra - Não se aplica
YYPITEMPERATURA - Temperatura
YYPITEMPNOTAPPLY - Temperatura - Não se aplica
YYTENSAO - Tensão
YYTENSAONOTAPPLY - Tensão - Não se aplica
YYFLUIDO - Fluído
YYCLASSFLUIDO - Classificação (do Fluído)
YYFLUIDONOTAPPLY - Fluído - Não se aplica
YYPRESSAO - Pressão
YYPRESSNOTAPPLY - Pressão - Não se aplica
YYCLASSPLAQUETA - Classificação (da Plaqueta)
YYPLAQUENOTAPPLY - Plaqueta - Não se aplica
YYNIVELAR - Nível da Análise de Risco
YYFLGADTCP_AR - Necessita ADTCP
YYNUM_GM - Gestão da Mudança
YYAPMANUTLIB - Depende de apoio da manutenção para liberação Portal Interv.
KOSTL1 - Centro de custo
KOKRS1 - Área de contabilidade de custos
TPLNR - Local de instalação
ABCKZ - Código ABC para o objeto técnico
EQFNR - Campo de seleção
SWERK - Centro de localização
STORT - Localização do objeto de manutenção
MSGRP - Sala

Página 20 de 29
 BEBER - Área operacional
PPSID - ID de objeto do centro de trabalho PCP
GSBER - Divisão
KOKRS - Área de contabilidade de custos
KOSTL - Centro de custo
PROID - Elemento do plano da estrutura do projeto (elemento PEP)
ANLNR - Nº principal do imobilizado
ANLUN - Subnº do imobilizado
DAUFN - Nº ordem permanente
KAUFN - Ordem p/apropriação de custos
BUKRS - Empresa
ABCKZI - Origem dos dados para campo 'código ABC'
EQFNRI - Origem dos dados para o campo 'campo de seleção'
SWERKI - Orig.dados para o campo 'centro de localização'
STORTI - Origem dados para o campo 'localização'
MSGRPI - Origem dados para o campo 'nº da sala'
BEBERI - Origemdos dados para campo 'área operacional'
CR_OBJTY - Categoria de objeto para recurso CIM
PPSIDI - Origem dados para o campo 'centro trab.PCB'
GSBERI - Origem dos dados para o campo 'Divisão'
KOKRSI - Origem dos dados para o campo 'área contab.custos'
KOSTLI - Origem dos dados para o campo 'centro de custo'
PROIDI - Origem dados para o campo 'elemento PEP'
BUKRSI - Origem dos dados para os campos 'empresa'
ANLNRI - Origem dados p/campos 'nº principal-instalação' e 'subnºs'
ANLUNI - Indicador: Origem dos dados
DAUFNI - Origem dos dados para o campo 'nº ordem permanente'
AUFNRI - Origem dos dados para campo 'ordem de apropriação'
SPART_ILOA - Setor de atividade
VTWEG_ILOA - Canal de distribuição
SPARTI - Origem dados para o campo 'setor de atividade'
VTWEGI - Origem dados para o campo 'canal de distribuição'
VKORGI - Origem dados para o campo 'organização de vendas'
VKORG_ILOA - Organização de vendas
ADRNR_ILOA - Nº endereço
OWNER - Código referência de objeto
KDAUF - Documento de vendas
KDPOS - Item do documento de vendas
PLNTY - Tipo lista tarefas
PLNNR - Chave para grupo de roteiros
PLNAL - Numerador de grupos

Campos do P_PARTNER:
PARTN_ROLE – Função do Parceiro (A Gerência solicitante tem a função ZG)
PARTNER – Parceiro (deve ser um código válido – ver lista de parceiros tipo ZG)
IS_OLD

Campos de P_ADD_INF: Estes campos não interessam para PM.

Saída:
Nota criada.
A BAPI serve para todos os tipos de notas de manutenção e, inclusive, para notas de Poços.

Observação importante: Foi criada a transação YSPM_CRIANOTA para testar esta BAPI nos
ambientes PED e PE2.

Página 21 de 29
BAPI_YNOTIF_YGETLIST_PAINEL_OP - Esta BAPI retorna uma lista de notas relacionadas
a um determinado filtro, conforme parâmetros de entrada definidos a seguir, com as mesmas
informações exibidas na transação IW29, e utilizadas pela Petrobras. Foi desenvolvida para
atender a interface do GIOM, mas pode ser usada por outros sistemas. Não tem Webservice
porque o GIOM opera em ambiente MII.

Entradas:
Centro de Localização (SWERK):
Local de Instalação (TPLNR)
Equipamento (EQUNR)
Última Modificação (AEDAT)
Data de Início
Data de Término
Tipo de Nota (QMART)
Status Inclusivo
Status Exclusivo
Deve ser informado pelo menos o centro de localização e mais algum campo, entre eles, ou local,
ou equipamento, ou, pelo menos uma data, com range menor que 180 dias, senão dá erro, devido
ao potencial número grande de registros.

Saída:
Campos de nota exibidos na IW29.

BAPI_YORDERS_YGETLIST_PAINELOP - Esta BAPI retorna uma lista de ordens

relacionadas a um dado local ou equipamento, com as mesmas informações exibidas na
transação IW39, em uso na Petrobras. Atende às interfaces do Painel Operacional (GIOM), e não
tem Webservice, pois este sistema é executado em ambiente MII.

Entrada:
Centro de Localização (SWERK):
Local de Instalação (TPLNR):
Equipamento (EQUNR):
Última Modificação (AEDAT) :
Data de Início:
Data de Término:
Tipo de Ordem (AUFART):
Status Inclusivo:
Status Exclusivo:
Plano de Manutenção (WARPL):
Deve ser informado pelo menos o centro de localização e mais algum campo, entre eles, ou local,
ou equipamento, ou, pelo menos uma data, com range menor que 180 dias, senão dá erro, devido
ao potencial número grande de registros.

Saída:
Campos de ordem exibidos na IW39.

BAPI_YFUNCLOC_YGETHIERARCHY_OP – Esta BAPI oferece uma lista dos locais filhos de

um dado local informado, e informa também se eles tem filhos ou não (indica 1 quando tem filhos
e 0 quando não tem), e também uma lista dos equipamentos montados no local informado, bem
como de eventuais “filhos” destes equipamentos. É utilizada pelo Painel Operacional (GIOM),
mas poderá ser usado por qualquer outro sistema legado. Permite montar, em sistema legado, ou
na WEB, uma árvore de objetos técnicos similar à da transação IH01. Não tem Webservice.

Página 22 de 29
Entrada:
Local de Instalação (TPLNR)
Equipamento (EQUNR)
Deve ser informado ou um Local de Instalação ou um Equipamento (mutuamente exclusivo).

Saída:
Locais e equipamentos filhos imediatos do Local informado, com alguns atributos,
inclusive a identificação de se possuem filhos.
Se o que foi informado é um equipamento, retornarão os equipamentos filhos deste
equipamento, com indicação de se possuem filhos.
Notar que a saída ocorre em tabelas diferentes;

BAPI_YNOTE_YINFO – Esta BAPI lê informações das notas ZF, ZS e ZR para disponibilização

no Banco de Dados de Confiabilidade. Foi preparada para tráfego de dados via ETL, para o
Banco de Dados de Confiabilidade, do CENPES (contato: Everton Nogueira Lima, chave URQJ)
mas também poderá ser utilizada via serviço se não houver muitos dados para trafegar. Não tem
Webservice desenvolvida.

Parâmetros de entrada:
Centro (obrigatório para a consulta em background)
Período: data início e data fim de pesquisa.
Filtros Opcionais: QMNUM (Número da Nota), QMART (tipo da nota), SWERK (centro de
localização).

Parâmetros de saída: Os principais campos de saída da transação IW29, mais os códigos de

falha.

BAPI_YORDERCAD_YLEITURA – Esta BAPI lê o cadastro de Ordens e também foi preparada

para processar via ETL. Mas poderá ser usada também via serviço se o filtro for por número de
ordem. Não tem Webservice. Também foi preparada para o Banco de Dados de Confiabilidade
do CENPES (contato: Everton Nogueira Lima, chave URQJ).

Parâmetros de entrada:
Centro de Localização (pode ser mais de um)
Data de criação ou data de modificação da ordem (se só existe data de criação, utilizar
esta, mas se existe data de modificação, usar a última).
Tipo de Ordem (opcional)
Número de Ordem (opcional)

BAPI_YLEITURA_YEQUIP - Esta BAPI lê os dados cadastrais de equipamentos e foi

preparada para processar via ETL. Poderá ser usada via serviço se não houver muitos dados
para trafegar. Não tem Webservice. Também foi preparada para o Banco de Dados de
Confiabilidade do CENPES (contato: Everton Nogueira Lima, chave URQJ).

Parâmetros de entrada:
Centro de Localização e Faixa de datas de criação ou modificação (obrigatório)
Número de Equipamento (opcional)
Área Operacional (opcional)
Grupo de Planejamento (opcional)

Parâmetros de Saída: Principais dados de saída da transação YSPM_IH08.

Página 23 de 29
BAPI_YLEITURA_YTECN_YEQUIP – Esta BAPI lê as Características Técnicas dos
equipamentos e foi preparada para processamento via ETL. Poderá ser usada via serviço se não
houver muitos dados para trafegar. Não tem Webservice.

Parâmetros de entrada:
Centro de Localização e Faixa de datas de criação ou modificação (obrigatório)
Número de Equipamento (opcional)
Área Operacional (opcional)
Grupo de Planejamento (opcional)

Parâmetros de saída:
Equipamento
Tipo do Objeto
Classe
Cód da característica
Valor da característica alfanumérica
Valor interno vírgula flutuante desde
Unidade medida

Observação importante: Esta BAPI, por ser mais antiga, tem performance inferior à desenvolvida
para a mesma finalidade para o APLAT, listada mais acima.

BAPI_YLEITURA_YLOCINST – Esta BAPI lê dados cadastrais de Local de Instalação e foi

preparada para tratar os dados via ETL. Foi desenvolvida para o Banco de Dados de
Confiabilidade do CENPES (2010). Não tem Webservice.

Parâmetros de entrada:
Centro de Localização (obrigatório e pode ser mais de um)
Faixa de datas da criação ou modificação de local de instalação (obrigatório)
Área Operacional (opcional)
Grupo de Planejamento (opcional)
Local de Instalação (opcional)

Obs.: Internamente a BAPI valida se, pelo menos, centro de localização e faixa de datas para
pesquisa foi informado.

BAPI_YEQUI_YGETDETAIL – Esta BAPI retorna dados técnicos de um dado equipamento

(principais campos da transação YSPM_IH08), com suas respectivas características técnicas. Foi
desenvolvida para o Proteus, mas já é usada também pelo GIS e GiOP. Foi desenvolvido
webservice para esta BAPI, chamado pelo nome de osYEquiYGetDetail.wsdl.

Parâmetros de entrada:
Número do Equipamento

BAPI_YLOCALINST_YGETDETAIL Esta BAPI retorna dados técnicos de um dado local de

instalação (principais campos da transação YSPM_IH06) com suas respectivas características
técnicas. Foi desenvolvida para o Proteus, mas já é usada também pelo GIS e GiOP. Foi
desenvolvido webservice para esta BAPI, chamado pelo nome de osYLocalInstYGetDetail.wsdl.

Parâmetros de entrada:
Código do Local de Instalação

Página 24 de 29
BAPI_YMAINTPLAN_YGETLIST – Esta BAPI retorna a lista de planos de manutenção
associados a um local ou equipamento, com um conjunto de dados similar aos da transação IP24.
Foi também desenvolvido pelo Proteus, mas vem sendo usada por alguns sistemas adicionais.
Também esta interface tem webservice, com o nome de osYMaintPlanYGetList.wsdl.

Parâmetros de entrada da BAPI:

Código do Local ou Número do Equipamento (um destes campos deve ser preenchido)
Data início da seleção da Data de Programação do Plano (opcional)
Data de Fim da Seleção da Data de Programação do Plano (opcional)

Obs.: Internamente a BAPI valida se, pelo menos, local ou equipamento foi informado.

Parâmetros de saída:
Os principais campos de saída da transação IP24.

BAPI_YNOTIFICATIONS_YGETLIST – Esta BAPI retorna uma lista de notas relacionadas a

um dado local ou equipamento, com as mesmas informações exibidas na transação IW29, e
utilizadas pela Petrobras. Foi desenvolvida para atender a interface do Proteus, mas vem sendo
usada por mais sistemas. Também esta interface contém Webservice, com o nome de
osYNotificationsYGetList.wsdl.

Parâmetros de entrada da BAPI:

Código do Local ou Número do Equipamento (um destes campos deve ser preenchido)
Data início da seleção da Data da nota (opcional)
Data de Fim da Seleção da Data da Nota (opcional)
Tipo de Nota (opcional)

Obs.: Internamente a BAPI valida se, pelo menos, local ou equipamento foi informado.

BAPI_YORDERS_YGETLIST – Esta BAPI retorna uma lista de ordens relacionadas a um dado

local ou equipamento, com as mesmas informações exibidas na transação IW39, em uso na
Petrobras. Atende a interface do Proteus e alguns outros sistemas, como o GiOP. Também esta
interface contém Webservice, com o nome de osYOrdersYGetList.wsdl.

Valores usados como parâmetros para filtrar os registros no SAP. São eles:
Código do Local ou Número do Equipamento (um destes campos deve ser preenchido)
Data início da seleção da Data de criação da Ordem (opcional)
Data de Fim da Seleção da Data de Criação da Ordem (opcional)
Tipo de Ordem (opcional)

Obs.: Internamente a BAPI valida se, pelo menos, local ou equipamento foi informado.

BAPI_YEQUI_YGETLIST – Lista todos os equipamentos modificados após uma determinada

data para um dado centro (ou lista todos os equipamentos do centro, dependendo de como foi
preenchido o filtro de seleção). Não contém Webservice.
Esta BAPI, desenvolvida em 2009, é utilizada por um ETL para o ACET e também para o PMS.

Parâmetros de entrada:
PS_WERKS (Centro) = Campo Obrigatório
PS_STORT (Localização) = Campo opcional
PS_BEBER (Área Operacional) = Campo Opcional
PS_INGRP (Grupo de Planejamento) = Campo opcional
PS_CLASS (Classe) = Campo opcional

Página 25 de 29
 PB_READFULL (Tipo de Leitura: Se = “X” será “Full” e senão será incremental)
PD_DATEREF (Data da última extração de dados) = Campo que só será passado
quando a leitura for incremental.

Parâmetros de saída:
Campos da transação YSPM_IH08.

BAPI_YNOTE_YGETLIST – Lista todas as medidas de Nota ZR modificadas após uma

determinada data para um dado centro (ou lista todas as medidas de nota ZR para o Centro,
dependendo de como foi preenchido o filtro de seleção).
Esta BAPI, desenvolvida em 2009, é utilizada por um ETL para o ACET e era para ser usada
também pelo APLAT (que não chegou a utilizar - usa as no início da lista).

Parâmetros de entrada:
PS_QMNUM (Número da Nota) = opcional
PS_IWERK (Centro) = opcional
PS_INGRP (Grupo de Planejamento) = opcional
PB_READFULL = SPACE(1)
PD_DATEREF (Data de referência – data última extração)
PB_RETURNLONGTEXT (indicação de texto longo – quando branco não vem nada e
quando X vem texto longo).

Obs.: Internamente a BAPI valida se pelo menos um dos três primeiros parâmetros foi informado.

Parâmetros de Saída
Campos de saída da transação IW29

BAPI_YORDEROPER_YGETLIST – Esta BAPI lista todas as ordens modificadas após uma

dada data, com suas respectivas operações. Os campos apresentados são todos os que a
Petrobras usa, da listagem da IW38 e da IW49. Foi preparada para ser usada tanto em ETL como
na forma de serviço, e objetivava atender o APLAT em 2009 (não chegou a ser usada).

Parâmetros de entrada:
PS_AUFNR (Número de Ordem) NÃO INFORMAR
PS_WERKS (Centro) informar obrigatoriamente
PS_INGRP (Grupo de Planejamento) informar opcionalmente
PD_DATEREF (Data de Referência) informar obrigatoriamente
PB_RETURNOPERS = X (com X retorna também operações)
PB_RETURNLONGTEXT = X (com X retorna também textos longos).

BAPI_YNOTE_YCREATEUPDATE – BAPI criada para migrar notas ZR, com respectivas

medidas do ACET para o SAP. É utilizada via serviço RFC. Solicita todos os campos relevantes
para a nota ZR no ambiente Petrobras. Emula a transação IW21 para a Nota ZR.

BAPI_YBOM_MATNR_YGETHIERARCHY – Permite extrair uma lista técnica de materiais por

centro. Trabalha com ETL em Background. Foi feita para o PMS.

Parâmetros de Entrada:
Centro  OBRIGATÓRIO
Tipo de leitura = “ ” (Full = “X” ou Incremental = “ ”) - OBRIGATÓRIO
Data de referência = Data da última extração de dados - OPCIONAL

Página 26 de 29
BAPI_YFUNCLOC_YGETHIERARCHY – Permite listar os locais de um dado centro que foram
modificados depois de uma determinada data. Foi desenvolvida para ser usada por ETL para o
PMS, mas vem sendo utilizada por mais sistemas, sempre em ETL. Não tem Webservice.

Parâmetros de entrada:
Centro (PS_WERKS)  OBRIGATÓRIO
Categ. Local de Instalação = (por Plataforma = “L” ou Centro = “C”) (PC_FLTYP) -
OBRIGATÓRIO
Tipo de leitura = “ ” (Full = “X” ou Incremental = “ ”) (PB_READFULL) - OBRIGATÓRIO
Data de referência = Data da última extração de dados (PD_DATEREF) - OPCIONAL

*Obs1: Sempre que houver um archiving o parâmetro do ETL do tipo de leitura de dados (full ou
incremental) deve ser modificado para full, para que seja possível identificar que um Local de
Instalação foi eliminado da base do SAP. A alteração do parâmetro será feita pelo próprio usuário
no arquivo “.txt” de parâmetros.

*Obs2: Considerar o parâmetro “Centro” como multi-valorado. O limite máximo atual é de 50

centros (centro = char 4). Inicialmente serão tratados apenas 6 Centros.

BAPI_YCHARACT_TPLNR – Esta BAPI lista as características dos locais de instalação com

seus respectivos valores, bem como identifica também a classe a que o local de instalação
pertence. Está preparada para extrair os dados modificados após uma determinada data, ou
todos os dados de um centro (massa grande de dados). Utiliza ETL para extração em
Background, para o PMS, em 2009. Não tem Webservice.

Parâmetros de entrada:
Centro (PS_WERKS)  OBRIGATÓRIO
Categ. Local de Instalação = “L” (por Plataforma = “L” ou Centro = “C”) (PC_FLTYP) 
OBRIGATÓRIO Tipo de leitura = “ ” (Full = “X” ou Incremental = “ ”) (PB_READFULL) 
OBRIGATÓRIO
Data de referência = Data da última extração de dados (PD_DATEREF)  OPCIONAL

*Obs1.: A carga incremental da classe/características será implementada através da data de

modificação do objeto técnico (mesmo que a modificação não tenha sido em um campo
relacionado à Classe ou Característica)

*Obs2: Considerar o parâmetro “Centro” como multi-valorado. O limite máximo atual é de 50

centros (centro = char 4). Inicialmente serão tratados apenas 6 Centros.

Parâmetros de saída:
Objeto Técnico (Local de instalação) (TPLNR)
Tipo do Objeto (FLTYP)
Classe (CLASS)
Código da característica (ATNAM)
Valor da característica alfanumérica (AUSP1)
Valor da característica ponto flutuante (ATFLV)
Unidade característica (DIME2)
Unidade usuário (DIME1)
Data de criação do objeto técnico (ERDAT)
Data de última modificação do objeto técnico (AEDAT)

Página 27 de 29
BAPI_YCHARACT_EQUNR - Esta BAPI lista as características dos equipamentos com seus
respectivos valores, bem como identifica também a classe a que o equipamento pertence. Está
preparada para extrair os dados modificados após uma determinada data, ou todos os dados de
um centro (massa grande de dados). Utiliza ETL para extração em Background, e atende ao PMS
(desenvolvida em 2009).

Parâmetros de entrada:
Centro (PS_WERKS) - OBRIGATÓRIO
Tipo de leitura = “ ” (Full = “X” ou Incremental = “ ”) (PB_READFULL) - OPCIONAL
Data de referência = Data da última extração de dados (PD_DATEREF) - OPCIONAL

*Obs1.: A carga incremental da classe/características será implementada através da data de

modificação do objeto técnico (mesmo que a modificação não tenha sido em um campo
relacionado à Classe ou Característica)

*Obs2: Considerar o parâmetro “Centro” como multi-valorado. O limite máximo atual é de 50

centros (centro = char 4). Inicialmente serão tratados apenas 6 Centros.

Parâmetros de Saída:
Objeto Técnico (EQUNR)
Tipo do objeto (EQTYP)
Classe (CLASS)
Característica (ATNAM)
Valor da característica alfanumérica (AUSP1)
Valor da caracterísitica ponto flutuante (ATFLV)
Unidade característica (DIME2)
Unidade usuário (DIME1)
Data de criação do objeto técnico (ERDAT)
Data de última modificação do objeto técnico (AEDAT)

BAPI_YBOM_EQUNR – Esta BAPI relaciona as listas técnicas de equipamentos de um dado

centro, modificadas após uma determinada data (ou lista todas as listas técnicas caso a opção
seja “FULL”). Foi preparada para ser processada via ETL, para atender o Sistema PMS, da UO-
Rio (2009).
Esta BAPI é similar à transação YSPM_LISTATEC, só que com menos filtros.

Parâmetros de entrada:
Centro (PS_WERKS)  OBRIGATÓRIO
Tipo de leitura = “ ” (Full = “X” ou Incremental = “ ”) (PB_READFULL)  OPCIONAL
Data de referência = Data da última extração de dados (PD_DATEREF)  OPCIONAL

*Obs1.: Este carga deste arquivo será sempre full, para que seja possível a atualização completa,
uma vez que o sistema exclui fisicamente o registro quando uma Lista Técnica é eliminada do
sistema.

*Obs2: Considerar o parâmetro “Centro” como multi-valorado. O limite máximo atual é de 50

centros (centro = char 4). Inicialmente serão tratados apenas 6 Centros.

Parâmetros de Saída:
Tipo do Objeto (EQTYP)
Centro (YYCENTROLOC)
Código do equipamento (EQUNR)
Nº Componente (IDNRK)

Página 28 de 29
Tipo (categoria do item) (POSTP),
Quantidade (MENGE)
Descrição 1 (POTX1)
Descrição 2 (POTX2)
Categoria da Lista Técnica (STLTY)
Código Lista (STLNR)
Status de Lista Técnica (STLST)
Data de criação da lista técnica (ANDAT_HEADER)
Data de última modificação da lista técnica (AEDAT_HEADER)
Data de criação do item da lista técnica (ANDAT_ITEM)
Data de última modificação do item da lista técnica (AEDAT_ITEM)

Página 29 de 29