Integrasjonsguide for Epicor Kinetic – produksjonsplanlegging med SkyPlanner APS

Epicor opplyser: «All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.» (Alle Kinetic-tjenester, inkludert forretningsobjekter, prosesser, rapporter, BAQ-er og Epicor Functions, er tilgjengelige via REST-endepunkter.) En integrasjon for produksjonsplanlegging bygger på fire Epicor-teknologier:

1. Kinetic REST API v2 (OData v4). Forretningsobjekter gjøres tilgjengelige som tjenester med navnet Erp.BO.<Name>Svc. Den vanlige stien er /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 finnes fortsatt, men er en eldre versjon, så bygg på v2. Kontroller hvilke entitetssett og metoder som finnes i din versjon, i REST Help på /api/help/v2/.
2. Business Activity Queries (BAQ) via REST. En BAQ gjøres tilgjengelig på /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Dette er en praktisk måte å lese ut planleggingsdata på, der JobHead, JobOper, JobMtl, PartWhse og PORel kobles sammen i ett kall (eksempel fra brukerforumet).
3. Epicor Functions (EFx). Funksjoner på serversiden som kan kalles på /api/v2/efx/{Company}/{Library}/{Function}. Epicor oppgir at de «can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.» (kan utløses fra flere inngangspunkter, blant annet BPM-er, REST-tjenester, tidsplaner og applikasjonshendelser).
4. BPM-direktiver. Method and Data Directives utløses når en jobb eller operasjon endres, og kan kalle en funksjon som sender data ut.

Ved filoverføring håndterer DMT importen, mens BAQ-eksporter håndterer uttrekkene. Epicor tilbyr også Epicor Automation Studio, som selskapet beskriver som «a low-code app for integration-led automations» (en lavkodeapp for integrasjonsdrevet automatisering). Unngå direkte databasetilgang: REST, BAQ-er og funksjoner fungerer likt lokalt og på Kinetic Cloud.

Epicor dokumenterer ikke noe generelt API for utgående webhooks. Endringer i Kinetic når derfor SkyPlanner på én av to måter:

• Hendelsesdrevet. En BPM Data Directive på JobHead eller JobOper kaller en Epicor Function, som sender den endrede jobben til SkyPlanner REST API.
• Planlagt polling. En BAQ filtrert på endringsdato kjøres med noen minutters mellomrom eller hver time. Denne løsningen er enklere å drifte og få i gang igjen etter feil.

I motsatt retning sender SkyPlanner status- og planendringer via webhooks. Mellomvaren deres eller et EFx-endepunkt mottar dem og skriver til Kinetic.

1. Førstegangsinnlasting av grunndata. Les inn artikler, ressursgrupper, ressurser, kapabiliteter, kalendere og ansatte. Opprett arbeidsstasjoner i SkyPlanner fra ressursene i Kinetic, og arbeidsstasjonsgrupper fra ressursgruppene. Del store leseoperasjoner i sider med $top og $skip, eller hent store datamengder gjennom en BAQ.

2. Synkronisering av ordrer. Send frigitte og bekreftede jobber med tilhørende operasjoner og materialer. Hent jobbtreet med GetDatasetForTree eller en BAQ, ikke entitet for entitet. La ubekreftede MRP-jobber bli i Kinetic til de er bekreftet. Synkroniser åpne leveringslinjer på innkjøpsordrer med tilhørende leveringsdatoer samtidig som lagerbeholdningen leses inn. SkyPlanner regner bestilte materialer som tilgjengelige på leveringsdatoen og oppdaterer lagerbeholdningen når innkjøpsordren får statusen Delivered. Dermed tar produksjonsplanen hensyn til både lagerbeholdning og innkommende innkjøp.

3. Tilbakeskriving av produksjonsplanen. SkyPlanners webhook sender planlagt start, slutt og arbeidsstasjon for hver operasjon til et EFx-endepunkt (/api/v2/efx/{Company}/{Library}/{Function}). Funksjonen skriver gjennom planleggingsmotoren i Kinetic, det samme forretningsobjektet som ligger bak planleggingen i Job Entry og planleggingstavlene (eksempel fra brukerforumet):

1. ScheduleEngine.GetNewParamsForJob oppretter datasettet som planleggingsmotoren bruker for jobben.
2. Funksjonen angir jobbnummer, montasje- og operasjonssekvens samt planlagt startdato og klokkeslett, og kaller deretter ScheduleEngine.MoveJobItem.
3. Når SkyPlanner har lagt operasjonen på en annen ressurs i gruppen, flyttes den dit med ScheduleEngine.ChangeResource. MoveJobItem alene beholder gruppens standardressurs.
4. Funksjonen låser jobbens plan (JobHead.SchedLocked, alternativet Lock i Job Entry), slik at Global Scheduling beholder datoene fra SkyPlanner.

Ved å samle disse kallene i én Epicor Function blir skrivingen atomisk per jobb, og du kan legge til egen validering. Hvis anlegget foretrekker å unngå en egendefinert funksjon, kan den samme sekvensen kjøres som direkte REST-kall til Erp.BO.ScheduleEngineSvc. Skriv aldri direkte til ResourceTimeUsed eller datofeltene i JobOper: Det omgår motoren og gjør at tildelingene på planleggingstavlene ikke lenger stemmer.

4. Tilbakemeldinger fra produksjonen. Operatørene registrerer arbeid i SkyPlanner med Mobile Confirmations, Production Timer eller Quick Log Mode. Hver avsluttet tidsregistrering blir en arbeidsregistrering i Kinetic gjennom Erp.BO.LaborSvc: StartActivity og EndActivityByEmp for løpende aktivitet, eller Labors med Update for etterregistreringer. Hvis anlegget krever godkjenning, må submitForApproval tas med i både flyten og tilgangsomfanget.

5. Dataeierskap og konfliktregler. Dokumenter dem før løsningen settes i drift:

Jobber som SkyPlanner planlegger, har planlås, slik at Global Scheduling ikke endrer datoene deres. Behold planleggingen i Kinetic for ressursene SkyPlanner ikke planlegger.

Implementeringen fullføres normalt i løpet av uker etter at oppstartsarbeidet begynner. Et Kinetic-prosjekt omfatter:

1. En 30-dagers prøveperiode med CSV- eller Excel-eksporter av jobber, operasjoner og ressurser, før utviklingsarbeidet starter.
2. API-nøkkel, tilgangsomfang, en egen integrasjonsbruker og BAQ-ene integrasjonen leser.
3. Kobling av grunndata: kapabiliteter, ressursgrupper, ressurser, kalendere og ansatte kobles til arbeidsstasjoner, grupper, skift og personell i SkyPlanner.
4. Førstegangsinnlasting av artikler, produksjonsmetoder (BOM og operasjoner) og ressurser.
5. Synkronisering av jobber og innkjøpsordrer (leveringsdatoer i PORel), samt lagerbeholdning fra PartWhse.
6. Tilbakeskriving av planlagte operasjonsdatoer gjennom ScheduleEngineSvc (MoveJobItem, ChangeResource) i en Epicor Function, med jobbens plan låst.
7. Tilbakemeldinger fra produksjonen overføres som arbeidsregistreringer gjennom LaborSvc.
8. Testing parallelt med den gjeldende planen i Kinetic, deretter produksjonssetting.

Ingen fabrikker bruker Kinetic helt likt. Kapabilitetsbaserte produksjonsruter, ressursgruppekalendere, BAQ-utforming, BPM-direktiver og versjonsavhengige metoder for tilbakeskriving varierer fra anlegg til anlegg. Riktig oppsett er forskjellen på en plan planleggerne stoler på, og en de må omarbeide.

1. SkyPlanner-teamet konfigurerer integrasjonen under oppstarten og gir støtte etter produksjonssetting. Teamet kobler ressursene, jobbene og leveranseplanlinjene for innkjøpsordrer og setter opp BAQ-lesing, BPM-utløsere og funksjonen for tilbakeskriving. Det kobler SkyPlanners REST API og webhooks til Kinetic REST v2. Støtten fortsetter når BAQ-ene, BPM-ene eller Kinetic-versjonen deres endres.
2. Epicor-partneren deres. Partnere som allerede utvikler BAQ-er, BPM-er og Epicor Functions, kan bruke det samme dokumenterte REST API-et fra SkyPlanner. Det leser og skriver ordrer, produkter, materialer, prosesstrinn og timeregistreringer.
3. Deres egne utviklere. Interne team med erfaring fra Kinetic REST kan bygge integrasjonen direkte, eller i Automation Studio hvis dere bruker det. En API-nøkkel fra SkyPlanner er nok til å komme i gang (integrasjonsveiledning), og SkyPlanner-teamet bistår ved behov. Se den offentlig tilgjengelige produktdokumentasjonen fra SkyPlanner.

Det samme mønsteret med API og webhooks er i drift med andre ERP-systemer, for eksempel hos UTU. Hos Laboratory & Allied bygde det interne IT-teamet integrasjonen med SAP Business One i stor grad selv, med hjelp fra SkyPlanner.

Alle alternativene starter på samme måte: Bruk først den gratis prøveperioden på 30 dager med CSV-import, bekreft at planen fungerer, og bygg deretter integrasjonen. Prisen er fra 199 € per måned med 5 arbeidsstasjoner. Abonnementet faktureres månedlig og kan sies opp når som helst. Dere får et pristilbud på integrasjonen på forhånd, tilpasset prosessen og behovene deres, sammen med abonnementet. Dermed ser dere hele kostnaden før dere starter.