Integrări / ERP / SAP Business ByDesign
Ghid de integrare SAP Business ByDesign pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare SAP Business ByDesign le arată partenerilor și echipelor IT cum să conecteze ByDesign la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu ByDesign, folosind serviciile web publicate de SAP:
- În SkyPlanner sunt importate comenzile de producție lansate, împreună cu operațiile lor, Production Models, Bills of Material și Bills of Operations, echipamentele și resursele de personal, materialele, stocurile și comenzile de achiziție.
- Momentul de început planificat al fiecărei comenzi de producție și resursa principală a fiecărei operații sunt trimise înapoi în ByDesign.
- Cantitățile confirmate, rebuturile și sarcinile finalizate pot fi transmise înapoi în ByDesign și înregistrate în loturile de producție.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner configurează integrarea cu instanța dumneavoastră ByDesign prin REST API în etapa de implementare inițială și asigură asistență după intrarea în exploatare. Acest ghid se adresează partenerilor și dezvoltatorilor care vor să participe la integrare sau să dezvolte singuri soluții folosind REST API documentat al SkyPlanner (documentația API).
Interfețele de integrare SAP ByDesign
Pentru fiecare versiune, ByDesign publică serviciile web A2X SOAP disponibile în lista API-urilor pentru servicii web. O integrare pentru programarea producției folosește următoarele servicii:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER returnează momentele de început și de sfârșit solicitate, cele mai timpurii și cele mai târzii, resursele cu duratele planificate și realizate, prioritatea, starea execuției și starea programării. MAINTAIN_BUNDLE_V2 actualizează EarliestStartPeriod sau LatestEndPeriod, precum și MainResourceID al operației (documentația SAP).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle creează sau actualizează sarcini de producție. Permite înregistrarea cantității confirmate, a rebuturilor și a indicatorului de finalizare a confirmării pentru fiecare punct de raportare, finalizarea sarcinii cu indicarea angajatului executant și a timpului de execuție, precum și înregistrarea utilizării resurselor (documentația SAP).
- Servicii de interogare. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (inclusiv după resursă), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks și Determine Availability of Products.
- OData. Servicii OData personalizate pentru obiecte de business, precum și OData pentru surse de date și rapoarte analitice. SAP afirmă că “companies are fully empowered to decide which business objects” (companiile au libertatea deplină de a decide ce obiecte de business) sunt expuse (scenarii de integrare SAP).
Folosiți serviciile Query sau OData pentru citire și cele două servicii Manage pentru toate operațiile de scriere.
Autentificare și licențiere
În ByDesign, creați un sistem de comunicare pentru SkyPlanner și un acord de comunicare pentru serviciile pe care le folosiți. Fiecare acord are propriul utilizator tehnic. Ghidul de securitate SAP prevede autentificarea integrării aplicațiilor cu “user ID plus password, and the X.509 client certificate” (ID de utilizator și parolă, precum și certificatul client menționat) (Ghid de securitate). Pentru OData se poate configura OAuth 2.0. Descărcați fișierul WSDL al fiecărui serviciu din acordul de comunicare sau din Service Explorer.
În SkyPlanner, fiecare apel include un token API în antetul Authorization-Token. Creați tokenul în SkyPlanner, din Settings > API. Un token API este suficient pentru a începe dezvoltarea.
Evenimente și interogări periodice
SkyPlanner trimite notificări webhook la fiecare modificare a programului de producție, astfel încât datele sunt scrise înapoi în ByDesign pe măsură ce planul se schimbă.
Pentru a prelua modificările din ByDesign, interogați periodic serviciile Query. Citiți comenzile de producție lansate și loturile de producție la fiecare câteva minute, iar materialele, stocurile și comenzile de achiziție la intervale mai mari. Rezultatele interogărilor sunt paginate folosind QueryHitsMaximumNumberValue și LastReturnedObjectID; SAP precizează dimensiunea implicită a paginii în pagina despre serviciile web.
Maparea datelor
| Obiect ByDesign (interfață) | Obiect SkyPlanner | Sens | Frecvență |
|---|---|---|---|
| Materiale (Query Materials) | Produse și materiale | ByDesign → SkyPlanner | Încărcare inițială, apoi interogare periodică |
| Production Bill of Material (Query Production Bill of Materials) | Structura produsului, materiale pentru fiecare produs | ByDesign → SkyPlanner | Încărcare inițială, apoi la modificare |
| Production Bill of Operations: operații, activități Setup, Produce și Tear down (Query Production Bill of Operations) | Etape de proces cu durate, timpi de pregătire și de demontare | ByDesign → SkyPlanner | Încărcare inițială, apoi la modificare |
| Production Model (Query Production Model) | Fluxul tehnologic al produsului pentru fiecare unitate de producție | ByDesign → SkyPlanner | Încărcare inițială, apoi la modificare |
| Echipamente și grupuri de resurse (Read Equipment Resources) | Centre de lucru, grupuri de centre de lucru, scule | ByDesign → SkyPlanner | Încărcare inițială, apoi rar |
| Resurse de personal, intervale de lucru (Query Labour Resource) | Personal și schimburi | ByDesign → SkyPlanner | Zilnic sau schimburi gestionate în SkyPlanner |
| Comenzi de producție lansate și operații (Query Production Orders, READ_PROD_ORDER) | Comenzi și operații cu termene și necesar de materiale | ByDesign → SkyPlanner | Interogare la fiecare câteva minute |
| Loturi și sarcini de producție (Query Production Lots) | Progresul operațiilor | ByDesign → SkyPlanner | Interogare la fiecare câteva minute |
| Stoc identificat, disponibilitatea produselor (Query Identified Stocks, Determine Availability of Products) | Solduri de stoc | ByDesign → SkyPlanner | Interogare periodică, la fiecare oră sau la rularea programării |
| Comenzi de achiziție (Query Purchase Orders) | Comenzi de achiziție, materiale așteptate în funcție de data livrării | ByDesign → SkyPlanner | Interogare periodică, la fiecare oră sau la rularea programării |
| EarliestStartPeriod, MainResourceID al operației (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Început planificat, centru de lucru alocat | SkyPlanner → ByDesign | La modificarea programului, prin webhook SkyPlanner |
| Cantitate confirmată, rebuturi, finalizarea sarcinii (Manage Production Lots, MaintainBundle) | Înregistrări de timp și confirmări ale operatorilor | SkyPlanner → ByDesign | La fiecare confirmare sau schimb, dacă se optează pentru aceasta |
| Nu există în ByDesign | Matricea timpilor de pregătire, cerințe privind folosirea mai multor operatori, utilaje și personal alternativ | Gestionate în SkyPlanner | Configurate în etapa de implementare inițială |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți materialele, Production Models, Bills of Material și Bills of Operations, echipamentele și resursele de personal. Stabiliți cu atenție corespondențele dintre resurse: un grup cu patru utilaje devine un grup de centre de lucru sau patru centre de lucru. Echipamentele care sunt scule devin în SkyPlanner scule cu disponibilitate limitată.
2. Sincronizarea comenzilor de producție. Citiți comenzile de producție lansate, împreună cu operațiile și materialele lor, precum și comenzile de achiziție deschise. SkyPlanner consideră materialele comandate disponibile la data de livrare a comenzii de achiziție și actualizează stocul când aceasta este marcată ca Delivered. Propunerile de producție rămân în ByDesign Supply Planning până când devin comenzi de producție.
3. Scrierea programului înapoi în ByDesign. Când motorul programează sau mută o comandă, un webhook SkyPlanner declanșează MAINTAIN_BUNDLE_V2 din Manage Production Orders. Acesta setează EarliestStartPeriod și MainResourceID al operației alese de SkyPlanner.
4. Confirmări din producție. Operatorii înregistrează munca folosind SkyPlanner Mobile Confirmations sau Production Timer, iar înregistrările de timp mențin programul actualizat. Dumneavoastră decideți dacă datele efective sunt trimise înapoi. Dacă da, MaintainBundle din Manage Production Lots înregistrează cantitatea confirmată, rebuturile și sarcina finalizată, împreună cu angajatul executant. Dacă nu, confirmările sunt introduse în ByDesign ca înainte.
5. Responsabilitatea pentru date și regulile de soluționare a conflictelor. Documentați-le înainte de punerea în producție:
| Date | Sistem responsabil |
|---|---|
| Materiale, Production Models, cantități, starea comenzilor și a loturilor | ByDesign |
| Succesiunea operațiilor, momentele de început și de sfârșit, alocarea resurselor | SkyPlanner |
| Matricea timpilor de pregătire și tranziție, cerințe privind sculele și operatorii, resurse alternative | SkyPlanner |
| Schimburi și zile nelucrătoare | Un singur sistem, ales la definirea domeniului |
| Confirmări, mișcări de stoc, calculul costurilor | ByDesign, prin introducere directă sau prin transfer din înregistrările de timp SkyPlanner |
Alegeți un singur sistem care să scrie datele calendaristice ale comenzilor. Nu rulați Load Leveling pentru resursele programate de SkyPlanner și verificați ca rularea planificării să nu mute comenzile lansate gestionate de SkyPlanner.
Etapele obișnuite ale proiectului
Implementarea se finalizează în mod normal în câteva săptămâni de la începerea configurării inițiale. Înainte de aceasta, validați programul în perioada de probă gratuită de 30 de zile, folosind resurse, Bills of Operations și comenzi de producție deschise, exportate din ByDesign în format CSV sau Excel.
- Mapare. Stabiliți tabelul de corespondențe, regulile privind sistemul responsabil de fiecare tip de date, frecvențele de sincronizare și dacă se trimit confirmările înapoi.
- Acces la ByDesign. Creați sistemul de comunicare și acordurile de comunicare, apoi descărcați fișierele WSDL. Testați mai întâi în instanța de test ByDesign.
- Încărcare inițială. Materiale, Production Models, Bills of Material și Bills of Operations, resurse, intervale de lucru.
- Sincronizarea comenzilor de producție și de achiziție. Interogare periodică cu paginare, filtre și reîncercări.
- Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire și tranziție, sculele, numărul de operatori pentru fiecare operație și utilajele sau personalul alternativ.
- Scrierea programului înapoi în ByDesign. Apeluri MAINTAIN_BUNDLE_V2 declanșate de notificările webhook SkyPlanner, plus confirmări de lot, dacă se optează pentru acestea.
- Testare în paralel. Rulați SkyPlanner în paralel cu planul actual, comparați datele și corectați nomenclatoarele.
- Punerea în producție. Activați scrierea datelor înapoi după ce datele corespund.
Ce trebuie să aveți în vedere la integrarea cu SAP ByDesign
- O singură dată calendaristică la fiecare apel. “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (EarliestStartPeriod și LatestEndPeriod nu pot fi actualizate simultan.) Folosiți data de început ca reper pentru scrierea înapoi în sistem.
- Fără blocare. Serviciile A2X nu păstrează starea, iar SAP precizează că nu se poate impune blocarea tranzacțională sau logică. Citiți din nou comanda înainte de fiecare scriere și gestionați conflictele.
- Finalizarea este definitivă. “Confirmation Finished Indicator cannot be unchecked once it is set.” (După bifare, Confirmation Finished Indicator nu mai poate fi debifat.) Înregistrați finalizarea numai când operatorul închide sarcina.
- Resurse principale și suplimentare. Programarea din ByDesign ia în calcul resursele principale. Modelați operatorii și sculele din categoria resurselor suplimentare ca resurse cu capacitate finită în SkyPlanner, astfel încât disponibilitatea lor să fie verificată la programare.
- Pregătire și demontare. În Bills of Operations, pregătirea și demontarea sunt înregistrate ca activități. Transferați timpii de schimbare de fabricație care depind de succesiunea operațiilor în matricea timpilor de pregătire.
Cine configurează integrarea cu SAP ByDesign și asigură asistența
- Echipa SkyPlanner configurează integrarea în etapa de implementare și asigură asistența după punerea în funcțiune, pentru serviciile web și interogările OData convenite. Fiecare companie folosește ByDesign în mod diferit, iar experiența echipei este pusă în practică în această etapă.
- Partenerul dumneavoastră SAP ByDesign poate participa. Acesta cunoaște instanța dumneavoastră, modul în care a fost definit domeniul și extensiile utilizate și poate configura acordurile de comunicare împreună cu echipa SkyPlanner.
- Dezvoltatorii dumneavoastră pot extinde integrarea folosind interfața REST API a SkyPlanner, cu un token API în antetul
Authorization-Token. Echipa SkyPlanner oferă asistență când este nevoie. Detaliile tehnice sunt disponibile în documentația de integrare SkyPlanner.
SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Oferta pentru integrare este stabilită în avans, în funcție de procesele și nevoile dumneavoastră, împreună cu abonamentul. Consultați prețurile, programarea cu capacitate finită pentru SAP ByDesign, pagina SAP Business ByDesign și secțiunea de integrări ERP. Pentru alte sisteme SAP există ghiduri separate: SAP Business One și SAP S/4HANA.
Părerile producătorilor despre SkyPlanner
2 heconomisite în fiecare săptămână
„Cu SkyPlanner, am trecut de la planificarea producției în foi de calcul Excel la optimizarea producției în timp real.”
Kalle Kalliomäki, specialist în lanțul de aprovizionare
UTU · Tablouri electrice și aparataj de comutație
Planificarea producției economisește 2 ore de lucru în fiecare săptămână, iar o nouă listă de operații ajunge la linia de producție în câteva secunde.
+90%eficiență în producție
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența în producție a crescut cu 90%, iar realizarea unui plan optimizat pe trei luni, pentru toate centrele de lucru, durează mai puțin de 30 de minute.
100%respectarea termenelor de livrare din 2021
„SkyPlanner ne oferă vizibilitate asupra capacității și face planificarea predictibilă.”
Dan Berglund, COO/CFO
Opes Corporation · Producție chimică și alimentară
Rata de respectare a termenelor de livrare a fost de 100% pe toată perioada de utilizare a SkyPlanner, din 2021.
Mai puțineopriri din cauza lipsei de materiale
„Valoarea pe care ne-o aduce SkyPlanner este că funcționează în activitatea de zi cu zi, mai ales când stabilim termenele de livrare.”
Tommi Männistö, responsabil cu planificarea producției
Eskomatic · Prelucrări mecanice la comandă
Programarea automată a încărcării resurselor oferă termene de livrare mai precise, iar opririle de producție cauzate de lipsa materialelor s-au redus considerabil.
Întrebări frecvente
Ce API-uri SAP ByDesign folosește SkyPlanner?
Serviciile web A2X publicate de SAP. Pentru citire se folosesc serviciile Query, precum Query Production Orders și Query Purchase Orders, sau interfețe OData personalizate. Pentru scriere se folosesc Manage Production Orders și Manage Production Lots.
Ce date scrie SkyPlanner înapoi în ByDesign?
EarliestStartPeriod și MainResourceID al operației, pentru fiecare comandă de producție. Dacă optați pentru aceasta, cantitățile confirmate, rebuturile și sarcinile finalizate sunt înregistrate în lotul de producție.
ByDesign trimite evenimente către SkyPlanner?
SkyPlanner interoghează serviciile Query din ByDesign la fiecare câteva minute pentru a prelua comenzile și loturile. La fiecare modificare a programului, SkyPlanner trimite webhook-uri care declanșează scrierea înapoi în sistem.
Cum se autentifică SkyPlanner în ByDesign?
Prin intermediul unui sistem de comunicare și al unui acord de comunicare cu un utilizator tehnic, conform ghidului de securitate SAP. API-ul propriu SkyPlanner folosește un token API în antetul Authorization-Token.
Propunerile de producție sunt trimise către SkyPlanner?
SkyPlanner programează comenzile de producție lansate. Propunerile rămân în ByDesign Supply Planning până când devin comenzi de producție.
Cine realizează integrarea?
Echipa SkyPlanner configurează integrarea în etapa de implementare și asigură asistența după punerea în funcțiune. Partenerul dumneavoastră SAP ByDesign sau dezvoltatorii proprii pot, de asemenea, să extindă integrarea folosind interfața REST API a SkyPlanner, cu un token API.
