Ghid de integrare SAP S/4HANA pentru programarea producției cu SkyPlanner APS

S/4HANA pune la dispoziție interfețe de integrare sub formă de servicii OData publicate, listate în SAP Business Accelerator Hub (api.sap.com). Integrarea pentru programarea producției folosește servicii OData V2. IDoc și BAPI există în continuare, dar acest ghid folosește API-urile OData publicate.

Autentificare în funcție de ediție

• On-premise și Private Edition. Serviciile se activează în SAP Gateway prin tranzacția /IWFND/MAINT_SERVICE. Utilizatorul de integrare are nevoie de obiectele de autorizare corespunzătoare, de exemplu C_AFRU_AWK pentru confirmări, C_AFKO_AWK pentru pozițiile mișcărilor de stoc înregistrate odată cu acestea și M_PLAF_ORG pentru ordinele planificate.
• Public Edition. Serviciile sunt expuse numai prin acorduri de comunicare. Urmând instrucțiunile SAP pentru configurarea comunicațiilor de intrare, creați un utilizator de comunicare, un sistem de comunicare și un acord de comunicare în aplicația Communication Arrangements, pe baza unui scenariu de comunicare SAP (SAP_COM_xxxx). Scenariul stabilește ce servicii sunt expuse și ce metode de autentificare sunt disponibile:

– pe bază de token: fluxuri bearer OAuth, SAML sau OpenID Connect, cu propagarea identității către un utilizator de business – certificat de client – autentificare de bază cu un utilizator tehnic de comunicare

SAP recomandă autentificarea prin token sau certificat.

La celălalt capăt, SkyPlanner oferă un REST API cu autentificare JWT, documentat în Swagger/OpenAPI (documentația API). Astfel, middleware-ul gestionează autentificarea SAP pe o parte și un JWT pe cealaltă.

API-uri pentru programarea producției

Serviciu	Entități și acțiuni utilizate	Scop
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; acțiunile ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Ordine, operații, componente, PRT-uri, stare, retransmiterea programului în SAP
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Centre de lucru, categorii de capacitate, intervale și schimburi
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Fluxuri tehnologice standard pentru planificare înainte de crearea ordinelor
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Structura produsului pe mai multe niveluri
API_PRODUCT_SRV (Product Master A2X)	A_Product	Materiale (denumite Product în API). SAP recomandă acum API-ul Product (Version 2) pentru majoritatea entităților de produs
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Rezultatele MRP Live înainte de conversie
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Stoc pe unitate de producție și locație de depozitare, pentru disponibilitatea materialelor
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Comenzi de achiziție deschise pentru materialele care urmează să sosească
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; acțiunile GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Confirmări și mișcări de stoc din secția de producție

În API-ul pentru ordine de producție, operațiile sunt identificate prin combinația OrderInternalBillOfOperations și OrderIntBillOfOperationsItem, nu prin numărul operației afișat planificatorului. Acțiunea GetConfProposal din API-ul de confirmare identifică aceeași operație prin OrderID și OrderOperation. Stocați în SkyPlanner atât cheile interne, cât și numărul operației încă de la prima încărcare.

Evenimente

S/4HANA generează evenimentele de business Production Order Created și Production Order Changed, al căror payload conține ManufacturingOrder, ProductionOrder, ProductionOrderType și ProductionPlant. Payload-ul conține doar chei, așa că integrarea recitește ordinul și operațiile acestuia. Evenimentul Changed se declanșează la fiecare modificare a ordinului; aplicați un mecanism de debounce pentru a grupa notificările succesive. În sens invers, webhook-urile SkyPlanner trimit notificări în timp real când se modifică programul sau starea unei operații.

Începeți cu fișiere

Pentru testare, exportați comenzile de producție și centrele de lucru din rapoartele de tip listă S/4HANA în Excel sau CSV și importați-le în SkyPlanner. Astfel validați programul înainte de a interveni în Gateway sau în configurările de comunicare.

1. Încărcarea nomenclatoarelor. Încărcați materialele, listele BOM, centrele de lucru cu intervalele de capacitate și schimburile aferente, precum și fluxurile tehnologice. Stabiliți acum în ce sistem se gestionează schimburile. O împărțire care funcționează: calendarul fabricii rămâne în S/4HANA, iar programele detaliate ale schimburilor, absențele și orele suplimentare se gestionează în SkyPlanner, unde planificatorii le modifică zilnic.

2. Sincronizarea ordinelor. Abonați-vă la evenimentele Production Order Created/Changed sau, dacă evenimentele de business nu sunt configurate, interogați periodic A_ProductionOrder_2 pe baza marcajului temporal al modificării. Filtrați după unitatea de producție, tipul ordinului și stare. Trimiteți ordinele la creare, astfel încât SkyPlanner să poată planifica în avans, și lansați-le în S/4HANA (ReleaseOrder sau ReleaseOperation) după ce SkyPlanner le-a programat.

3. Retransmiterea programului în SAP. Când un webhook SkyPlanner semnalează o modificare a programului, integrarea apelează ScheduleProductionOrderOperation din API_PRODUCTION_ORDER_2_SRV pentru fiecare operație modificată. Sunt trimise:

• ManufacturingOrder, OrderInternalBillOfOperations și OrderIntBillOfOperationsItem drept chei
• OpSchedulingMode cu valoarea F (programare înainte), cu data și ora de început din SkyPlanner în OpSchedldStartDate și OpSchedldStartTime
• OpSchedulingStatus cu valoarea DISP (dispecerizare) și câmpul obligatoriu OpSchedulingStrategy cu valoarea M
• ETag-ul în if-match

Toate operațiile unei comenzi sunt incluse într-un singur set de modificări, în succesiunea stabilită de SkyPlanner, astfel încât S/4HANA să aloce întregul program al comenzii printr-un singur apel. Modul K nu este folosit niciodată: păstrează datele inițiale ale operațiilor și ignoră datele trimise.

SkyPlanner calculează duratele operațiilor folosind aceleași valori standard din fluxurile tehnologice și aceleași formule de capacitate ale centrelor de lucru ca S/4HANA. Prin urmare, data de încheiere calculată de S/4HANA pe baza datei de început transmise corespunde programului SkyPlanner. După fiecare set de modificări, integrarea recitește operațiile și semnalează orice dată care diferă, iar planificatorul vede diferența înainte de schimbul următor.

4. Confirmări din secția de producție. Fiecare înregistrare de timp din Mobile Confirmations sau Production Timer devine o confirmare în S/4HANA. Webhook-ul SkyPlanner declanșează o cerere POST către ProdnOrdConf2, cu cantitatea bună, rebuturile și timpii activităților. Integrarea apelează mai întâi GetConfProposal, astfel încât S/4HANA să propună cantități, activități, date calendaristice și date despre personal. GetGdsMvtProposal propune mișcările de stoc.

Materiale în curs de aprovizionare. Comenzile de achiziție deschise fac parte din sincronizarea datelor către SkyPlanner. SkyPlanner consideră materialul comandat disponibil la data de livrare estimată a comenzii de achiziție. Lucrările care așteaptă componente achiziționate sunt programate pentru ziua sosirii materialului, nu sunt blocate de stocul disponibil astăzi.

S/4HANA rămâne sursa de referință pentru recepții: la înregistrarea unei recepții de marfă, stocul crește, iar cantitatea deschisă a poziției din comanda de achiziție scade. Următoarea sincronizare actualizează stocul în SkyPlanner și marchează o comandă de achiziție recepționată integral ca Delivered; după o recepție parțială, cantitatea rămasă deschisă figurează în continuare ca aprovizionare viitoare, la data din linia de programare. Gestionarea comenzilor de achiziție în SkyPlanner este descrisă în documentația SkyPlanner.

5. Reguli de responsabilitate asupra datelor. S/4HANA gestionează cantitățile, BOM, fluxul tehnologic, calculul costurilor și starea. SkyPlanner gestionează succesiunea, alocarea la centrele de lucru și datele operațiilor. Nu permiteți niciodată ambelor sisteme să scrie în același câmp. Dacă planificatorii continuă să mute operații în Capacity Scheduling Board, stabiliți ce are prioritate. Fie următoarea sincronizare a comenzilor preia modificarea lor în SkyPlanner, fie centrul de lucru respectiv rămâne în afara domeniului gestionat de SkyPlanner.

• Retransmiterea se face prin apelarea unei acțiuni cu un ETag. Metoda documentată pentru programarea unei operații este ScheduleProductionOrderOperation, nu o cerere PATCH către A_ProductionOrderOperation_2. Modul F programează înainte pornind de la un moment de început, iar B înapoi pornind de la un moment de sfârșit; K și S păstrează datele existente și le ignoră pe cele trimise. ETag-ul din if-match este construit din LastChangeDateTime al ordinului (YYYYMMDDHHMMSS), deci orice modificare a ordinului îl invalidează. Implementați citirea înainte de scriere și o coadă pentru reîncercări.
• Capacitatea nu se află în antetul centrului de lucru. Capacitatea disponibilă rezultă din categoria de capacitate (001 utilaje, 002 forță de muncă), calendarul fabricii și intervalele și schimburile care au prioritate față de acesta. Formulele de capacitate transformă valorile standard din fluxul tehnologic în necesar de capacitate pentru pregătire, prelucrare și demontare. Citiți A_WorkCenterCapacityInterval_2 și entitățile pentru schimburi și conveniți cum se transpun formulele în durate în SkyPlanner.
• Valorile standard trebuie corectate. Fluxurile tehnologice întreținute pentru calculul costurilor conțin adesea timpi medii de pregătire sau timpi de pregătire înregistrați la o categorie de capacitate greșită.
• Regulile de confirmare sunt stricte. SAP recomandă apeluri în lot pentru înregistrările în masă. Un set de modificări se aplică integral sau deloc, așa că o singură fișă de timp incorectă blochează restul setului. Anulările dintr-un lot trebuie executate în ordinea inversă a valorilor ConfirmationCount. Nu puteți combina tipuri de confirmare pentru același ordin, înregistra mișcări de stoc fără o confirmare sau confirma operații ale căror puncte de declanșare necesită o casetă de dialog.
• Verificați dacă PP/DS este activ. PP/DS încorporat necesită activitatea de Customizing Activate Advanced Planning and Scheduling și SAP HANA integrated liveCache. SAP îl comercializează ca produs separat, SAP S/4HANA Manufacturing for planning and scheduling. Acolo unde este activ, stabiliți pentru fiecare material cine face programarea: materialele marcate pentru planificare avansată sunt gestionate de PP/DS. SAP precizează și pentru API-ul comenzilor planificate: “Automatic integration to PP/DS is not enabled from this API.” (Integrarea automată cu acest sistem nu este activată prin acest API.)
• Unități de măsură. Cantitățile operațiilor, cantitățile de bază ale fluxurilor tehnologice și unitățile de confirmare pot diferi. Faceți conversia explicit, folosind unitatea operației, nu unitatea de bază a materialului.
• Diferențe între ediții. SAP Learning arată că tabelul clasic de planificare CM21/CM22 este înlocuit de Manage Work Center Capacity, Capacity Scheduling Table și Capacity Scheduling Board. Public Edition oferă acces la API-uri numai prin scenarii de comunicare, iar versiunile serviciilor disponibile pot diferi de cele din instalările locale. API-ul pentru fluxuri tehnologice nu poate șterge fluxuri tehnologice sau actualiza alocările de materiale. În etapa de definire a domeniului, echipa SkyPlanner fixează versiunile serviciilor pentru sistemul fiecărui client, folosind intrarea din API Business Accelerator Hub corespunzătoare versiunii respective.
• Constrângeri care nu sunt cuprinse în fluxurile tehnologice. Gestionați în SkyPlanner schimbările de fabricație dependente de succesiune, conflictele de utilizare a sculelor și operațiile cu mai mulți operatori, nu în valorile standard ale fluxurilor tehnologice. Matricea timpilor de pregătire conține timpii de schimbare de fabricație pentru fiecare pereche de produse. Sculele din PRT-urile comenzii sunt resurse cu capacitate finită, utilizabile la un singur centru de lucru la un moment dat, iar o operație poate necesita mai multe persoane simultan.