Ghid de integrare Epicor Kinetic pentru programarea producției cu SkyPlanner APS

Epicor precizează: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Toate serviciile Kinetic, inclusiv obiectele de business, procesele, rapoartele, interogările BAQ și Epicor Functions, sunt accesibile prin endpoint-uri REST.) Integrarea pentru programarea producției se bazează pe patru tehnologii Epicor:

1. Kinetic REST API v2 (OData v4). Obiectele de business sunt expuse ca servicii cu nume de forma Erp.BO.<Name>Svc. Calea uzuală este /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 încă există, dar este o versiune veche, așa că dezvoltați integrarea pe v2. Verificați seturile de entități și metodele disponibile pentru versiunea dumneavoastră în REST Help, la /api/help/v2/.
2. Business Activity Queries (BAQ) prin REST. O interogare BAQ este expusă la /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Aceasta este o modalitate practică de a extrage date pentru planificare, reunind JobHead, JobOper, JobMtl, PartWhse și PORel într-un singur apel (exemplu din comunitate).
3. Epicor Functions (EFx). Funcții executate pe server, care pot fi apelate la /api/v2/efx/{Company}/{Library}/{Function}. Epicor precizează că acestea „can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (pot fi declanșate din mai multe puncte, inclusiv prin BPM, servicii REST, execuții programate și evenimente ale aplicației).
4. Directive BPM. Method Directives și Data Directives se declanșează când se modifică o comandă de producție sau o operație și pot apela o funcție care transmite datele către exterior.

Pentru transferul prin fișiere, DMT gestionează importurile, iar exporturile BAQ asigură extragerea datelor. Epicor oferă și Epicor Automation Studio, pe care îl descrie astfel: “a low-code app for integration-led automations” (o aplicație low-code pentru automatizări bazate pe integrare). Evitați accesul direct la baza de date: REST, interogările BAQ și funcțiile operează la fel în instalările locale și în Kinetic Cloud.

Epicor nu documentează un API generic pentru webhook-uri de ieșire, așa că modificările din Kinetic ajung în SkyPlanner prin una dintre următoarele două metode:

• Pe bază de evenimente. O directivă BPM Data Directive pentru JobHead sau JobOper apelează o Epicor Function, care trimite comanda de producție modificată către API-ul REST SkyPlanner.
• Interogări periodice. O interogare BAQ filtrată după data modificării rulează la câteva minute sau o dată pe oră. Această variantă este mai simplu de administrat și de repus în funcțiune după o eroare.

În sens invers, SkyPlanner transmite modificările de stare și de program prin propriile webhook-uri. Componenta middleware sau un endpoint EFx le primește și le scrie în Kinetic.

1. Încărcarea inițială a nomenclatoarelor. Citiți articolele, grupurile de resurse, resursele, capabilitățile, calendarele și angajații. Creați centrele de lucru SkyPlanner pe baza resurselor Kinetic și grupurile de centre de lucru pe baza grupurilor de resurse. Pentru volume mari de date, folosiți paginarea cu $top și $skip sau extrageți datele în masă printr-o interogare BAQ.

2. Sincronizarea comenzilor. Trimiteți comenzile de producție lansate și ferme, împreună cu operațiile și materialele lor. Extrageți structura arborescentă a comenzii cu GetDatasetForTree sau cu o interogare BAQ, nu entitate cu entitate. Lăsați comenzile MRP neconfirmate în Kinetic până când devin ferme. Odată cu citirea stocurilor, sincronizați și pozițiile de livrare deschise ale comenzilor de achiziție, împreună cu termenele lor. SkyPlanner consideră materialele comandate disponibile la data livrării și actualizează stocul când comanda de achiziție este marcată ca Delivered. Astfel, la programare se verifică atât stocurile, cât și materialele care urmează să sosească din achiziții.

3. Scrierea programului de producție înapoi în Kinetic. Webhook-ul SkyPlanner trimite începutul, sfârșitul și centrul de lucru planificate pentru fiecare operație către un endpoint EFx (/api/v2/efx/{Company}/{Library}/{Function}). Funcția scrie datele prin motorul de programare Kinetic, același obiect de business care stă la baza programării din Job Entry și a panourilor de programare (exemplu din comunitate):

1. ScheduleEngine.GetNewParamsForJob construiește setul de date folosit de motorul de programare pentru comanda de producție.
2. Funcția setează numărul comenzii de producție, numerele de secvență ale ansamblului și operației, precum și data și ora de început planificate, apoi apelează ScheduleEngine.MoveJobItem.
3. Dacă SkyPlanner a alocat operația unei alte resurse din grup, ScheduleEngine.ChangeResource o mută pe acea resursă. Folosit singur, MoveJobItem păstrează resursa implicită a grupului.
4. Funcția blochează programarea comenzii de producție (JobHead.SchedLocked, opțiunea Lock din Job Entry), astfel încât Global Scheduling să păstreze datele stabilite de SkyPlanner.

Încapsularea acestor apeluri într-o singură Epicor Function asigură o scriere atomică pentru fiecare comandă de producție și vă permite să adăugați propriile validări. Dacă unitatea de producție preferă să nu folosească o funcție personalizată, aceeași secvență se execută prin apeluri REST directe către Erp.BO.ScheduleEngineSvc. Nu scrieți niciodată direct în ResourceTimeUsed sau în câmpurile de dată din JobOper: astfel ocoliți motorul, iar alocările din panourile de programare se desincronizează.

4. Confirmări din producție. Operatorii înregistrează activitatea în SkyPlanner folosind Mobile Confirmations, Production Timer sau Quick Log Mode. Fiecare înregistrare de timp închisă devine o înregistrare de manoperă în Kinetic prin Erp.BO.LaborSvc: StartActivity și EndActivityByEmp pentru activitatea în timp real sau Labors cu Update pentru înregistrările introduse ulterior. Dacă unitatea de producție impune aprobarea, includeți submitForApproval în flux și în permisiunile acordate.

5. Reguli privind sistemul responsabil de date și soluționarea conflictelor. Documentați-le înainte de intrarea în exploatare:

Comenzile de producție programate de SkyPlanner au programarea blocată, astfel încât Global Scheduling nu le modifică datele. Păstrați programarea din Kinetic pentru resursele pe care SkyPlanner nu le planifică.

Implementarea se finalizează de regulă în câteva săptămâni de la începerea etapei inițiale. Un proiect Kinetic include:

1. O perioadă de testare de 30 de zile, pe baza exporturilor CSV sau Excel cu comenzi de producție, operații și resurse, înainte de orice activitate de dezvoltare.
2. Cheia API, setul de permisiuni de acces, un utilizator dedicat integrării și interogările BAQ pe care integrarea le citește.
3. Maparea nomenclatoarelor: capabilitățile, grupurile de resurse, resursele, calendarele și angajații sunt puse în corespondență cu posturile de lucru, grupurile, schimburile și personalul din SkyPlanner.
4. Încărcarea inițială a articolelor, a metodelor de fabricație (BOM și operații) și a resurselor.
5. Sincronizarea comenzilor de producție și a comenzilor de achiziție (termenele din PORel), precum și a stocurilor din PartWhse.
6. Scrierea datelor planificate ale operațiilor înapoi în Kinetic prin ScheduleEngineSvc (MoveJobItem, ChangeResource), într-o Epicor Function, cu blocarea programării comenzii de producție activată.
7. Înregistrarea confirmărilor din producție ca manoperă prin LaborSvc.
8. Testarea în paralel cu programul curent din Kinetic, urmată de intrarea în exploatare.

Nicio fabrică nu folosește Kinetic exact ca alta. Fluxurile tehnologice bazate pe capabilități, calendarele grupurilor de resurse, structura interogărilor BAQ, directivele BPM și metodele de scriere înapoi specifice fiecărei versiuni diferă de la o unitate la alta. Configurarea lor corectă face diferența dintre un program în care planificatorii au încredere și unul pe care trebuie să-l refacă.

1. Echipa SkyPlanner configurează integrarea în etapa inițială și asigură asistență după intrarea în exploatare. Echipa mapează resursele, comenzile de producție și tranșele de livrare aferente comenzilor de achiziție și configurează citirile BAQ, declanșatoarele BPM și funcția de scriere înapoi. Conectează API-ul REST și webhook-urile SkyPlanner la Kinetic REST v2. Asistența continuă și când se schimbă interogările BAQ, directivele BPM sau versiunea Kinetic.
2. Partenerul dumneavoastră Epicor. Partenerii care dezvoltă deja interogări BAQ, directive BPM și Epicor Functions pot lucra cu același API REST documentat al SkyPlanner, care citește și scrie comenzi, produse, materiale, operații și pontaje.
3. Dezvoltatorii proprii. Echipele interne cu experiență în Kinetic REST pot dezvolta integrarea direct sau în Automation Studio, dacă îl folosiți. O cheie API SkyPlanner este suficientă pentru a începe (tutorial de integrare), iar echipa SkyPlanner oferă asistență la nevoie. Documentația produsului este disponibilă public în documentația SkyPlanner.

Același model bazat pe API și webhook-uri funcționează în exploatare cu alte sisteme ERP, de exemplu la UTU. La Laboratory & Allied, echipa IT internă a realizat integrarea cu SAP Business One în mare parte pe cont propriu, cu ajutorul SkyPlanner.

Indiferent de variantă, începeți la fel: folosiți mai întâi perioada de testare gratuită de 30 de zile cu importuri CSV, validați programul, apoi realizați integrarea. Prețul pornește de la 199 € pe lună pentru 5 posturi de lucru, cu facturare lunară și posibilitatea de a renunța oricând. Oferta pentru integrare se stabilește de la început, în funcție de procesele și nevoile dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe.