Integracije / ERP / JobBOSS²
Vodnik za integracijo JobBOSS² za terminiranje proizvodnje s SkyPlanner APS
Ta vodnik partnerjem in ekipam IT pojasnjuje, kako JobBOSS² podjetja ECI povezati s SkyPlanner APS. SkyPlanner se z JobBOSS² povezuje dvosmerno prek lastnih API-jev podjetja ECI:
- V SkyPlanner se prenašajo Orders in Order Line Items, Order Routings, Estimates, Routings in materiali, Work Centers, Employees, Company Calendar, Job Requirements ter postavke nabavnih naročil.
- Planirani datumi začetka in konca se zapisujejo nazaj v vsak korak Order Routing.
- Če se tako odločite, se lahko evidence časa operaterjev zapisujejo nazaj kot Time Ticket Details.
- SkyPlanner prek webhookov pošilja spremembe terminskega plana takoj, ko se zgodijo.
Ekipa SkyPlanner med uvajanjem prilagodi integracijo vaši namestitvi JobBOSS² in zanjo zagotavlja podporo tudi po prehodu v produkcijsko uporabo. Vodnik je namenjen partnerjem in razvijalcem, ki želijo sodelovati ali sami razvijati rešitve na podlagi dokumentiranega REST API-ja SkyPlanner (referenčna dokumentacija API-ja). Prav to je že storilo podjetje za naročniško proizvodnjo iz ZDA:
Integracijski vmesniki JobBOSS²
ECI svoje API-je za proizvodnjo skupaj s specifikacijami OpenAPI objavlja na spletnem mestu Dokumentacija proizvodnih API-jev ECI. Za terminiranje sta pomembna dva:
- JobBOSS² API (v1). Uporablja REST in JSON ter je namenjen posebej za JobBOSS². Omogoča branje in zapisovanje naročil, Order Line Items, Order Routings, Estimates, Routings, materialov, Job Requirements, Work Centers, Company Calendar, Employees, nabavnih naročil, Time Tickets in Time Ticket Details. ECI navaja: “is currently only supported for JobBOSS² hosted (Cloud) customers.” (Trenutno je podprt le za stranke, ki uporabljajo gostovani JobBOSS² v oblaku.)
- ECI ERP API (v2.1). REST API za Deacom, M1 in JobBOSS², ki ni vezan na posamezen izdelek. Pri JobBOSS² zajema naloge, operacije nalog, materiale za naloge, artikle, operacije artiklov, delovne centre, postavke nabavnih naročil in postavke evidenc časa. ECI pojasnjuje: “the actual ERP database could be a cloud hosted ERP or on premises install,” (podatkovna zbirka ERP je lahko v oblaku ali v lokalni namestitvi), zato je to ustrezna pot za lokalno nameščeni JobBOSS².
Oba API-ja uporabljata enaka pravila: filtrirne izraze, kot je lastModDate[gte]=, parameter fields=, sort= ter razdelitev na strani s parametroma take in skip. Privzeta vrednost parametra take je 200. “All dates submitted to the API are assumed to be in UTC.” (Za vse datume, poslane v API, se predpostavlja čas UTC.)
Za oba velja pravilo ECI: “All APIs must be activated by ECI before use.” (ECI mora pred uporabo aktivirati vse API-je.) Pravočasno se obrnite na svojega skrbnika strank pri ECI.
Avtentikacija in dostop
- Uporabniki API-ja. Integracija uporablja uporabniški račun za API, ustvarjen v konzoli Integration Engine Management Console podjetja ECI. Ta račun določa, do katerega izdelka, stranke in podatkovne zbirke dostopajo klici.
- Poverilnice odjemalca OAuth 2.0. Z ID-jem in skrivnostjo odjemalca pridobite žeton na končni točki za žetone Authentication API. Vsak nadaljnji klic pošlje
Authorization: Bearer [token]. - Obseg dostopa. Uporabniku API-ja dodelite dostop samo do virov, potrebnih za spodnjo preslikovalno tabelo.
Za dostop do REST API-ja SkyPlanner se pristnost preverja z žetonom API (SkyPlanner Settings > API), dokumentacija pa je na voljo v Swagger/OpenAPI. Vodič za integracijo vas popelje skozi prve klice.
Dogodki in periodično preverjanje
Dokumentacija nobenega od API-jev ECI ne opisuje webhookov. Podatki na strani JobBOSS² se preverjajo periodično: Order Line Items, Order Routings in postavke nabavnih naročil filtrirajte po lastModDate od zadnjega zagona ter jih razdelite na strani s take in skip. Pogostost se določi za vsak obrat posebej, od vsakih nekaj minut za naloge do enkrat na uro za zaloge.
SkyPlanner ob spremembi stanja ali terminskega plana pošilja webhooke, zato povratni zapis sprožajo dogodki.
Preslikava podatkov
| Objekt JobBOSS² (vir v JobBOSS² API) | Objekt SkyPlanner | Smer | Pogostost |
|---|---|---|---|
Estimates (/estimates), materiali (/materials) | Izdelki, materiali, struktura izdelka | JobBOSS² → SkyPlanner | Začetni prenos, nato ob spremembah |
Routings (/routings): delovni center, pripravljalni čas, čas cikla, velikost ekipe, stroji za operacijo | Koraki postopka s trajanjem in pripravljalnimi časi | JobBOSS² → SkyPlanner | Začetni prenos, nato ob spremembah |
Work Centers (/work-centers): ure na izmeno, delovanje v izmenah od 1 do 3, delovni dnevi | Delovni centri, skupine delovnih centrov, učinkovitost | JobBOSS² → SkyPlanner | Začetni prenos, nato redko |
Company Calendar (/company-calendars), Employees (/employees) | Izmene, dela prosti dnevi, osebje | JobBOSS² → SkyPlanner | Dnevno ali upravljanje izmen v SkyPlanner |
Orders in Order Line Items (/order-line-items): številka naloga, rok, prioriteta, količina za izdelavo | Naročila z roki in prioritetami | JobBOSS² → SkyPlanner | Preverjanje vsakih nekaj minut |
Order Routings (/order-routings): koraki naloga, stanje, preostale ure | Operacije po korakih postopka | JobBOSS² → SkyPlanner | Preverjanje vsakih nekaj minut |
Job Requirements (/job-requirements), postavke nabavnih naročil (/purchase-order-line-items) | Potrebe po materialu, nabavna naročila po datumu dobave | JobBOSS² → SkyPlanner | Periodično preverjanje, vsako uro ali ob zagonu terminiranja |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Planirani začetek in konec, stroj in operater za vsak korak | SkyPlanner → JobBOSS² | Ob spremembi terminskega plana prek webhooka SkyPlanner |
| Time Ticket Details (POST): nalog, korak, delovni center, zaposleni, pripravljalni čas, čas cikla, število izdelanih in izmetnih kosov, čas začetka in konca | Evidence časa in potrditve operaterjev | SkyPlanner → JobBOSS² | Ob vsaki potrditvi ali po izmenah, če se tako odločite |
| Ni v JobBOSS² | Matrika časov menjav, orodja kot viri z omejeno zmogljivostjo, nadomestni stroji in osebje | Vzdrževanje v SkyPlanner | Nastavitev med uvajanjem |
Pri lokalno nameščenem JobBOSS² se isti objekti berejo prek virov ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers in /purchase-order-lines, evidence časa pa se zapisujejo v /timecard-lines.
Načini integracije
1. Začetni prenos matičnih podatkov. Preberite Estimates, Routings, materiale, Work Centers, Company Calendar in Employees. Premišljeno preslikajte delovne centre: delovni center s štirimi stružnicami postane ena skupina delovnih centrov ali štirje delovni centri, da lahko SkyPlanner določi zaporedje dela za vsak stroj.
2. Sinhronizacija nalogov. Preberite odprte Order Line Items skupaj z njihovimi Order Routings, Job Requirements in odprtimi postavkami nabavnih naročil. SkyPlanner naročeni material obravnava kot razpoložljiv na datum dobave iz nabavnega naročila in posodobi zalogo, ko je naročilo označeno s stanjem Delivered. Izpustite zadržane in zaključene naloge.
3. Povratni zapis terminskega plana. Ko mehanizem razporedi ali premakne korak, webhook SkyPlanner sproži zahtevo PATCH na /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Ta nastavi estimatedStartDate in estimatedEndDate v času UTC ter workCenter in employeeCode, če je SkyPlanner korak premaknil na drug stroj ali ga dodelil drugi osebi. Datumi se zapišejo v korake naloga, ki jih že prikazujejo Whiteboard, Planning Board in Scheduling Advisor.
4. Potrditve iz proizvodnje. Operaterji beležijo delo s SkyPlanner Mobile Confirmations ali Production Timer, evidence časa pa ohranjajo terminski plan ažuren. Sami določite, ali se dejanski časi zapisujejo nazaj v JobBOSS². Če se za to odločite, vsaka potrditev postane Time Ticket Detail s pripravljalnim časom, časom cikla in številom kosov. Sicer zbiranje podatkov ostane v JobBOSS², SkyPlanner pa bere napredek iz Order Routings.
5. Pravila o lastništvu podatkov in reševanju neskladij. Zapišite jih pred prehodom v produkcijsko uporabo:
| Podatki | Lastnik |
|---|---|
| Estimates, Routings, količine, roki, stanje naloga | JobBOSS² |
| Zaporedje korakov, čas začetka in konca, stroj in operater za vsak korak | SkyPlanner |
| Matrika časov menjav, zahteve glede orodij in operaterjev, nadomestni viri | SkyPlanner |
| Izmene in dela prosti dnevi | En sistem, izbran med opredelitvijo obsega |
| Delovni listki, izdaje materiala, prevzemi, obračun stroškov | JobBOSS²; podatki se vnesejo tam ali prenesejo iz evidenc časa SkyPlanner |
Za zapisovanje datumov korakov naloga določite en sistem. SkyPlanner pri nalogih, ki jih terminira, nadomesti prerazporejanje v Whiteboard. Planerji zato delo premikajo v SkyPlanner, datumi pa se prenesejo v JobBOSS².
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem preverite terminski plan v 30-dnevnem brezplačnem preizkusu s podatki Work Centers, tehnološkimi postopki in odprtimi nalogi, izvoženimi iz JobBOSS² v obliki CSV ali Excel.
- Preslikava. Dokončno določite preslikovalno tabelo, pravila o lastništvu podatkov, pogostost sinhronizacije in ali se delovni listki zapisujejo nazaj.
- Dostop prek ECI. ECI prosite, naj aktivira JobBOSS² API ali ERP API in ustvari uporabnika API. Če imate na voljo testno podjetje, preizkusite povezavo z njim.
- Začetni prenos. Estimates, Routings, Work Centers, koledar in zaposleni.
- Sinhronizacija delovnih nalogov in nabavnih naročil. Periodično poizvedovanje s filtri
lastModDate, s pridobivanjem podatkov po straneh in ponovnimi poskusi. - Nastavitev omejitev v SkyPlanner. Matrika časov za pripravo in prehode, orodja, število operaterjev za posamezno operacijo ter nadomestni stroji ali osebje.
- Zapis terminskega plana nazaj v sistem. Klici PATCH za Order Routing, ki jih sprožijo webhooki SkyPlanner, po izbiri pa tudi Time Ticket Details.
- Vzporedno preizkušanje. SkyPlanner uporabljajte vzporedno z obstoječo plansko tablo, primerjajte datume in popravite matične podatke.
- Zagon v živo. Ko se podatki ujemajo, vklopite zapisovanje nazaj v sistem.
Kaj upoštevati pri integraciji z JobBOSS²
- Gostovanje ali lokalna namestitev. JobBOSS² API je namenjen strankam z gostovano rešitvijo. Lokalne namestitve uporabljajo ERP API, ki ima drugačen seznam virov. Način povezave določite v koraku 1.
- Povsod UTC. API bere in zapisuje čas v UTC. Pretvorite ga v lokalni čas obrata, sicer bo začetek ob 7:00 uvrščen ob napačni uri.
- Delovni centri, ki združujejo stroje. Delovni center lahko predstavlja stroj, skupino, celico ali ljudi. Število strojev in velikost ekipe pri vsakem koraku tehnološkega postopka povesta sistemu SkyPlanner, koliko virov korak potrebuje.
- Zunanje storitve. Koraki, pri katerih je namesto delovnega centra naveden dobavitelj, prispevajo k pretočnemu času, ne obremenjujejo pa vaših zmogljivosti. Modelirajte jih kot korake, ki zahtevajo le čas.
- Prekrivanje in koraki brez nadzora. Korake tehnološkega postopka je mogoče označiti za prekrivanje ali izvajanje brez nadzora. Prenesite obe oznaki, da bo delo brez prisotnosti osebja pravilno načrtovano.
- Časovne enote. Pripravljalni časi in časi cikla imajo vsak svoje enote, čas v čakalni vrsti pa pomeni čakanje, ne strojnega časa. Enote pretvorite ob uvozu, sicer bodo vsa trajanja napačna.
- Pridobivanje po straneh. Privzeta stran vsebuje 200 zapisov. Pri vsakem branju pridobite vse strani.
Kdo nastavi integracijo z JobBOSS² in zagotavlja podporo
- Ekipa SkyPlanner integracijo nastavi med uvajanjem in zanjo zagotavlja podporo po zagonu v živo, v okviru dogovorjenih virov in pravil periodičnega poizvedovanja. Vsak proizvodni obrat uporablja JobBOSS² drugače, to poznavanje pa je podlaga za nastavitev integracije.
- Sodeluje lahko tudi vaš partner za JobBOSS². Partner pozna vašo konfiguracijo in lahko skupaj z ekipo SkyPlanner pri ECI uredi aktivacijo API in uporabnika API.
- Vaši razvijalci lahko integracijo nadgradijo prek REST API sistema SkyPlanner z žetonom API. Za začetek zadostuje žeton API, ekipa SkyPlanner pa po potrebi pomaga. Dokumentacija je na voljo na strani Dokumentacija za integracijo s SkyPlanner.
SkyPlanner je na voljo od 199 € na mesec z vključenimi 5 delovnimi centri in mesečnim obračunavanjem. Ponudbo za integracijo pripravimo vnaprej skupaj s ponudbo za vaš paket, glede na vaše procese in potrebe. Oglejte si cenik, terminiranje proizvodnje z upoštevanjem razpoložljivih zmogljivosti za JobBOSS², stran o JobBOSS², funkcije SkyPlanner in pregled integracij s sistemi ERP.
Proizvodna podjetja, ki uporabljajo SkyPlanner
2 hprihranka vsak teden
»S SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za oskrbovalno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri dela, nova čakalna vrsta operacij pa je na proizvodni liniji na voljo v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost v proizvodnji se je povečala za 90%.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90%, priprava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
Več 1.000samodejno terminiranih delovnih nalogov
»Proizvodnjo obvladujemo povsem drugače, naše razumevanje zmogljivosti pa je na povsem drugi ravni.«
Hannu Ryynänen, direktor
Mamec · Industrijska mešala, črpalke in visokotehnološka pogodbena proizvodnja
Na tisoče delovnih nalogov se terminira samodejno, celotna organizacija pa ima vpogled v proizvodnjo v realnem času.
98%zanesljivost dobav, prej približno 50%
»SkyPlanner ima odločilno vlogo pri ohranjanju naše zanesljivosti dobav.«
Hannu Lahtinen, direktor
KJH-Comp · Obdelava pločevine in pogodbena proizvodnja
Zanesljivost dobav se je s približno 50% povečala na kar 98%, za terminiranje pa zdaj namesto dveh zadostuje en vodja.
Pogosta vprašanja
Ali ima JobBOSS² API?
Da. ECI objavlja JobBOSS² API in ERP API, ki ni vezan na posamezen izdelek. Oba temeljita na REST in imata specifikacije OpenAPI. JobBOSS² API strankam z gostovano rešitvijo omogoča branje in zapisovanje naročil, Order Routings, Estimates, Work Centers, nabavnih nalogov in Time Tickets.
Kako se integracija avtenticira v JobBOSS²?
S poverilnicami odjemalca OAuth 2.0. ECI aktivira API, uporabnik API se ustvari v Integration Engine Management Console, vsak klic pa vsebuje žeton Bearer.
Ali JobBOSS² podpira obvestila webhook?
V dokumentaciji API-jev ECI obvestila webhook niso navedena, zato integracija periodično poizveduje v JobBOSS² s filtri lastModDate po urniku, določenem za posamezen obrat. SkyPlanner prek lastnih obvestil webhook pošilja spremembe terminskega plana takoj, ko nastanejo.
Kako se načrtovani datumi zapišejo nazaj v JobBOSS²?
Za vsak korak posebej. SkyPlanner s klicem PATCH posodobi vsak Order Routing s poljema estimatedStartDate in estimatedEndDate, ob premiku koraka na drug stroj ali k drugemu operaterju pa tudi s poljema workCenter in employeeCode.
Naj partner za JobBOSS² predlaga ECI APS ali SkyPlanner?
SkyPlanner, kadar želi stranka v nekaj tednih uvesti terminiranje proizvodnje, ki upošteva razpoložljive zmogljivosti več virov. ECI APS je ločen dodatek, ki ga poganja LYNQ. SkyPlanner se poveže prek lastnega JobBOSS² API podjetja ECI, načrtuje menjave, ekipe, vpenjala in material ter samodejno prilagaja plan. Na voljo je od 199 € na mesec.
Ali lahko SkyPlanner preizkusimo, preden vzpostavimo integracijo?
Da. 30-dnevni brezplačni preizkus podpira do 20 delovnih centrov z uvozom datotek CSV ali Excel iz JobBOSS². Kreditna kartica ni potrebna. Začnite preizkus ali stopite v stik s prodajo za opredelitev obsega integracije.
