Koppelingen / ERP / APplus
Handleiding voor de APplus koppeling voor productieplanning met SkyPlanner APS
Deze handleiding laat APplus-partners en IT-teams zien hoe ze APplus aan SkyPlanner APS koppelen. SkyPlanner wisselt gegevens in beide richtingen uit met APplus via de eigen interfaces van Asseco:
- SkyPlanner ontvangt productieorders (Fertigungsaufträge) met hun bewerkingen (Arbeitsgänge), bewerkingsroutes (Arbeitspläne), stuklijsten (Stücklisten), capaciteitseenheden (Kapazitätsstellen en Kapazitätseinheiten), gereedschappen (Betriebsmittel), voorraadgegevens en inkooporders.
- De geplande start, het geplande einde en de capaciteitseenheid worden per bewerking teruggeschreven naar de productieorder.
- Als u daarvoor kiest, kunnen tijdregistraties van operators als BDE-berichten worden teruggeschreven naar de order.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Tijdens de onboarding stemt het SkyPlanner-team de koppeling af op uw APplus-inrichting. Ook na ingebruikname blijft het team de koppeling ondersteunen. Deze handleiding is bedoeld voor partners en ontwikkelaars die willen meewerken of zelf verder willen bouwen op de gedocumenteerde REST API van SkyPlanner (API-referentie).
Interfaces voor de APplus koppeling
APplus biedt de volgende mogelijkheden om externe planningssoftware te koppelen:
- APplus-webservices. APplus is gebouwd op een webservicearchitectuur. Volgens Asseco zijn alle benodigde planningsfuncties rechtstreeks via internet toegankelijk en kunnen de IT-systemen van klanten en leveranciers ze gebruiken (Asseco). Dit is de belangrijkste route om productiegegevens uit te lezen en geplande datums terug te schrijven.
- Business Integration Framework. Sinds APplus 6.3 koppelt dit framework externe systemen zonder programmeerwerk, via aanpasbare datastructuren (Asseco). Gebruik het om APplus-objecten te mappen op de REST API van SkyPlanner.
- Universal Cloud Connector. Toegevoegd in APplus 7.1 om partneroplossingen en SaaS-diensten aan APplus te koppelen, met een hoog beveiligingsniveau voor de overgedragen gegevens (Asseco).
In APplus 10 start Flow Mode processen op vastgelegde tijdstippen of bij bepaalde gebeurtenissen, zonder handmatige stappen (Asseco). Tijdens de scopebepaling bij de onboarding wordt per object vastgelegd welke route wordt gebruikt.
Authenticatie en toegang
- In APplus. De koppeling werkt met een eigen technische gebruiker in APplus. De rechten zijn beperkt tot de objecten die de koppeling leest en schrijft. Uw APplus-partner maakt de gebruiker aan en stelt de toegang tot de webservices in.
- Netwerk. APplus draait lokaal of als gehoste versie (Feiten over APplus). De koppeling maakt verbinding via de route die uw IT-team of hostingprovider toestaat.
- In SkyPlanner. De REST API gebruikt voor authenticatie een API-token in de
Authorization-Token-header. U maakt dit token aan onder Settings > API. De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding begeleidt u bij de eerste API-aanroepen.
Events en polling
Aan de APplus-kant vraagt de koppeling via polling openstaande productieorders en recente wijzigingen op bij de webservices, of stuurt het Business Integration Framework wijzigingen naar SkyPlanner. De frequentie wordt per fabriek ingesteld: van om de paar minuten voor orders tot elk uur voor voorraadgegevens.
SkyPlanner verstuurt webhooks wanneer de status of de planning verandert. Het terugschrijven gebeurt dus op basis van events.
Datamapping
| APplus-object | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
| Artikelen (Artikel), eenheden | Producten en materialen | APplus → SkyPlanner | Eerste import, daarna polling |
| Stuklijsten (Stücklisten, Strukturstücklisten) | Productstructuur, deelproducten, materialen per product | APplus → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Bewerkingsroutes (Arbeitspläne) met bewerkingen, instel- en bewerkingstijden | Processtappen met tijdsduur, instel- en afbouwtijden | APplus → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Capaciteitsplaatsen en capaciteitseenheden (Kapazitätsstellen, Kapazitätseinheiten) | Werkcentrumgroepen en werkcentra, efficiëntiewaarden | APplus → SkyPlanner | Eerste import, daarna zelden |
| Personeelscapaciteit | Personeel met dienstroosters | APplus → SkyPlanner | Dagelijks, of eigen dienstroosters in SkyPlanner |
| Gereedschappen en opspanmiddelen (Betriebsmittel) | Gereedschappen als gedeelde middelen met beperkte beschikbaarheid | APplus → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Productieorders (Fertigungsaufträge) met bewerkingen en materiaal | Orders en taken met uiterste datums en materiaalbehoeften | APplus → SkyPlanner | Polling om de paar minuten |
| Fysieke voorraad | Voorraadstanden | APplus → SkyPlanner | Polling, elk uur of bij een planningsrun |
| Inkooporders (Bestellungen) met leverdatums | Inkooporders, inkomend materiaal per leverdatum | APplus → SkyPlanner | Polling, elk uur of bij een planningsrun |
| Geplande start, gepland einde en capaciteitseenheid per bewerking van de productieorder | Ingeplande start- en eindtijd per taak | SkyPlanner → APplus | Bij een planningswijziging, via een SkyPlanner-webhook |
| BDE-berichten: tijd en hoeveelheid per bewerking, medewerker | Tijdregistraties en terugmeldingen van operators | SkyPlanner → APplus | Per terugmelding of per dienst, indien gekozen |
| Niet in APplus | Omsteltijdenmatrix, aantal operators per taak, alternatieve machines en personeelsleden | Beheerd in SkyPlanner | Ingesteld tijdens de onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Lees artikelen, stuklijsten, bewerkingsroutes, capaciteitsplaatsen en capaciteitseenheden, Betriebsmittel en personeelscapaciteit uit via de APplus-webservices. Maak bewuste keuzes bij de mapping: een Kapazitätsstelle met vier Kapazitätseinheiten wordt één werkcentrumgroep met vier werkcentra.
2. Ordersynchronisatie. Lees productieorders met hun bewerkingen en materiaal 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. Inkoopvoorstellen blijven in APplus Disposition totdat ze orders worden.
3. Planning terugschrijven. Wanneer de planningsengine een bewerking inplant of verplaatst, activeert een SkyPlanner-webhook de update in APplus via de route die bij de scopebepaling is afgesproken (webservices of het Business Integration Framework). De geplande start, het geplande einde en de capaciteitseenheid van die bewerking worden op de productieorder vastgelegd. Zo toont het planbord in APplus de volgorde uit SkyPlanner.
4. Werkorders vrijgeven. De planner blijft werkorders (Werkstattaufträge) vrijgeven in APplus, nu met de datums uit SkyPlanner. Bij de volgende synchronisatie worden vrijgegeven orders en hun status weer ingelezen in SkyPlanner.
5. Terugmeldingen van de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Deze tijdregistraties houden de planning actueel. U kiest zelf of de werkelijke tijden worden teruggeschreven. Zo ja, dan worden tijd en hoeveelheid per bewerking als BDE-berichten op de order geboekt. Blijft BDE met barcodes in gebruik, dan leest SkyPlanner de berichten juist uit APplus.
6. Gegevenseigenaarschap en conflictregels. Leg deze vóór ingebruikname vast:
| Gegevens | Eigenaar |
|---|---|
| Artikelen, stuklijsten, bewerkingsroutes, hoeveelheden, orderstatus, vrijgave van werkorders | APplus |
| Bewerkingsvolgorde, start- en eindtijden, toewijzing van capaciteitseenheden | SkyPlanner |
| Omsteltijdenmatrix, aantallen operators, alternatieve middelen | SkyPlanner |
| Stamgegevens van Betriebsmittel | APplus; beschikbaarheid in de tijd gepland in SkyPlanner |
| Dienstroosters en vrije dagen | Eén systeem, gekozen bij de scopebepaling |
| BDE-berichten, materiaaluitgiften en -ontvangsten | APplus, daar ingevoerd of geboekt vanuit tijdregistraties in SkyPlanner |
Laat slechts één systeem de bewerkingsdatums schrijven. Als de PPS-planning actief is, of Feinplanung of APplus APS datums schrijft, schakel die functie dan uit voor de orders die SkyPlanner inplant.
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 capaciteitseenheden, bewerkingsroutes en openstaande productieorders die u vanuit APplus als CSV of Excel exporteert.
- Mapping. Leg de mappingtabel, de regels voor gegevenseigenaarschap en de synchronisatiefrequenties vast. Bepaal ook of BDE-berichten worden teruggeschreven.
- Toegang tot APplus. Maak de technische gebruiker aan, schakel samen met uw APplus-partner de webservices in en test eerst in een testsysteem.
- Eerste import. Artikelen, stuklijsten, bewerkingsroutes, capaciteitsplaatsen en capaciteitseenheden, Betriebsmittel, personeel.
- Orders en inkooporders synchroniseren. Via polling met filters, paginering en herhaalde pogingen, of via pushberichten vanuit het Business Integration Framework.
- Randvoorwaarden instellen in SkyPlanner. Een omsteltijdenmatrix, gereedschappen, het aantal operators per taak en alternatieve machines of medewerkers.
- De planning terugschrijven. Geplande datums per bewerking via SkyPlanner-webhooks, aangevuld met BDE-berichten als u daarvoor kiest.
- Parallel testen. Gebruik SkyPlanner naast het huidige planbord, vergelijk de datums en corrigeer de stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten voor een APplus-koppeling
- Beperkte en onbeperkte capaciteit. In APplus kunnen sommige capaciteitseenheden met onbeperkte capaciteit worden gepland. In SkyPlanner heeft elk werkcentrum een beperkte capaciteit. Controleer daarom bij het importeren voor elk werkcentrum de ploegendiensten en efficiëntie.
- Actieve planningslagen. Controleer of er een licentie voor Feinplanung of APplus APS is en of de module in gebruik is. Leg vast dat slechts één systeem datums wegschrijft.
- Werkbonnen en barcodes. BDE-berichten worden geregistreerd op orders waarvoor werkbonnen zijn afgedrukt. Spreek af of vrijgave en afdrukken net als nu in APplus blijven plaatsvinden.
- Eenheden voor instel- en bewerkingstijden. Reken instel- en bewerkingstijden bij het importeren om met de juiste eenheid en berekeningsbasis. Anders klopt geen enkele tijdsduur.
- Externe bewerkingen. Uitbestede bewerkingen kosten doorlooptijd, maar belasten uw eigen capaciteit niet. Modelleer ze als stappen met alleen een tijdsduur.
- Gehoste installaties. Spreek bij de gehoste versie vroegtijdig met de hostingprovider af hoe de webservices via het netwerk bereikbaar worden.
Wie configureert en ondersteunt de APplus-koppeling?
- Het SkyPlanner-team configureert de koppeling tijdens de onboarding en ondersteunt deze na ingebruikname. Dit omvat de afgesproken webservices en veldtoewijzingen. Elke fabriek gebruikt APplus anders; die praktijkkennis wordt in de koppeling verwerkt.
- Uw APplus-partner kan meewerken. De partner kent uw maatwerkaanpassingen, gebruikersrechten en inrichting van het Business Integration Framework en kan samen met het SkyPlanner-team de toegang regelen.
- Uw eigen ontwikkelaars kunnen de koppeling verder uitbouwen via de REST API van SkyPlanner met een API-token. Een API-token volstaat om te beginnen en het SkyPlanner-team helpt waar nodig. De documentatie vindt u in de integratiedocumentatie van SkyPlanner.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturatie. Samen met uw abonnement ontvangt u vooraf een offerte voor de koppeling, afgestemd op uw proces en behoeften. Bekijk de prijzen, capaciteitsplanning voor APplus, de APplus-pagina en het overzicht van ERP-koppelingen.
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.
6 maandenvooruit zicht op vrije capaciteit voor de verkoopafdeling
“SkyPlanner biedt een betrouwbare basis voor de volledige productieplanning.”
Anu Järvinen, productiemanager
Fredman Operations · Voedselveilig verpakkingspapier
De verkoopafdeling ziet de vrije capaciteit zes maanden vooruit. Verzoeken om de planning aan te passen, die eerder een uur of langer kostten, worden nu in seconden beantwoord.
Minderstilstand door materiaaltekorten
“De waarde van SkyPlanner zit voor ons in het dagelijks gebruik: het is een hulpmiddel dat werkt, vooral bij het vaststellen van leverdatums.”
Tommi Männistö, manager productieplanning
Eskomatic · Verspaning in opdracht
Door de capaciteitsbelasting automatisch te plannen, zijn de leverdatums nauwkeuriger geworden. Ook is de productiestilstand door materiaaltekorten sterk afgenomen.
Veelgestelde vragen
Heeft APplus een API voor productieorders?
Ja. APplus is gebouwd op een webservicearchitectuur. Volgens Asseco kunnen de IT-systemen van klanten en leveranciers de planningsfuncties rechtstreeks gebruiken. Het Business Integration Framework koppelt externe systemen via aanpasbare gegevensstructuren en de Universal Cloud Connector verbindt SaaS-oplossingen met APplus.
Hoe worden geplande datums teruggeschreven naar APplus?
Bij elke wijziging in de productieplanning activeert een SkyPlanner-webhook een update van de geplande start, het geplande einde en de capaciteitseenheid voor elke bewerking van de productieorder. De update verloopt via de webservices van APplus of het Business Integration Framework. De route wordt vastgelegd tijdens de scopebepaling bij de onboarding.
Kan SkyPlanner BDE-berichten naar APplus sturen?
Ja, als u daarvoor kiest. Tijdregistraties van operators uit SkyPlanner worden als BDE-berichten geboekt, met tijd en hoeveelheid per bewerking op de order. Fabrieken die BDE met barcodes blijven gebruiken, laten SkyPlanner de berichten juist uitlezen.
Moet een APplus-partner APplus APS of SkyPlanner voorstellen?
SkyPlanner, als de klant binnen enkele weken een werkende planning wil die rekening houdt met de beschikbare capaciteit. APplus APS is een partnerproduct dat in APplus is geïntegreerd voor omstelmatrices met meerdere gereedschappen en het plannen van meerdere resources (Asseco). SkyPlanner ondersteunt deze toepassingen, maakt verbinding via de webservices van APplus, herplant automatisch en biedt een onbeperkt aantal gebruikers, vanaf 199 € per maand.
Werkt de koppeling met een gehoste versie van APplus?
Ja. APplus draait op locatie of als gehoste versie. SkyPlanner maakt met beide verbinding via de webservices. Tijdens de scopebepaling wordt met uw IT-team of hostingprovider afgesproken hoe de verbinding via het netwerk verloopt.
Kunnen we SkyPlanner testen voordat we de integratie bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken, met CSV- of Excel-imports uit APplus en alle functies van Basic. Een creditcard is niet nodig. Start de proefperiode of neem contact op met verkoop om de scope van de koppeling te bepalen.
