Integrasjoner / ERP / SAP Business ByDesign
Guide til integrasjon med SAP Business ByDesign for produksjonsplanlegging med SkyPlanner APS
Denne guiden til integrasjon med SAP Business ByDesign viser partnere og IT-team hvordan de kobler ByDesign til SkyPlanner APS. SkyPlanner integreres med ByDesign i begge retninger via SAPs publiserte webtjenester:
- Frigitte produksjonsordrer med tilhørende operasjoner, Production Models, Bills of Material og Bills of Operations, utstyrs- og personellressurser, materialer, lagerbeholdning og innkjøpsordrer overføres til SkyPlanner.
- Planlagt start for hver produksjonsordre og hovedressursen for hver operasjon overføres tilbake til ByDesign.
- Bekreftede mengder, vrak og fullførte oppgaver kan skrives tilbake til produksjonspartiene.
- SkyPlanners webhooks sender planendringer fortløpende.
SkyPlanner-teamet setter opp integrasjonen mot ByDesign-miljøet ditt via REST API under oppstarten og følger den opp etter produksjonssetting. Denne guiden er for partnere og utviklere som vil delta i arbeidet eller bygge videre på SkyPlanners dokumenterte REST API på egen hånd (API-referanse).
Integrasjonsgrensesnitt i SAP ByDesign
For hver versjon publiserer ByDesign de tilgjengelige A2X SOAP-webtjenestene i listen over webtjeneste-API-er. En integrasjon for produksjonsplanlegging bruker disse tjenestene:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER returnerer ønsket, tidligste og seneste start og slutt, ressurser med planlagt og faktisk varighet, prioritet, utførelsesstatus og planleggingsstatus. MAINTAIN_BUNDLE_V2 oppdaterer EarliestStartPeriod eller LatestEndPeriod samt MainResourceID for operasjonen (SAP-hjelp).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle oppretter eller oppdaterer produksjonsoppgaver. Kallet registrerer bekreftet mengde, vrak og en indikator for fullført bekreftelse per rapporteringspunkt, fullfører oppgaver med opplysninger om utførende medarbeider og utførelsestid og registrerer ressursutnyttelse (SAP-hjelp).
- Query-tjenester. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (også per ressurs), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks og Determine Availability of Products.
- OData. Egendefinerte OData-tjenester for forretningsobjekter, samt OData for datakilder og analytiske rapporter. Ifølge SAP bestemmer bedriftene selv hvilke forretningsobjekter som eksponeres: «companies are fully empowered to decide which business objects» (bedriftene står helt fritt til å bestemme hvilke forretningsobjekter) (SAPs integrasjonsscenarioer).
Bruk Query-tjenestene eller OData til lesing og de to Manage-tjenestene til all skriving.
Autentisering og lisensiering
I ByDesign oppretter du et kommunikasjonssystem for SkyPlanner og et kommunikasjonsoppsett for tjenestene du bruker. Hvert oppsett har sin egen tekniske bruker. SAPs sikkerhetsguide beskriver autentisering av applikasjonsintegrasjon med «user ID plus password, and the X.509 client certificate» (bruker-ID og passord samt klientsertifikatet) (sikkerhetsguide). OAuth 2.0 kan konfigureres for OData. Du laster ned WSDL for hver tjeneste fra kommunikasjonsoppsettet eller Service Explorer.
På SkyPlanner-siden inneholder hvert kall et API-token i Authorization-Token-headeren. Du oppretter tokenet i SkyPlanner under Settings > API. Et API-token er alt du trenger for å begynne å bygge.
Hendelser og polling
SkyPlanner sender webhooks ved hver planendring, slik at endringene skrives tilbake til ByDesign etter hvert som planen endres.
Hent endringer fra ByDesign ved å spørre Query-tjenestene regelmessig. Les frigitte produksjonsordrer og produksjonspartier med noen minutters mellomrom, og materialer, lagerbeholdning og innkjøpsordrer med lengre intervaller. Spørringsresultatene deles opp i sider med QueryHitsMaximumNumberValue og LastReturnedObjectID. SAP dokumenterer standard sidestørrelse på siden om webtjenester.
Datakobling
| ByDesign-objekt (grensesnitt) | Objekt i SkyPlanner | Retning | Hyppighet |
|---|---|---|---|
| Materialer (Query Materials) | Produkter og materialer | ByDesign → SkyPlanner | Førstegangsinnlasting, deretter regelmessig henting |
| Production Bill of Material (Query Production Bill of Materials) | Produktstruktur, materialer per produkt | ByDesign → SkyPlanner | Førstegangsinnlasting, deretter ved endringer |
| Production Bill of Operations: operasjoner og aktivitetene Setup, Produce og Tear down (Query Production Bill of Operations) | Prosesstrinn med varighet, klargjørings- og nedriggingstider | ByDesign → SkyPlanner | Førstegangsinnlasting, deretter ved endring |
| Production Model (Query Production Model) | Produktets produksjonsrute per produksjonssted | ByDesign → SkyPlanner | Førstegangsinnlasting, deretter ved endring |
| Utstyrsressurser og ressursgrupper (Read Equipment Resources) | Arbeidsstasjoner, arbeidsstasjonsgrupper, verktøy | ByDesign → SkyPlanner | Førstegangsinnlasting, sjelden deretter |
| Personellressurser, driftstider (Query Labour Resource) | Personell og skift | ByDesign → SkyPlanner | Daglig, eller egne skift i SkyPlanner |
| Frigitte produksjonsordrer og operasjoner (Query Production Orders, READ_PROD_ORDER) | Ordrer og jobber med frister og materialbehov | ByDesign → SkyPlanner | Henting med noen minutters mellomrom |
| Produksjonspartier og oppgaver (Query Production Lots) | Fremdrift for jobber | ByDesign → SkyPlanner | Henting med noen minutters mellomrom |
| Identifisert lagerbeholdning, produkttilgjengelighet (Query Identified Stocks, Determine Availability of Products) | Lagerbeholdning | ByDesign → SkyPlanner | Henting hver time eller ved planleggingskjøring |
| Innkjøpsordrer (Query Purchase Orders) | Innkjøpsordrer, innkommende materialer etter leveringsdato | ByDesign → SkyPlanner | Henting hver time eller ved planleggingskjøring |
| EarliestStartPeriod, operasjonens MainResourceID (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Planlagt start, tildelt arbeidsstasjon | SkyPlanner → ByDesign | Ved planendring, via webhook fra SkyPlanner |
| Bekreftet mengde, vrak, fullføring av oppgave (Manage Production Lots, MaintainBundle) | Tidsregistreringer og operatørbekreftelser | SkyPlanner → ByDesign | Per bekreftelse eller per skift, hvis valgt |
| Finnes ikke i ByDesign | Matrise for klargjøringstider, krav til flere operatører, alternative maskiner og personell | Vedlikeholdes i SkyPlanner | Settes opp under oppstarten |
Slik settes integrasjonen opp
1. Førstegangsinnlasting av grunndata. Les inn materialer, Production Models, Bills of Material og Bills of Operations samt utstyrs- og personellressurser. Ta bevisste valg når du kobler ressursene: En ressursgruppe med fire maskiner blir til én arbeidsstasjonsgruppe eller fire arbeidsstasjoner. Utstyrsressurser som er verktøy, blir til verktøy med begrenset kapasitet i SkyPlanner.
2. Synkronisering av produksjonsordrer. Les inn frigitte produksjonsordrer med tilhørende operasjoner og materialer, samt åpne innkjøpsordrer. SkyPlanner regner bestilte materialer som tilgjengelige på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered. Produksjonsforslag forblir i ByDesign Supply Planning til de blir produksjonsordrer.
3. Tilbakeskriving av planen. Når planleggingsmotoren plasserer eller flytter en ordre, utløser en webhook fra SkyPlanner MAINTAIN_BUNDLE_V2 i Manage Production Orders. Kallet setter EarliestStartPeriod og MainResourceID for operasjonen SkyPlanner valgte.
4. Bekreftelser fra produksjonen. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringene holder planen oppdatert. Du velger om faktiske produksjonsdata skal skrives tilbake. Hvis ja, posterer MaintainBundle i Manage Production Lots bekreftet mengde, vrak og den fullførte oppgaven med utførende medarbeider. Hvis nei, registreres bekreftelsene i ByDesign som før.
5. Dataeierskap og konfliktregler. Dokumenter reglene før produksjonssetting:
| Data | Eier |
|---|---|
| Materialer, Production Models, mengder, ordre- og partistatus | ByDesign |
| Operasjonsrekkefølge, start- og sluttider, ressurstildeling | SkyPlanner |
| Matrise for omstillingstider, krav til verktøy og operatører, alternative ressurser | SkyPlanner |
| Skift og arbeidsfrie dager | Ett system, valgt under avklaringen |
| Bekreftelser, varebevegelser, kostnadsberegning | ByDesign, registrert der eller overført fra tidsregistreringer i SkyPlanner |
Velg ett system som skriver ordredatoer. Ikke kjør Load Leveling på ressurser som SkyPlanner planlegger, og kontroller at planleggingskjøringen ikke flytter frigitte ordrer som SkyPlanner har ansvar for.
Typiske prosjekttrinn
Implementeringen er normalt ferdig i løpet av noen uker etter oppstart. Før det bør du validere planen i den gratis prøveperioden på 30 dager med ressurser, Bills of Operations og åpne produksjonsordrer eksportert fra ByDesign som CSV eller Excel.
- Datakobling. Fastsett koblingstabellen, reglene for dataansvar, synkroniseringsintervallene og om bekreftelser skal skrives tilbake.
- Tilgang til ByDesign. Opprett kommunikasjonssystemet og kommunikasjonsoppsettene, og last ned WSDL-filene. Test først i ByDesign-testmiljøet ditt.
- Førstegangsinnlasting. Materialer, Production Models, Bills of Material og Bills of Operations, ressurser og driftstider.
- Synkronisering av ordrer og innkjøpsordrer. Regelmessig henting med sideinndeling, filtre og nye forsøk ved feil.
- Oppsett av begrensninger i SkyPlanner. Matrise for omstillingstider, verktøy, antall operatører per jobb og alternative maskiner eller medarbeidere.
- Tilbakeskriving av planen. MAINTAIN_BUNDLE_V2-kall utløst av webhooks fra SkyPlanner, samt bekreftelser på produksjonspartier hvis dere velger det.
- Parallell testing. Kjør SkyPlanner parallelt med dagens plan, sammenlign datoer og rett opp grunndata.
- Produksjonssetting. Aktiver tilbakeskriving når dataene stemmer overens.
Dette må dere ta høyde for i en SAP ByDesign-integrasjon
- Én dato per kall. «The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.» (EarliestStartPeriod og LatestEndPeriod kan ikke oppdateres samtidig.) Bruk startdatoen som utgangspunkt for tilbakeskrivingen.
- Ingen låsing. A2X-tjenestene er tilstandsløse. Ifølge SAP kan derfor verken transaksjonslåsing eller logisk låsing håndheves. Les ordren på nytt før hver skriving, og håndter konflikter.
- Fullført betyr fullført. «Confirmation Finished Indicator cannot be unchecked once it is set.» (Avmerkingen for Confirmation Finished Indicator kan ikke fjernes når den først er satt.) Registrer oppgaven som fullført først når operatøren avslutter den.
- Hovedressurser og tilleggsressurser. ByDesign tar hensyn til hovedressursene i planleggingen. Modeller operatører og verktøy fra tilleggsressursene som ressurser med begrenset kapasitet i SkyPlanner, slik at planen også kontrolleres mot disse.
- Klargjøring og nedrigging. I Bills of Operations ligger klargjøring og nedrigging som aktiviteter. Flytt rekkefølgeavhengige omstillingstider til matrisen for klargjøringstid.
Hvem setter opp og støtter SAP ByDesign-integrasjonen?
- SkyPlanner-teamet setter opp integrasjonen under innføringen og gir støtte etter driftsstart. Dette dekker de avtalte webtjenestene og OData-spørringene. Hver bedrift bruker ByDesign på sin måte, og denne kunnskapen tas med i oppsettet.
- SAP ByDesign-partneren deres kan delta. Partneren kjenner tenantmiljøet, omfanget dere har avklart, og utvidelsene deres, og kan sette opp kommunikasjonsoppsettene sammen med SkyPlanner-teamet.
- Deres egne utviklere kan bygge videre på integrasjonen via SkyPlanners REST API med et API-token i
Authorization-Token-headeren. SkyPlanner-teamet bistår ved behov. Dere finner dokumentasjonen i SkyPlanners integrasjonsdokumentasjon.
SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og faktureres månedlig. Dere får et pristilbud på integrasjonen på forhånd, tilpasset prosessene og behovene deres, sammen med abonnementet. Se priser, produksjonsplanlegging for SAP ByDesign som tar hensyn til faktisk maskin- og personellkapasitet, siden om SAP Business ByDesign og oversikten over ERP-integrasjoner. Andre SAP-systemer har egne veiledninger: SAP Business One og SAP S/4HANA.
Produsentenes erfaringer med SkyPlanner
2 hspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-regneark til produksjonsoptimalisering i sanntid.»
Kalle Kalliomäki, spesialist i forsyningskjeder
UTU · Elektriske tavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 timers arbeidstid hver uke, og en ny arbeidskø når produksjonslinjen på sekunder.
+90%produksjonseffektivitet
«Effektiviteten i produksjonen har økt med 90%.»
Abdul Rucyinga, IT-sjef
Laboratory & Allied · Legemiddelproduksjon
Produksjonseffektiviteten har økt med 90%, og det tar under 30 minutter å lage en optimalisert plan for tre måneder som dekker alle arbeidsstasjonene.
100%leveringspålitelighet siden 2021
«SkyPlanner gir oss oversikt over kapasiteten og gjør planleggingen forutsigbar.»
Dan Berglund, COO/CFO
Opes Corporation · Kjemikalie- og næringsmiddelproduksjon
Leveringspåliteligheten har vært 100% hele tiden SkyPlanner har vært i bruk, siden 2021.
Færrestans på grunn av materialmangel
«Verdien av SkyPlanner for oss er at det er et verktøy som fungerer i det daglige, særlig når vi skal fastsette leveringsdatoer.»
Tommi Männistö, leder for produksjonsplanlegging
Eskomatic · Maskinering på oppdrag
Automatisk planlegging av belastningen gir mer presise leveringsdatoer, og produksjonsstans som skyldes materialmangel, har gått kraftig ned.
Vanlige spørsmål
Hvilke API-er i SAP ByDesign bruker SkyPlanner?
SAPs publiserte A2X-webtjenester. Data leses via Query-tjenestene, som Query Production Orders og Query Purchase Orders, eller via tilpasset OData. Til skriving brukes Manage Production Orders og Manage Production Lots.
Hva skriver SkyPlanner tilbake til ByDesign?
EarliestStartPeriod og operasjonens MainResourceID på hver produksjonsordre. Hvis dere velger det, registreres også bekreftede mengder, vrak og fullførte oppgaver på produksjonspartiet.
Sender ByDesign hendelser til SkyPlanner?
SkyPlanner spør ByDesigns Query-tjenester etter ordrer og produksjonspartier med noen minutters mellomrom. SkyPlanner sender selv webhooks ved hver endring i planen. Disse utløser tilbakeskrivingen.
Hvordan autentiserer SkyPlanner seg mot ByDesign?
Via et kommunikasjonssystem og et kommunikasjonsoppsett med en teknisk bruker, slik SAPs sikkerhetsveiledning beskriver. SkyPlanners eget API bruker et API-token i Authorization-Token-headeren.
Overføres produksjonsforslag til SkyPlanner?
SkyPlanner planlegger frigitte produksjonsordrer. Forslagene blir i ByDesign Supply Planning til de blir produksjonsordrer.
Hvem bygger integrasjonen?
SkyPlanner-teamet setter opp integrasjonen under innføringen og gir støtte etter driftsstart. SAP ByDesign-partneren deres eller deres egne utviklere kan også bygge videre på SkyPlanners REST API med et API-token.
