Integraties / ERP / JobBOSS²
JobBOSS²-integratiegids voor productieschema’s met SkyPlanner APS
Deze JobBOSS²-integratiegids laat partners en IT-teams zien hoe ze JobBOSS² van ECI aan SkyPlanner APS koppelen. SkyPlanner wisselt in beide richtingen gegevens uit met JobBOSS² via de eigen API’s van ECI:
- SkyPlanner leest Orders en Order Line Items, Order Routings, Estimates, Routings en materialen, Work Centers, Employees, de Company Calendar, Job Requirements en inkooporderregels in.
- De geplande start- en einddatums worden teruggeschreven naar elke Order Routing-stap.
- Als u daarvoor kiest, kunnen tijdregistraties van operators worden teruggeschreven als Time Ticket Details.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Het SkyPlanner-team stemt de integratie tijdens de onboarding af op uw JobBOSS²-inrichting en blijft deze na ingebruikname 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). Een Amerikaans bedrijf dat op order produceert, heeft dat al gedaan:
Integratie-interfaces van JobBOSS²
ECI publiceert zijn API’s voor de maakindustrie, inclusief OpenAPI-specificaties, op de site ECI Manufacturing API Documentation. Twee daarvan zijn relevant voor het productieschema:
- JobBOSS² API (v1). REST en JSON, specifiek voor JobBOSS². Deze API leest en schrijft orders, Order Line Items, Order Routings, Estimates, Routings, materialen, Job Requirements, Work Centers, de Company Calendar, Employees, inkooporders, Time Tickets en Time Ticket Details. Volgens ECI geldt: “is currently only supported for JobBOSS² hosted (Cloud) customers.” (wordt momenteel alleen ondersteund voor klanten met JobBOSS² hosted (Cloud)).
- ECI ERP API (v2.1). Een productonafhankelijke REST API voor Deacom, M1 en JobBOSS². Voor JobBOSS² biedt deze toegang tot taken, bewerkingen per taak, materialen per taak, artikelen, artikelbewerkingen, werkcentra, inkooporderregels en urenstaatregels. ECI vermeldt: “the actual ERP database could be a cloud hosted ERP or on premises install,” (de ERP-database kan in de cloud of lokaal worden gehost). Dit is dus de route voor een lokale JobBOSS²-installatie.
Beide API’s hanteren dezelfde conventies: filterexpressies zoals lastModDate[gte]=, een parameter fields=, sort= en paginering met take en skip, waarbij take standaard op 200 staat. “All dates submitted to the API are assumed to be in UTC.” (Alle datums die aan de API worden doorgegeven, worden geacht in UTC te staan.)
Voor beide API’s geldt de regel van ECI: “All APIs must be activated by ECI before use.” (Alle API’s moeten vóór gebruik door ECI worden geactiveerd.) Vraag dit tijdig aan uw ECI-accountmanager.
Authenticatie en toegang
- API-gebruikers. De integratie gebruikt een API-gebruiker die wordt aangemaakt via de Integration Engine Management Console van ECI. De API-gebruiker bepaalt op welk product, welke klant en welke database de aanroepen betrekking hebben.
- OAuth 2.0 client credentials. Met de client-ID en het clientgeheim vraagt u een token op bij het token-endpoint van de Authentication API. Elke volgende aanroep stuurt
Authorization: Bearer [token]mee. - Toegangsbereik. Geef de API-gebruiker uitsluitend toegang tot de resources die nodig zijn voor de onderstaande mappingtabel.
Aan de kant van SkyPlanner gebruikt de REST API een API-token voor authenticatie (SkyPlanner Settings > API). De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding begeleidt u bij de eerste aanroepen.
Events en polling
Geen van beide ECI-API’s documenteert webhooks. Gegevens uit JobBOSS² worden via polling opgehaald: filter Order Line Items, Order Routings en inkooporderregels op lastModDate sinds de vorige uitvoering en gebruik take en skip voor paginering. De frequentie wordt per productiebedrijf ingesteld: van om de paar minuten voor taken tot elk uur voor voorraad.
SkyPlanner verstuurt webhooks wanneer de status of het productieschema verandert. Het terugschrijven wordt dus door events aangestuurd.
Datamapping
| JobBOSS²-object (JobBOSS² API-resource) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
Estimates (/estimates), materialen (/materials) | Producten, materialen, productstructuur | JobBOSS² → SkyPlanner | Eerste import, daarna bij wijzigingen |
Routings (/routings): werkcentrum, insteltijd, cyclustijd, teamgrootte, machines voor de taak | Processtappen met bewerkingsduur en insteltijden | JobBOSS² → SkyPlanner | Eerste import, daarna bij wijzigingen |
Work Centers (/work-centers): uren per ploeg, actief in ploeg 1 tot en met 3, werkdagen | Werkcentra, werkcentrumgroepen, efficiënties | JobBOSS² → SkyPlanner | Eerste import, daarna zelden |
Company Calendar (/company-calendars), Employees (/employees) | Ploegendiensten, niet-werkdagen, personeel | JobBOSS² → SkyPlanner | Dagelijks, of ploegendiensten beheren in SkyPlanner |
Orders en Order Line Items (/order-line-items): taaknummer, leverdatum, prioriteit, te produceren aantal | Orders met leverdatums en prioriteiten | JobBOSS² → SkyPlanner | Polling om de paar minuten |
Order Routings (/order-routings): taakstappen, status, resterende uren | Taken per processtap | JobBOSS² → SkyPlanner | Polling om de paar minuten |
Job Requirements (/job-requirements), inkooporderregels (/purchase-order-line-items) | Materiaalbehoeften, inkooporders op leverdatum | JobBOSS² → SkyPlanner | Polling, elk uur of bij het berekenen van het productieschema |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Geplande start- en eindtijd, machine en operator per stap | SkyPlanner → JobBOSS² | Bij wijziging van het productieschema, via een SkyPlanner-webhook |
| Time Ticket Details (POST): taak, stap, werkcentrum, medewerker, insteltijd, cyclustijd, geproduceerde en afgekeurde aantallen, start- en eindtijd | Tijdregistraties en terugmeldingen van operators | SkyPlanner → JobBOSS² | Per terugmelding of per ploegendienst, indien gekozen |
| Niet in JobBOSS² | Omsteltijdenmatrix, gereedschappen met beperkte beschikbaarheid, alternatieve machines en medewerkers | Beheerd in SkyPlanner | Ingericht tijdens de onboarding |
Bij een lokale JobBOSS²-installatie worden dezelfde objecten ingelezen via de ERP API-resources /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers en /purchase-order-lines. Tijdregistraties worden verstuurd naar /timecard-lines.
Integratiepatronen
1. Eerste import van stamgegevens. Lees Estimates, Routings, materialen, Work Centers, de Company Calendar en Employees in. Kies bewust hoe u werkcentra koppelt: een werkcentrum met vier draaibanken wordt één werkcentrumgroep of vier werkcentra, zodat SkyPlanner voor elke machine de taakvolgorde bepaalt.
2. Taken synchroniseren. Lees openstaande Order Line Items in met de bijbehorende Order Routings, Job Requirements en openstaande inkooporderregels. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder als Delivered is gemarkeerd. Sla taken in de wacht en afgesloten taken over.
3. Productieschema terugschrijven. Wanneer de engine een stap inplant of verplaatst, activeert een SkyPlanner-webhook een PATCH naar /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Deze stelt estimatedStartDate en estimatedEndDate in UTC in, en ook workCenter en employeeCode als SkyPlanner de stap aan een andere machine of persoon heeft toegewezen. De datums komen terecht bij de taakstappen die Whiteboard, Planning Board en Scheduling Advisor al tonen.
4. Terugmeldingen van de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. De tijdregistraties houden het productieschema actueel. U kiest of de werkelijke tijden worden teruggeschreven naar JobBOSS². Zo ja, dan wordt elke terugmelding een Time Ticket Detail met insteltijd, cyclustijd en aantallen. Zo nee, dan blijft de gegevensregistratie in JobBOSS² en leest SkyPlanner de voortgang uit Order Routings.
5. Gegevenseigenaarschap en conflictregels. Leg deze vóór ingebruikname vast:
| Gegevens | Eigenaar |
|---|---|
| Estimates, Routings, aantallen, leverdatums, taakstatus | JobBOSS² |
| Volgorde van stappen, start- en eindtijden, machine en operator per stap | SkyPlanner |
| Omsteltijdenmatrix, eisen aan gereedschappen en operators, alternatieve productiemiddelen | SkyPlanner |
| Ploegendiensten en niet-werkdagen | Eén systeem, gekozen tijdens de scopebepaling |
| Urenbonnen, materiaaluitgiften, ontvangsten, kostencalculatie | JobBOSS², daar ingevoerd of overgenomen uit tijdregistraties in SkyPlanner |
Kies één systeem dat de datums van taakstappen schrijft. Voor de taken die SkyPlanner inplant, vervangt SkyPlanner het herplannen in Whiteboard. Planners verplaatsen het werk dus in SkyPlanner, waarna de datums naar JobBOSS² worden overgezet.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Valideer vooraf het productieschema tijdens de gratis proefperiode van 30 dagen, met Work Centers, bewerkingsvolgorden en openstaande taken die u vanuit JobBOSS² als CSV of Excel exporteert.
- Mapping. Leg de mappingtabel, de regels voor gegevenseigenaarschap en de synchronisatiefrequenties vast. Bepaal ook of urenbonnen worden teruggeschreven.
- Toegang via ECI. Vraag ECI om de JobBOSS² API of ERP API te activeren en de API-gebruiker aan te maken. Test met een sandboxadministratie als u die heeft.
- Eerste gegevensimport. Estimates, Routings, Work Centers, kalender en medewerkers.
- Taken en inkooporders synchroniseren. Polling met filters op
lastModDate, paginering en herhaalpogingen. - Randvoorwaarden instellen in SkyPlanner. Matrix voor omsteltijden, gereedschappen, aantal operators per taak en alternatieve machines of medewerkers.
- Planning terugschrijven. PATCH-aanroepen voor Order Routing vanuit SkyPlanner-webhooks, plus Time Ticket Details als daarvoor is gekozen.
- Parallel testen. Gebruik SkyPlanner naast het huidige planbord, vergelijk datums en corrigeer stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten bij een JobBOSS²-integratie
- Gehost of on-premise. De JobBOSS² API is bedoeld voor klanten met een gehoste omgeving. On-premise-installaties gebruiken de ERP API, die een andere lijst met resources heeft. Bepaal in stap 1 welke route u volgt.
- Overal UTC. De API leest en schrijft tijden in UTC. Reken deze om naar de lokale tijd van de fabriek, anders komt een start om 7:00 op het verkeerde tijdstip terecht.
- Machines achter een werkcentrum. Een werkcentrum kan een machine, een groep, een cel of medewerkers vertegenwoordigen. Het aantal machines en de teamgrootte per bewerkingsstap geven SkyPlanner aan hoeveel productiemiddelen die stap nodig heeft.
- Uitbesteding. Stappen met een leverancier in plaats van een werkcentrum tellen mee als doorlooptijd, niet als belasting van uw eigen capaciteit. Modelleer ze als stappen die alleen tijd in beslag nemen.
- Overlappende en onbemande stappen. Bewerkingsstappen kunnen gemarkeerd zijn als overlappend of onbemand. Neem beide markeringen over, zodat onbemande productie correct wordt gepland.
- Tijdseenheden. Instel- en cyclustijden hebben elk hun eigen eenheden. Wachttijd is geen machinetijd. Reken de eenheden bij het importeren om, anders klopt geen enkele tijdsduur.
- Paginering. Een pagina bevat standaard 200 records. Gebruik paginering bij elke leesactie.
Wie configureert en ondersteunt de JobBOSS²-integratie?
- Het SkyPlanner-team configureert de integratie tijdens de onboarding en ondersteunt deze na ingebruikname, voor de afgesproken resources en volgens de afgesproken pollingregels. Elk productiebedrijf gebruikt JobBOSS² anders. Die praktijkkennis wordt in de configuratie verwerkt.
- Uw JobBOSS²-partner kan meewerken. De partner kent uw inrichting en kan samen met het SkyPlanner-team de API-activering en de API-gebruiker bij ECI regelen.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen 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 integratiedocumentatie vindt u in de SkyPlanner-integratiedocumentatie.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturering. U ontvangt vooraf een offerte voor de integratie, afgestemd op uw processen en behoeften, samen met uw abonnement. Bekijk de prijzen, capaciteitsplanning voor JobBOSS², de JobBOSS²-pagina, de functies van SkyPlanner en het overzicht van ERP-integraties.
Productiebedrijven die SkyPlanner gebruiken
2 hbespaard per week
“Dankzij 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 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’enwerkorders automatisch ingepland
“We hebben op een andere manier grip op de productie en ons inzicht in de capaciteit ligt op een heel ander niveau.”
Hannu Ryynänen, CEO
Mamec · Industriële mengers, 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 circa 50% naar maar liefst 98%. Voor de planning is nu één leidinggevende nodig in plaats van twee.
Veelgestelde vragen
Heeft JobBOSS² een API?
Ja. ECI publiceert de JobBOSS² API en de productonafhankelijke ERP API. Beide zijn REST-API’s met OpenAPI-specificaties. Voor klanten met een gehoste omgeving leest en schrijft de JobBOSS² API orders, Order Routings, Estimates, Work Centers, inkooporders en Time Tickets.
Hoe authenticeert de integratie zich bij JobBOSS²?
Met OAuth 2.0 client credentials. ECI activeert de API en via de Integration Engine Management Console wordt een API-gebruiker aangemaakt. Elke aanroep bevat een Bearer-token.
Ondersteunt JobBOSS² webhooks?
De documentatie van de ECI-API’s vermeldt geen webhooks. Daarom vraagt de integratie JobBOSS² periodiek uit met filters op lastModDate, volgens een schema dat per productiebedrijf wordt ingesteld. De eigen webhooks van SkyPlanner sturen planningswijzigingen direct door zodra ze plaatsvinden.
Hoe worden geplande datums teruggeschreven naar JobBOSS²?
Per bewerkingsstap. SkyPlanner werkt elke Order Routing bij via PATCH met estimatedStartDate en estimatedEndDate. Als de stap naar een andere machine of operator is verplaatst, worden ook workCenter en employeeCode bijgewerkt.
Moet een JobBOSS²-partner ECI APS of SkyPlanner voorstellen?
SkyPlanner, als de klant binnen enkele weken wil werken met capaciteitsplanning die rekening houdt met de beschikbare capaciteit van meerdere productiemiddelen. ECI APS is een afzonderlijke uitbreiding op basis van LYNQ. SkyPlanner koppelt via de eigen JobBOSS² API van ECI, plant omstellingen, teams, opspanmiddelen en materiaal, past de planning automatisch aan en is beschikbaar vanaf 199 € per maand.
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 JobBOSS². Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales voor de scopebepaling van de integratie.
