Integrationsguide för Epicor Kinetic för produktionsplanering med SkyPlanner APS

Epicor skriver: ”All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Alla Kinetic-tjänster, inklusive affärsobjekt, processer, rapporter, BAQ-frågor och Epicor Functions, är tillgängliga via REST-endpoints.) En integration för produktionsplanering bygger på fyra Epicor-tekniker:

1. Kinetic REST API v2 (OData v4). Affärsobjekt exponeras som tjänster med namnet Erp.BO.<Name>Svc. Den vanliga sökvägen är /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 finns kvar men är en äldre version, så bygg på v2. Kontrollera vilka entitetsuppsättningar och metoder som gäller för din version i REST Help på /api/help/v2/.
2. Business Activity Queries (BAQ) via REST. En BAQ exponeras på /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Det är ett praktiskt sätt att läsa ut planeringsunderlag som sammanför JobHead, JobOper, JobMtl, PartWhse och PORel i ett enda anrop (exempel från användarforumet).
3. Epicor Functions (EFx). Funktioner på serversidan som kan anropas på /api/v2/efx/{Company}/{Library}/{Function}. Epicor skriver att de ”can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (kan utlösas från flera ingångspunkter, bland annat BPM, REST-tjänster, scheman och applikationshändelser).
4. BPM-direktiv. Method Directives och Data Directives utlöses när en tillverkningsorder eller operation ändras och kan anropa en funktion som skickar ut data.

För filöverföring hanterar DMT importen, medan BAQ-exporter används för att hämta ut data. Epicor erbjuder även Epicor Automation Studio, som företaget beskriver som ”a low-code app for integration-led automations” (en lågkodsapp för integrationsdriven automatisering). Undvik direkt databasåtkomst: REST, BAQ-frågor och funktioner fungerar på samma sätt lokalt och i Kinetic Cloud.

Epicor dokumenterar inget generellt API för utgående webhooks. Därför når ändringar i Kinetic SkyPlanner på ett av två sätt:

• Händelsestyrt. Ett BPM Data Directive på JobHead eller JobOper anropar en Epicor Function, som skickar den ändrade tillverkningsordern till SkyPlanners REST API.
• Schemalagd polling. En BAQ-fråga med filter på ändringsdatum körs med några minuters mellanrum eller varje timme. Det är enklare att förvalta och återställa efter fel.

I den andra riktningen skickar SkyPlanner status- och planeringsändringar via sina webhooks. Er mellanprogramvara eller en EFx-endpoint tar emot dem och skriver till Kinetic.

1. Första inläsningen av grunddata. Läs in artiklar, resursgrupper, resurser, förmågor, kalendrar och anställda. Skapa produktionsgrupper i SkyPlanner utifrån resurserna i Kinetic och gruppera dem utifrån resursgrupperna. Använd $top och $skip för att hämta stora datamängder sida för sida, eller hämta större datamängder via en BAQ.

2. Ordersynkronisering. Skicka frisläppta och fastställda tillverkningsorder med tillhörande operationer och material. Hämta hela orderträdet med GetDatasetForTree eller en BAQ, inte entitet för entitet. Låt preliminära MRP-order ligga kvar i Kinetic tills de har fastställts. Synkronisera öppna avrop på inköpsorder och deras leveransdatum samtidigt som lagersaldot läses in. SkyPlanner räknar beställt material som tillgängligt på leveransdagen och uppdaterar lagersaldot när inköpsordern markeras som Delivered. Planeringen tar därmed hänsyn till både lagersaldo och inkommande inköp.

3. Återskrivning av produktionsplanen. SkyPlanners webhook skickar planerad start, sluttid och produktionsgrupp per operation till en EFx-endpoint (/api/v2/efx/{Company}/{Library}/{Function}). Funktionen skriver via Kinetics planeringsmotor, samma affärsobjekt som används för planeringen i Job Entry och på planeringstavlorna (exempel från användarforumet):

1. ScheduleEngine.GetNewParamsForJob skapar planeringsmotorns dataset för tillverkningsordern.
2. Funktionen anger tillverkningsordernummer, sammanbyggnads- och operationssekvens samt planerat startdatum och klockslag och anropar sedan ScheduleEngine.MoveJobItem.
3. När SkyPlanner har lagt operationen på en annan resurs i gruppen flyttar ScheduleEngine.ChangeResource den dit. Enbart MoveJobItem behåller gruppens standardresurs.
4. Funktionen låser tillverkningsorderns planering (JobHead.SchedLocked, alternativet Lock i Job Entry), så att Global Scheduling behåller datumen från SkyPlanner.

Genom att samla anropen i en Epicor Function blir skrivningen atomär per tillverkningsorder, och du kan lägga till egen validering. Om anläggningen föredrar att inte använda en anpassad funktion kan samma sekvens köras som direkta REST-anrop till Erp.BO.ScheduleEngineSvc. Skriv aldrig direkt till ResourceTimeUsed eller datumfälten i JobOper: då kringgås motorn och allokeringarna på planeringstavlan hamnar ur synk.

4. Återrapportering från produktionen. Operatörerna registrerar arbete i SkyPlanner med Mobile Confirmations, Production Timer eller Quick Log Mode. Varje avslutad tidsregistrering blir en arbetsrapportering i Kinetic via Erp.BO.LaborSvc: StartActivity och EndActivityByEmp för pågående arbete, eller Labors med Update för efterhandsregistrering. Om anläggningen kräver godkännande ska submitForApproval ingå i både flödet och behörighetsomfånget.

5. Dataägarskap och konfliktregler. Dokumentera dem före driftsättning:

Tillverkningsorder som SkyPlanner planerar är låsta för omplanering, så Global Scheduling lämnar deras datum oförändrade. Behåll Kinetics planering för de resurser som SkyPlanner inte planerar.

Implementeringen blir normalt klar inom några veckor efter att införandet har startat. Ett Kinetic-projekt omfattar:

1. En 30-dagars provperiod med CSV- eller Excel-exporter av tillverkningsorder, operationer och resurser, innan någon utveckling påbörjas.
2. API-nyckel, åtkomstomfång, ett särskilt integrationskonto och de BAQ-frågor som integrationen läser.
3. Mappning av grunddata: förmågor, resursgrupper, resurser, kalendrar och anställda till arbetsstationer, grupper, skift och personal i SkyPlanner.
4. Initial inläsning av artiklar, tillverkningsmetoder (BOM och operationer) och resurser.
5. Synkronisering av tillverkningsorder och inköpsorder (leveransdatum i PORel) samt lagersaldo från PartWhse.
6. Återskrivning av planerade operationsdatum via ScheduleEngineSvc (MoveJobItem, ChangeResource) i en Epicor Function, med tillverkningsorderns planering låst.
7. Återrapportering från produktionen som registreras som arbetsrapportering via LaborSvc.
8. Testning parallellt med den befintliga Kinetic-planen, följt av driftsättning.

Ingen fabrik använder Kinetic på exakt samma sätt som en annan. Förmågebaserade operationsföljder, resursgruppernas kalendrar, BAQ-utformning, BPM-direktiv och versionsspecifika metoder för återskrivning skiljer sig mellan anläggningar. Hur väl dessa delar fungerar avgör om planerarna litar på planen eller måste arbeta om den.

1. SkyPlanner-teamet konfigurerar integrationen under införandet och ger support efter driftsättningen. Teamet mappar era resurser, tillverkningsorder och avrop på inköpsorder samt konfigurerar BAQ-läsningar, BPM-utlösare och funktionen för återskrivning. Teamet kopplar SkyPlanners REST API och webhooks till Kinetic REST v2. Supporten fortsätter när era BAQ-frågor, BPM-direktiv eller er Kinetic-version ändras.
2. Er Epicor-partner. Partner som redan utvecklar BAQ-frågor, BPM-direktiv och Epicor Functions kan använda samma dokumenterade REST API i SkyPlanner för att läsa och skriva order, produkter, material, processteg och tidsregistreringar.
3. Era egna utvecklare. Interna team med erfarenhet av Kinetic REST kan bygga direkt, eller i Automation Studio om ni använder det. En API-nyckel till SkyPlanner räcker för att komma igång (integrationshandledning), och SkyPlanner-teamet hjälper till vid behov. Produktdokumentationen finns öppet tillgänglig i SkyPlanners dokumentation.

Samma integrationsmönster med API och webhooks används i produktion med andra ERP-system, till exempel hos UTU. Hos Laboratory & Allied byggde det interna IT-teamet integrationen med SAP Business One till stor del på egen hand med hjälp från SkyPlanner.

Alla alternativ börjar på samma sätt: använd först den kostnadsfria provperioden på 30 dagar med CSV-importer, verifiera planen och bygg sedan integrationen. Priset är från 199 € per månad med 5 arbetsstationer. Fakturering sker månadsvis och ni kan säga upp när som helst. Ni får en offert på integrationen i förväg utifrån era processer och behov, tillsammans med ert abonnemang, så att ni ser hela kostnaden innan ni börjar.