Integratiegids voor Epicor Kinetic voor productieschema’s met SkyPlanner APS

Epicor stelt: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Alle Kinetic-services, waaronder business objects, processen, rapporten, BAQs en Epicor Functions, zijn toegankelijk via REST-endpoints.) Een integratie voor het opstellen van productieschema’s is gebaseerd op vier Epicor-technologieën:

1. Kinetic REST API v2 (OData v4). Business objects zijn beschikbaar als services met de naam Erp.BO.<Name>Svc. Het gebruikelijke pad is /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 bestaat nog, maar is verouderd. Bouw daarom op v2. Controleer de entity sets en methoden voor uw release in REST Help op /api/help/v2/.
2. Business Activity Queries (BAQ) via REST. Een BAQ is beschikbaar op /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Dit is een praktische manier om planningsgegevens uit te lezen en daarbij JobHead, JobOper, JobMtl, PartWhse en PORel in één aanroep te combineren (voorbeeld uit de community).
3. Epicor Functions (EFx). Serverfuncties die aan te roepen zijn via /api/v2/efx/{Company}/{Library}/{Function}. Epicor stelt dat deze functies “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (Ze kunnen vanuit meerdere ingangen worden geactiveerd, waaronder BPM’s, REST-services, geplande taken en applicatiegebeurtenissen.)
4. BPM directives. Method en Data Directives worden geactiveerd wanneer een taak of bewerking verandert en kunnen een functie aanroepen die gegevens verstuurt.

Voor bestandsuitwisseling verzorgt DMT de import en leveren BAQ-exports de uitgaande gegevens. Epicor biedt ook Epicor Automation Studio, dat het omschrijft als “a low-code app for integration-led automations” (een low-code-app voor automatisering op basis van integraties). Vermijd rechtstreekse databasetoegang: REST, BAQs en functies werken lokaal en op Kinetic Cloud op dezelfde manier.

Epicor documenteert geen generieke API voor uitgaande webhooks. Wijzigingen in Kinetic bereiken SkyPlanner daarom op een van deze twee manieren:

• Gebeurtenisgestuurd. Een BPM Data Directive op JobHead of JobOper roept een Epicor Function aan. Die verstuurt de gewijzigde productieorder naar de SkyPlanner REST API.
• Periodieke polling. Een BAQ die op wijzigingsdatum filtert, wordt om de paar minuten of elk uur uitgevoerd. Deze aanpak is eenvoudiger te beheren en na fouten te herstellen.

In de andere richting verstuurt SkyPlanner status- en schemawijzigingen via webhooks. Uw middleware of een EFx-endpoint ontvangt ze en schrijft ze naar Kinetic.

1. Eerste import van stamgegevens. Lees artikelen, groepen productiemiddelen, productiemiddelen, bewerkingsmogelijkheden, kalenders en medewerkers uit. Maak werkcentra in SkyPlanner aan op basis van de productiemiddelen in Kinetic, en werkcentrumgroepen op basis van de groepen productiemiddelen. Verdeel grote leesopdrachten over pagina’s met $top en $skip, of haal bulkgegevens op via een BAQ.

2. Ordersynchronisatie. Verstuur vrijgegeven en vastgezette productieorders met hun bewerkingen en materialen. Haal de volledige orderstructuur op met GetDatasetForTree of een BAQ, niet entiteit voor entiteit. Laat voorlopige MRP-productieorders in Kinetic staan totdat ze zijn vastgezet. Synchroniseer bij het uitlezen van de voorraad ook de openstaande inkoopafroepen met hun leverdatums. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum en werkt de voorraad bij zodra de inkooporder als Delivered is gemarkeerd. Zo houdt het productieschema rekening met zowel voorraad als verwachte inkopen.

3. Productieschema terugschrijven. De webhook van SkyPlanner stuurt de geplande start, het einde en het werkcentrum per bewerking naar een EFx-endpoint (/api/v2/efx/{Company}/{Library}/{Function}). De functie schrijft deze gegevens weg via de planningsengine van Kinetic. Dat is hetzelfde business object dat de planning in Job Entry en op de planborden aanstuurt (voorbeeld uit de community):

1. ScheduleEngine.GetNewParamsForJob bouwt de dataset op die de planningsengine voor de productieorder nodig heeft.
2. De functie stelt het productieordernummer, de volgnummers van de assemblage en de bewerking, en de geplande startdatum en -tijd in. Daarna roept de functie ScheduleEngine.MoveJobItem aan.
3. Als SkyPlanner de bewerking op een ander productiemiddel binnen de groep heeft ingepland, verplaatst ScheduleEngine.ChangeResource de bewerking daarheen. Met alleen MoveJobItem blijft het standaardproductiemiddel van de groep behouden.
4. De functie vergrendelt de planning van de productieorder (JobHead.SchedLocked, de optie Lock in Job Entry), zodat Global Scheduling de datums van SkyPlanner behoudt.

Door deze aanroepen in één Epicor Function onder te brengen, blijft het schrijven per productieorder atomair en kunt u eigen validatie toevoegen. Als een vestiging liever geen maatwerkfunctie gebruikt, kan dezelfde reeks rechtstreeks via REST-aanroepen naar Erp.BO.ScheduleEngineSvc worden uitgevoerd. Schrijf nooit rechtstreeks naar ResourceTimeUsed of de datumvelden van JobOper: daarmee omzeilt u de engine en lopen de toewijzingen op het planbord uit de pas.

4. Terugmeldingen van de werkvloer. Operators registreren hun werk in SkyPlanner met Mobile Confirmations, de Production Timer of Quick Log Mode. Elke afgesloten tijdregistratie wordt via Erp.BO.LaborSvc als arbeidsregistratie in Kinetic geboekt: met StartActivity en EndActivityByEmp voor actuele activiteiten, of met Labors en Update voor registraties achteraf. Als uw vestiging goedkeuring vereist, neem dan submitForApproval op in de gegevensstroom en de toegangsrechten.

5. Gegevenseigenaarschap en conflictregels. Leg deze vóór de ingebruikname vast:

Taken die SkyPlanner inplant, krijgen een planningsvergrendeling, zodat Global Scheduling hun datums ongemoeid laat. Blijf de planning in Kinetic gebruiken voor productiemiddelen die SkyPlanner niet inplant.

De implementatie wordt normaal gesproken binnen enkele weken na de start van de onboarding afgerond. Een Kinetic-project omvat:

1. Een proefperiode van 30 dagen met CSV- of Excel-exports van taken, bewerkingen en productiemiddelen, voordat er iets wordt ontwikkeld.
2. Een API-sleutel, het toegangsbereik, een aparte integratiegebruiker en de BAQs die de integratie uitleest.
3. Mapping van stamgegevens: capabilities, groepen productiemiddelen, productiemiddelen, kalenders en medewerkers koppelen aan werkstations, groepen, diensten en personeel in SkyPlanner.
4. De eerste import van artikelen, productiemethoden (BOM en bewerkingen) en productiemiddelen.
5. Synchronisatie van productieorders en inkooporders (leverdatums in PORel), plus de voorraad uit PartWhse.
6. Geplande bewerkingsdatums terugschrijven via ScheduleEngineSvc (MoveJobItem, ChangeResource) binnen een Epicor Function, met de planning van de productieorder vergrendeld.
7. Terugmeldingen van de werkvloer via LaborSvc als arbeidsregistraties boeken.
8. Parallel testen met het huidige Kinetic-schema en daarna in gebruik nemen.

Geen twee fabrieken gebruiken Kinetic op dezelfde manier. Bewerkingsvolgorden op basis van capabilities, kalenders van groepen productiemiddelen, de opzet van BAQs, BPM directives en versieafhankelijke methoden voor terugschrijven verschillen per locatie. Een juiste inrichting maakt het verschil tussen een schema waarop planners vertrouwen en een schema dat ze moeten aanpassen.

1. Het SkyPlanner-team configureert de integratie tijdens de onboarding en ondersteunt deze na de ingebruikname. Het team maakt de mapping voor uw productiemiddelen, taken en inkoopafroepen en stelt het uitlezen van BAQs, de BPM-triggers en de terugschrijffunctie in. Het koppelt de REST API en webhooks van SkyPlanner aan Kinetic REST v2. De ondersteuning loopt door wanneer uw BAQs, BPMs of Kinetic-versie veranderen.
2. Uw Epicor-partner. Partners die al BAQs, BPMs en Epicor Functions schrijven, kunnen werken met dezelfde gedocumenteerde SkyPlanner REST API. Deze leest en schrijft orders, producten, materialen, processtappen en tijdregistraties.
3. Uw eigen ontwikkelaars. Interne teams met ervaring met Kinetic REST kunnen rechtstreeks bouwen, of in Automation Studio als u dat gebruikt. Een SkyPlanner-API-sleutel is genoeg om te beginnen (integratiehandleiding) en het SkyPlanner-team helpt waar nodig. De productdocumentatie is openbaar beschikbaar in de SkyPlanner-documentatie.

Hetzelfde integratiepatroon met API’s en webhooks wordt al in productie gebruikt met andere ERP-systemen, bijvoorbeeld bij UTU. Bij Laboratory & Allied heeft het interne IT-team de integratie met SAP Business One grotendeels zelf gebouwd, met hulp van SkyPlanner.

Elke aanpak begint op dezelfde manier: gebruik eerst de gratis proefperiode van 30 dagen met CSV-imports, toets het schema en bouw daarna de integratie. De prijs is vanaf 199 € per maand met 5 werkstations, maandelijks gefactureerd en op elk moment opzegbaar. U ontvangt vooraf een offerte voor de integratie, afgestemd op uw proces en behoeften, samen met uw abonnement. Zo kent u de volledige kosten voordat u begint.