Koppelingen / ERP / E2 Shop System
Handleiding voor de E2 Shop System koppeling voor productieplanning met SkyPlanner APS
Deze handleiding laat partners en IT-teams zien hoe ze E2 Shop System (E2 SHOP) of E2 MFG aan SkyPlanner APS koppelen. SkyPlanner wisselt gegevens met E2 in beide richtingen uit:
- Orders en taken met hun bewerkingsstappen, werkcentra, medewerkers en diensten, stuklijsten, materiaalbehoeften en inkooporders worden ingelezen.
- De geplande start- en eindtijden worden per bewerking teruggeschreven, samen met de machine en medewerker die SkyPlanner heeft toegewezen.
- Als u daarvoor kiest, kunnen afgeronde bewerkingen en geregistreerde uren worden teruggeschreven naar de taak.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Het SkyPlanner-team stemt de koppeling tijdens de onboarding af op uw E2-installatie en blijft deze na de ingebruikname ondersteunen. Deze handleiding is voor partners en ontwikkelaars die willen meewerken of zelf aan de slag willen met de gedocumenteerde REST API van SkyPlanner (API-referentie).
Welke E2 gebruikt u?
Stel dit eerst vast, want het bepaalt hoe u de koppeling maakt:
| U gebruikt | Huidige status | Manier van koppelen |
|---|---|---|
| E2 Shop System (desktop, op uw eigen server) | De oorspronkelijke E2 van Shoptech voor productie op order | Rechtstreekse verbinding met uw E2-server, waar zinvol aangevuld met bestanden |
| E2 MFG (E2 Manufacturing System) | De E2-editie voor repetitieve, discrete en gemengde productie, door ECI aangeboden “for existing customers” (voor bestaande klanten) | Hetzelfde als bij een lokale installatie van E2 Shop System |
| Gehost E2 SHOP | Het webplatform dat ECI heeft herbouwd tot JobBOSS² | Gebruikt u inmiddels JobBOSS²? Raadpleeg dan de handleiding voor de JobBOSS²-koppeling |
ECI omschrijft JobBOSS² als “formerly E2 Shop” (voorheen E2 Shop) en stelt dat het “combines E2 SHOP’s cloud-native, user-friendly platform with JobBOSS’ depth of functionality” (het cloud-native, gebruiksvriendelijke platform van E2 SHOP combineert met de uitgebreide functionaliteit van JobBOSS) (ECI). De rest van deze handleiding gaat over productiebedrijven die E2 Shop System of E2 MFG gebruiken.
Manieren om E2 te koppelen
De gepubliceerde productie-API’s van ECI op de website ECI Manufacturing API Documentation zijn bedoeld voor JobBOSS², M1, Macola en Deacom. E2 wordt daarentegen rechtstreeks op de installatie gekoppeld. Dat past goed bij een lokale E2-installatie: de gegevens staan op een server die uw eigen IT-team beheert. Tijdens de scopebepaling bij de onboarding wordt vastgelegd hoe gegevens in uw installatie precies worden gelezen en geschreven.
- Rechtstreekse serververbinding (on-premise). Een integratieservice op uw netwerk leest openstaande taken, bewerkingsstappen, werkcentra, medewerkers, materialen en inkooporders uit de E2-database en schrijft geplande start- en eindtijden terug naar de bewerkingen. Uw IT-team keurt de toegang, een speciaal hiervoor bestemd serviceaccount en de precieze velden waarnaar de service schrijft goed. Dit is de belangrijkste manier om een live koppeling in twee richtingen te realiseren.
- Periodieke exports en imports. Via E2-rapporten en exports van tabelweergaven maakt u CSV- of Excel-bestanden met taken, bewerkingsvolgorden en werkcentra. De importfunctie van SkyPlanner leest deze bestanden in. Deze aanpak is bedoeld voor de proefperiode en is ook geschikt voor stamgegevens die u slechts af en toe inleest.
- Gehoste installaties. Als ECI uw E2-installatie host, wordt de toegang tot gegevens met ECI geregeld. Bespreek dit tijdig met uw ECI-accountmanager.
Aan de kant van SkyPlanner leest en schrijft de REST API orders, producten, materialen, processtappen, tijdregistraties en inkooporders. Authenticatie verloopt via een API-token in de Authorization-Token-header (SkyPlanner Settings > API). De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding leidt u door de eerste API-aanroepen.
Events en polling
E2 wordt via polling uitgelezen. De integratieservice leest taken en bewerkingsstappen die sinds de vorige uitlezing zijn gewijzigd. Voor taken gebeurt dat om de paar minuten en voor voorraad en inkooporders elk uur, volgens de afspraken per productiebedrijf.
SkyPlanner verstuurt webhooks wanneer de status of de planning verandert. De service ontvangt deze en schrijft de nieuwe datums direct naar E2. Het terugschrijven is dus eventgestuurd. Gebeurtenissen op de werkvloer kunnen ook periodiek worden uitgelezen via het SkyPlanner-endpoint /timelogs.
Gegevensmapping
| E2-object | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
| Artikelen en calculaties, stuklijsten met meerdere niveaus | Producten, materialen, productstructuur | E2 → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Bewerkingsstappen: werkcentrum, insteltijd, bewerkingstijd | Processtappen met bewerkingstijden en insteltijden | E2 → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Werkcentra en machines | Werkcentra, werkcentrumgroepen, efficiëntiefactoren | E2 → SkyPlanner | Eerste import, daarna zelden |
| Medewerkers, diensten, afdelingen, niet-werkdagen | Personeel, diensten, kalenders | E2 → SkyPlanner | Dagelijks, of diensten in SkyPlanner beheren |
| Orders en taken: taaknummer, artikel, aantal, leverdatum, prioriteit, spoedmarkering | Orders met leverdatums en prioriteiten | E2 → SkyPlanner | Polling om de paar minuten |
| Bewerkingsstappen van taken: status, gereed aantal, resterende uren | Taken per processtap | E2 → SkyPlanner | Polling om de paar minuten |
| Materiaalbehoeften, inkooporders met leverdatums | Materiaalbehoeften, inkooporders op leverdatum | E2 → SkyPlanner | Polling, elk uur of bij het berekenen van de planning |
| Geplande start- en eindtijd, werkcentrum en medewerker per bewerking | Geplande start- en eindtijd, machine en operator per stap | SkyPlanner → E2 | Bij wijzigingen in de planning, via een SkyPlanner-webhook |
| Bestede tijd en gereedgemelde aantallen per bewerking | Tijdregistraties en terugmeldingen van operators | SkyPlanner → E2 | Per terugmelding of per dienst, als u daarvoor kiest |
| Niet in E2 | Omsteltijdenmatrix, gereedschappen met beperkte beschikbaarheid, alternatieve machines en medewerkers | Beheerd in SkyPlanner | Ingericht tijdens de onboarding |
Opzet van de koppeling
1. Eerste import van stamgegevens. Lees artikelen, stuklijsten, bewerkingsvolgorden, werkcentra, medewerkers en diensten in. Maak bewuste keuzes bij het koppelen van werkcentra: een werkcentrum met drie freesmachines wordt één werkcentrumgroep of drie werkcentra, zodat SkyPlanner elke machine afzonderlijk plant.
2. Taken synchroniseren. Lees openstaande taken met hun bewerkingsstappen, materiaalbehoeften en openstaande inkooporders in. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt. Sla afgesloten en geblokkeerde taken over. Neem de spoedmarkering over als prioriteit in SkyPlanner.
3. Planning terugschrijven. Wanneer de planningsengine een stap inplant of verplaatst, activeert een SkyPlanner-webhook de service. Die schrijft de geplande start- en eindtijd naar de betreffende bewerking in E2. Als SkyPlanner de stap naar een andere machine of medewerker heeft verplaatst, worden ook het werkcentrum en de medewerker teruggeschreven. Het Whiteboard en Planning Board tonen vervolgens de datums uit SkyPlanner.
4. Terugmeldingen van de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. De tijdregistraties houden de planning actueel. U kiest of de werkelijke tijden naar E2 worden teruggeschreven. Zo ja, dan wordt elke terugmelding als tijd en aantal op de bewerking vastgelegd. Zo nee, dan blijft E2 Data Collection ongewijzigd en leest SkyPlanner de voortgang uit de bewerkingen.
5. Gegevenseigenaarschap en conflictregels. Leg deze vast vóór de ingebruikname:
| Gegevens | Eigenaar |
|---|---|
| Calculaties, bewerkingsvolgorden, aantallen, leverdatums, taakstatus | E2 |
| Volgorde van de stappen, start- en eindtijden, machine en operator per stap | SkyPlanner |
| Omsteltijdenmatrix, vereisten voor gereedschappen en operators, alternatieve resources | SkyPlanner |
| Diensten en niet-werkdagen | Eén systeem, gekozen tijdens de scopebepaling |
| Uren, materiaaluitgiften, ontvangsten, kostencalculatie | E2, daar ingevoerd of overgenomen uit tijdregistraties van SkyPlanner |
Laat slechts één systeem de datums van bewerkingen schrijven. Planners verplaatsen werk in SkyPlanner, waarna de datums naar E2 worden doorgestuurd. Voor taken die SkyPlanner plant, moet het verslepen van kaarten op het Planning Board stoppen. Anders gaan de twee planningen uiteenlopen.
Gebruikelijke projectstappen
De implementatie is normaal gesproken binnen enkele weken na de start van de onboarding afgerond. Toets de planning vooraf tijdens de gratis proefperiode van 30 dagen met werkcentra, bewerkingsvolgordes en openstaande taken die u vanuit E2 als CSV of Excel exporteert.
- Scopebepaling. Leg de E2-editie en -versie, de server, de mappingtabel en de regels voor gegevenseigenaarschap vast. Bepaal ook of tijdregistraties worden teruggeschreven.
- Toegang. Uw IT-team maakt het serviceaccount aan en keurt de lees- en schrijftoegang goed. Maak een volledige back-up van E2 en test eerst op een kopie van de bedrijfsgegevens.
- Eerste gegevensimport. Onderdelen, stuklijsten, bewerkingsvolgordes, werkcentra, medewerkers en diensten.
- Taken en inkooporders synchroniseren. Via polling op wijzigingen, met herhaalpogingen en logging.
- Planningsbeperkingen instellen in SkyPlanner. De insteltijdmatrix, gereedschappen, het aantal operators per taak en alternatieve machines of medewerkers.
- De planning terugschrijven. Webhooks sturen het terugschrijven van datums naar taakstappen aan, aangevuld met tijd en aantallen als u daarvoor kiest.
- Parallel testen. Gebruik SkyPlanner naast het huidige Whiteboard, vergelijk datums en corrigeer stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten voor een E2-koppeling
- Editie en versie. Installaties van E2 Shop System en E2 MFG verschillen per versie. Leg uw editie en versie vast tijdens de scopebepaling en test de koppeling opnieuw na elke E2-update.
- Uw server, uw regels. Een lokale E2-installatie draait op uw netwerk. Spreek met IT af waar de integratieservice draait, welk account deze gebruikt en naar welke velden deze mag schrijven.
- Machines achter een werkcentrum. Een werkcentrum kan één machine, een groep of een cel zijn. Bepaal vóór de eerste import hoe elk werkcentrum aan de werkcentra in SkyPlanner wordt gekoppeld.
- Uitbesteed werk. Stappen bij een leverancier tellen mee voor de doorlooptijd, niet voor uw eigen capaciteit. Modelleer ze als stappen die alleen tijd kosten.
- Tijdseenheden. Instel- en bewerkingstijden kunnen per stuk, per partij of per uur zijn vastgelegd. Reken ze bij de import om, anders klopt geen enkele tijdsduur.
- Spoedwerk. E2 markeert taken met een hoge prioriteit. Koppel die markering aan de prioriteit in SkyPlanner of aan Fast Track, zodat spoedwerk zijn plek behoudt.
- Wilt u overstappen op JobBOSS²? De SkyPlanner-kant hoeft u maar één keer in te richten. Met JobBOSS² wordt dezelfde planning gekoppeld via de JobBOSS² API (gehost) of ERP API van ECI, zoals beschreven in de JobBOSS²-handleiding.
Wie richt de E2-koppeling in en biedt ondersteuning?
- Het SkyPlanner-team richt de koppeling tijdens de onboarding in en biedt ondersteuning na ingebruikname, voor de afgesproken objecten en synchronisatieregels. Elk productiebedrijf gebruikt E2 anders. Die praktijkkennis wordt hierin verwerkt.
- Uw E2-partner of IT-dienstverlener kan meewerken. Zij kennen uw server en E2-inrichting en kunnen samen met het SkyPlanner-team de toegang en het serviceaccount regelen.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen via de REST API van SkyPlanner met een API-token. Een API-token is voldoende 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. U ontvangt vooraf een offerte voor de koppeling, afgestemd op uw proces en behoeften, samen met uw abonnement. Bekijk de prijzen, capaciteitsplanning voor E2 Shop System, de E2 Shop System-pagina, de functies van SkyPlanner en het overzicht van ERP-koppelingen.
Productiebedrijven die SkyPlanner gebruiken
2 hbespaard per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelpanelen en schakelapparatuur
De productieplanning bespaart elke week 2 uur 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.
1.000-tallenwerkorders automatisch ingepland
“We hebben de productie op een andere manier onder controle en ons inzicht in de capaciteit is van een heel ander niveau.”
Hannu Ryynänen, algemeen directeur
Mamec · Industriële mixers, pompen en hightech productie in opdracht
Duizenden werkorders worden automatisch ingepland en de hele organisatie heeft realtime inzicht in de productie.
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 ongeveer 50% naar wel 98%. Voor de planning is nu één leidinggevende nodig in plaats van twee.
Veelgestelde vragen
Heeft E2 Shop System een API?
De gepubliceerde productie-API’s van ECI zijn bedoeld voor JobBOSS², M1, Macola en Deacom. Voor lokaal geïnstalleerde versies van E2 Shop System en E2 MFG wordt de koppeling ter plaatse ingericht: een integratieservice op uw netwerk leest en schrijft E2-gegevens met toegangsrechten die uw IT-team goedkeurt. De overige gegevens worden via bestandsexports uitgewisseld.
Hoe worden geplande datums teruggeschreven naar E2?
Per taakstap. Een webhook van SkyPlanner activeert de integratieservice. Die schrijft de geplande begin- en eindtijd naar de taakstap in E2, aangevuld met het werkcentrum en de medewerker als SkyPlanner de stap heeft verplaatst.
Kan SkyPlanner tijdregistraties van de werkvloer terugschrijven naar E2?
Ja, als u daarvoor kiest. Elke terugmelding in SkyPlanner wordt als tijd en aantal op de taakstap vastgelegd. Bedrijven die liever E2 Data Collection gebruiken, behouden dat systeem. SkyPlanner leest dan de voortgang uit E2.
Wij gebruiken gehost E2 SHOP. Welke handleiding is van toepassing?
Gehost E2 SHOP is overgegaan in JobBOSS². Als u nu inlogt op JobBOSS², gebruikt u de integratiehandleiding voor JobBOSS². Gebruikt u nog gehost E2, dan wordt de toegang tot de gegevens tijdens de scopebepaling met ECI geregeld.
Blijft de koppeling bruikbaar als we later overstappen op JobBOSS²?
Aan de SkyPlanner-kant blijft alles hetzelfde: werkcentra, planningsbeperkingen, de insteltijdmatrix en uw productieplanning. Alleen de E2-koppeling wordt vervangen door de JobBOSS² API of ERP API van ECI.
Kunnen we SkyPlanner testen voordat de koppeling wordt gebouwd?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en CSV- of Excel-bestanden uit E2 importeren. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales voor de scopebepaling van de koppeling.