Liidestused / ERP / JobBOSS²
JobBOSS² liidestamise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See JobBOSS² liidestamise juhend näitab partneritele ja IT-meeskondadele, kuidas ühendada ECI JobBOSS² SkyPlanner APS-iga. SkyPlanner vahetab JobBOSS²-ga andmeid mõlemas suunas, kasutades ECI enda API-sid:
- SkyPlannerisse loetakse Orders ja Order Line Items, Order Routings, Estimates, Routings ja materjalid, Work Centers, Employees, Company Calendar, Job Requirements ning ostutellimuste read.
- Planeeritud algus- ja lõppkuupäevad kirjutatakse tagasi igale Order Routing etapile.
- Soovi korral saab operaatorite ajakirjed saata tagasi Time Ticket Details kirjetena.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe, kui need toimuvad.
SkyPlanneri meeskond seadistab liidese kasutuselevõtu käigus teie JobBOSS² seadistusele vastavaks ja pakub tuge ka pärast töölerakendamist. See juhend on mõeldud partneritele ja arendajatele, kes soovivad liidestamises osaleda või ise SkyPlanneri dokumenteeritud REST API abil lahendusi luua (API dokumentatsioon). Üks USA tellimustootja ongi seda juba teinud:
JobBOSS² liidestusvõimalused
ECI avaldab oma tootmise API-d koos OpenAPI spetsifikatsioonidega veebilehel ECI tootmise API-de dokumentatsioon. Ajakava koostamisel on olulised kaks API-t:
- JobBOSS² API (v1). Spetsiaalselt JobBOSS² jaoks loodud API kasutab REST-i ja JSON-i. Sellega saab lugeda ja kirjutada järgmisi andmeid: tellimused, Order Line Items, Order Routings, Estimates, Routings, materjalid, Job Requirements, Work Centers, Company Calendar, Employees, ostutellimused, Time Tickets ja Time Ticket Details. ECI märgib: “is currently only supported for JobBOSS² hosted (Cloud) customers.” (Seda toetatakse praegu ainult JobBOSS² pilvemajutuse klientide puhul.)
- ECI ERP API (v2.1). Tootest sõltumatu REST API Deacomi, M1 ja JobBOSS² jaoks. JobBOSS² puhul hõlmab see töid, tööoperatsioone, töömaterjale, detaile, detailide operatsioone, töökeskusi, ostutellimuste ridu ja tööajaarvestuse ridu. ECI märgib, et “the actual ERP database could be a cloud hosted ERP or on premises install,” (ERP andmebaas võib asuda pilves või kohalikus paigalduses), seega sobib see liidestusviis kohapeal majutatud JobBOSS² jaoks.
Mõlemad API-d järgivad samu põhimõtteid: filtritingimused, näiteks lastModDate[gte]=, parameetrid fields= ja sort= ning lehekülgedeks jaotamine parameetritega take ja skip. Parameetri take vaikeväärtus on 200. “All dates submitted to the API are assumed to be in UTC.” (Kõiki API-le saadetud kuupäevi käsitatakse UTC ajas.)
ECI reegel mõlema API kohta: “All APIs must be activated by ECI before use.” (ECI peab kõik API-d enne kasutamist aktiveerima.) Pöörduge selleks aegsasti oma ECI kliendihalduri poole.
Autentimine ja juurdepääs
- API kasutajad. Liides kasutab ECI Integration Engine Management Console’is loodud API kasutajat. API kasutaja määrab, millise toote, kliendi ja andmebaasini päringud jõuavad.
- OAuth 2.0 kliendi autentimisandmed. Kliendi ID ja saladuse abil hangitakse Authentication API tokeni lõpp-punktist token. Seejärel saadetakse iga päringuga
Authorization: Bearer [token]. - Õiguste ulatus. Andke API kasutajale juurdepääs ainult neile ressurssidele, mida allolev vastendustabel nõuab.
SkyPlanneri poolel kasutatakse REST API autentimiseks API tokenit (SkyPlanner Settings > API) ning API on dokumenteeritud Swagger/OpenAPI vormingus. Liidestamise õpetus juhendab esimeste päringute tegemist.
Sündmused ja perioodilised päringud
Kummagi ECI API dokumentatsioon ei kirjelda veebihaake. JobBOSS² poolel tehakse perioodilisi päringuid: Order Line Items, Order Routings ja ostutellimuste read filtreeritakse välja lastModDate järgi alates viimasest käivitusest ning tulemused jaotatakse lehekülgedeks parameetritega take ja skip. Sagedus määratakse iga tootmisettevõtte jaoks eraldi: tööde puhul mõneminutilise intervalliga, laoseisu puhul kord tunnis.
SkyPlanner saadab oleku või ajakava muutumisel veebihaake, seega toimub tagasikirjutamine sündmuste alusel.
Andmete vastendamine
| JobBOSS² objekt (JobBOSS² API ressurss) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Estimates (/estimates), materjalid (/materials) | Tooted, materjalid, tootestruktuur | JobBOSS² → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
Routings (/routings): töökeskus, seadistusaeg, tsükliaeg, meeskonna suurus, tööks vajalikud masinad | Protsessietapid koos kestuste ja seadistusaegadega | JobBOSS² → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
Work Centers (/work-centers): tundide arv vahetuses, töötamine vahetustes 1 kuni 3, tööpäevad | Töökeskused, töökeskuste rühmad, efektiivsusnäitajad | JobBOSS² → SkyPlanner | Esmane laadimine, hiljem harva |
Company Calendar (/company-calendars), Employees (/employees) | Vahetused, puhkepäevad, töötajad | JobBOSS² → SkyPlanner | Iga päev või vahetuste haldamine SkyPlanneris |
Orders ja Order Line Items (/order-line-items): töö number, tähtaeg, prioriteet, valmistatav kogus | Tellimused koos tähtaegade ja prioriteetidega | JobBOSS² → SkyPlanner | Päringud iga mõne minuti järel |
Order Routings (/order-routings): tööetapid, olek, järelejäänud tunnid | Tööd protsessietappide kaupa | JobBOSS² → SkyPlanner | Päringud iga mõne minuti järel |
Job Requirements (/job-requirements), ostutellimuste read (/purchase-order-line-items) | Materjalivajadused, ostutellimused tarnekuupäeva järgi | JobBOSS² → SkyPlanner | Päringud kord tunnis või ajakava koostamise käivitamisel |
Order Routing väljad estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Iga etapi planeeritud algus ja lõpp, masin ning operaator | SkyPlanner → JobBOSS² | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
| Time Ticket Details (POST): töö, etapp, töökeskus, töötaja, seadistusaeg, tsükliaeg, valmis- ja praakdetailide arv, algus- ja lõppaeg | Ajakirjed ja operaatorite kinnitused | SkyPlanner → JobBOSS² | Soovi korral iga kinnituse või vahetuse kohta |
| JobBOSS²-s puudub | Ümberseadistusaegade maatriks, tööriistad piiratud saadavusega ressurssidena, alternatiivsed masinad ja töötajad | Hallatakse SkyPlanneris | Seadistatakse kasutuselevõtu käigus |
Kohapeal majutatud JobBOSS² puhul loetakse samu objekte ERP API ressursside /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers ja /purchase-order-lines kaudu ning ajakirjed saadetakse lõpp-punkti /timecard-lines.
Liidestuse töövood
1. Põhiandmete esmane laadimine. Lugege sisse Estimates, Routings, materjalid, Work Centers, Company Calendar ja Employees. Vastendage töökeskused läbimõeldult: nelja treipingiga töökeskusest saab üks töökeskuste rühm või neli töökeskust, et SkyPlanner koostaks iga masina tööjärjekorra.
2. Tööde sünkroonimine. Lugege sisse avatud Order Line Items koos nende Order Routings ja Job Requirements andmetega ning avatud ostutellimuste read. SkyPlanner käsitab tellitud materjali ostutellimuse tarnekuupäeval kättesaadavana ja uuendab laoseisu, kui ostutellimus märgitakse olekusse Delivered. Jätke ootel ja suletud tööd vahele.
3. Ajakava tagasikirjutamine. Kui planeerimismootor paigutab etapi ajakavasse või muudab selle asukohta, käivitab SkyPlanneri veebihaak PATCH-päringu lõpp-punkti /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Päring määrab väljade estimatedStartDate ja estimatedEndDate väärtused UTC ajas. Kui SkyPlanner viis etapi teisele masinale või töötajale, määrab see ka väljade workCenter ja employeeCode väärtused. Kuupäevad jõuavad nendele tööetappidele, mida Whiteboard, Planning Board ja Scheduling Advisor juba kuvavad.
4. Kinnitused tootmisest. Operaatorid registreerivad tööd SkyPlanner Mobile Confirmations või Production Timer abil ning ajakirjed hoiavad ajakava ajakohasena. Teie valite, kas tegelikud ajad saadetakse tagasi JobBOSS²-sse. Kui jah, luuakse igast kinnitusest Time Ticket Detail kirje koos seadistusaja, tsükliaja ja tükiarvuga. Kui ei, jääb andmete kogumine JobBOSS²-sse ja SkyPlanner loeb töö edenemist Order Routings andmetest.
5. Andmete haldamise ja vastuolude lahendamise reeglid. Pange need enne töölerakendamist kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Estimates, Routings, kogused, tähtajad, töö olek | JobBOSS² |
| Etappide järjekord, algus- ja lõppajad, iga etapi masin ja operaator | SkyPlanner |
| Ümberseadistusaegade maatriks, nõuded tööriistadele ja operaatoritele, alternatiivsed ressursid | SkyPlanner |
| Vahetused ja puhkepäevad | Üks süsteem, mis valitakse ulatuse määramisel |
| Tööaja arvestuslehed, materjalide väljastused, vastuvõtud, kuluarvestus | JobBOSS²; andmed sisestatakse seal või saadetakse SkyPlanneri ajakirjetest |
Valige tööetappide kuupäevade kirjutamiseks üks süsteem. SkyPlanneri ajastatavate tööde puhul asendab see Whiteboardis ajakava muutmist: planeerijad liigutavad töid SkyPlanneris ja kuupäevad edastatakse JobBOSS²-sse.
Projekti tavapärased etapid
Rakendamine lõpeb tavaliselt mõne nädala jooksul pärast kasutuselevõtuprotsessi algust. Enne seda kontrollige ajakava sobivust 30-päevase tasuta prooviperioodi jooksul, kasutades JobBOSS²-st CSV- või Exceli vormingus eksporditud Work Centers andmeid, tehnoloogilisi marsruute ja avatud töid.
- Vastendamine. Leppige kokku vastendustabel, andmete haldamise reeglid, sünkroonimissagedused ja see, kas tööaja arvestuslehed saadetakse tagasi.
- Juurdepääs ECI kaudu. Paluge ECI-l aktiveerida JobBOSS² API või ERP API ja luua API kasutaja. Kui teil on testettevõte, katsetage sellega.
- Esmane andmete laadimine. Estimates, Routings, Work Centers, kalender ja töötajad.
- Tööde ja ostutellimuste sünkroonimine. Perioodilised päringud
lastModDatefiltritega, lehekülgede kaupa lugemine ja korduskatsed. - Piirangute seadistamine SkyPlanneris. Seadistusaegade maatriks, tööriistad, operaatorite arv töö kohta ning alternatiivsed masinad või töötajad.
- Ajakava tagasikirjutamine. SkyPlanneri veebihaakide käivitatud Order Routing PATCH-päringud ning soovi korral ka Time Ticket Details.
- Paralleelne testimine. Kasutage SkyPlannerit senise planeerimistahvli kõrval, võrrelge kuupäevi ja parandage põhiandmed.
- Kasutuselevõtt. Lülitage tagasikirjutamine sisse, kui andmed ühtivad.
Millega JobBOSS² integratsiooni kavandamisel arvestada
- Majutatud või kohapealne lahendus. JobBOSS² API on mõeldud majutatud lahenduse klientidele. Kohapealsed paigaldused kasutavad ERP API-t, mille ressursiloend on teistsugune. Otsustage ühendusviis 1. etapis.
- Kõikjal UTC. API loeb ja kirjutab aegu UTC-s. Teisendage need tehase kohalikku aega, muidu määratakse kell 7:00 algav töö valele kellaajale.
- Töökeskuste taga olevad masinad. Töökeskus võib tähendada masinat, masinarühma, tootmisrakku või inimesi. Tehnoloogilise marsruudi iga etapi masinate arv ja meeskonna suurus näitavad SkyPlannerile, kui palju ressursse etapp vajab.
- Allhanketeenused. Etapid, millel on töökeskuse asemel tarnija, lisavad läbiminekuaega ega koorma teie tootmisvõimsust. Modelleerige need etappidena, millel arvestatakse ainult aega.
- Kattuvad ja järelevalveta etapid. Tehnoloogilise marsruudi etapid saab märkida kattuvaks või järelevalveta tehtavaks. Kandke mõlemad tunnused üle, et mehitamata töö oleks õigesti planeeritud.
- Ajaühikud. Seadistus- ja tsükliaegadel on oma ühikud ning järjekorraaeg on ooteaeg, mitte masina tööaeg. Teisendage ühikud importimisel, muidu on kõik kestused valed.
- Lehekülgede kaupa lugemine. Vaikimisi sisaldab lehekülg 200 kirjet. Kasutage lehekülgede kaupa lugemist iga lugemispäringu puhul.
Kes JobBOSS² integratsiooni seadistab ja toetab
- SkyPlanneri meeskond seadistab integratsiooni juurutamise käigus ja pakub tuge pärast kasutuselevõttu, lähtudes kokkulepitud ressurssidest ja perioodiliste päringute reeglitest. Iga tootmisettevõte kasutab JobBOSS² omamoodi ning seadistamisel arvestatakse just nende eripäradega.
- Ka teie JobBOSS² partner saab osaleda. Partner tunneb teie seadistust ning saab koos SkyPlanneri meeskonnaga korraldada ECI kaudu API aktiveerimise ja API kasutaja loomise.
- Teie arendajad saavad lahendust edasi arendada, kasutades SkyPlanneri REST API-t ja API tokenit. Alustamiseks piisab API tokenist ning vajaduse korral aitab SkyPlanneri meeskond. Integratsiooni dokumentatsiooni leiate SkyPlanneri integratsioonijuhendist.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub iga kuu. Integratsiooni hinnapakkumine koostatakse ette koos paketiga, lähtudes teie protsessist ja vajadustest. Vaadake hindu, JobBOSS² tootmise planeerimist masinate ja töötajate tegeliku võimsuse piires, JobBOSS² lehte, SkyPlanneri funktsioone ja ERP-integratsioonide ülevaadet.
SkyPlannerit kasutavad tootmisettevõtted
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.“
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ja uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise efektiivsust
„Tootmise efektiivsus on kasvanud 90%.“
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise efektiivsus on kasvanud 90% ning kõiki töökeskusi hõlmava optimeeritud plaani koostamine kolmeks kuuks võtab alla 30 minuti.
1 000-dautomaatselt ajakavasse paigutatud töökäsud
„Tootmine on hoopis teistmoodi kontrolli all ja meie ülevaade tootmisvõimsusest on täiesti uuel tasemel.“
Hannu Ryynänen, tegevjuht
Mamec · Tööstuslikud segistid, pumbad ja kõrgtehnoloogiline lepinguline tootmine
Tuhanded töökäsud paigutatakse automaatselt ajakavasse ning kogu organisatsioonil on tootmisest reaalajas ülevaade.
98%tarnekindlus varasema ligikaudu 50% asemel
„SkyPlanneril on meie tarnekindluse hoidmisel otsustav roll.“
Hannu Lahtinen, tegevjuht
KJH-Comp · Lehtmetallist detailide ja koostude valmistamine ning lepinguline tootmine
Tarnekindlus tõusis ligikaudu 50%-lt koguni 98%-ni ning ajakava koostamiseks on nüüd kahe töödejuhataja asemel vaja ühte.
Korduma kippuvad küsimused
Kas JobBOSS²-l on API?
Jah. ECI pakub JobBOSS² API-t ja tooteülest ERP API-t. Mõlemad on REST-liidesed, millel on OpenAPI spetsifikatsioonid. Majutatud lahenduse klientidel võimaldab JobBOSS² API lugeda ja kirjutada tellimuste, ostutellimuste ning objektide Order Routings, Estimates, Work Centers ja Time Tickets andmeid.
Kuidas integratsioon end JobBOSS²-s autendib?
OAuth 2.0 autentimisviisiga client credentials. ECI aktiveerib API, API kasutaja luuakse konsoolis Integration Engine Management Console ja iga päringuga saadetakse Bearer token.
Kas JobBOSS² toetab veebihaake?
ECI API-de dokumentatsioonis veebihaake ei kirjeldata. Seetõttu teeb integratsioon JobBOSS²-sse perioodilisi päringuid lastModDate filtritega, iga tootmisettevõtte jaoks määratud sagedusega. SkyPlanneri enda veebihaagid saadavad ajakava muudatused edasi kohe nende tekkimisel.
Kuidas planeeritud kuupäevad JobBOSS²-sse tagasi kirjutatakse?
Tööetapi kaupa. SkyPlanner uuendab iga objekti Order Routing PATCH-päringuga, saates väljad estimatedStartDate ja estimatedEndDate. Kui etapp viidi teisele masinale või operaatorile, saadetakse ka workCenter ja employeeCode.
Kas JobBOSS² partner peaks pakkuma ECI APS-i või SkyPlannerit?
SkyPlannerit, kui klient soovib nädalatega kasutusele võtta tootmise planeerimise, mis arvestab mitme ressursi tegelikku võimsust. ECI APS on eraldi lisamoodul, mis põhineb LYNQ-l. SkyPlanner ühendub ECI enda JobBOSS² API kaudu, planeerib ümberseadistusi, meeskondi, rakiseid ja materjale ning koostab ajakava automaatselt ümber. Hind algab 199 € kuus.
Kas saame SkyPlannerit enne integratsiooni loomist katsetada?
Jah. 30-päevase tasuta prooviperioodi jooksul saate kasutada kuni 20 töökeskust ja importida JobBOSS² andmeid CSV- või Exceli failidest. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügiga, et määrata integratsiooni ulatus.
