Guide til integration af Epicor Kinetic med SkyPlanner APS til detailplanlægning

Epicor skriver: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Alle Kinetic-tjenester, herunder forretningsobjekter, processer, rapporter, BAQs og Epicor Functions, er tilgængelige via REST-endpoints.) En integration til detailplanlægning bygger på fire Epicor-teknologier:

1. Kinetic REST API v2 (OData v4). Forretningsobjekter udstilles som tjenester med navnet Erp.BO.<Name>Svc. Den sædvanlige sti er /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 findes stadig, men er en ældre version, så byg på v2. Kontrollér entitetssæt og metoder for din version i REST Help på /api/help/v2/.
2. Business Activity Queries (BAQ) via REST. En BAQ udstilles på /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Det er den praktiske vej til at hente planlægningsdata, der sammenkobler JobHead, JobOper, JobMtl, PartWhse og PORel i ét kald (eksempel fra brugerforummet).
3. Epicor Functions (EFx). Funktioner på serversiden, som kan kaldes på /api/v2/efx/{Company}/{Library}/{Function}. Epicor oplyser, at de “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (kan udløses fra flere indgangspunkter, herunder BPM’er, REST-tjenester, tidsplaner og applikationshændelser).
4. BPM-direktiver. Method and Data Directives udløses, når en produktionsordre eller operation ændres, og kan kalde en funktion, der sender data ud.

Ved filoverførsel håndterer DMT importen, mens BAQ-eksporter står for dataudtræk. Epicor tilbyder også Epicor Automation Studio, som virksomheden beskriver som “a low-code app for integration-led automations” (en low-code-app til automatisering baseret på integrationer). Undgå direkte databaseadgang: REST, BAQs og funktioner fungerer ens lokalt og på Kinetic Cloud.

Epicor dokumenterer ikke noget generelt API til udgående webhooks. Derfor overføres ændringer i Kinetic til SkyPlanner på en af to måder:

• Hændelsesstyret. Et BPM Data Directive på JobHead eller JobOper kalder en Epicor Function, som sender den ændrede produktionsordre til SkyPlanners REST API.
• Planlagt polling. En BAQ, der filtrerer på ændringsdato, køres med få minutters mellemrum eller hver time. Denne løsning er enklere at drive og genoprette efter fejl.

I den modsatte retning sender SkyPlanner status- og planændringer via sine webhooks. Jeres middleware eller et EFx-endpoint modtager dem og skriver til Kinetic.

1. Førstegangsindlæsning af stamdata. Hent varer, ressourcegrupper, ressourcer, kapabiliteter, kalendere og medarbejdere. Opret arbejdsstationer i SkyPlanner ud fra Kinetic-ressourcer og arbejdsstationsgrupper ud fra ressourcegrupper. Opdel store dataudtræk i sider med $top og $skip, eller hent store datamængder via en BAQ.

2. Ordresynkronisering. Send frigivne og fastlagte produktionsordrer med deres operationer og materialer. Hent hele ordrestrukturen med GetDatasetForTree eller en BAQ, ikke én entitet ad gangen. Lad ikke-fastlagte MRP-ordrer blive i Kinetic, indtil de er fastlagt. Synkronisér åbne delleverancer på indkøbsordrer med deres leveringsdatoer, samtidig med at lagerbeholdningen hentes. SkyPlanner betragter bestilte materialer som tilgængelige på leveringsdatoen og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered. Planlægningen kontrollerer dermed både lagerbeholdningen og kommende materialeleverancer fra indkøb.

3. Tilbageskrivning af planen. SkyPlanners webhook sender planlagt start, slut og arbejdsstation for hver operation til et EFx-endpoint (/api/v2/efx/{Company}/{Library}/{Function}). Funktionen skriver via Kinetics planlægningsmotor, som er det samme forretningsobjekt, der ligger bag planlægningen i Job Entry og på planlægningstavlerne (eksempel fra brugerforummet):

1. ScheduleEngine.GetNewParamsForJob opretter planlægningsmotorens datasæt for produktionsordren.
2. Funktionen angiver produktionsordrenummer, montage- og operationssekvens samt planlagt startdato og -tidspunkt og kalder derefter ScheduleEngine.MoveJobItem.
3. Hvis SkyPlanner har placeret operationen på en anden ressource i gruppen, flytter ScheduleEngine.ChangeResource den dertil. MoveJobItem alene beholder gruppens standardressource.
4. Funktionen låser produktionsordrens plan (JobHead.SchedLocked, indstillingen Lock i Job Entry), så Global Scheduling bevarer SkyPlanners datoer.

Ved at samle disse kald i én Epicor Function bliver skrivningen atomar pr. produktionsordre, og du kan tilføje din egen validering. Hvis virksomheden foretrækker at undgå en tilpasset funktion, kan den samme sekvens køres som direkte REST-kald til Erp.BO.ScheduleEngineSvc. Skriv aldrig direkte til ResourceTimeUsed eller datofelter i JobOper: Det omgår motoren, så allokeringerne på planlægningstavlen ikke længere stemmer.

4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejde i SkyPlanner med Mobile Confirmations, Production Timer eller Quick Log Mode. Hver afsluttet tidsregistrering bliver til en arbejdsregistrering i Kinetic via Erp.BO.LaborSvc: StartActivity og EndActivityByEmp til løbende registrering eller Labors med Update til efterregistrering. Hvis virksomheden kræver godkendelse, skal submitForApproval med i både forløbet og adgangsomfanget.

5. Dataejerskab og konfliktregler. Skriv dem ned før idriftsættelsen:

Produktionsordrer, som SkyPlanner planlægger, har en planlægningslås, så Global Scheduling ikke ændrer deres datoer. Behold Kinetics planlægning for de ressourcer, SkyPlanner ikke planlægger.

Implementeringen afsluttes normalt inden for få uger efter opstarten. Et Kinetic-projekt omfatter:

1. En prøveperiode på 30 dage med CSV- eller Excel-eksporter af produktionsordrer, operationer og ressourcer, før udviklingsarbejdet begynder.
2. API-nøgle, adgangsomfang, en særskilt integrationsbruger og de BAQs, integrationen læser.
3. Mapping af stamdata: kapabiliteter, ressourcegrupper, ressourcer, kalendere og medarbejdere knyttes til arbejdsstationer, grupper, skift og personale i SkyPlanner.
4. Førstegangsindlæsning af varer, fremstillingsmetoder (BOM og operationer) og ressourcer.
5. Synkronisering af produktionsordrer og indkøbsordrer (leveringsdatoer i PORel) samt lagerbeholdning fra PartWhse.
6. Tilbageskrivning af planlagte operationsdatoer via ScheduleEngineSvc (MoveJobItem, ChangeResource) i en Epicor Function, hvor produktionsordrens plan låses.
7. Tilbagemeldinger fra produktionen bogføres som arbejdsregistreringer via LaborSvc.
8. Test parallelt med den eksisterende Kinetic-plan og derefter idriftsættelse.

Ingen fabrikker bruger Kinetic helt ens. Ruter baseret på kapabiliteter, ressourcegruppernes kalendere, BAQ-design, BPM-direktiver og versionsspecifikke metoder til tilbageskrivning varierer fra fabrik til fabrik. Den korrekte opsætning gør forskellen mellem en plan, planlæggerne stoler på, og en, de må lave om.

1. SkyPlanner-teamet opsætter integrationen under opstarten og yder support efter idriftsættelsen. Teamet mapper jeres ressourcer, produktionsordrer og leveranceplanlinjer på indkøbsordrer og opsætter BAQ-læsninger, BPM-triggere og funktionen til tilbageskrivning. Teamet forbinder SkyPlanners REST API og webhooks med Kinetic REST v2. Supporten fortsætter, når jeres BAQs, BPMs eller Kinetic-version ændres.
2. Jeres Epicor-partner. Partnere, der allerede udvikler BAQs, BPMs og Epicor Functions, kan arbejde med det samme dokumenterede SkyPlanner REST API, som læser og skriver ordrer, produkter, materialer, procestrin og tidsregistreringer.
3. Jeres egne udviklere. Interne teams med erfaring i Kinetic REST kan bygge integrationen direkte eller i Automation Studio, hvis I bruger det. En SkyPlanner-API-nøgle er nok til at komme i gang (integrationsvejledning), og SkyPlanner-teamet hjælper efter behov. Produktdokumentationen er offentligt tilgængelig i SkyPlanners dokumentation.

Det samme integrationsmønster med API og webhooks er i drift med andre ERP-systemer, for eksempel hos UTU. Hos Laboratory & Allied byggede det interne IT-team i vid udstrækning selv integrationen til SAP Business One med hjælp fra SkyPlanner.

Uanset hvem der bygger integrationen, er starten den samme: Brug først den gratis prøveperiode på 30 dage med CSV-import, afprøv planen, og byg derefter integrationen. Prisen er fra 199 € pr. måned med 5 arbejdsstationer, månedlig fakturering og mulighed for at opsige når som helst. I får på forhånd et tilbud på integrationen tilpasset jeres processer og behov sammen med abonnementet, så I kender den samlede pris, før I starter.