SAP S/4HANA integrācijas ceļvedis ražošanas grafiku sastādīšanai ar SkyPlanner APS

S/4HANA integrācijai piedāvā oficiāli publicētus OData servisus, kas uzskaitīti SAP Business Accelerator Hub (api.sap.com). Ražošanas grafiku integrācija izmanto OData V2 servisus. IDoc un BAPI joprojām ir pieejami, taču šajā ceļvedī tiek izmantotas oficiāli publicētās OData API.

Autentifikācija atkarībā no izdevuma

• Lokālā instalācija un Private Edition. Pakalpojumus aktivizē SAP Gateway ar transakciju /IWFND/MAINT_SERVICE. Integrācijas lietotājam vajadzīgi atbilstošie autorizācijas objekti, piemēram, C_AFRU_AWK apstiprinājumiem, C_AFKO_AWK kopā ar tiem iegrāmatotajām preču kustības pozīcijām un M_PLAF_ORG plānotajiem pasūtījumiem.
• Public Edition. Pakalpojumi ir pieejami tikai ar saziņas konfigurācijām. Ievērojot SAP norādījumus par ienākošās saziņas iestatīšanu, lietotnē Communication Arrangements izveidojiet saziņas lietotāju, saziņas sistēmu un saziņas konfigurāciju, pamatojoties uz SAP saziņas scenāriju (SAP_COM_xxxx). Scenārijs nosaka, kuri pakalpojumi ir pieejami un kādas autentifikācijas metodes var izmantot:

– ar pilnvarām: OAuth, SAML vai OpenID Connect bearer plūsmas ar identitātes tālāknodošanu biznesa lietotājam – ar klienta sertifikātu – pamata autentifikācija ar tehnisko saziņas lietotāju

SAP iesaka autentifikācijai izmantot pilnvaras vai sertifikātus.

SkyPlanner pusē ir REST API ar JWT autentifikāciju, kas dokumentēta Swagger/OpenAPI formātā (API uzziņa). Tādēļ starpprogrammatūra vienā pusē nodrošina SAP autentifikāciju, bet otrā — JWT.

API ražošanas grafiku sastādīšanai

Pakalpojums	Izmantotās entītijas un darbības	Pielietojums
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; darbības ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Pasūtījumi, operācijas, komponenti, ražošanas resursi un instrumenti (PRT), statuss, grafika datu ierakstīšana avota sistēmā
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Darba centri, jaudas kategorijas, intervāli un maiņas
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Standarta tehnoloģiskie procesi plānošanai pirms pasūtījuma izveides
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Daudzlīmeņu produkta struktūra
API_PRODUCT_SRV (Product Master A2X)	A_Product	Materiāli (API tos sauc par Product). Lielākajai daļai produktu entītiju SAP tagad iesaka Product (Version 2) API
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	MRP Live rezultāti pirms pārveidošanas
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Krājumi pa ražotnēm un uzglabāšanas vietām materiālu pieejamības noteikšanai
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Atvērtie iepirkuma pasūtījumi gaidāmajiem materiāliem
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; darbības GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Apstiprinājumi un preču kustības no ražošanas ceha

Ražošanas pasūtījumu API operācijas identificē pēc OrderInternalBillOfOperations un OrderIntBillOfOperationsItem kombinācijas, nevis pēc plānotājam redzamā operācijas numura. Apstiprinājumu API darbība GetConfProposal to pašu operāciju identificē pēc OrderID un OrderOperation. Jau no pirmās ielādes saglabājiet SkyPlanner gan iekšējās atslēgas, gan operācijas numuru.

Notikumi

S/4HANA ģenerē biznesa notikumus Production Order Created un Production Order Changed, kuru datu saturā ir ManufacturingOrder, ProductionOrder, ProductionOrderType un ProductionPlant. Notikuma dati satur tikai atslēgas, tāpēc integrācija atkārtoti nolasa pasūtījumu un tā operācijas. Notikums Changed tiek ģenerēts pie katras pasūtījuma izmaiņas, tāpēc ieviesiet apstrādes aizturi, kas apvieno strauji sekojošus notikumus. Pretējā virzienā SkyPlanner ar webhook palīdzību reāllaikā nosūta paziņojumus, kad mainās grafiks vai ražošanas uzdevuma stāvoklis.

Sāciet ar failiem

Izmēģinājumam eksportējiet ražošanas pasūtījumus un darba centrus no S/4HANA sarakstu pārskatiem Excel vai CSV formātā un importējiet tos SkyPlanner. Tā var pārbaudīt grafiku, pirms ķerties pie Gateway vai saziņas konfigurācijas.

1. Pamatdatu ielāde. Ielādējiet materiālus, BOM, darba centrus ar to jaudas intervāliem un maiņām, kā arī tehnoloģiskos procesus. Šajā posmā izlemiet, kura sistēma pārvaldīs maiņas. Praksē darbojas šāds sadalījums: rūpnīcas kalendārs paliek S/4HANA, savukārt detalizēti maiņu grafiki, prombūtnes un virsstundas tiek uzturētas SkyPlanner, kur plānotāji tās maina ik dienu.

2. Pasūtījumu sinhronizācija. Abonējiet Production Order Created/Changed notikumus vai, ja biznesa notikumi nav iestatīti, periodiski nolasiet A_ProductionOrder_2 pēc izmaiņu laika zīmoga. Filtrējiet pēc ražotnes, pasūtījuma veida un statusa. Nosūtiet pasūtījumus uzreiz pēc izveides, lai SkyPlanner varētu plānot uz priekšu, un izlaidiet tos izpildei S/4HANA sistēmā (ReleaseOrder vai ReleaseOperation), kad SkyPlanner tos ir ieplānojis.

3. Grafika datu ierakstīšana avota sistēmā. Kad SkyPlanner webhook ziņo par grafika izmaiņām, integrācija katrai mainītajai operācijai izsauc ScheduleProductionOrderOperation pakalpojumā API_PRODUCTION_ORDER_2_SRV. Tā nosūta:

• ManufacturingOrder, OrderInternalBillOfOperations un OrderIntBillOfOperationsItem kā atslēgas
• OpSchedulingMode vērtību F (uz priekšu), norādot SkyPlanner noteikto sākumu laukos OpSchedldStartDate un OpSchedldStartTime
• OpSchedulingStatus vērtību DISP (norīkošana izpildei) un obligāto OpSchedulingStrategy vērtību M
• ETag laukā if-match

Visas viena pasūtījuma operācijas tiek nosūtītas vienā izmaiņu kopā SkyPlanner noteiktajā secībā, lai S/4HANA ar vienu izsaukumu ieplānotu visu pasūtījumu. Režīms K netiek izmantots nekad: tas saglabā sākotnējos operāciju datumus un ignorē nosūtītos datumus.

SkyPlanner aprēķina operāciju ilgumu, izmantojot tās pašas tehnoloģisko procesu standartvērtības un darba centru jaudas formulas, ko izmanto S/4HANA. Tādēļ beigu datums, ko S/4HANA aprēķina no nosūtītā sākuma datuma, atbilst SkyPlanner plānam. Pēc katras izmaiņu kopas integrācija atkārtoti nolasa operācijas un atzīmē katru datumu, kas atšķiras, lai plānotājs to redzētu pirms nākamās maiņas.

4. Apstiprinājumi no ražošanas ceha. Katrs Mobile Confirmations vai Production Timer laika uzskaites ieraksts kļūst par S/4HANA apstiprinājumu. SkyPlanner ar webhook palīdzību ierosina ProdnOrdConf2 ieraksta nosūtīšanu ar derīgās produkcijas daudzumu, brāķi un darbību laikiem. Vispirms integrācija izsauc GetConfProposal, lai S/4HANA piedāvātu daudzumus, darbības, datumus un personāla datus. GetGdsMvtProposal piedāvā preču kustības.

Ienākošie materiāli. Atvērtie iepirkuma pasūtījumi ir daļa no ienākošo datu sinhronizācijas. SkyPlanner uzskata pasūtīto materiālu par pieejamu iepirkuma pasūtījumā norādītajā paredzamajā piegādes datumā. Darbi, kas gaida iepirktās komponentes, tiek ieplānoti materiāla saņemšanas dienā, nevis bloķēti pašreizējā krājumu atlikuma dēļ.

S/4HANA paliek noteicošais preču saņemšanas datu avots: iegrāmatojot preču saņemšanu, krājumi palielinās un iepirkuma pasūtījuma pozīcijas nesaņemtais daudzums samazinās. Nākamā sinhronizācija atjaunina krājumus SkyPlanner un pilnībā saņemtam iepirkuma pasūtījumam piešķir statusu Delivered. Pēc daļējas saņemšanas atlikušais daudzums joprojām tiek uzskatīts par ienākošu piegādes grafika rindā norādītajā datumā. Iepirkuma pasūtījumu apstrāde ir aprakstīta SkyPlanner dokumentācijā.

5. Datu pārvaldības noteikumi. S/4HANA pārvalda daudzumus, BOM, tehnoloģiskos procesus, pašizmaksas aprēķinus un statusus. SkyPlanner pārvalda secību, darba centru piešķiršanu un operāciju datumus. Nekad neļaujiet abām sistēmām rakstīt vienā un tajā pašā laukā. Ja plānotāji joprojām pārvieto operācijas rīkā Capacity Scheduling Board, nosakiet, kurām izmaiņām ir priekšroka. Vai nu nākamā pasūtījumu sinhronizācija pārnes viņu izmaiņas uz SkyPlanner, vai arī attiecīgais darba centrs paliek ārpus SkyPlanner tvēruma.

• Datus ieraksta avota sistēmā, izsaucot darbību un izmantojot ETag. Dokumentācijā paredzētais operācijas ieplānošanas veids ir ScheduleProductionOrderOperation, nevis PATCH pieprasījums entītijai A_ProductionOrderOperation_2. Režīms F plāno uz priekšu no sākuma, bet B — atpakaļ no beigām; savukārt K un S saglabā esošos datumus un ignorē jūsu norādītos. ETag laukā if-match veido no pasūtījuma LastChangeDateTime (YYYYMMDDHHMMSS), tāpēc jebkura pasūtījuma izmaiņa padara to novecojušu. Ieviesiet nolasīšanu pirms ierakstīšanas un atkārtotu mēģinājumu rindu.
• Jauda nav norādīta darba centra galvenē. Pieejamo jaudu nosaka jaudas kategorija (001 iekārtas, 002 darbaspēks), ražotnes kalendārs un intervāli un maiņas, kas aizstāj tā iestatījumus. Jaudas formulas pārvērš tehnoloģiskā procesa standarta vērtības par sagatavošanas, apstrādes un noslēguma darbu jaudas vajadzībām. Nolasiet A_WorkCenterCapacityInterval_2 un maiņu entītijas un vienojieties, kā ar šīm formulām aprēķināt SkyPlanner izmantojamos operāciju ilgumus.
• Standartvērtības ir jāsakārto. Pašizmaksas aprēķiniem uzturētos tehnoloģiskajos procesos bieži ir norādīti vidējie iestatīšanas laiki vai iestatīšana ir piesaistīta nepareizai jaudas kategorijai.
• Apstiprinājumu noteikumi ir stingri. Masveida iegrāmatošanai SAP iesaka pakešu izsaukumus. Izmaiņu kopa tiek izpildīta pilnībā vai netiek izpildīta vispār, tāpēc viens kļūdains darba laika ieraksts bloķē visu pārējo kopu. Atcelšana paketē jāveic apgrieztā ConfirmationCount secībā. Vienā pasūtījumā nedrīkst apvienot dažādus apstiprinājumu veidus, iegrāmatot preču kustības bez apstiprinājuma vai apstiprināt operācijas, kuru palaides punktiem vajadzīgs dialoglodziņš.
• Pārbaudiet, vai PP/DS ir aktīvs. Iegultajam PP/DS ir nepieciešama Customizing darbība Activate Advanced Planning and Scheduling un SAP HANA integrētais liveCache. SAP to pārdod kā atsevišķu produktu — SAP S/4HANA Manufacturing for planning and scheduling. Ja tas ir aktīvs, katram materiālam nosakiet, kura sistēma sastāda grafiku: materiāli, kam atzīmēta progresīvā plānošana, ir PP/DS pārziņā. Par plānoto pasūtījumu API SAP arī norāda: “Automatic integration to PP/DS is not enabled from this API.” (Šī API nenodrošina automātisku integrāciju ar minēto sistēmu.)
• Mērvienības. Operāciju daudzumu, tehnoloģisko procesu bāzes daudzumu un apstiprinājumu mērvienības var atšķirties. Veiciet skaidri noteiktu pārrēķinu, izmantojot operācijas mērvienību, nevis materiāla bāzes mērvienību.
• Atšķirības starp izdevumiem. SAP Learning parāda, ka klasisko CM21/CM22 plānošanas tabulu aizstāj Manage Work Center Capacity, Capacity Scheduling Table un Capacity Scheduling Board. Public Edition nodrošina piekļuvi API tikai ar saziņas scenārijiem, un tajā piedāvātās servisu versijas var atšķirties no lokāli izvietotās sistēmas versijām. Tehnoloģisko procesu API nevar dzēst tehnoloģiskos procesus vai atjaunināt materiālu piesaistes. Tvēruma noteikšanas laikā SkyPlanner komanda katra klienta sistēmai fiksē servisu versijas, izmantojot attiecīgā laidiena ierakstu API Business Accelerator Hub.
• Ierobežojumi, ko tehnoloģiskie procesi neietver. No secības atkarīgo pārregulēšanu, instrumentu pieejamības konfliktus un operācijas ar vairākiem operatoriem uzturiet SkyPlanner, nevis tehnoloģisko procesu standartvērtībās. Iestatīšanas laiku matricā glabājas pārregulēšanas laiki katram produktu pārim. Pasūtījuma PRT norādītie instrumenti ir ierobežoti resursi — tos vienlaikus var izmantot tikai vienā darba centrā, savukārt operācijai var būt vajadzīgi vairāki cilvēki vienlaikus.