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

O S/4HANA disponibiliza a integração através de serviços OData oficiais, listados no SAP Business Accelerator Hub (api.sap.com). A integração para programação utiliza serviços OData V2. Os IDocs e as BAPIs continuam a existir, mas este guia utiliza as APIs OData oficiais.

Autenticação por edição

• Instalação local e Private Edition. Os serviços são ativados no SAP Gateway com a transação /IWFND/MAINT_SERVICE. O utilizador da integração precisa dos objetos de autorização correspondentes, por exemplo, C_AFRU_AWK para confirmações, C_AFKO_AWK para os itens de movimento de mercadorias lançados com essas confirmações e M_PLAF_ORG para ordens planeadas.
• Public Edition. Os serviços só são disponibilizados através de acordos de comunicação. Seguindo a configuração de comunicação de entrada da SAP, crie um utilizador de comunicação, um sistema de comunicação e um acordo de comunicação na aplicação Communication Arrangements, com base num cenário de comunicação SAP (SAP_COM_xxxx). O cenário define quais os serviços disponibilizados e os métodos de autenticação disponíveis:

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

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

Do lado do SkyPlanner, existe uma API REST com autenticação JWT, documentada em Swagger/OpenAPI (referência da API). Assim, o middleware trata da autenticação SAP de um lado e de um 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, estado 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	Gamas operatórias padrão para planear 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 (designados Product na API). A SAP recomenda agora 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	Stock por centro e local de armazenamento, para determinar a disponibilidade de materiais
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Encomendas de compra em aberto para materiais a receber
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; ações GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Confirmações e movimentos de mercadorias do chão de fábrica

Na API de ordens de produção, as operações são identificadas pela combinação de OrderInternalBillOfOperations e OrderIntBillOfOperationsItem, e não pelo número da operação que o planeador vê. A ação GetConfProposal da API de confirmações identifica a mesma operação através de OrderID e OrderOperation. Guarde as chaves internas e o número da operação no SkyPlanner desde o primeiro carregamento.

Eventos

O S/4HANA gera 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, pelo que a integração volta a ler a ordem e as suas operações. O evento Changed é gerado a cada alteração da ordem; aplique um mecanismo de debounce para agrupar eventos sucessivos. No sentido inverso, os webhooks do SkyPlanner enviam notificações em tempo real quando a programação ou o estado de uma tarefa muda.

Começar com ficheiros

Para o teste, exporte as ordens de produção e os centros de trabalho dos relatórios de listagem do S/4HANA para Excel ou CSV e importe-os para o SkyPlanner. Assim, pode validar a programação antes de se alterar o Gateway ou os acordos de comunicação.

1. Carregamento de dados mestre. Carregue os materiais, as listas de materiais (BOM), os centros de trabalho com os respetivos intervalos de capacidade e turnos, e as gamas operatórias. Nesta fase, decida qual dos sistemas gere os turnos. Uma divisão que funciona: o calendário da fábrica fica no S/4HANA, enquanto os padrões detalhados de turnos, as ausências e as horas extraordinárias ficam no SkyPlanner, onde os responsáveis pelo planeamento os alteram diariamente.

2. Sincronização de ordens. Subscreva os eventos Production Order Created/Changed ou, se os eventos de negócio não estiverem configurados, consulte periodicamente A_ProductionOrder_2 com base na data e hora da alteração. Filtre por centro, tipo de ordem e estado. Envie as ordens assim que forem criadas para que o SkyPlanner possa planear antecipadamente e liberte-as no S/4HANA (ReleaseOrder ou ReleaseOperation) depois de o SkyPlanner as programar.

3. Gravação da programação no SAP. Quando um webhook do SkyPlanner comunica uma alteração da programação, a integração chama ScheduleProductionOrderOperation em API_PRODUCTION_ORDER_2_SRV para cada operação alterada. 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 valor obrigatório M em OpSchedulingStrategy
• o ETag em if-match

Todas as operações de uma ordem são enviadas num único conjunto de alterações, pela sequência definida no SkyPlanner, para que o S/4HANA aplique a programação completa da ordem numa só chamada. O modo K nunca é utilizado: mantém as datas originais das operações e ignora as datas enviadas.

O SkyPlanner calcula a duração das operações a partir dos mesmos valores padrão das gamas operatórias e das mesmas fórmulas de capacidade dos centros de trabalho que o S/4HANA utiliza. Por isso, a data de fim que o S/4HANA calcula a partir da data de início enviada fica alinhada com o plano do SkyPlanner. Após cada conjunto de alterações, a integração volta a ler as operações e assinala qualquer divergência nas datas, para que o responsável pelo planeamento a veja antes do turno seguinte.

4. Confirmações do chão de fábrica. Cada registo de tempo de Mobile Confirmations ou de Production Timer dá origem a uma confirmação no S/4HANA. O webhook do SkyPlanner desencadeia um envio de ProdnOrdConf2 com a quantidade boa, o refugo e os 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 os movimentos de mercadorias.

Material a receber. As encomendas de compra em aberto fazem parte da sincronização de entrada. O SkyPlanner considera que o material encomendado estará disponível na data de entrega prevista da encomenda de compra. Os trabalhos que aguardam componentes comprados são programados para o dia em que o material chega, em vez de ficarem bloqueados pelas existências atuais.

O S/4HANA continua a ser o sistema de referência para as receções: quando é lançada uma entrada de mercadorias, as existências aumentam e a quantidade em aberto da posição da encomenda de compra diminui. A sincronização seguinte atualiza as existências no SkyPlanner e marca uma encomenda de compra totalmente recebida como Delivered; após uma receção parcial, a quantidade ainda em aberto mantém-se como prevista para receção na data da respetiva linha de remessa. O tratamento das encomendas de compra no SkyPlanner está descrito na documentação do SkyPlanner.

5. Regras de responsabilidade pelos dados. O S/4HANA gere as quantidades, a BOM, a gama operatória, o cálculo de custos e o estado. O SkyPlanner gere a sequência, a atribuição aos centros de trabalho e as datas das operações. Nunca permita que ambos escrevam no mesmo campo. Se os responsáveis pelo planeamento continuarem a deslocar operações no Capacity Scheduling Board, decida o que prevalece. Ou a sincronização seguinte das ordens transfere essa alteração para o SkyPlanner, ou esse centro de trabalho fica fora do âmbito do SkyPlanner.

• A gravação no SAP exige uma chamada de ação com um ETag. O método documentado para programar uma operação é ScheduleProductionOrderOperation, e 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 para trás a partir de um fim, enquanto K e S mantêm as datas existentes e ignoram as datas enviadas. O ETag em if-match é construído a partir de LastChangeDateTime da ordem (YYYYMMDDHHMMSS), pelo que qualquer alteração à ordem o torna desatualizado. Implemente uma leitura antes de cada escrita e uma fila de novas tentativas.
• A capacidade não está no cabeçalho do centro de trabalho. A capacidade disponível resulta da categoria de capacidade (001 máquina, 002 mão de obra), do calendário de fábrica e dos intervalos e turnos que se sobrepõem a esse calendário. As fórmulas de capacidade convertem os valores padrão da gama operatória em necessidades de preparação, processamento e desmontagem. Leia A_WorkCenterCapacityInterval_2 e as entidades de turnos, e acorde como converter as fórmulas em durações no SkyPlanner.
• Os valores padrão precisam de ser revistos. As gamas operatórias mantidas para cálculo de custos contêm frequentemente tempos médios de preparação ou tempos de preparação imputados à categoria de capacidade errada.
• As regras de confirmação são rigorosas. A SAP recomenda chamadas em lote para lançamentos em massa. Cada conjunto de alterações é aplicado na totalidade ou não é aplicado: um único registo de tempos inválido bloqueia os restantes lançamentos desse conjunto. Os cancelamentos num lote têm de ser executados pela ordem inversa de ConfirmationCount. Não é possível misturar tipos de confirmação numa mesma ordem, lançar movimentos de mercadorias sem uma confirmação ou confirmar operações cujos pontos de acionamento exijam uma caixa de diálogo.
• Verifique se o PP/DS está ativo. O PP/DS integrado requer a atividade de Customizing Activate Advanced Planning and Scheduling e o SAP HANA integrated liveCache. A SAP comercializa-o como um produto separado, SAP S/4HANA Manufacturing for planning and scheduling. Quando está ativo, decida, para cada material, quem faz a programação: os materiais assinalados para planeamento avançado ficam a cargo do PP/DS. A SAP também indica, relativamente à API de ordens planeadas: “Automatic integration to PP/DS is not enabled from this API.” (Esta API não permite a integração automática com esse sistema.)
• Unidades de medida. As quantidades das operações, as quantidades de base das gamas operatórias e as unidades de confirmação podem ser diferentes. Faça a conversão explicitamente com base na unidade da operação, não na unidade de base do material.
• Diferenças entre edições. O SAP Learning mostra que a tabela de planeamento clássica CM21/CM22 está a ser substituída por Manage Work Center Capacity, Capacity Scheduling Table e Capacity Scheduling Board. A Public Edition só disponibiliza APIs através de cenários de comunicação, e as versões dos serviços que oferece podem diferir das disponíveis em instalações locais. A API de gamas operatórias não permite eliminar gamas operatórias nem atualizar atribuições de materiais. Durante a definição do âmbito, a equipa SkyPlanner fixa as versões dos serviços para o sistema de cada cliente, usando a entrada do API Business Accelerator Hub correspondente a essa versão.
• Restrições que as gamas operatórias não contemplam. Mantenha no SkyPlanner as mudanças de produção dependentes da sequência, os conflitos de ferramentas e as operações com vários operadores, em vez de os incluir nos valores padrão das gamas operatórias. A matriz de tempos de preparação contém os tempos de mudança de produção por par de produtos. As ferramentas dos PRTs da ordem são recursos de capacidade finita, utilizáveis num único centro de trabalho de cada vez, e uma operação pode exigir várias pessoas em simultâneo.