Integraties / ERP / SYSPRO
SYSPRO-integratiegids voor productieschema’s met SkyPlanner APS
Deze integratiegids voor SYSPRO laat partners en IT-teams zien hoe ze SYSPRO 8 aan SkyPlanner APS koppelen. SkyPlanner wisselt gegevens in beide richtingen uit met SYSPRO via de eigen interfaces van SYSPRO:
- Taken, taakbewerkingen, Structures and Routings, werkcentra, machines, Stock Codes, voorraad en inkooporders worden ingelezen.
- Geplande start- en einddatums worden teruggeschreven naar de taken.
- Als u daarvoor kiest, kunnen tijdregistraties van operators als arbeidsuren worden teruggeschreven.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Tijdens de onboarding stemt het SkyPlanner-team de integratie af op uw SYSPRO-inrichting. Ook na de ingebruikname blijft het team de integratie ondersteunen. Deze gids is bedoeld voor partners en ontwikkelaars die willen meewerken of zelf verder willen bouwen op de gedocumenteerde REST API van SkyPlanner (API-referentie).
Integratie-interfaces van SYSPRO
SYSPRO biedt externe planningssoftware twee routes voor gegevensuitwisseling:
- e.net Solutions Business Objects. Hiermee roept u de bedrijfslogica van SYSPRO van buitenaf aan, met XML als invoer en uitvoer. Er zijn drie categorieën: Query (bijvoorbeeld WIPQBL, WIP Balance Query), Transaction of Post (bijvoorbeeld WIPTJB, WIP Job Creation and Maintenance) en Setup voor stamgegevens. Business objects voeren dezelfde validaties uit als de SYSPRO-schermen en blijven compatibel tussen releases. De bestpracticegids van SYSPRO is duidelijk: “SYSPRO’s Business Objects are used to query and post data to SYSPRO.” (De Business Objects van SYSPRO worden gebruikt om gegevens uit SYSPRO op te vragen en naar SYSPRO te schrijven.)
- SYSPRO OData Service (OData v4). Biedt alleen-lezen toegang via REST tot de bedrijfs- en systeemdatabases en tot Business Activity Queries: SQL-views die in SYSPRO zijn gedefinieerd. Deze service is beschikbaar vanaf SYSPRO 8 2021 R2. Voor SYSPRO Cloud ERP geldt: “Syspro OData is the only mechanism available when applications need access to SYSPRO data.” (Syspro OData is het enige beschikbare mechanisme waarmee applicaties toegang krijgen tot SYSPRO-gegevens.)
Business objects worden aangeroepen via de e.net Communications-service, met behulp van de SYSPRO WCF Service of SYSPRO Web Service.
Master Data Take On (IMPIMP) importeert spreadsheets via Setup-business objects. Dat is handig om eenmalig stamgegevens in te laden. SYSPRO Harmony bereikt op 31 december 2026 het einde van zijn levensduur. Bouw er dus niets nieuws meer op.
Authenticatie en licenties
- Aanmelden via e.net. De integratie meldt zich bij een bedrijf aan als SYSPRO Operator en ontvangt een sessie-GUID voor volgende aanroepen.
- Licenties. Uw SYSPRO-licentie moet de functionele gebieden dekken van de business objects die de operator aanroept.
- OData. De toegang verloopt via HTTPS met operators die voor OData zijn geconfigureerd.
Aan de SkyPlanner-kant gebruikt de REST API een API-token voor authenticatie (SkyPlanner Settings > API). De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding leidt u door de eerste aanroepen.
Events en polling
SYSPRO verstuurt geen uitgaande webhooks. Electronic Signature Transaction Setup kan na een geslaagde transactie triggers activeren, zoals een e-mail of een VBScript. Maar SYSPRO stelt: “It is not intended that triggers from e.net Business Objects fire VBScript triggers.” (Het is niet de bedoeling dat triggers vanuit e.net Business Objects VBScript-triggers activeren.)
Daarom worden gegevens aan de SYSPRO-kant via polling opgehaald. Query’s op business objects of OData-verzoeken, gefilterd op openstaande taken en recente wijzigingen, halen nieuw werk op. De frequentie wordt per fabriek ingesteld: van elke paar minuten voor taken tot elk uur voor voorraad.
SkyPlanner verstuurt webhooks wanneer de status of het productieschema verandert. Het terugschrijven is dus eventgestuurd.
Gegevensmapping
| SYSPRO-object (interface) | Object in SkyPlanner | Richting | Frequentie |
|---|---|---|---|
| Stock Codes, maateenheden (OData of Query-business objects) | Producten en materialen | SYSPRO → SkyPlanner | Eerste gegevensimport, daarna polling |
| Structures (componenten, fictieve artikelen, coproducten) | Productstructuur, deelproducten, materialen per product | SYSPRO → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Routings: werkcentrum, instel-, bewerkings-, wacht- en transporttijd, Maximum units | Processtappen met tijdsduur, instel- en afbouwtijden | SYSPRO → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Work Centers (productie-eenheden, capaciteit) en Machines | Werkcentra, werkcentrumgroepen, efficiëntiewaarden | SYSPRO → SkyPlanner | Eerste gegevensimport, daarna zelden |
| Capacity Calendar, Shift Patterns | Ploegendiensten en niet-werkdagen | SYSPRO → SkyPlanner | Dagelijks, of ploegendiensten in SkyPlanner beheren |
| Taken en subtaken (WipMaster), taakbewerkingen, taakmaterialen | Orders en taken met einddatums en materiaalbehoeften | SYSPRO → SkyPlanner | Polling om de paar minuten |
| Aanwezige magazijnvoorraad per Stock Code | Voorraadsaldi | SYSPRO → SkyPlanner | Polling, elk uur of bij het berekenen van het productieschema |
| Inkooporders met leverdatums | Inkooporders, binnenkomende materialen per leverdatum | SYSPRO → SkyPlanner | Polling, elk uur of bij het berekenen van het productieschema |
| Geplande start- en einddatums van taken (WIPTJB, WIP Job Creation and Maintenance) | Geplande start- en eindtijd per taak | SkyPlanner → SYSPRO | Bij wijzigingen in het productieschema, via een SkyPlanner-webhook |
| Labor Posting: instel- en bewerkingstijd per taakbewerking, machine en medewerker | Tijdregistraties en terugmeldingen van operators | SkyPlanner → SYSPRO | Per terugmelding of per ploegendienst, indien gewenst |
| Job Receipts (business object WIP Job Receipts) | Gereedgemelde aantallen | SkyPlanner → SYSPRO | Per terugmelding, indien gewenst |
| Niet in SYSPRO | Omsteltijdenmatrix, gereedschappen met beperkte beschikbaarheid, alternatieve machines en medewerkers | Beheerd in SkyPlanner | Ingericht tijdens de onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Lees Stock Codes, Structures and Routings, werkcentra, machines en kalenders in via OData of Query-business objects. Maak een bewuste keuze bij het koppelen van werkcentra aan SkyPlanner: een werkcentrum met vier machines wordt één werkcentrumgroep of vier werkcentra.
2. Taken synchroniseren. Lees bestaande taken 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 wanneer de inkooporder de status Delivered krijgt.
Plan alleen bestaande taken in. Voorgestelde taken blijven in de MRP-snapshot totdat MRP Job Review ze omzet in taken.
3. Productieschema terugschrijven. Wanneer de engine een taak inplant of verplaatst, activeert een SkyPlanner-webhook een schrijfactie naar het business object WIP Job Creation and Maintenance (WIPTJB). Daarmee worden de geplande start- en einddatums van de taak vastgelegd. Het business object valideert de wijziging op precies dezelfde manier als Job Entry.
4. Terugmeldingen van de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Die tijdregistraties houden het productieschema actueel. U kiest of de werkelijke tijden worden teruggeschreven naar SYSPRO. Zo ja, dan gaan de instel- en bewerkingstijd per taakbewerking naar Labor Posting en de gereedgemelde aantallen naar Job Receipts. Zo nee, dan worden de arbeidsuren zoals voorheen in SYSPRO ingevoerd.
5. Gegevenseigenaarschap en conflictregels. Leg deze vóór de ingebruikname vast:
| Gegevens | Eigenaar |
|---|---|
| Stock Codes, Structures and Routings, aantallen, taakstatus | SYSPRO |
| Bewerkingsvolgorde, start- en eindtijden, machinetoewijzing | SkyPlanner |
| Omsteltijdenmatrix, vereisten voor gereedschappen en operators, alternatieve resources | SkyPlanner |
| Ploegendiensten en niet-werkdagen | Eén systeem, gekozen tijdens de scopebepaling |
| Arbeidsuren, materiaaluitgiften en ontvangsten | SYSPRO, met rechtstreekse invoer of boekingen vanuit tijdregistraties in SkyPlanner |
Laat slechts één systeem de taakdatums schrijven. SkyPlanner heeft geen planningsmodule van SYSPRO nodig en neemt het schrijven van geplande datums dus over van Factory Scheduling, Visual APS of APS (Nexsys). Werkt een van die modules de geplande datums nog bij? Schakel dat dan uit voor taken die SkyPlanner inplant. In Factory Scheduling heet de optie in Job Entry “Update planned dates to scheduled dates.” (Werk de geplande datums bij naar de ingeroosterde datums.)
Gebruikelijke projectstappen
De implementatie is normaal gesproken binnen enkele weken na de start van de onboarding afgerond. Valideer het productieschema vooraf tijdens de gratis proefperiode van 30 dagen, met werkcentra, bewerkingsvolgorden en openstaande taken die u vanuit SYSPRO als CSV of Excel exporteert.
- Mapping. Leg de mappingtabel, verantwoordelijkheden en synchronisatiefrequenties vast. Bepaal ook of arbeidsuren worden teruggeschreven.
- Toegang tot SYSPRO. Maak de operator voor de integratie aan, controleer de licenties voor business objects en schakel OData in waar u het gebruikt. Test eerst in een kopie van de bedrijfsadministratie.
- Eerste gegevensimport. Stock Codes, Structures and Routings, werkcentra, machines en kalenders.
- Taken en inkooporders synchroniseren. Polling met filters, paginering en herhaalpogingen.
- Randvoorwaarden instellen in SkyPlanner. Omsteltijdenmatrix, gereedschappen, aantal operators per taak en alternatieve machines of medewerkers.
- Productieschema terugschrijven. Boekingen via WIPTJB op basis van SkyPlanner-webhooks, plus boeking van arbeidsuren als u daarvoor kiest.
- Parallel testen. Laat SkyPlanner naast het huidige plan draaien, vergelijk datums en corrigeer stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten voor een SYSPRO-integratie
- _TMP-taken. Proefberekeningen met beperkte capaciteit in Job Entry kunnen _TMP-taken aanmaken in WipMaster. Filter deze bij elke leesactie uit.
- Gestarte bewerkingen. Forward Finite Scheduling geeft fouten bij gestarte bewerkingen die niet passen. Lees vóór elke berekening de voortgang van de bewerkingen in SkyPlanner in, zodat het productieschema uitgaat van het werk dat al is gedaan. Running Time Lock zet vervolgens de taken voor de komende uren vast.
- Tijdseenheden in de bewerkingsvolgorde. Instel-, bewerkings-, wacht- en transporttijd vereisen elk de juiste eenheid en berekeningsbasis. Wacht- en transporttijd zijn wachttijden, geen machinetijd. Reken ze bij de import om, anders klopt geen enkele tijdsduur.
- Uitbestede bewerkingen. Offsite Days en Dock to Stock Days geven doorlooptijd aan, geen beslag op uw capaciteit. Modelleer ze als stappen die alleen tijd kosten.
Wie configureert en ondersteunt de SYSPRO-integratie?
- Het SkyPlanner-team configureert de integratie tijdens de onboarding en biedt ondersteuning na de ingebruikname, voor de afgesproken business objects en OData-query’s. Elke fabriek gebruikt SYSPRO anders. Die praktijkkennis komt hier van pas.
- Uw SYSPRO-partner kan meewerken. Uw partner kent uw inrichting, aangepaste formulieren en licenties en kan samen met het SkyPlanner-team de operator en de OData-toegang instellen.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen via de REST API van SkyPlanner, met een API-token. Een API-token volstaat om te beginnen. Het SkyPlanner-team helpt waar nodig. Zie de SkyPlanner-integratiedocumentatie voor de technische uitleg.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturatie. U ontvangt vooraf een offerte voor de integratie, afgestemd op uw proces en behoeften, samen met uw abonnement. Bekijk de prijzen, capaciteitsplanning voor SYSPRO, de SYSPRO-pagina en het overzicht van ERP-integraties.
Ervaringen van maakbedrijven met SkyPlanner
2 hbespaard per week
“Dankzij SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd. Een nieuwe werklijst staat binnen enkele seconden op de productielijn.
+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 geoptimaliseerd plan voor drie maanden, voor alle werkcentra, is in minder dan 30 minuten klaar.
98%leverbetrouwbaarheid, gestegen van circa 50%
“SkyPlanner speelt een doorslaggevende rol bij het op peil houden van onze leverbetrouwbaarheid.”
Hannu Lahtinen, algemeen directeur
KJH-Comp · Plaatbewerking en productie in opdracht
De leverbetrouwbaarheid steeg van circa 50% tot wel 98%. Voor het opstellen van het productieschema is nu één leidinggevende nodig in plaats van twee.
99,2%leverbetrouwbaarheid
“SkyPlanner heeft knelpunten zichtbaar gemaakt en meer overzicht gebracht in de productieaansturing.”
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
Heeft SYSPRO een API voor taken?
Ja. Met e.net Solutions Business Objects kunt u SYSPRO-gegevens opvragen en schrijven, onder meer via WIPTJB voor het aanmaken en onderhouden van taken. De SYSPRO OData-service biedt daarnaast alleen-lezen-toegang via REST tot tabellen en Business Activity Queries.
Ondersteunt SYSPRO webhooks?
Geen uitgaande webhooks. Triggers in Electronic Signature Transaction Setup zijn niet bedoeld om te worden geactiveerd door aanroepen van business objects. Daarom vraagt de integratie SYSPRO periodiek uit, met een interval dat per fabriek wordt ingesteld. De eigen webhooks van SkyPlanner sturen wijzigingen in het productieschema door zodra ze plaatsvinden.
Hoe worden geplande datums teruggeschreven naar SYSPRO?
Via het business object WIP Job Creation and Maintenance (WIPTJB), dat de geplande start- en einddatum van de taak vastlegt. SYSPRO valideert de schrijfactie met dezelfde regels als in Job Entry.
Werkt de integratie met SYSPRO Cloud ERP?
Ja. SkyPlanner leest gegevens uit Cloud ERP via de SYSPRO OData-service. Volgens SYSPRO is dat daar de enige manier om toegang tot gegevens te krijgen. Tijdens de scopebepaling richt het SkyPlanner-team samen met u en uw SYSPRO-partner de route voor het terugschrijven in.
Kan een SYSPRO-partner beter SYSPRO MOM Visual APS of SkyPlanner voorstellen?
SkyPlanner, als de klant binnen enkele weken een werkend productieschema wil dat rekening houdt met de beschikbare capaciteit. Visual APS maakt deel uit van de SYSPRO MOM-suite, heeft een eigen licentie en wordt geïnstalleerd met een koppeling aan de SYSPRO SQL Server. Voor gebruikers van MOM Workbench zijn licenties per gebruiker nodig (SYSPRO-help). SkyPlanner maakt verbinding via e.net Business Objects en OData, plant automatisch opnieuw en plant omstellingen, gereedschappen, ploegen en materiaal. SkyPlanner is beschikbaar vanaf 199 € per maand, met een onbeperkt aantal gebruikers.
Kunnen we SkyPlanner testen voordat we de integratie bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en gegevens uit SYSPRO importeren via CSV of Excel. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales voor de scopebepaling van de integratie.
