Integraties / ERP / SAP Business One
Integratiehandleiding voor SAP Business One voor het opstellen van productieschema’s met SkyPlanner APS
Deze handleiding laat SAP Business One-partners en IT-teams zien hoe ze B1 aan SkyPlanner APS koppelen. U leest welke API’s u gebruikt, welke objecten in welke richting worden uitgewisseld en waar B1-projecten mislopen. SkyPlanner wisselt via de Service Layer gegevens in beide richtingen uit met SAP Business One:
- Productieorders, bewerkingsfasen, productiemiddelen, artikelen en inkooporders worden ingelezen.
- Geplande start- en einddatums worden teruggeschreven naar de productieorders.
- Urenregistraties van operators worden geboekt als Receipt and Issue for Production.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Artikelen, stuklijsten, productieorders, voorraad en financiën blijven in SAP Business One. Uw productiemodule blijft ongewijzigd. Het SkyPlanner-team configureert de integratie tijdens de onboarding op basis van standaard B1-objecten en biedt ondersteuning na de ingebruikname. Elke bedrijfsdatabase heeft andere bewerkingsfasen, groepen productiemiddelen, gebruikersvelden en add-ons. De configuratie stemt de koppeling daarop af.
Laboratory & Allied gebruikt SkyPlanner met SAP Business One op HANA. Bekijk voor de businesscase de pagina over het opstellen van productieschema’s met SAP Business One.
Integratiemogelijkheden voor SAP Business One
SAP Business One biedt drie integratie-interfaces. Voor een planningssysteem in de cloud is Service Layer de standaardkeuze.
| Optie | Beschrijving | Geschiktheid voor APS-integratie |
|---|---|---|
| Service Layer | REST/OData-API. /b1s/v1 gebruikt OData v3, /b1s/v2 gebruikt OData v4. Beschikbaar voor de SAP HANA-versie van SAP Business One en sinds 10.0 PL01 ook voor Microsoft SQL Server. | Voorkeursroute. Gebruikt HTTP en JSON en werkt vanuit een cloudservice. |
| DI API | Windows COM-bibliotheek. Productieorders worden weergegeven door het object ProductionOrders en opgeslagen in tabel OWOR (objecttype 202). | Voor legacy- of on-premises middleware. Vereist een Windows-host. |
| Integration Framework (B1if) | Middleware van SAP voor scenario’s op documentniveau. | Nuttig als de partner al B1if-scenario’s gebruikt. |
Authenticatie
Service Layer gebruikt sessieauthenticatie. U verstuurt POST /b1s/v1/Login met CompanyDB, UserName en Password en ontvangt een B1SESSION-cookie (plus eventueel een ROUTEID bij configuraties met load balancing). De standaardwaarde van SessionTimeout is 30 minuten inactiviteit. Roep Logout expliciet aan zodra een synchronisatieronde is afgerond. Maak een aparte B1-gebruiker voor de integratie aan, zodat elke wijziging vanuit SkyPlanner in het wijzigingslogboek te herleiden is.
Service Layer-entiteiten voor het opstellen van productieschema’s
| Gegevens | Entiteit in Service Layer |
|---|---|
| Artikelen en planningsgegevens | Items |
| Stuklijsten en fasen in de bewerkingsvolgorde | ProductTrees (Lines, Stages) |
| Machines, personeel en overige productiemiddelen | Resources, ResourceGroups |
| Productieorders | ProductionOrders (Lines, Stages) |
| Voorraad per magazijn | Voorraadgegevens van Items, Warehouses |
| Openstaande inkooporders en leverdatums | PurchaseOrders (DocumentLines: openstaande hoeveelheid, ShipDate) |
| Goederenontvangsten op inkooporders | PurchaseDeliveryNotes (Goods Receipt PO, objecttype 20) |
| Issue for Production | InventoryGenExits |
| Receipt from Production | InventoryGenEntries |
| Webhookconfiguratie | EventSubscriptions, EventNotifications |
De standaardpaginagrootte is 20 records. Verhoog deze met de header Prefer: odata.maxpagesize (of met PageSize in b1s.conf) en volg odata.nextLink. Gebruik $expand om productieorderregels en -fasen in één aanroep op te halen en batchverzoeken om grote hoeveelheden gegevens terug te schrijven.
Events en webhooks
Vanaf SAP Business One 10.0 FP 2602 ondersteunt Service Layer webhooks. Ze staan standaard uit. U schakelt ze per bedrijfsdatabase in met CompanyService_UpdateAdminInfo (EnableWebhook = tYES). Vervolgens verstuurt u POST EventSubscriptions met drie onderdelen:
- een
WebhookURL - een
AuthenticationType: None, Basic, HMAC of OAuth, met HMAC als standaardwaarde - een
EventCollectionmet bedrijfsobjecten en transactietypen
De WebhookURL moet HTTPS gebruiken met een certificaat dat overeenkomt met de hostnaam. EventSubscriptionsService_GetEventCatalog geeft aan op welke gebeurtenissen u zich kunt abonneren. De Webhook Messenger Service moet actief zijn.
Gebruik bij oudere versies periodieke polling (zie de valkuil rond UpdateDate hieronder). SBO_SP_TransactionNotification is een validatiehook op databaseniveau, geen kanaal voor het afleveren van meldingen.
Datamapping: van SAP Business One naar SkyPlanner
| SAP Business One (Service Layer) | Object in SkyPlanner | Richting | Frequentie |
|---|---|---|---|
Items (zelf geproduceerde artikelen, Procurement Method) | Producten | B1 → SkyPlanner | Eerste import, daarna periodiek |
Lines van ProductTrees (artikelregels) | Materialen per product | B1 → SkyPlanner | Eerste import, daarna bij wijzigingen |
Stages en regels voor productiemiddelen van ProductTrees | Processtappen en bewerkingstijden | B1 → SkyPlanner | Eerste import, daarna bij wijzigingen |
Resources (Machine, Labor, Other) | Werkcentra en personeel | B1 → SkyPlanner | Eerste import, zelden wijzigingen |
ResourceGroups | Werkcentrumgroepen | B1 → SkyPlanner | Eerste import |
ProductionOrders (Planned, Released) | Orders en taken | B1 → SkyPlanner | Webhook (FP 2602+) of polling om de paar minuten |
Stages van ProductionOrders | Taakstappen met volgorde | B1 → SkyPlanner | Samen met de order |
Voorraad van Items per Warehouses | Materiaalvoorraad | B1 → SkyPlanner | Periodiek, bijvoorbeeld elk uur |
Openstaande regels van PurchaseOrders (objecttype 22) met leverdatum | Inkooporders / inkomend materiaal met verwachte leverdatum | B1 → SkyPlanner | Periodiek, bijvoorbeeld elk uur |
Regels van PurchaseDeliveryNotes (Goods Receipt PO) met BaseType 22 | Ontvangen hoeveelheid op de inkooporderregel, bijgewerkte voorraad | B1 → SkyPlanner | Periodiek, bijvoorbeeld elk uur |
| Gepland begin en einde | PATCH ProductionOrders({DocEntry}): StartDate, DueDate, en op de regel voor het productiemiddel StartDate en EndDate | SkyPlanner → B1 | SkyPlanner-webhook bij wijziging van het productieschema |
| Geregistreerde hoeveelheden | InventoryGenEntries (Receipt from Production) | SkyPlanner → B1 | Bij bevestiging of in batches |
| Geregistreerde uren en materiaalverbruik | InventoryGenExits (Issue for Production) | SkyPlanner → B1 | Bij bevestiging of in batches |
Ploegenkalenders, personeel en afwezigheden worden in SkyPlanner beheerd. De dagelijkse capaciteitscijfers uit B1 worden niet uitgewisseld (zie de eerste valkuil hieronder).
Integratiepatronen
1. Eerste import van stamgegevens. Haal Resources, ResourceGroups en Items met Procurement Method Make op, samen met de bijbehorende ProductTrees inclusief fasen. Koppel elk productiemiddel dat een machine vertegenwoordigt aan een werkcentrum in SkyPlanner. Neem de lijst met de planners door voordat u voor het eerst orders synchroniseert.
2. Ordersynchronisatie. Lees ProductionOrders met de status Planned en Released uit en gebruik $expand voor regels en fasen. Productieorders in B1 bevatten fasen uit de bewerkingsvolgorde van de stuklijst. Planners kunnen een order na het aanmaken nog wijzigen. Gebruik daarom de fasen van de order, niet die van de stuklijst. Een productieorder maakt één product, dus voor een product met meerdere niveaus is per niveau één productieorder nodig. Koppel deze orders, zodat SkyPlanner de deelproducten vóór het bovenliggende product inplant.
Synchroniseer ook openstaande regels van PurchaseOrders, inclusief de openstaande hoeveelheid en leverdatum, naar de endpoints voor inkooporders van SkyPlanner. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder. In B1 wordt de voorraad bijgewerkt zodra een Goods Receipt PO (PurchaseDeliveryNotes) wordt geboekt. De integratie leest deze ontvangsten uit, markeert de ontvangen hoeveelheid als geleverd in SkyPlanner en laat het restant openstaan. Deelontvangsten worden één keer meegeteld. De materiaalcontrole houdt rekening met zowel de voorraad als de inkomende leveringen.
3. Productieschema terugschrijven. De webhooks van SkyPlanner worden geactiveerd wanneer het productieschema verandert. De integratie verstuurt PATCH /b1s/v1/ProductionOrders({DocEntry}) met de nieuwe StartDate en DueDate, en met StartDate en EndDate op de regels voor productiemiddelen van de order (ProductionOrderLines). Zo krijgt elke fase zijn geplande tijdvak. De body bevat alleen velden die SkyPlanner beheert. Meerdere orders worden in één $batch-verzoek verstuurd. B1-gebruikers zien de geplande datums vervolgens op de productieorder en in het venster Resource Capacity. Bij installaties zonder Service Layer voert een on-premises service dezelfde update uit via het DI API-object ProductionOrders (GetByKey, datums instellen, Update).
4. Terugmeldingen vanaf de werkvloer. Operators registreren hun werk in SkyPlanner met Mobile Confirmations of de Production Timer. Elke tijdregistratie wordt omgezet in een POST /b1s/v1/InventoryGenEntries voor de gereedgemelde hoeveelheid (Receipt from Production) en een POST /b1s/v1/InventoryGenExits voor componenten en de tijdsbesteding van productiemiddelen (Issue for Production).
Elke documentregel bevat BaseType 202 en BaseEntry met als waarde de DocEntry van de productieorder. Uitgifteregels bevatten daarnaast de BaseLine van de componentregel of de regel voor het productiemiddel. Deelhoeveelheden worden geboekt zodra ze worden geregistreerd. Bij artikelen die per batch of serienummer worden beheerd, worden de batch- en serienummers meegegeven. De order moet de status Released hebben.
De ID van de SkyPlanner-urenregistratie wordt opgeslagen in het B1-document. Daardoor wordt een opnieuw verwerkt event nooit dubbel geboekt. Een mislukte boeking wordt opnieuw geprobeerd en gemeld, niet overgeslagen.
5. Gegevensbeheer en conflictregels. Maak hierover afspraken voordat u gaat programmeren:
- B1 is leidend voor artikelen, stuklijsten, hoeveelheden, magazijnen en het aanmaken van orders.
- SkyPlanner is leidend voor de volgorde, start- en eindtijden en de toewijzing aan werkcentra.
- Als de datums van een order in beide systemen worden gewijzigd, is de volgende planningsrun van SkyPlanner leidend, tenzij de planners de taak in SkyPlanner hebben vergrendeld.
- Bij orders met de status Closed of Cancelled in B1 wordt de taak uit het schema verwijderd.
Wat het project omvat
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Daarvóór gebruikt u tijdens de gratis proefperiode van 30 dagen uw eigen gegevens. Exporteer artikelen, productiemiddelen en openstaande productieorders uit B1 naar CSV of Excel en laad ze met de gegevensimport van SkyPlanner. Zo zien planners een echt schema voordat er integratiecode wordt geschreven.
Een typisch SAP Business One-project omvat:
- Stamgegevens koppelen. Productiemiddelen en groepen productiemiddelen uit B1 worden gekoppeld aan werkcentra, bewerkingsfasen aan processtappen en artikelen van het type Make aan producten.
- Eerste gegevensimport. Artikelen, Product Trees met fasen en artikelregels, productiemiddelen en voorraad per magazijn.
- Productie- en inkooporders synchroniseren. Openstaande productieorders met regels en fasen, plus openstaande inkooporders met hun leverdatums.
- Productieschema terugschrijven. Geplande startdatums en uiterste opleverdatums naar
ProductionOrders. - Terugmeldingen van de werkvloer. Receipt and Issue for Production worden geboekt op basis van urenregistraties in SkyPlanner.
- Testen naast de huidige planning. Planners vergelijken het schema van SkyPlanner met hun huidige manier van plannen.
- Ingebruikname. Het schema van SkyPlanner wordt de leidende planning.
Goed opgeschoonde productiemiddelen en bewerkingsfasen in B1 beperken het werk aan de datamapping. Bij Laboratory & Allied was de integratie een van de eenvoudigste onderdelen van het project. Het interne IT-team realiseerde de integratie met SAP Business One op HANA grotendeels zelfstandig. Het SkyPlanner-team hielp bij de complexste gevallen, zoals producten die in processen met meerdere stappen worden samengevoegd.
Valkuilen bij SAP Business One
Dagcapaciteit is geen ploegenmodel.
B1 slaat Daily Internal Capacity en Single Run Capacity per productiemiddel per dag op (“These capacities are defined on a daily basis,” (deze capaciteiten worden per dag vastgelegd), aldus SAP Learning). Volgens de SAP-handleiding gaat de berekening van Required Days ervan uit dat “a single production order can be produced on a single machine” (één productieorder op één machine kan worden geproduceerd) (SAP-handleiding). Neem die cijfers niet over als beschikbare machine- en personeelscapaciteit voor de capaciteitsplanning. Leg ploegen, personeel en de efficiëntie van werkcentra vast in SkyPlanner.
De bewerkingsvolgorde ligt vast in de stuklijst.
Er zijn geen aparte stamgegevens voor de bewerkingsvolgorde. De Route Stage-regels in de Product Tree bepalen de volgorde en Waiting Days worden handmatig ingevoerd. Lees de Stages van ProductTrees en ProductionOrders uit en controleer of elke regel voor een productiemiddel aan een fase is gekoppeld. Orders zonder fasen geven de planningssoftware geen bewerkingsvolgorde.
Hoeveelheden op regels voor productiemiddelen moeten worden omgerekend.
Quantity op een stuklijstregel is de hoeveelheid die nodig is om de hoeveelheid in de stuklijstkop te produceren, niet één eenheid. Additional Quantity wordt aan de geplande tijd toegevoegd “regardless of the quantity of the parent item produced” (ongeacht de geproduceerde hoeveelheid van het bovenliggende artikel) (SAP-handleiding). Behandel dit als vaste tijd per order, zoals insteltijd. Deel door de hoeveelheid in de stuklijstkop voordat u de bewerkingstijd per eenheid berekent. Anders wijkt de tijd voor elke taak met een factor af.
Stamgegevens van productiemiddelen zijn zelden goed opgeschoond.
Productiemiddelen hebben het type Machine, Labor of Other. Machines kunnen aan vaste activa worden gekoppeld en arbeid aan medewerkers. Een productiemiddel kan ook gekoppeld zijn aan een niet-voorraadartikel voor de inkoop of verkoop ervan. Dat zegt echter niets over welke productiemiddelen echte, inplanbare machines zijn. Schoon de groepen en dubbele productiemiddelen op voordat u ze omzet in uw lijst met werkcentra.
Terugmeldingen mislukken door voorraadregels.
Ontvangsten en uitgiften zijn voorraaddocumenten. Veelvoorkomende fouten zijn het verwisselen van InventoryGenEntries en InventoryGenExits, ontbrekende batch- of serienummers bij artikelen die daarmee worden beheerd, en boekingen op een order met de status Planned.
Sessies en paginering.
Een verlopen sessie geeft de melding “Invalid session or session already timeout.” (ongeldige sessie of sessie al verlopen). Meld u bij deze fout opnieuw aan. Door de standaardpaginagrootte van 20 records worden synchronisaties die odata.nextLink negeren ongemerkt afgekapt.
UpdateDate bevat geen tijdstip.
In tabel OWOR is UpdateDate een datumveld. Het tijdstip van de wijziging staat apart in UpdateTS. Polling die alleen op UpdateDate filtert, haalt bij elke uitvoering alle orders op die vandaag zijn gewijzigd. Combineer beide velden of verwijder dubbele resultaten aan uw kant.
Webhooks worden ten minste één keer afgeleverd.
De Webhook Messenger probeert een mislukte aflevering maximaal vijf keer opnieuw (2, 4, 8, 16 en 32 seconden) en markeert deze daarna als mislukt. Herhaalde pogingen kunnen duplicaten opleveren. De volgorde is alleen binnen één bedrijf gegarandeerd. Maak handlers idempotent op basis van de event-ID en blijf elke nacht de gegevens via polling controleren en vergelijken.
Wie richt de SAP Business One-integratie in?
Het werk omvat het koppelen van uw bewerkingsfasen, productiemiddelen en B1-inrichting, en het vastleggen van beperkingen waarmee B1 niet plant: een matrix met insteltijden, gereedschappen, aantallen operators en alternatieve productiemiddelen.
- Het SkyPlanner-team configureert de integratie tijdens de onboarding en biedt ondersteuning na de ingebruikname. Elk bedrijf gebruikt B1 anders. Die kennis wordt hier in de inrichting verwerkt. Dit is de standaardaanpak.
- Uw SAP Business One-partner kan meewerken. Partners die uw bedrijfsdatabase, add-ons en gebruikersvelden kennen, kunnen de koppeling bouwen met Service Layer en de REST API van SkyPlanner (API-documentatie).
- Uw eigen ontwikkelaars kunnen de koppeling bouwen. De REST API van SkyPlanner leest en schrijft orders, producten, materialen, processtappen, inkooporders en urenregistraties. De API gebruikt authenticatie met JWT bearer tokens en is gedocumenteerd in Swagger/OpenAPI. De documentatie is openbaar beschikbaar in de SkyPlanner-documentatie. Webhooks geven wijzigingen in het schema en de status in realtime door. Om te beginnen met bouwen hebt u alleen een SkyPlanner API-sleutel nodig (integratiehandleiding). Het SkyPlanner-team helpt waar nodig. Het interne IT-team van Laboratory & Allied koos deze aanpak.
Valideer het schema eerst tijdens de gratis proefperiode van 30 dagen. Zo begint de integratie met een schema dat al bij uw fabriek past.
Waarom technische teams SkyPlanner kiezen voor B1
- Kies SkyPlanner als u een kleine, duidelijk afgebakende integratie wilt. Standaard B1-objecten worden ingelezen (productieorders, Product Trees, Resources, Items); datums en Issue and Receipt from Production worden teruggeschreven. De productiemodule van B1 blijft ongewijzigd en er is geen datamigratie nodig.
- Kies SkyPlanner als het project zich al vroeg moet bewijzen. Tijdens de gratis proefperiode van 30 dagen werkt u met een CSV-export en maximaal 20 werkcentra, zonder creditcard. Uw bedrijf ziet het eigen schema voordat de integratie begint.
- Kies SkyPlanner als het schema rekening moet houden met de werkelijke beperkingen. Omsteltijden, gedeelde gereedschappen, taken met meerdere operators, alternatieve productiemiddelen, voorraad en openstaande inkooporders worden allemaal in SkyPlanner gemodelleerd. De integratie levert alleen de B1-gegevens aan.
- Kies SkyPlanner als u één systeem wilt voor planners en operators. De Arcturus-engine stelt het schema in enkele seconden op. Autopilot plant automatisch opnieuw wanneer de productie verandert. Operators registreren hun werk op een telefoon of tablet en uw integratie schrijft die terugmeldingen naar B1.
- Kies SkyPlanner als de kosten voorspelbaar moeten zijn. De prijzen beginnen bij 199 € per maand, inclusief 5 werkcentra. U betaalt maandelijks en kunt op elk moment opzeggen. Samen met uw abonnement ontvangt u vooraf een offerte voor de integratie, afgestemd op uw proces en behoeften. Zo kent u alle kosten voordat u begint.
Lees de uitleg over capaciteitsplanning met SAP Business One om te zien waar de standaardplanning tekortschiet. Bekijk het overzicht van ERP-integraties voor andere ERP-systemen.
Ervaringen van productiebedrijven met SkyPlanner
+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.
2 hbespaard per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning kost elke week 2 uur minder werktijd. Een nieuwe werklijst is binnen enkele seconden beschikbaar aan de productielijn.
6 maandenvooruit inzicht in vrije capaciteit voor verkoop
“SkyPlanner legt een betrouwbare basis voor de volledige productieplanning.”
Anu Järvinen, productiemanager
Fredman Operations · Voedselveilig verpakkingspapier
De verkoopafdeling ziet zes maanden vooruit hoeveel capaciteit er vrij is. Verzoeken om de planning aan te passen worden binnen enkele seconden beantwoord, waar dat eerder een uur of langer duurde.
99,2%leverbetrouwbaarheid
“Met SkyPlanner kunnen we knelpunten beter herkennen en is de productieaansturing overzichtelijker geworden.”
Toni Tuori, productiemanager
Piristeel · Dakveiligheid en hemelwaterafvoersystemen
De leverbetrouwbaarheid bereikte dit jaar 99,2%. Het opstellen van het productieschema bespaart tot vier uur werktijd per dag.
Veelgestelde vragen
Wie bouwt de integratie met SAP Business One?
Het SkyPlanner-team configureert de tweerichtingsintegratie tijdens de onboarding en biedt na de ingebruikname ondersteuning. Productieorders, bewerkingsstappen, productiemiddelen, inkooporders en goederenontvangsten worden ingelezen. Geplande datums en Issue and Receipt from Production worden teruggestuurd. Uw B1-partner of uw eigen ontwikkelaars kunnen de integratie ook bouwen met Service Layer en de REST API van SkyPlanner. Een API-sleutel is genoeg om te beginnen.
Hoelang duurt de implementatie van SkyPlanner met SAP Business One?
De implementatie is normaal gesproken binnen enkele weken na de start van de onboarding afgerond. Het team stelt de mapping voor productiemiddelen en bewerkingsfasen in, koppelt productie- en inkooporders en toetst het productieschema vóór de ingebruikname aan uw huidige planning.
Service Layer of DI API?
Kies Service Layer voor nieuwe integraties. Deze is gebaseerd op HTTP, draait op HANA en SQL Server en is geschikt voor planningssoftware in de cloud. Gebruik DI API alleen als bestaande middleware er al van afhankelijk is.
Heb ik SAP Business One 10.0 FP 2602 nodig?
Alleen voor webhooks. Bij eerdere versies van 10.0 verloopt de integratie via periodieke polling.
Hoe worden geplande datums teruggeschreven naar SAP Business One?
Via PATCH /b1s/v1/ProductionOrders({DocEntry}), geactiveerd door de SkyPlanner-webhook voor wijzigingen in het productieschema. Daarbij worden StartDate en DueDate op de order ingesteld en StartDate en EndDate op de bijbehorende regels voor productiemiddelen. Geproduceerde hoeveelheden en bestede tijd worden teruggeschreven als InventoryGenEntries en InventoryGenExits, gekoppeld aan de order met BaseType 202 en BaseEntry.
Hebben we een productie-add-on nodig in B1?
Nee. De integratie gebruikt alleen standaardobjecten van B1: productieorders, Product Trees, Resources, Items, inkooporders en voorraaddocumenten. Er worden geen gegevens overgezet naar een nieuw datamodel voor productie.
Kunnen we SkyPlanner vóór de integratie testen met onze B1-gegevens?
Ja. Tijdens de proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en gegevens importeren via CSV of Excel. U hebt geen creditcard nodig. Start de gratis proefperiode of bespreek uw B1-inrichting met ons verkoopteam.
