Integracijos / ERP / JobBOSS²
JobBOSS² integravimo vadovas: gamybos tvarkaraščių sudarymas su SkyPlanner APS
Šiame JobBOSS² integravimo vadove partneriams ir IT komandoms paaiškinama, kaip sujungti ECI sistemą JobBOSS² su SkyPlanner APS. SkyPlanner keičiasi duomenimis su JobBOSS² abiem kryptimis per pačios ECI API:
- Į SkyPlanner perduodami Orders ir Order Line Items, Order Routings, Estimates, Routings ir medžiagos, Work Centers, Employees, Company Calendar, Job Requirements bei pirkimo užsakymų eilutės.
- Suplanuotos pradžios ir pabaigos datos grąžinamos į kiekvieną Order Routing operaciją.
- Jei pasirinksite, operatorių darbo laiko įrašai gali būti grąžinami kaip Time Ticket Details.
- SkyPlanner per webhook sąsajas iškart perduoda tvarkaraščio pakeitimus.
Diegimo metu SkyPlanner komanda sukonfigūruoja integraciją pagal jūsų JobBOSS² aplinką, o pradėjus naudoti sistemą teikia jos palaikymą. Šis vadovas skirtas partneriams ir programuotojams, kurie nori prisidėti arba patys kurti sprendimus naudodamiesi dokumentuota SkyPlanner REST API (API žinynas). Viena JAV įmonė, gaminanti pagal užsakymus, jau būtent taip ir padarė:
JobBOSS² integravimo sąsajos
ECI skelbia savo gamybos sistemų API ir jų OpenAPI specifikacijas ECI gamybos sistemų API dokumentacijos svetainėje. Tvarkaraščiams sudaryti svarbios dvi API:
- JobBOSS² API (v1). Tai būtent JobBOSS² skirta API, naudojanti REST ir JSON. Ji leidžia skaityti ir rašyti užsakymus, Order Line Items, Order Routings, Estimates, Routings, medžiagas, Job Requirements, Work Centers, Company Calendar, Employees, pirkimo užsakymus, Time Tickets ir Time Ticket Details. ECI nurodo: „is currently only supported for JobBOSS² hosted (Cloud) customers.” (Šiuo metu palaikoma tik klientams, naudojantiems debesijoje talpinamą JobBOSS².)
- ECI ERP API (v2.1). Tai nuo konkretaus produkto nepriklausanti REST API, skirta Deacom, M1 ir JobBOSS². JobBOSS² sistemoje ji apima užduotis, užduočių operacijas, užduočių medžiagas, detales, detalių operacijas, darbo centrus, pirkimo užsakymų eilutes ir darbo laiko apskaitos eilutes. ECI pažymi: „the actual ERP database could be a cloud hosted ERP or on premises install,” (ERP duomenų bazė gali būti talpinama debesijoje arba įdiegta vietinėje infrastruktūroje), todėl ši sąsaja naudojama vietinėje infrastruktūroje įdiegtai JobBOSS².
Abiejose API taikomos tos pačios taisyklės: filtravimo išraiškos, pvz., lastModDate[gte]=, parametrai fields= ir sort= bei puslapiavimas naudojant take ir skip. Numatytoji take reikšmė yra 200. „All dates submitted to the API are assumed to be in UTC.” (Laikoma, kad visos API pateiktos datos yra UTC laiku.)
Abiem API galioja ECI taisyklė: „All APIs must be activated by ECI before use.” (Prieš naudojimą visas API turi aktyvinti ECI.) Iš anksto kreipkitės į savo ECI klientų vadybininką.
Autentifikavimas ir prieiga
- API naudotojai. Integracijai naudojama API naudotojo paskyra, sukurta ECI Integration Engine Management Console. API naudotojo paskyra apibrėžia, kurį produktą, klientą ir duomenų bazę pasiekia užklausos.
- OAuth 2.0 kliento prisijungimo duomenys. Naudojant kliento ID ir slaptąjį raktą, prieigos raktas gaunamas iš Authentication API prieigos raktų galinio taško. Tada su kiekviena užklausa siunčiama
Authorization: Bearer [token]. - Prieigos apimtis. Suteikite API naudotojui prieigą tik prie išteklių, kurių reikia pagal toliau pateiktą susiejimo lentelę, ir prie jokių kitų.
SkyPlanner pusėje REST API autentifikavimui naudojamas API prieigos raktas (SkyPlanner Settings > API), o dokumentacija pateikiama Swagger/OpenAPI formatu. Integravimo pamokoje nuosekliai paaiškintos pirmosios užklausos.
Įvykiai ir periodinės užklausos
Nė vienos ECI API dokumentacijoje nėra aprašytų webhook pranešimų. JobBOSS² duomenys tikrinami periodinėmis užklausomis: Order Line Items, Order Routings ir pirkimo užsakymų eilutės filtruojamos pagal lastModDate nuo paskutinio patikrinimo, o puslapiavimui naudojami take ir skip. Dažnis nustatomas kiekvienai gamybos įmonei atskirai: užduotys gali būti tikrinamos kas kelias minutes, o atsargos – kas valandą.
Pasikeitus būsenai ar tvarkaraščiui, SkyPlanner siunčia webhook pranešimus, todėl duomenų grąžinimą inicijuoja įvykiai.
Duomenų susiejimas
| JobBOSS² objektas (JobBOSS² API išteklius) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
Estimates (/estimates), medžiagos (/materials) | Gaminiai, medžiagos, gaminio struktūra | JobBOSS² → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
Routings (/routings): darbo centras, paruošimo laikas, ciklo trukmė, komandos dydis, užduočiai skirtos staklės | Proceso operacijos su trukme ir paruošimo laiku | JobBOSS² → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
Work Centers (/work-centers): valandos per pamainą, darbas 1–3 pamainose, darbo dienos | Darbo centrai, darbo centrų grupės, efektyvumo rodikliai | JobBOSS² → SkyPlanner | Pradinis įkėlimas, vėliau – retai |
Company Calendar (/company-calendars), Employees (/employees) | Pamainos, nedarbo dienos, darbuotojai | JobBOSS² → SkyPlanner | Kasdien arba pamainos tvarkomos SkyPlanner sistemoje |
Orders ir Order Line Items (/order-line-items): užduoties numeris, įvykdymo terminas, prioritetas, gamintinas kiekis | Užsakymai su įvykdymo terminais ir prioritetais | JobBOSS² → SkyPlanner | Periodinės užklausos kas kelias minutes |
Order Routings (/order-routings): užduoties operacijos, būsena, likusios valandos | Kiekvienos proceso operacijos užduotys | JobBOSS² → SkyPlanner | Periodinės užklausos kas kelias minutes |
Job Requirements (/job-requirements), pirkimo užsakymų eilutės (/purchase-order-line-items) | Medžiagų poreikis, pirkimo užsakymai pagal pristatymo datą | JobBOSS² → SkyPlanner | Periodinės užklausos kas valandą arba sudarant tvarkaraštį |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Kiekvienos operacijos suplanuota pradžia ir pabaiga, staklės ir operatorius | SkyPlanner → JobBOSS² | Pasikeitus tvarkaraščiui, per SkyPlanner webhook pranešimą |
| Time Ticket Details (POST): užduotis, operacija, darbo centras, darbuotojas, paruošimo laikas, ciklo trukmė, pagamintų ir brokuotų vienetų skaičius, pradžios ir pabaigos laikas | Darbo laiko įrašai ir operatorių patvirtinimai | SkyPlanner → JobBOSS² | Po kiekvieno patvirtinimo arba pamainos, jei pasirinkta |
| JobBOSS² sistemoje nėra | Perderinimo laikų matrica, riboto prieinamumo įrankiai, alternatyvios staklės ir darbuotojai | Tvarkoma SkyPlanner sistemoje | Sukonfigūruojama diegimo metu |
Vietinėje infrastruktūroje įdiegtos JobBOSS² atveju tie patys objektai skaitomi per ERP API išteklius /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers ir /purchase-order-lines, o darbo laiko įrašai siunčiami į /timecard-lines.
Integravimo modeliai
1. Pradinis pagrindinių duomenų įkėlimas. Nuskaitykite Estimates, Routings, medžiagas, Work Centers, Company Calendar ir Employees. Apgalvotai susiekite darbo centrus: darbo centras su keturiomis tekinimo staklėmis tampa viena darbo centrų grupe arba keturiais darbo centrais, kad SkyPlanner sudarytų kiekvienų staklių darbų seką.
2. Užduočių sinchronizavimas. Nuskaitykite neužbaigtus Order Line Items su jų Order Routings, Job Requirements ir neužbaigtomis pirkimo užsakymų eilutėmis. SkyPlanner laiko užsakytas medžiagas prieinamomis pirkimo užsakymo pristatymo dieną ir atnaujina atsargas, kai pirkimo užsakymui suteikiama būsena Delivered. Praleiskite sustabdytas ir užbaigtas užduotis.
3. Tvarkaraščio grąžinimas. Kai planavimo algoritmas suplanuoja arba perkelia operaciją, SkyPlanner webhook pranešimas inicijuoja PATCH užklausą į /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Ja nustatomos estimatedStartDate ir estimatedEndDate reikšmės UTC laiku, o jei SkyPlanner priskyrė operaciją kitoms staklėms ar kitam darbuotojui – ir workCenter bei employeeCode reikšmės. Datos įrašomos į užduočių operacijas, kurios jau rodomos Whiteboard, Planning Board ir Scheduling Advisor.
4. Darbų atlikimo patvirtinimai ceche. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations arba Production Timer, o darbo laiko įrašai padeda palaikyti aktualų tvarkaraštį. Jūs pasirenkate, ar faktinis darbo laikas bus grąžinamas į JobBOSS². Jei taip, kiekvienas patvirtinimas tampa Time Ticket Detail įrašu su paruošimo laiku, ciklo trukme ir vienetų skaičiumi. Jei ne, duomenys ir toliau renkami JobBOSS² sistemoje, o SkyPlanner nuskaito pažangą iš Order Routings.
5. Duomenų valdymo ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami naudoti sistemą:
| Duomenys | Atsakinga sistema |
|---|---|
| Estimates, Routings, kiekiai, įvykdymo terminai, užduoties būsena | JobBOSS² |
| Operacijų seka, pradžios ir pabaigos laikas, kiekvienai operacijai priskirtos staklės ir operatorius | SkyPlanner |
| Perderinimo laikų matrica, įrankių ir operatorių poreikis, alternatyvūs ištekliai | SkyPlanner |
| Pamainos ir nedarbo dienos | Viena sistema, pasirinkta apibrėžiant apimtį |
| Darbo laiko apskaitos įrašai, medžiagų išdavimas, gavimas, savikainos skaičiavimas | JobBOSS²: duomenys įvedami joje arba perduodami iš SkyPlanner darbo laiko įrašų |
Pasirinkite vieną sistemą, kuri įrašys užduočių operacijų datas. SkyPlanner suplanuotų užduočių perkėlimas atliekamas nebe Whiteboard, o SkyPlanner sistemoje: planuotojai joje perkelia darbus, o datos perduodamos į JobBOSS².
Įprasti projekto etapai
Diegimas paprastai užbaigiamas per kelias savaites nuo įvadinio parengimo pradžios. Prieš tai patikrinkite tvarkaraštį per 30 dienų nemokamą bandomąjį laikotarpį, naudodami iš JobBOSS² CSV arba Excel formatu eksportuotus Work Centers, technologinius maršrutus ir neužbaigtas užduotis.
- Susiejimas. Patvirtinkite duomenų susiejimo lentelę, duomenų valdymo taisykles, sinchronizavimo dažnį ir tai, ar darbo laiko apskaitos įrašai bus grąžinami.
- ECI prieiga. Paprašykite ECI aktyvinti JobBOSS² API arba ERP API ir sukurti API naudotoją. Jei turite bandomąją įmonę, bandymus atlikite joje.
- Pradinis duomenų įkėlimas. Estimates, Routings, Work Centers, kalendorius ir darbuotojai.
- Užduočių ir pirkimo užsakymų sinchronizavimas. Periodinės užklausos su
lastModDatefiltrais, duomenų skaitymas puslapiais ir pakartotiniai bandymai. - Apribojimų nustatymas SkyPlanner sistemoje. Perderinimo laikų matrica, įrankiai, kiekvienai užduočiai reikalingas operatorių skaičius ir alternatyvios staklės ar darbuotojai.
- Tvarkaraščio grąžinimas. SkyPlanner webhook pranešimai inicijuoja Order Routing PATCH užklausas, o pasirinkus – ir Time Ticket Details įrašymą.
- Lygiagretus testavimas. Naudokite SkyPlanner kartu su dabartine planavimo lenta, palyginkite datas ir pataisykite pagrindinius duomenis.
- Paleidimas. Kai duomenys sutaps, įjunkite duomenų grąžinimą.
Į ką atsižvelgti planuojant JobBOSS² integraciją
- Paslaugos teikėjo ar vietiniuose serveriuose. JobBOSS² API skirta klientams, kurių sistema veikia paslaugos teikėjo serveriuose. Vietiniuose serveriuose įdiegtos sistemos naudoja ERP API, kurios išteklių sąrašas skiriasi. Integracijos būdą pasirinkite 1 žingsnyje.
- Visur naudojamas UTC. API nuskaito ir įrašo laiką pagal UTC. Konvertuokite jį į gamyklos vietos laiką, kitaip 7:00 numatyta pradžia bus įrašyta nurodant neteisingą valandą.
- Darbo centras nebūtinai reiškia vienas stakles. Darbo centras gali būti staklės, jų grupė, gamybos celė arba darbuotojai. Kiekvienoje technologinio maršruto operacijoje nurodytas staklių skaičius ir komandos dydis leidžia SkyPlanner nustatyti, kiek išteklių reikia tai operacijai.
- Išorės paslaugos. Operacijos, kurioms vietoj darbo centro nurodytas tiekėjas, lemia užsakymo įvykdymo laiką, bet neapkrauna jūsų pajėgumų. Modeliuokite jas kaip operacijas, kurioms taikoma tik trukmė.
- Persidengiančios ir be priežiūros vykdomos operacijos. Technologinio maršruto operacijas galima pažymėti kaip persidengiančias arba vykdomas be priežiūros. Perkelkite abi žymas, kad darbas be operatorių būtų suplanuotas teisingai.
- Laiko vienetai. Paruošimo ir ciklo laikai turi atskirus matavimo vienetus, o laukimo eilėje laikas nėra staklių darbo laikas. Importuodami konvertuokite vienetus, kitaip visos trukmės bus neteisingos.
- Skaitymas puslapiais. Pagal numatytąsias nuostatas puslapyje yra 200 įrašų. Kiekvieną kartą skaitydami duomenis naudokite puslapiavimą.
Kas konfigūruoja ir prižiūri JobBOSS² integraciją
- SkyPlanner komanda sukonfigūruoja integraciją diegimo metu ir prižiūri ją po paleidimo, laikydamasi sutartos išteklių apimties ir periodinių užklausų taisyklių. Kiekviena gamybos įmonė JobBOSS² naudoja savaip, todėl čia svarbios žinios apie konkrečios įmonės darbą.
- Gali dalyvauti ir jūsų JobBOSS² partneris. Partneris žino jūsų sistemos konfigūraciją ir kartu su SkyPlanner komanda gali suderinti su ECI API aktyvinimą bei API naudotojo sukūrimą.
- Jūsų programuotojai gali plėtoti integraciją naudodami SkyPlanner REST API ir API prieigos raktą. Pradėti pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Integracijos dokumentaciją rasite SkyPlanner integracijos dokumentacijos puslapyje.
SkyPlanner kaina prasideda nuo 199 € per mėnesį, įskaitant 5 darbo centrus. Mokama kas mėnesį. Integracijos kaina pagal jūsų procesą ir poreikius pateikiama iš anksto kartu su pasirinkto plano kaina. Žr. kainas, JobBOSS² gamybos planavimą pagal realius staklių ir darbuotojų pajėgumus, JobBOSS² puslapį, SkyPlanner funkcijas ir ERP integracijų apžvalgą.
Gamintojai, naudojantys SkyPlanner
2 hsutaupoma kas savaitę
„Su SkyPlanner nuo gamybos planavimo Excel lentelėse perėjome prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skydai ir skirstymo įranga
Planuojant gamybą kas savaitę sutaupomos 2 darbo valandos, o nauja užduočių eilė gamybos liniją pasiekia per kelias sekundes.
+90%gamybos efektyvumas
„Gamybos efektyvumas padidėjo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas padidėjo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas per mažiau nei 30 minučių.
1 000-iais skaičiuojamiautomatiškai suplanuoti gamybos užsakymai
„Dabar gamybą valdome kitaip, o mūsų supratimas apie pajėgumus pakilo į visiškai kitą lygį.“
Hannu Ryynänen, generalinis direktorius
Mamec · Pramoninės maišyklės, siurbliai ir aukštųjų technologijų sutartinė gamyba
Tūkstančiai gamybos užsakymų suplanuojami automatiškai, o visa organizacija mato gamybos padėtį realiuoju laiku.
98%pristatymo patikimumas, padidėjęs nuo maždaug 50%
„SkyPlanner atlieka lemiamą vaidmenį užtikrinant mūsų pristatymo patikimumą.“
Hannu Lahtinen, vykdomasis direktorius
KJH-Comp · Lakštinio metalo konstrukcijos ir sutartinė gamyba
Pristatymo patikimumas padidėjo nuo maždaug 50% iki net 98%, o tvarkaraščiams sudaryti dabar pakanka vieno meistro vietoj dviejų.
Dažniausiai užduodami klausimai
Ar JobBOSS² turi API?
Taip. ECI teikia JobBOSS² API ir nuo konkretaus produkto nepriklausančią ERP API. Abi yra REST sąsajos su OpenAPI specifikacijomis. Klientams, kurių sistema veikia paslaugos teikėjo serveriuose, JobBOSS² API leidžia skaityti ir įrašyti užsakymus, Order Routings, Estimates, Work Centers, pirkimo užsakymus ir Time Tickets.
Kaip integracija autentifikuojasi JobBOSS² sistemoje?
Naudojami OAuth 2.0 kliento prisijungimo duomenys. ECI aktyvina API, per Integration Engine Management Console sukuriamas API naudotojas, o su kiekviena užklausa perduodamas Bearer prieigos raktas.
Ar JobBOSS² palaiko webhooks?
ECI API dokumentacijoje webhooks nenurodyti, todėl integracija periodiškai siunčia užklausas į JobBOSS² su lastModDate filtrais pagal kiekvienai gamybos įmonei nustatytą dažnį. SkyPlanner webhooks perduoda tvarkaraščio pakeitimus vos jiems įvykus.
Kaip suplanuotos datos įrašomos atgal į JobBOSS²?
Kiekvienai užduoties operacijai atskirai. SkyPlanner PATCH užklausomis atnaujina kiekvieno Order Routing laukus estimatedStartDate ir estimatedEndDate, taip pat workCenter ir employeeCode, jei operacija priskirta kitoms staklėms arba kitam operatoriui.
Ką JobBOSS² partneriui siūlyti – ECI APS ar SkyPlanner?
SkyPlanner, kai klientas nori per kelias savaites pradėti planuoti gamybą atsižvelgdamas į realius kelių rūšių išteklių pajėgumus. ECI APS yra atskiras priedas, veikiantis LYNQ pagrindu. SkyPlanner jungiasi per pačios ECI JobBOSS² API, planuoja perderinimus, brigadas, tvirtinimo įtaisus ir medžiagas, automatiškai perplanuoja, o kaina prasideda nuo 199 € per mėnesį.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti duomenis iš JobBOSS² CSV arba Excel failais. Mokėjimo kortelės nereikia. Pradėkite bandomąjį laikotarpį arba susisiekite su pardavimo komanda, kad apibrėžtumėte integracijos apimtį.
