Integraatiot / ERP / JobBOSS²
JobBOSS²-integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä JobBOSS²-integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten ECI:n JobBOSS² liitetään SkyPlanner APS:ään. SkyPlannerin ja JobBOSS²:n välinen integraatio toimii molempiin suuntiin ECI:n omien rajapintojen kautta:
- SkyPlanneriin tuodaan Orders-, Order Line Items-, Order Routings-, Estimates-, Routings-, Work Centers-, Employees-, Company Calendar- ja Job Requirements -tiedot sekä materiaalit ja ostotilausrivit.
- Suunnitellut alkamis- ja päättymispäivät palautetaan kullekin Order Routing -vaiheelle.
- Halutessasi työntekijöiden aikakirjaukset voidaan palauttaa Time Ticket Details -tietoina.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlanner-tiimi määrittää integraation JobBOSS²-ympäristöösi sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on tarkoitettu kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa integraation itse SkyPlannerin dokumentoidun REST API:n varaan (rajapintakuvaus). Eräs yhdysvaltalainen tilauskonepaja on jo tehnyt juuri näin:
JobBOSS²:n integraatiorajapinnat
ECI julkaisee valmistavan teollisuuden rajapintansa ja niiden OpenAPI-määritykset ECI Manufacturing API Documentation -sivustolla. Tuotannonsuunnittelun kannalta olennaisia on kaksi:
- JobBOSS² API (v1). JobBOSS²:lle tarkoitettu rajapinta, joka käyttää RESTiä ja JSONia. Sen kautta luetaan ja kirjoitetaan tilauksia, Order Line Items-, Order Routings-, Estimates-, Routings-, Job Requirements-, Work Centers-, Company Calendar- ja Employees-tietoja, materiaaleja, ostotilauksia sekä Time Tickets- ja Time Ticket Details -tietoja. ECI:n mukaan se “is currently only supported for JobBOSS² hosted (Cloud) customers.” (on tällä hetkellä tuettu vain JobBOSS²:n pilvipalveluasiakkaille).
- ECI ERP API (v2.1). Tuoteriippumaton REST API Deacom-, M1- ja JobBOSS²-järjestelmille. JobBOSS²:n osalta se kattaa työt, työvaiheet, töiden materiaalit, nimikkeet, nimikkeiden työvaiheet, työpisteet, ostotilausrivit ja tuntikirjausrivit. ECI toteaa, että “the actual ERP database could be a cloud hosted ERP or on premises install,” (varsinainen ERP-tietokanta voi sijaita pilvipalvelussa tai paikallisessa asennuksessa), joten tätä rajapintaa käytetään paikallisesti asennetun JobBOSS²:n kanssa.
Molemmat rajapinnat noudattavat samoja käytäntöjä: suodatuslausekkeet, kuten lastModDate[gte]=, parametrit fields= ja sort= sekä sivutus parametreilla take ja skip. Parametrin take oletusarvo on 200. “All dates submitted to the API are assumed to be in UTC.” (Kaikkien rajapintaan lähetettyjen päivämäärien oletetaan olevan UTC-ajassa.)
ECI:n sääntö koskee molempia: “All APIs must be activated by ECI before use.” (ECI:n on aktivoitava kaikki rajapinnat ennen käyttöä.) Ota yhteyttä ECI:n asiakasvastaavaasi hyvissä ajoin.
Tunnistautuminen ja käyttöoikeudet
- API-käyttäjät. Integraatio käyttää ECI:n Integration Engine Management Console -hallintakonsolissa luotua API-käyttäjää. API-käyttäjä määrittää, mihin tuotteeseen, asiakkaaseen ja tietokantaan kutsut kohdistuvat.
- OAuth 2.0 client credentials. Asiakastunnuksella ja salaisuudella haetaan token Authentication API:n token-päätepisteestä. Sen jälkeen jokaisessa kutsussa lähetetään
Authorization: Bearer [token]. - Käyttöoikeuksien rajaus. Anna API-käyttäjälle pääsy vain alla olevan vastaavuustaulukon edellyttämiin resursseihin.
SkyPlannerin REST API käyttää tunnistautumiseen API-tokenia (SkyPlanner Settings > API), ja se on dokumentoitu Swagger/OpenAPI-muodossa. Integraatio-ohje opastaa ensimmäisten kutsujen tekemisessä.
Tapahtumat ja säännölliset kyselyt
Kummankaan ECI-rajapinnan dokumentaatiossa ei kuvata webhookeja. JobBOSS²:n muutokset haetaan säännöllisillä kyselyillä: suodata Order Line Items- ja Order Routings -tiedot sekä ostotilausrivit kentän lastModDate perusteella edellisen ajon jälkeiseltä ajalta ja sivuta tulokset parametreilla take ja skip. Kyselyväli määritetään tuotantolaitoskohtaisesti: töiden tiedot voidaan hakea muutaman minuutin välein ja varastotiedot tunnin välein.
SkyPlanner lähettää webhook-ilmoituksia tilan tai aikataulun muuttuessa, joten tietojen palautus toimii tapahtumapohjaisesti.
Tietojen vastaavuudet
| JobBOSS²-objekti (JobBOSS² API:n resurssi) | SkyPlanner-objekti | Suunta | Siirtoväli |
|---|---|---|---|
Estimates (/estimates), materiaalit (/materials) | Tuotteet, materiaalit, tuoterakenne | JobBOSS² → SkyPlanner | Alkutuonti, sen jälkeen muutosten yhteydessä |
Routings (/routings): työpiste, asetusaika, jaksoaika, ryhmäkoko, työn koneet | Työvaiheet kestoineen ja asetusaikoineen | JobBOSS² → SkyPlanner | Alkutuonti, sen jälkeen muutosten yhteydessä |
Work Centers (/work-centers): tunnit vuoroa kohden, käytössä olevat vuorot 1–3, työpäivät | Työpisteet, työpisteryhmät, tehokkuudet | JobBOSS² → SkyPlanner | Alkutuonti, sen jälkeen harvoin |
Company Calendar (/company-calendars), Employees (/employees) | Työvuorot, vapaapäivät, henkilöstö | JobBOSS² → SkyPlanner | Päivittäin, tai työvuorot ylläpidetään SkyPlannerissa |
Orders ja Order Line Items (/order-line-items): työnumero, määräpäivä, prioriteetti, valmistettava määrä | Tilaukset määräpäivineen ja prioriteetteineen | JobBOSS² → SkyPlanner | Kysely muutaman minuutin välein |
Order Routings (/order-routings): työvaiheet, tila, jäljellä olevat tunnit | Työvaihekohtaiset työt | JobBOSS² → SkyPlanner | Kysely muutaman minuutin välein |
Job Requirements (/job-requirements), ostotilausrivit (/purchase-order-line-items) | Materiaalitarpeet, ostotilaukset toimituspäivän mukaan | JobBOSS² → SkyPlanner | Kysely tunnin välein tai suunnitteluajon yhteydessä |
Order Routing: estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Suunniteltu alku ja loppu sekä kone ja työntekijä vaihekohtaisesti | SkyPlanner → JobBOSS² | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
| Time Ticket Details (POST): työ, vaihe, työpiste, työntekijä, asetusaika, jaksoaika, valmistuneet ja hylätyt kappaleet, alkamis- ja päättymisaika | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → JobBOSS² | Kuittaus- tai vuorokohtaisesti, jos käytössä |
| Ei JobBOSS²:ssa | Asetusaikamatriisi, työkalut rajallisen kapasiteetin resursseina, vaihtoehtoiset koneet ja työntekijät | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Paikallisesti asennetussa JobBOSS²:ssa samat objektit luetaan ERP API:n resursseista /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers ja /purchase-order-lines. Aikakirjaukset lähetetään resurssiin /timecard-lines.
Integraation toteutustavat
1. Perustietojen alkutuonti. Lue Estimates-, Routings-, Work Centers-, Company Calendar- ja Employees-tiedot sekä materiaalit. Määritä työpisteiden vastaavuudet huolellisesti: neljä sorvia sisältävä työpiste mallinnetaan yhdeksi työpisteryhmäksi tai neljäksi työpisteeksi, jotta SkyPlanner suunnittelee kunkin koneen työjärjestyksen.
2. Töiden synkronointi. Lue avoimet Order Line Items -tiedot ja niihin liittyvät Order Routings- ja Job Requirements -tiedot sekä avoimet ostotilausrivit. SkyPlanner käsittelee tilatun materiaalin käytettävissä olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilauksen tilaksi merkitään Delivered. Ohita pidossa olevat ja suljetut työt.
3. Aikataulun palautus. Kun suunnittelumoottori sijoittaa tai siirtää vaiheen, SkyPlannerin webhook käynnistää PATCH-kutsun osoitteeseen /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Kutsu asettaa kentät estimatedStartDate ja estimatedEndDate UTC-ajassa sekä kentät workCenter ja employeeCode, jos SkyPlanner siirsi vaiheen toiselle koneelle tai työntekijälle. Päivämäärät tallentuvat työvaiheille, jotka näkyvät jo Whiteboard-, Planning Board- ja Scheduling Advisor -toiminnoissa.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työt SkyPlanner Mobile Confirmations- tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Päätät itse, palautetaanko toteutuneet ajat JobBOSS²:een. Jos palautetaan, kustakin kuittauksesta muodostuu Time Ticket Detail, joka sisältää asetusajan, jaksoajan ja kappalemäärät. Jos ei palauteta, tiedonkeruu jää JobBOSS²:een ja SkyPlanner lukee töiden etenemisen Order Routings -tiedoista.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäytön aloitusta:
| Tiedot | Omistaja |
|---|---|
| Estimates, Routings, määrät, määräpäivät, työn tila | JobBOSS² |
| Vaiheiden järjestys, alkamis- ja päättymisajat, kone ja työntekijä vaihekohtaisesti | SkyPlanner |
| Asetusaikamatriisi, työkalu- ja työntekijävaatimukset, vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot ja vapaapäivät | Yksi määrittelyssä valittu järjestelmä |
| Tuntikirjaukset, materiaalien otot, vastaanotot, kustannuslaskenta | JobBOSS²: tiedot kirjataan siellä tai siirretään SkyPlannerin aikakirjauksista |
Valitse vain yksi järjestelmä kirjoittamaan työvaiheiden päivämäärät. SkyPlanner korvaa Whiteboardissa tehtävän uudelleensuunnittelun niiden töiden osalta, jotka se suunnittelee. Suunnittelijat siis siirtävät töitä SkyPlannerissa, ja päivämäärät siirtyvät JobBOSS²:een.
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä viikkojen kuluessa käyttöönoton aloittamisesta. Tarkista sitä ennen aikataulun toimivuus 30 päivän maksuttomalla kokeilujaksolla. Käytä JobBOSS²:sta CSV- tai Excel-muodossa vietyjä Work Centers -tietoja, reitityksiä ja avoimia töitä.
- Tietojen vastaavuudet. Sovi taulukon mukaisista tietojen vastaavuuksista, tietojen omistajuussäännöistä, synkronointiväleistä ja siitä, siirretäänkö tuntikirjaukset takaisin.
- ECI:n käyttöoikeudet. Pyydä ECI:tä aktivoimaan JobBOSS² API tai ERP API ja luomaan API-käyttäjä. Testaa testiympäristön yritystiedoilla, jos sellaiset ovat käytettävissä.
- Alkulataus. Estimates, Routings, Work Centers, kalenteri ja työntekijät.
- Töiden ja ostotilausten synkronointi. Pollaus
lastModDate-suodattimilla, sivutus ja uudelleenyritykset. - Rajoitteiden määrittely SkyPlannerissa. Asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai työntekijät.
- Suunnitelman takaisinkirjoitus. SkyPlannerin webhookien käynnistämät Order Routing PATCH -kutsut sekä Time Ticket Details, jos se on valittu mukaan.
- Rinnakkaistestaus. Käytä SkyPlanneria nykyisen suunnittelutaulun rinnalla, vertaa päivämääriä ja korjaa perustiedot.
- Tuotantokäyttöön siirtyminen. Ota takaisinkirjoitus käyttöön, kun tiedot täsmäävät.
Mitä JobBOSS²-integraation suunnittelussa on huomioitava
- Palveluna vai paikallisesti. JobBOSS² API on tarkoitettu palveluna tarjottavan version asiakkaille. Paikalliset asennukset käyttävät ERP API -rajapintaa, jonka resurssivalikoima on erilainen. Valitse toteutustapa vaiheessa 1.
- UTC kaikkialla. API lukee ja kirjoittaa ajat UTC-muodossa. Muunna ajat tehtaan paikalliseen aikaan, tai kello 7:00 alkava työ merkitään väärään kellonaikaan.
- Työpisteen taakse voi kätkeytyä useita koneita. Työpiste voi olla kone, ryhmä, solu tai joukko työntekijöitä. Kunkin reititysvaiheen konemäärä ja tiimin koko kertovat SkyPlannerille, kuinka monta resurssia vaihe tarvitsee.
- Alihankintapalvelut. Vaiheet, joille on määritetty toimittaja työpisteen sijaan, vaikuttavat läpimenoaikaan eivätkä käytä omaa kapasiteettiasi. Mallinna ne vaiheiksi, joilla on vain kesto.
- Limittäiset ja miehittämättömät vaiheet. Reititysvaiheet voidaan merkitä limittäisiksi tai miehittämättömiksi. Siirrä molemmat merkinnät, jotta miehittämätön tuotanto suunnitellaan oikein.
- Aikayksiköt. Asetus- ja jaksoajoilla on omat yksikkönsä, ja jonotusaika on odotusta, ei koneaikaa. Muunna yksiköt tuonnin yhteydessä, tai kaikki kestot ovat väärin.
- Sivutus. Oletusarvoisesti sivulla on 200 tietuetta. Käytä sivutusta jokaisessa haussa.
Kuka määrittää JobBOSS²-integraation ja vastaa sen tuesta
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen, sovittujen resurssien ja pollaussääntöjen mukaisesti. Jokainen tuotantolaitos käyttää JobBOSS²:ta omalla tavallaan, ja määrityksissä hyödynnetään tämän käyttötavan tuntemusta.
- JobBOSS²-kumppanisi voi osallistua. Kumppani tuntee ympäristösi ja voi yhdessä SkyPlanner-tiimin kanssa sopia ECI:n kanssa API:n aktivoinnista ja API-käyttäjän luomisesta.
- Omat kehittäjäsi voivat jatkokehittää ratkaisua SkyPlannerin REST API -rajapinnan kautta API-tunnuksella. Alkuun pääsee pelkällä API-tunnuksella, ja SkyPlanner-tiimi auttaa tarvittaessa. Integraation ohjeet löydät SkyPlannerin integraatiodokumentaatiosta.
SkyPlannerin hinta on alkaen 199 € kuukaudessa, ja siihen sisältyy 5 työpistettä. Laskutus tapahtuu kuukausittain. Saat integraatiosta ja SkyPlanner-tilauksesta etukäteen tarjouksen, jossa huomioidaan prosessisi ja tarpeesi. Tutustu hinnastoon, JobBOSS²-hienokuormitukseen, JobBOSS²-sivuun, SkyPlannerin ominaisuuksiin ja ERP-integraatioihin.
SkyPlanneria käyttäviä valmistajia
2 hsäästöä viikossa
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kojeistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa viikossa, ja uusi työjono siirtyy tuotantolinjalle sekunneissa.
+90%tuotannon tehokkuutta
”Tuotannon tehokkuus on kasvanut 90%.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkkeiden valmistus
Tuotannon tehokkuus on kasvanut 90%, ja kaikkien työpisteiden optimoitu suunnitelma kolmeksi kuukaudeksi syntyy alle 30 minuutissa.
1 000:siaautomaattisesti suunniteltuja työmääräimiä
”Tuotanto on aivan eri tavalla hallinnassa, ja ymmärryksemme kapasiteetista on täysin eri tasolla.”
Hannu Ryynänen, toimitusjohtaja
Mamec · Teollisuussekoittimet, pumput ja korkean teknologian sopimusvalmistus
Tuhansia työmääräimiä suunnitellaan automaattisesti, ja koko organisaatiolla on reaaliaikainen näkymä tuotantoon.
98%toimitusvarmuus, lähtötaso noin 50%
”SkyPlannerilla on ratkaiseva rooli toimitusvarmuutemme ylläpitämisessä.”
Hannu Lahtinen, toimitusjohtaja
KJH-Comp · Ohutlevymekaniikka ja sopimusvalmistus
Toimitusvarmuus nousi noin 50%:sta jopa 98%:iin, ja tuotannonsuunnitteluun tarvitaan nyt yksi työnjohtaja kahden sijaan.
Usein kysytyt kysymykset
Onko JobBOSS²:ssa API-rajapinta?
Kyllä. ECI julkaisee JobBOSS² API -rajapinnan ja tuoteriippumattoman ERP API -rajapinnan. Molemmat ovat REST-rajapintoja, joille on OpenAPI-määritykset. JobBOSS² API lukee ja kirjoittaa palveluna tarjottavan version asiakkaiden tilauksia, Order Routings-, Estimates- ja Work Centers -tietoja, ostotilauksia sekä Time Tickets -tietoja.
Miten integraatio tunnistautuu JobBOSS²:een?
OAuth 2.0 client credentials -menetelmällä. ECI aktivoi API:n, API-käyttäjä luodaan Integration Engine Management Console -konsolissa, ja jokainen kutsu sisältää Bearer-tunnuksen.
Tukeeko JobBOSS² webhookeja?
ECI:n API-dokumentaatiossa ei ole webhookeja, joten integraatio pollaa JobBOSS²:ta lastModDate-suodattimilla tuotantolaitoskohtaisesti sovituin väliajoin. SkyPlannerin omat webhookit välittävät suunnitelman muutokset heti niiden tapahtuessa.
Miten suunnitellut päivämäärät kirjoitetaan takaisin JobBOSS²:een?
Työvaihekohtaisesti. SkyPlanner päivittää jokaisen Order Routing -tietueen PATCH-kutsulla, joka sisältää kentät estimatedStartDate ja estimatedEndDate. Mukana ovat myös workCenter ja employeeCode, jos vaihe on siirtynyt toiselle koneelle tai työntekijälle.
Kannattaako JobBOSS²-kumppanin ehdottaa ECI APS:ää vai SkyPlanneria?
SkyPlanneria, kun asiakas haluaa useita resursseja huomioivan hienokuormituksen käyttöön viikoissa. ECI APS on erillinen lisäosa, joka perustuu LYNQ-teknologiaan. SkyPlanner yhdistyy ECI:n oman JobBOSS² API -rajapinnan kautta, suunnittelee asetustyöt sekä työryhmien, kiinnittimien ja materiaalien käytön ja päivittää suunnitelman automaattisesti. Hinta on alkaen 199 € kuukaudessa.
Voimmeko testata SkyPlanneria ennen integraation rakentamista?
Kyllä. Ilmaisessa 30 päivän kokeilussa voit käyttää enintään 20 työpistettä ja tuoda tiedot JobBOSS²:sta CSV- tai Excel-tiedostoina. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
