Koppelingen / ERP / SAP Business ByDesign
Handleiding voor de SAP Business ByDesign koppeling voor productieplanning met SkyPlanner APS
Deze handleiding laat partners en IT-teams zien hoe ze SAP Business ByDesign aan SkyPlanner APS koppelen. SkyPlanner wisselt in beide richtingen gegevens uit met ByDesign via de door SAP vrijgegeven webservices:
- SkyPlanner leest vrijgegeven productieorders met hun bewerkingen, Production Models, Bills of Material en Bills of Operations, machines en personeel, materialen, voorraden en inkooporders in.
- De geplande start van elke productieorder en het primaire productiemiddel van elke bewerking worden teruggestuurd naar ByDesign.
- Bevestigde hoeveelheden, afkeur en afgeronde taken kunnen worden teruggeboekt op de productiepartijen.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Het SkyPlanner-team configureert tijdens de onboarding de koppeling met uw ByDesign-tenant via de REST API en biedt ook na de ingebruikname ondersteuning. Deze handleiding is bedoeld voor partners en ontwikkelaars die hieraan willen meewerken of zelf willen bouwen op de gedocumenteerde REST API van SkyPlanner (API-documentatie).
Integratie-interfaces van SAP ByDesign
ByDesign publiceert per release de vrijgegeven A2X SOAP-webservices in de lijst met webservice-API’s. Een koppeling voor de planning gebruikt de volgende services:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER retourneert de aangevraagde, vroegste en laatste start- en eindtijd, productiemiddelen met hun geplande en gerealiseerde duur, prioriteit, uitvoeringsstatus en planningsstatus. MAINTAIN_BUNDLE_V2 werkt EarliestStartPeriod of LatestEndPeriod bij, en de MainResourceID van de bewerking (SAP-documentatie).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle maakt productietaken aan of werkt ze bij. Hiermee worden per meldpunt de bevestigde hoeveelheid, afkeur en de indicator voor een afgeronde bevestiging vastgelegd. Ook kunnen taken worden afgerond met vermelding van de uitvoerende medewerker en de uitvoeringstijd, en kan de benutting van productiemiddelen worden vastgelegd (SAP-documentatie).
- Query-services. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (ook per productiemiddel), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks en Determine Availability of Products.
- OData. OData-services op maat voor businessobjecten, plus OData voor gegevensbronnen en analytische rapporten. SAP stelt dat “companies are fully empowered to decide which business objects” (bedrijven volledig zelf kunnen bepalen welke businessobjecten) beschikbaar worden gesteld (SAP-integratiescenario’s).
Gebruik de Query-services of OData om gegevens te lezen en de twee Manage-services voor alle schrijfacties.
Authenticatie en licenties
Maak in ByDesign een communicatiesysteem voor SkyPlanner aan en een communicatieconfiguratie voor de services die u gebruikt. Elke configuratie heeft een eigen technische gebruiker. De beveiligingshandleiding van SAP beschrijft authenticatie voor applicatie-integratie met “user ID plus password, and the X.509 client certificate” (gebruikers-ID plus wachtwoord, en het clientcertificaat) (beveiligingshandleiding). Voor OData kan OAuth 2.0 worden geconfigureerd. De WSDL van elke service downloadt u vanuit de communicatieconfiguratie of de Service Explorer.
Aan de SkyPlanner-kant bevat elke aanroep een API-token in de Authorization-Token-header. U maakt het token in SkyPlanner aan onder Settings > API. Met een API-token kunt u meteen beginnen met bouwen.
Events en polling
SkyPlanner verstuurt bij elke planningswijziging webhooks, zodat wijzigingen in de planning direct worden teruggeschreven naar ByDesign.
Vraag de Query-services periodiek op om wijzigingen in ByDesign op te halen. Lees vrijgegeven productieorders en productiepartijen om de paar minuten uit, en materialen, voorraden en inkooporders minder vaak. Queryresultaten worden gepagineerd met QueryHitsMaximumNumberValue en LastReturnedObjectID. SAP vermeldt de standaardpaginagrootte op de pagina over webservices.
Gegevensmapping
| ByDesign-object (interface) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
| Materialen (Query Materials) | Producten en materialen | ByDesign → SkyPlanner | Eerste import, daarna polling |
| Production Bill of Material (Query Production Bill of Materials) | Productstructuur, materialen per product | ByDesign → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Production Bill of Operations: bewerkingen, activiteiten Setup, Produce en Tear down (Query Production Bill of Operations) | Processtappen met bewerkingsduur, instel- en afbouwtijden | ByDesign → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Production Model (Query Production Model) | Bewerkingsvolgorde van het product per vestiging | ByDesign → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Machines en groepen productiemiddelen (Read Equipment Resources) | Werkcentra, werkcentrumgroepen, gereedschappen | ByDesign → SkyPlanner | Eerste import, daarna zelden |
| Personeel en werktijden (Query Labour Resource) | Personeel en diensten | ByDesign → SkyPlanner | Dagelijks, of eigen diensten in SkyPlanner |
| Vrijgegeven productieorders en bewerkingen (Query Production Orders, READ_PROD_ORDER) | Orders en taken met leverdatums en materiaalbehoeften | ByDesign → SkyPlanner | Polling om de paar minuten |
| Productiepartijen en taken (Query Production Lots) | Voortgang van taken | ByDesign → SkyPlanner | Polling om de paar minuten |
| Geïdentificeerde voorraad, productbeschikbaarheid (Query Identified Stocks, Determine Availability of Products) | Voorraadstanden | ByDesign → SkyPlanner | Polling, elk uur of bij een planningsrun |
| Inkooporders (Query Purchase Orders) | Inkooporders, inkomend materiaal per leverdatum | ByDesign → SkyPlanner | Polling, elk uur of bij een planningsrun |
| EarliestStartPeriod, MainResourceID van de bewerking (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Geplande start, toegewezen werkcentrum | SkyPlanner → ByDesign | Bij planningswijzigingen, via een SkyPlanner-webhook |
| Bevestigde hoeveelheid, afkeur, taak afronden (Manage Production Lots, MaintainBundle) | Tijdregistraties en bevestigingen van operators | SkyPlanner → ByDesign | Per bevestiging of per dienst, indien gewenst |
| Niet in ByDesign | Matrix met insteltijden, vereisten voor meerdere operators, alternatieve machines en medewerkers | Beheerd in SkyPlanner | Ingericht tijdens de onboarding |
Opzet van de koppeling
1. Eerste import van stamgegevens. Lees materialen, Production Models, Bills of Material en Bills of Operations, machines en personeel in. Maak bewuste keuzes bij het koppelen van productiemiddelen: een groep met vier machines wordt één werkcentrumgroep of vier werkcentra. Apparatuur die als gereedschap dient, wordt in SkyPlanner als gereedschap met eindige beschikbaarheid gemodelleerd.
2. Productieorders synchroniseren. Lees vrijgegeven productieorders met hun bewerkingen en materialen in, samen met openstaande inkooporders. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt. Productievoorstellen blijven in ByDesign Supply Planning totdat ze productieorders worden.
3. De planning terugschrijven. Wanneer de planningsengine een order inplant of verplaatst, activeert een SkyPlanner-webhook MAINTAIN_BUNDLE_V2 op Manage Production Orders. Daarmee worden EarliestStartPeriod en MainResourceID ingesteld voor de bewerking die SkyPlanner heeft gekozen.
4. Bevestigingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. De tijdregistraties houden de planning actueel. U kiest zelf of de werkelijke gegevens worden teruggeboekt. Zo ja, dan boekt MaintainBundle op Manage Production Lots de bevestigde hoeveelheid, afkeur en de afgeronde taak met de uitvoerende medewerker. Zo nee, dan worden bevestigingen zoals voorheen in ByDesign ingevoerd.
5. Gegevenseigenaarschap en conflictregels. Leg deze vast vóór de ingebruikname:
| Gegevens | Eigenaar |
|---|---|
| Materialen, Production Models, hoeveelheden, order- en partijstatus | ByDesign |
| Volgorde van bewerkingen, start- en eindtijden, toewijzing van productiemiddelen | SkyPlanner |
| Matrix met insteltijden, vereisten voor gereedschappen en operators, alternatieve productiemiddelen | SkyPlanner |
| Diensten en niet-werkdagen | Eén systeem, gekozen tijdens de scopebepaling |
| Bevestigingen, goederenbewegingen, kostencalculatie | ByDesign, daar ingevoerd of geboekt vanuit tijdregistraties in SkyPlanner |
Laat slechts één systeem orderdatums schrijven. Voer geen Load Leveling uit op productiemiddelen die SkyPlanner inplant. Controleer ook dat de planningsrun geen vrijgegeven orders verplaatst waarvoor SkyPlanner leidend is.
Gebruikelijke projectstappen
De implementatie is normaal gesproken binnen enkele weken na de start van de onboarding afgerond. Valideer de planning vooraf tijdens de gratis proefperiode van 30 dagen, met productiemiddelen, Bills of Operations en openstaande productieorders die u vanuit ByDesign als CSV of Excel exporteert.
- Mapping. Leg de mappingtabel vast, bepaal welk systeem leidend is, stel de synchronisatiefrequenties vast en besluit of bevestigingen worden teruggeboekt.
- Toegang tot ByDesign. Maak het communicatiesysteem en de communicatieconfiguraties aan en download de WSDL’s. Test eerst in uw ByDesign-testtenant.
- Eerste import. Materialen, Production Models, Bills of Material en Bills of Operations, productiemiddelen en werktijden.
- Orders en inkooporders synchroniseren. Polling met paginering, filters en herhaalpogingen.
- Planningsbeperkingen instellen in SkyPlanner. De insteltijdmatrix, gereedschappen, het aantal operators per taak en alternatieve machines of medewerkers.
- Planning terugschrijven. MAINTAIN_BUNDLE_V2-aanroepen via SkyPlanner-webhooks, desgewenst aangevuld met partijbevestigingen.
- Parallel testen. Laat SkyPlanner naast de huidige planning draaien, vergelijk de datums en corrigeer de stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Waar u rekening mee moet houden bij een SAP ByDesign-koppeling
- Eén datum per aanroep. “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (EarliestStartPeriod en LatestEndPeriod kunnen niet tegelijk worden bijgewerkt.) Gebruik de startdatum als uitgangspunt voor het terugschrijven.
- Geen vergrendeling. A2X-services zijn stateless. Volgens SAP kan daarom geen transactionele of logische vergrendeling worden afgedwongen. Lees de order vóór elke schrijfactie opnieuw uit en handel conflicten af.
- Afgerond is afgerond. “Confirmation Finished Indicator cannot be unchecked once it is set.” (Confirmation Finished Indicator kan niet meer worden uitgevinkt zodra deze is aangevinkt.) Meld een taak pas gereed wanneer de operator deze afsluit.
- Primaire en aanvullende productiemiddelen. De planning in ByDesign houdt rekening met primaire productiemiddelen. Modelleer operators en gereedschappen uit de aanvullende productiemiddelen in SkyPlanner met een begrensde capaciteit, zodat de planning ook hun beschikbaarheid controleert.
- Instellen en afbouwen. In Bills of Operations zijn instellen en afbouwen als activiteiten opgenomen. Neem volgordeafhankelijke omsteltijden op in de insteltijdenmatrix.
Wie richt de SAP ByDesign-koppeling in en biedt ondersteuning?
- Het SkyPlanner-team richt de koppeling tijdens de onboarding in en biedt ondersteuning na de livegang. Dit geldt voor de afgesproken webservices en OData-query’s. Elk bedrijf gebruikt ByDesign anders; die praktijkkennis wordt in de inrichting verwerkt.
- Uw SAP ByDesign-partner kan meewerken. Uw partner kent uw tenant, scopebepaling en uitbreidingen en kan samen met het SkyPlanner-team de communicatieconfiguraties inrichten.
- Uw eigen ontwikkelaars kunnen de koppeling verder uitbouwen via de REST API van SkyPlanner, met een API-token in de
Authorization-Token-header. Het SkyPlanner-team helpt waar nodig. De integratiedocumentatie vindt u in de SkyPlanner-integratiedocumentatie.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, en wordt maandelijks gefactureerd. U ontvangt vooraf een offerte voor de koppeling, afgestemd op uw processen en behoeften, samen met uw abonnement. Bekijk de prijzen, capaciteitsplanning voor SAP ByDesign, de SAP Business ByDesign-pagina en het overzicht van ERP-koppelingen. Voor andere SAP-systemen zijn er aparte handleidingen: SAP Business One en SAP S/4HANA.
Ervaringen van maakbedrijven met SkyPlanner
2 hbespaard per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime optimalisatie van de productie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning kost elke week 2 uur minder werktijd en een nieuwe werklijst bereikt de productielijn binnen enkele seconden.
+90%productie-efficiëntie
“De efficiëntie in de productie is met 90% gestegen.”
Abdul Rucyinga, hoofd IT
Laboratory & Allied · Farmaceutische productie
De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerde planning voor drie maanden voor alle werkcentra is in minder dan 30 minuten klaar.
100%leverbetrouwbaarheid sinds 2021
“SkyPlanner geeft ons inzicht in de capaciteit en maakt de planning voorspelbaar.”
Dan Berglund, COO/CFO
Opes Corporation · Chemische productie en voedingsmiddelenproductie
De leverbetrouwbaarheid is 100% sinds SkyPlanner in 2021 in gebruik is genomen.
Minderstilstand door materiaaltekorten
“De waarde van SkyPlanner zit voor ons in het feit dat het in de dagelijkse praktijk werkt, vooral bij het vaststellen van leverdatums.”
Tommi Männistö, manager productieplanning
Eskomatic · Verspaning in opdracht
Automatische planning van de werklast levert nauwkeurigere leverdatums op. Ook is de productiestilstand door materiaaltekorten sterk afgenomen.
Veelgestelde vragen
Welke SAP ByDesign-API’s gebruikt SkyPlanner?
De door SAP vrijgegeven A2X-webservices. Voor het uitlezen gebruikt de koppeling Query-services, zoals Query Production Orders en Query Purchase Orders, of OData op maat. Voor het schrijven gebruikt de koppeling Manage Production Orders en Manage Production Lots.
Wat schrijft SkyPlanner terug naar ByDesign?
EarliestStartPeriod en MainResourceID van de bewerking op elke productieorder. Desgewenst worden ook bevestigde aantallen, uitval en afgeronde taken op de productiepartij geboekt.
Stuurt ByDesign events naar SkyPlanner?
SkyPlanner vraagt om de paar minuten orders en partijen op via de Query-services van ByDesign. SkyPlanner verstuurt zelf bij elke planningswijziging webhooks die het terugschrijven activeren.
Hoe authenticeert SkyPlanner zich bij ByDesign?
Via een communicatiesysteem en een communicatieconfiguratie met een technische gebruiker, zoals beschreven in de beveiligingshandleiding van SAP. De eigen API van SkyPlanner gebruikt een API-token in de Authorization-Token-header.
Gaan productievoorstellen naar SkyPlanner?
SkyPlanner plant vrijgegeven productieorders in. Voorstellen blijven in ByDesign Supply Planning totdat ze worden omgezet in productieorders.
Wie bouwt de koppeling?
Het SkyPlanner-team richt de koppeling tijdens de onboarding in en biedt ondersteuning na de livegang. Uw SAP ByDesign-partner of uw eigen ontwikkelaars kunnen ook verder bouwen op de REST API van SkyPlanner met een API-token.
