Integrationer / ERP / SAP Business ByDesign
Guide til SAP Business ByDesign integration med SkyPlanner APS til produktionsplanlægning
Denne guide til SAP Business ByDesign integration viser partnere og IT-teams, hvordan de forbinder ByDesign med SkyPlanner APS. SkyPlanner udveksler data med ByDesign i begge retninger via SAP’s frigivne webservices:
- Frigivne produktionsordrer med tilhørende operationer, Production Models, Bills of Material og Bills of Operations samt udstyrs- og personaleressourcer, materialer, lagerbeholdninger og indkøbsordrer overføres til SkyPlanner.
- Det planlagte starttidspunkt for hver produktionsordre og hovedressourcen for hver operation sendes tilbage til ByDesign.
- Tilbagemeldte mængder, kassation og afsluttede opgaver kan skrives tilbage til produktionspartierne.
- SkyPlanner-webhooks sender ændringer i planen, så snart de sker.
SkyPlanner-teamet konfigurerer integrationen til jeres ByDesign-tenant via REST API under opstarten og yder support efter idriftsættelsen. Denne guide er til partnere og udviklere, der vil deltage eller selv bygge videre på SkyPlanners dokumenterede REST API (API-reference).
Integrationsgrænseflader i SAP ByDesign
For hver version offentliggør ByDesign sine frigivne A2X SOAP-webservices i listen over webservice-API’er. En integration til detailplanlægning bruger følgende tjenester:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER returnerer ønskede, tidligste og seneste start- og sluttidspunkter, ressourcer med planlagt og faktisk varighed, prioritet, udførelsesstatus og planlægningsstatus. MAINTAIN_BUNDLE_V2 opdaterer EarliestStartPeriod eller LatestEndPeriod samt operationens MainResourceID (SAP-hjælp).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle opretter eller opdaterer produktionsopgaver med tilbagemeldt mængde, kassation og en markering af afsluttet tilbagemelding pr. rapporteringspunkt. Tjenesten afslutter også opgaver med angivelse af den udførende medarbejder og udførelsestid samt registrerer ressourceudnyttelse (SAP-hjælp).
- Query-tjenester. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (også efter ressource), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks og Determine Availability of Products.
- OData. Tilpassede OData-tjenester til forretningsobjekter samt OData til datakilder og analyserapporter. SAP skriver “companies are fully empowered to decide which business objects” (virksomhederne kan frit vælge, hvilke forretningsobjekter) der eksponeres (SAP’s integrationsscenarier).
Brug Query-tjenesterne eller OData til at læse data og de to Manage-tjenester til al skrivning.
Autentificering og licenser
Opret et kommunikationssystem til SkyPlanner i ByDesign og en kommunikationsaftale for de tjenester, I bruger. Hver aftale har sin egen tekniske bruger. SAP’s sikkerhedsvejledning angiver autentificering af applikationsintegration med “user ID plus password, and the X.509 client certificate” (bruger-id og adgangskode samt klientcertifikatet) (sikkerhedsvejledning). OAuth 2.0 kan konfigureres til OData. Hent WSDL-filen for hver tjeneste fra kommunikationsaftalen eller Service Explorer.
I SkyPlanner skal hvert kald indeholde et API-token i headeren Authorization-Token. Opret tokenet i SkyPlanner under Settings > API. Et API-token er nok til at komme i gang med udviklingen.
Hændelser og polling
SkyPlanner sender webhooks ved hver ændring i planen, så ændringer skrives tilbage til ByDesign, i takt med at planen justeres.
Hent ændringer fra ByDesign ved at foretage regelmæssige kald til Query-tjenesterne. Læs frigivne produktionsordrer og produktionspartier med få minutters mellemrum og materialer, lagerbeholdninger og indkøbsordrer med længere intervaller. Forespørgselsresultater opdeles i sider med QueryHitsMaximumNumberValue og LastReturnedObjectID. SAP dokumenterer standardstørrelsen på siderne på sin side om webservices.
Datamapping
| ByDesign-objekt (grænseflade) | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
| Materialer (Query Materials) | Produkter og materialer | ByDesign → SkyPlanner | Indledende indlæsning, derefter polling |
| Production Bill of Material (Query Production Bill of Materials) | Produktstruktur, materialer pr. produkt | ByDesign → SkyPlanner | Første indlæsning, derefter ved ændringer |
| Production Bill of Operations: operationer samt aktiviteterne Setup, Produce og Tear down (Query Production Bill of Operations) | Procestrin med varighed samt opstillings- og nedtagningstider | ByDesign → SkyPlanner | Indledende indlæsning, derefter ved ændringer |
| Production Model (Query Production Model) | Produktrute pr. produktionssted | ByDesign → SkyPlanner | Indledende indlæsning, derefter ved ændringer |
| Udstyrsressourcer og ressourcegrupper (Read Equipment Resources) | Arbejdsstationer, grupper af arbejdsstationer, værktøjer | ByDesign → SkyPlanner | Indledende indlæsning, derefter sjældent |
| Personaleressourcer, driftstider (Query Labour Resource) | Personale og skiftehold | ByDesign → SkyPlanner | Dagligt, eller egne skiftehold i SkyPlanner |
| Frigivne produktionsordrer og operationer (Query Production Orders, READ_PROD_ORDER) | Ordrer og opgaver med leveringsfrister og materialebehov | ByDesign → SkyPlanner | Polling med få minutters mellemrum |
| Produktionspartier og opgaver (Query Production Lots) | Opgavernes fremdrift | ByDesign → SkyPlanner | Polling med få minutters mellemrum |
| Identificeret lagerbeholdning, produkttilgængelighed (Query Identified Stocks, Determine Availability of Products) | Lagerbeholdninger | ByDesign → SkyPlanner | Polling hver time eller ved kørsel af planlægningen |
| Indkøbsordrer (Query Purchase Orders) | Indkøbsordrer, indgående materialer efter leveringsdato | ByDesign → SkyPlanner | Polling hver time eller ved kørsel af planlægningen |
| EarliestStartPeriod, operationens MainResourceID (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Planlagt start, tildelt arbejdsstation | SkyPlanner → ByDesign | Ved ændringer i planen via en SkyPlanner-webhook |
| Tilbagemeldt mængde, kassation, afslutning af opgave (Manage Production Lots, MaintainBundle) | Tidsregistreringer og operatørtilbagemeldinger | SkyPlanner → ByDesign | Pr. tilbagemelding eller skiftehold, hvis det er valgt |
| Findes ikke i ByDesign | Matrix over omstillingstider, krav om flere operatører, alternative maskiner og medarbejdere | Vedligeholdes i SkyPlanner | Konfigureres under opstarten |
Integrationsmønstre
1. Indledende indlæsning af stamdata. Læs materialer, Production Models, Bills of Material og Bills of Operations samt udstyrs- og personaleressourcer. Tag bevidst stilling til, hvordan ressourcerne skal mappes: En ressourcegruppe med fire maskiner bliver til én gruppe af arbejdsstationer eller fire arbejdsstationer. Udstyrsressourcer, der er værktøjer, bliver til værktøjer med begrænset tilgængelighed i SkyPlanner.
2. Synkronisering af produktionsordrer. Læs frigivne produktionsordrer med tilhørende operationer og materialer samt åbne indkøbsordrer. SkyPlanner regner bestilte materialer som tilgængelige på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered. Produktionsforslag bliver i ByDesign Supply Planning, indtil de bliver til produktionsordrer.
3. Tilbageskrivning af planen. Når planlægningsmotoren placerer eller flytter en ordre, udløser en SkyPlanner-webhook et kald til MAINTAIN_BUNDLE_V2 i Manage Production Orders. Kaldet angiver EarliestStartPeriod og MainResourceID for den operation, SkyPlanner har valgt.
4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringerne holder planen ajour. I vælger, om faktiske produktionsdata skal skrives tilbage. Hvis ja, sender MaintainBundle i Manage Production Lots den tilbagemeldte mængde, kassation og den afsluttede opgave med angivelse af den udførende medarbejder. Hvis nej, registreres tilbagemeldingerne i ByDesign som hidtil.
5. Dataejerskab og konfliktregler. Skriv dem ned før idriftsættelsen:
| Data | Ejer |
|---|---|
| Materialer, Production Models, mængder, ordre- og partistatus | ByDesign |
| Operationsrækkefølge, start- og sluttidspunkter, ressourcetildeling | SkyPlanner |
| Matrix for omstillingstider, krav til værktøjer og operatører, alternative ressourcer | SkyPlanner |
| Skiftehold og arbejdsfri dage | Ét system, valgt under afklaringen |
| Tilbagemeldinger, varebevægelser, omkostningsberegning | ByDesign, registreret dér eller overført fra tidsregistreringer i SkyPlanner |
Vælg ét system til at skrive ordredatoer. Kør ikke Load Leveling på ressourcer, som SkyPlanner planlægger, og kontrollér, at planlægningskørslen ikke flytter frigivne ordrer, som SkyPlanner har ansvaret for.
Typiske projekttrin
Implementeringen er normalt færdig inden for få uger efter opstarten. Inden da skal I validere planen i den gratis prøveperiode på 30 dage med ressourcer, Bills of Operations og åbne produktionsordrer eksporteret fra ByDesign som CSV eller Excel.
- Mapping. Fastlæg mappingtabellen, ansvarsreglerne, synkroniseringsintervallerne, og om tilbagemeldinger skal skrives tilbage.
- Adgang til ByDesign. Opret kommunikationssystemet og kommunikationsaftalerne, og hent WSDL-filerne. Test først i jeres ByDesign-testtenant.
- Indledende indlæsning. Materialer, Production Models, Bills of Material og Bills of Operations, ressourcer og driftstider.
- Synkronisering af produktions- og indkøbsordrer. Polling med sideopdeling, filtre og genforsøg.
- Opsætning af begrænsninger i SkyPlanner. Omstillingsmatrix, værktøjer, antal operatører pr. opgave og alternative maskiner eller medarbejdere.
- Tilbageskrivning af planen. Kald til MAINTAIN_BUNDLE_V2 via SkyPlanner-webhooks samt tilbagemeldinger på produktionspartier, hvis det er valgt.
- Parallel test. Kør SkyPlanner sideløbende med den nuværende plan, sammenlign datoer, og ret stamdata.
- Idriftsættelse. Aktivér tilbageskrivning, når dataene stemmer overens.
Det skal I tage højde for i en SAP ByDesign-integration
- Én dato pr. kald. “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (EarliestStartPeriod og LatestEndPeriod kan ikke opdateres samtidig.) Brug startdatoen som udgangspunkt for tilbageskrivningen.
- Ingen låsning. A2X-tjenester er tilstandsløse, og ifølge SAP kan der derfor hverken håndhæves transaktionslåsning eller logisk låsning. Læs ordren igen før hver skrivning, og håndter konflikter.
- Afsluttet betyder afsluttet. “Confirmation Finished Indicator cannot be unchecked once it is set.” (Markeringen i Confirmation Finished Indicator kan ikke fjernes, når den først er sat.) Registrer først afslutningen, når operatøren lukker opgaven.
- Hovedressourcer og ekstra ressourcer. Planlægningen i ByDesign tager højde for hovedressourcer. Opret operatører og værktøjer fra de ekstra ressourcer som ressourcer med begrænset kapacitet i SkyPlanner, så planlægningen også kontrollerer deres tilgængelighed.
- Klargøring og nedtagning. I Bills of Operations er klargøring og nedtagning registreret som aktiviteter. Flyt rækkefølgeafhængige omstillingstider til matricen for omstillingstider.
Hvem konfigurerer og supporterer SAP ByDesign-integrationen?
- SkyPlanner-teamet konfigurerer integrationen under opstarten og yder support efter idriftsættelsen. Det omfatter de aftalte webtjenester og OData-forespørgsler. Hver virksomhed bruger ByDesign på sin egen måde, og den viden indgår i arbejdet.
- Jeres SAP ByDesign-partner kan deltage. Partneren kender jeres tenant, afklaring og udvidelser og kan sætte communication arrangements op sammen med SkyPlanner-teamet.
- Jeres egne udviklere kan bygge videre på integrationen via SkyPlanners REST API med et API-token i
Authorization-Token-headeren. SkyPlanner-teamet hjælper efter behov. I finder integrationsdokumentationen i SkyPlanners integrationsvejledning.
SkyPlanner koster fra 199 € pr. måned med 5 arbejdsstationer inkluderet og månedlig fakturering. I får på forhånd et tilbud på integrationen sammen med jeres abonnement, tilpasset jeres processer og behov. Se priser, produktionsplanlægning med SAP ByDesign, der tager højde for den faktiske kapacitet, siden om SAP Business ByDesign og oversigten over ERP-integrationer. Andre SAP-systemer har deres egne vejledninger: SAP Business One og SAP S/4HANA.
Produktionsvirksomheders anmeldelser af SkyPlanner
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-ark til optimering af produktionen i realtid.”
Kalle Kalliomäki, forsyningskædespecialist
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 timers arbejdstid hver uge, og en ny opgavekø når ud til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
100%leveringssikkerhed siden 2021
“SkyPlanner giver os overblik over kapaciteten og gør planlægningen forudsigelig.”
Dan Berglund, COO/CFO
Opes Corporation · Kemikalie- og fødevareproduktion
Leveringssikkerheden har været 100% i hele den periode, SkyPlanner har været i brug, siden 2021.
Færrestop på grund af materialemangel
“Værdien af SkyPlanner for os er, at det er et værktøj, der fungerer i hverdagen, især når vi skal fastsætte leveringsdatoer.”
Tommi Männistö, chef for produktionsplanlægning
Eskomatic · Maskinbearbejdning som underleverandør
Automatisk planlægning af belastningen giver mere præcise leveringsdatoer, og antallet af produktionsstop på grund af materialemangel er faldet markant.
Ofte stillede spørgsmål
Hvilke API’er i SAP ByDesign bruger SkyPlanner?
SAP’s frigivne A2X-webtjenester. Data læses via Query-tjenesterne, såsom Query Production Orders og Query Purchase Orders, eller via tilpasset OData. Data skrives via Manage Production Orders og Manage Production Lots.
Hvad skriver SkyPlanner tilbage til ByDesign?
EarliestStartPeriod og operationens MainResourceID på hver produktionsordre. Hvis I vælger det, registreres bekræftede mængder, kassation og afsluttede opgaver på produktionspartiet.
Sender ByDesign hændelser til SkyPlanner?
SkyPlanner henter ordrer og produktionspartier fra ByDesigns Query-tjenester med få minutters mellemrum. SkyPlanner sender selv webhooks ved hver ændring i planen, som udløser tilbageskrivningen.
Hvordan autentificerer SkyPlanner sig over for ByDesign?
Via et communication system og et communication arrangement med en teknisk bruger, som beskrevet i SAP’s sikkerhedsvejledning. SkyPlanners eget API bruger et API-token i Authorization-Token-headeren.
Overføres produktionsforslag til SkyPlanner?
SkyPlanner planlægger frigivne produktionsordrer. Forslag bliver i ByDesign Supply Planning, indtil de bliver til produktionsordrer.
Hvem bygger integrationen?
SkyPlanner-teamet konfigurerer integrationen under opstarten og yder support efter idriftsættelsen. Jeres SAP ByDesign-partner eller egne udviklere kan også bygge videre via SkyPlanners REST API med et API-token.
