Guia de integração do SAP S/4HANA para programação da produção com SkyPlanner APS

O S/4HANA disponibiliza suas interfaces de integração como serviços OData liberados, listados no SAP Business Accelerator Hub (api.sap.com). A integração de programação utiliza serviços OData V2. IDocs e BAPIs continuam disponíveis, mas este guia usa as APIs OData liberadas.

Autenticação por edição

• On-premise e Private Edition. Os serviços são ativados no SAP Gateway pela transação /IWFND/MAINT_SERVICE. O usuário de integração precisa dos objetos de autorização correspondentes, como C_AFRU_AWK para confirmações, C_AFKO_AWK para os itens de movimentação de mercadorias lançados com elas e M_PLAF_ORG para ordens planejadas.
• Public Edition. Os serviços são expostos apenas por meio de acordos de comunicação. Seguindo a configuração de comunicação de entrada da SAP, você cria um usuário de comunicação, um sistema de comunicação e um acordo de comunicação no aplicativo Communication Arrangements, com base em um cenário de comunicação SAP (SAP_COM_xxxx). O cenário define quais serviços são expostos e quais métodos de autenticação estão disponíveis:

– baseada em token: fluxos bearer de OAuth, SAML ou OpenID Connect, com propagação de identidade para um usuário de negócio – certificado de cliente – autenticação básica com um usuário técnico de comunicação

A SAP recomenda autenticação por token ou certificado.

Do lado do SkyPlanner, há uma API REST com autenticação JWT, documentada em Swagger/OpenAPI (referência da API). Assim, o middleware cuida da autenticação SAP de um lado e do JWT do outro.

APIs para programação da produção

Serviço	Entidades e ações utilizadas	Finalidade
API_PRODUCTION_ORDER_2_SRV (Production Order, Version 2)	A_ProductionOrder_2, A_ProductionOrderItem_2, A_ProductionOrderOperation_2, A_ProductionOrderComponent_2, A_ProductionOrderStatus_2, A_ProductionRsceTools_2; ações ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Ordens, operações, componentes, PRTs, status e gravação da programação no SAP
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Centros de trabalho, categorias de capacidade, intervalos e turnos
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Roteiros de produção padrão para planejar antes da criação das ordens
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Estrutura de produto multinível
API_PRODUCT_SRV (Product Master A2X)	A_Product	Materiais (chamados de Product na API). A SAP agora recomenda a API Product (Version 2) para a maioria das entidades de produto
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Resultados do MRP Live antes da conversão
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Estoque por centro e depósito, para verificar a disponibilidade de materiais
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Pedidos de compra em aberto para materiais a receber
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; ações GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Confirmações e movimentações de mercadorias do chão de fábrica

Na API de ordens de produção, as operações são identificadas pelas chaves OrderInternalBillOfOperations e OrderIntBillOfOperationsItem, não pelo número da operação que o planejador vê. A ação GetConfProposal da API de confirmações identifica a mesma operação por OrderID e OrderOperation. Armazene as chaves internas e o número da operação no SkyPlanner desde a primeira carga.

Eventos

O S/4HANA emite os eventos de negócio Production Order Created e Production Order Changed com ManufacturingOrder, ProductionOrder, ProductionOrderType e ProductionPlant no payload. O payload contém apenas chaves, por isso a integração relê a ordem e suas operações. O evento Changed é disparado a cada alteração na ordem, portanto aplique debounce. No sentido inverso, os webhooks do SkyPlanner enviam notificações em tempo real quando a programação ou o estado de uma operação muda.

Comece com arquivos

Para o teste, exporte ordens de produção e centros de trabalho dos relatórios de lista do S/4HANA para Excel ou CSV e importe os arquivos no SkyPlanner. Isso valida a programação antes de qualquer intervenção no Gateway ou nos acordos de comunicação.

1. Carga de dados mestres. Carregue materiais, BOMs, centros de trabalho com seus intervalos de capacidade e turnos, e roteiros de produção. Defina nesta etapa qual sistema será responsável pelos turnos. Uma divisão que funciona: o calendário de fábrica fica no S/4HANA, enquanto as escalas detalhadas de turnos, as ausências e as horas extras ficam no SkyPlanner, onde os planejadores fazem alterações diariamente.

2. Sincronização de ordens. Assine os eventos Production Order Created/Changed ou consulte periodicamente A_ProductionOrder_2 pelo registro de data e hora da alteração quando os eventos de negócio não estiverem configurados. Filtre por centro, tipo de ordem e status. Envie as ordens assim que forem criadas para que o SkyPlanner possa planejar com antecedência e libere-as no S/4HANA (ReleaseOrder ou ReleaseOperation) depois que o SkyPlanner as programar.

3. Gravação da programação no SAP. Quando um webhook do SkyPlanner informa uma alteração na programação, a integração chama ScheduleProductionOrderOperation em API_PRODUCTION_ORDER_2_SRV para cada operação alterada. Ela envia:

• ManufacturingOrder, OrderInternalBillOfOperations e OrderIntBillOfOperationsItem como chaves
• OpSchedulingMode F (para a frente), com o início definido pelo SkyPlanner em OpSchedldStartDate e OpSchedldStartTime
• OpSchedulingStatus DISP (despacho) e o campo obrigatório OpSchedulingStrategy com valor M
• o ETag em if-match

Todas as operações de uma ordem são enviadas em um único change set, na sequência definida pelo SkyPlanner. Assim, o S/4HANA despacha todo o plano da ordem em uma única chamada. O modo K nunca é usado: ele mantém as datas originais das operações e ignora as datas enviadas.

O SkyPlanner calcula a duração das operações com os mesmos valores padrão dos roteiros de produção e as mesmas fórmulas de capacidade dos centros de trabalho usados pelo S/4HANA. Por isso, a data de término que o S/4HANA calcula a partir da data de início enviada fica alinhada ao plano do SkyPlanner. Após cada change set, a integração lê as operações novamente e sinaliza qualquer divergência de data, que o planejador vê antes do próximo turno.

4. Confirmações do chão de fábrica. Cada apontamento de tempo do Mobile Confirmations ou do Production Timer se torna uma confirmação no S/4HANA. O webhook do SkyPlanner dispara um lançamento de ProdnOrdConf2 com quantidade boa, refugo e tempos de atividade. A integração chama primeiro GetConfProposal, para que o S/4HANA proponha quantidades, atividades, datas e dados de pessoal. GetGdsMvtProposal propõe as movimentações de mercadorias.

Materiais a receber. Os pedidos de compra em aberto fazem parte da sincronização de entrada. O SkyPlanner considera o material comprado disponível na data de entrega prevista no pedido de compra. Os trabalhos que aguardam componentes comprados são programados para o dia da chegada do material, sem ficarem bloqueados pelo saldo atual de estoque.

O S/4HANA continua sendo a fonte oficial dos recebimentos: quando uma entrada de mercadorias é lançada, o estoque aumenta e a quantidade em aberto do item do pedido de compra diminui. A sincronização seguinte atualiza o estoque no SkyPlanner e marca como Delivered o pedido de compra totalmente recebido. Após um recebimento parcial, a quantidade restante em aberto continua prevista para a data da respectiva linha de remessa. O tratamento de pedidos de compra pelo SkyPlanner está descrito na documentação do SkyPlanner.

5. Regras de responsabilidade. O S/4HANA é responsável por quantidades, BOM, roteiro de produção, custeio e status. O SkyPlanner é responsável pela sequência, pela alocação aos centros de trabalho e pelas datas das operações. Nunca permita que os dois gravem no mesmo campo. Se os planejadores ainda movem operações no Capacity Scheduling Board, defina o que prevalece. Ou a próxima sincronização de ordens leva a alteração para o SkyPlanner, ou esse centro de trabalho fica fora do escopo do SkyPlanner.

• A gravação no SAP exige uma chamada de ação com ETag. A forma documentada de programar uma operação é usar ScheduleProductionOrderOperation, não um PATCH em A_ProductionOrderOperation_2. O modo F programa para a frente a partir de um início, e o modo B programa para trás a partir de um término. Já K e S mantêm as datas existentes e ignoram as que você envia. O ETag em if-match é gerado a partir de LastChangeDateTime da ordem (YYYYMMDDHHMMSS), portanto qualquer alteração na ordem o torna desatualizado. Implemente a leitura antes da gravação e uma fila de novas tentativas.
• A capacidade não está no cabeçalho do centro de trabalho. A capacidade disponível é determinada pela categoria de capacidade (001 máquina, 002 mão de obra), pelo calendário de fábrica e pelos intervalos e turnos que se sobrepõem a ele. As fórmulas de capacidade convertem os valores padrão do roteiro de produção em necessidades de preparação, processamento e desmontagem. Leia A_WorkCenterCapacityInterval_2 e as entidades de turno e defina de comum acordo como converter as fórmulas em durações no SkyPlanner.
• Os valores padrão precisam de revisão. Roteiros de produção mantidos para custeio costumam ter tempos médios de preparação ou preparação registrada na categoria de capacidade errada.
• As regras de confirmação são rígidas. A SAP recomenda chamadas em lote para lançamentos em massa. Cada conjunto de alterações é processado por inteiro ou rejeitado por inteiro; assim, um único apontamento de tempo incorreto bloqueia os demais lançamentos do conjunto. Os cancelamentos em um lote devem ser executados na ordem inversa de ConfirmationCount. Não é possível misturar tipos de confirmação em uma mesma ordem, lançar movimentações de mercadorias sem uma confirmação ou confirmar operações cujos pontos de acionamento exigem uma caixa de diálogo.
• Verifique se o PP/DS está ativo. O PP/DS embarcado exige a atividade de Customizing Activate Advanced Planning and Scheduling e o SAP HANA integrated liveCache. A SAP o vende como um produto separado, SAP S/4HANA Manufacturing for planning and scheduling. Onde ele estiver ativo, defina por material quem faz a programação: os materiais marcados para planejamento avançado ficam sob responsabilidade do PP/DS. A SAP também informa sobre a API de ordens planejadas: “Automatic integration to PP/DS is not enabled from this API.” (A integração automática com esse módulo não é habilitada por esta API.)
• Unidades de medida. As unidades das quantidades das operações, das quantidades básicas dos roteiros de produção e das confirmações podem ser diferentes. Faça a conversão explicitamente usando a unidade da operação, não a unidade básica do material.
• Diferenças entre edições. O SAP Learning mostra a tabela clássica de planejamento CM21/CM22 sendo substituída por Manage Work Center Capacity, Capacity Scheduling Table e Capacity Scheduling Board. A Public Edition disponibiliza APIs apenas por cenários de comunicação, e as versões dos serviços oferecidas podem diferir das disponíveis no ambiente local. A API de roteiros de produção não permite excluir roteiros nem atualizar atribuições de materiais. Durante a definição de escopo, a equipe SkyPlanner fixa as versões dos serviços para o sistema de cada cliente, usando a entrada do API Business Accelerator Hub correspondente àquela versão.
• Restrições que os roteiros de produção não contemplam. Mantenha no SkyPlanner as trocas de produção dependentes da sequência, os conflitos de ferramentas e as operações com vários operadores, não nos valores padrão dos roteiros de produção. A matriz de tempos de preparação armazena os tempos de troca de produção por par de produtos. As ferramentas dos PRTs da ordem são recursos finitos, disponíveis para um centro de trabalho por vez, e uma operação pode exigir várias pessoas ao mesmo tempo.