Integraatiot / ERP / SYSPRO
SYSPRO-integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä SYSPRO-integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten SYSPRO 8 yhdistetään SkyPlanner APS:ään. SkyPlannerin ja SYSPROn välinen integraatio toimii molempiin suuntiin SYSPROn omien rajapintojen kautta:
- SkyPlanneriin tuodaan työt, työvaiheet, Structures and Routings, työpisteet, koneet, Stock Codes, varastosaldot ja ostotilaukset.
- Suunnitellut aloitus- ja lopetuspäivät palautetaan töille.
- Työntekijöiden aikakirjaukset voidaan halutessasi palauttaa työaikatoteumina.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlannerin tiimi määrittää integraation SYSPRO-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 itse ratkaisuja SkyPlannerin dokumentoidun REST API -rajapinnan avulla (rajapintakuvaus).
SYSPROn integraatiorajapinnat
SYSPRO tarjoaa ulkoiselle suunnittelujärjestelmälle kaksi tapaa käsitellä tietoja:
- e.net Solutions Business Objects. SYSPROn liiketoimintalogiikkaa kutsutaan ulkopuolelta: sekä syöte että vastaus ovat XML-muodossa. Ryhmiä on kolme: Query (esimerkiksi WIPQBL, WIP Balance Query), Transaction tai Post (esimerkiksi WIPTJB, WIP Job Creation and Maintenance) sekä perustietojen käsittelyyn tarkoitettu Setup. Business Objects -objektit tekevät samat tarkistukset kuin SYSPROn käyttöliittymä ja säilyvät yhteensopivina versiosta toiseen. SYSPROn parhaiden käytäntöjen opas toteaa suoraan: “SYSPRO’s Business Objects are used to query and post data to SYSPRO.” (SYSPROn Business Objects -objekteilla haetaan tietoja SYSPROsta ja tallennetaan niitä sinne.)
- SYSPRO OData Service (OData v4). REST-periaatteisiin perustuva, vain lukuun tarkoitettu pääsy yritys- ja järjestelmätietokantoihin sekä Business Activity Queries -kyselyihin, jotka ovat SYSPROssa määriteltyjä SQL-näkymiä. Palvelu on saatavilla versiosta SYSPRO 8 2021 R2 alkaen. SYSPRO Cloud ERP -ympäristöstä todetaan: “Syspro OData is the only mechanism available when applications need access to SYSPRO data.” (Syspro OData on ainoa käytettävissä oleva tapa, jolla sovellukset pääsevät SYSPROn tietoihin.)
Business Objects -objekteja kutsutaan e.net Communications -palvelun kautta käyttäen SYSPRO WCF Service- tai SYSPRO Web Service -palvelua.
Master Data Take On (IMPIMP) tuo laskentataulukoiden tiedot Setup-objektien kautta. Se sopii perustietojen kertaluonteiseen tuontiin. SYSPRO Harmonyn elinkaari päättyy 31. joulukuuta 2026, joten älä rakenna sen varaan mitään uutta.
Tunnistautuminen ja lisensointi
- e.net-kirjautuminen. Integraatio kirjautuu yritykseen SYSPRO Operator -käyttäjänä ja saa istunnon GUID-tunnisteen myöhempiä kutsuja varten.
- Lisensointi. SYSPRO-lisenssin on katettava käyttäjän kutsumien Business Objects -objektien toimintoalueet.
- OData. Yhteys muodostetaan HTTPS:n kautta käyttäjillä, joille on määritetty OData-käyttöoikeudet.
SkyPlannerin REST API käyttää tunnistautumiseen API-tokenia (SkyPlanner Settings > API), ja rajapinta on dokumentoitu Swagger/OpenAPI-muodossa. Integraatio-ohje käy läpi ensimmäiset kutsut.
Tapahtumat ja säännölliset kyselyt
SYSPRO ei lähetä webhook-kutsuja. Electronic Signature Transaction Setup voi käynnistää esimerkiksi sähköpostin lähetyksen tai VBScript-komentosarjan, kun tapahtuma onnistuu. SYSPRO kuitenkin toteaa: “It is not intended that triggers from e.net Business Objects fire VBScript triggers.” (e.net Business Objects -objektien laukaisimia ei ole tarkoitettu käynnistämään VBScript-laukaisimia.)
Siksi SYSPROn tiedot haetaan määräajoin toistuvilla kyselyillä. Uudet työt poimitaan Business Objects -kyselyillä tai OData-pyynnöillä, jotka rajataan avoimiin töihin ja viimeaikaisiin muutoksiin. Kyselyväli määritetään tehdaskohtaisesti: töiden tiedot voidaan hakea muutaman minuutin välein ja varastosaldot tunnin välein.
SkyPlanner lähettää webhook-kutsuja tilan tai aikataulun muuttuessa, joten tietojen palautus SYSPROon on tapahtumapohjaista.
Tietojen vastaavuudet
| SYSPRO-objekti (rajapinta) | SkyPlannerin objekti | Suunta | Siirtotiheys |
|---|---|---|---|
| Stock Codes, mittayksiköt (OData tai Query-objektit) | Tuotteet ja materiaalit | SYSPRO → SkyPlanner | Alkutuonti, sen jälkeen toistuvilla kyselyillä |
| Structures (komponentit, laskennalliset nimikkeet, rinnakkaistuotteet) | Tuoterakenne, alituotteet, tuotekohtaiset materiaalit | SYSPRO → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Routings: työpiste, asetus-, ajo-, jonotus- ja siirtoaika, Maximum units | Työvaiheet kestoineen sekä asetus- ja purkuaikoineen | SYSPRO → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Work Centers (tuotantoyksiköt, kapasiteetti) ja Machines | Työpisteet, työpisteryhmät, tehokkuudet | SYSPRO → SkyPlanner | Alkutuonti, sen jälkeen harvoin |
| Capacity Calendar, Shift Patterns | Työvuorot ja vapaapäivät | SYSPRO → SkyPlanner | Päivittäin, tai työvuorot ylläpidetään SkyPlannerissa |
| Työt ja alityöt (WipMaster), työvaiheet, töiden materiaalit | Tilaukset ja työt määräpäivineen ja materiaalitarpeineen | SYSPRO → SkyPlanner | Kyselyt muutaman minuutin välein |
| Varastossa oleva määrä Stock Code -kohtaisesti | Varastosaldot | SYSPRO → SkyPlanner | Kyselyt tunnin välein tai suunnitteluajon yhteydessä |
| Ostotilaukset toimituspäivineen | Ostotilaukset, saapuvat materiaalit toimituspäivän mukaan | SYSPRO → SkyPlanner | Kyselyt tunnin välein tai suunnitteluajon yhteydessä |
| Työn suunnitellut aloitus- ja lopetuspäivät (WIPTJB, WIP Job Creation and Maintenance) | Työkohtaiset suunnitellut aloitus- ja lopetusajat | SkyPlanner → SYSPRO | Aikataulun muuttuessa SkyPlannerin webhook-kutsulla |
| Labor Posting: asetus- ja ajoaika työvaihe-, kone- ja työntekijäkohtaisesti | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → SYSPRO | Kuittaus- tai työvuorokohtaisesti, jos otetaan käyttöön |
| Job Receipts (WIP Job Receipts -objekti) | Valmistuneet määrät | SkyPlanner → SYSPRO | Kuittauskohtaisesti, jos otetaan käyttöön |
| Ei SYSPROssa | Asetusaikamatriisi, työkalut rajallisina resursseina, vaihtoehtoiset koneet ja henkilöt | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutustavat
1. Perustietojen alkutuonti. Hae Stock Codes, Structures and Routings, työpisteet, koneet ja kalenterit OData-rajapinnan tai Query-objektien kautta. Määritä harkiten, miten työpisteet mallinnetaan SkyPlannerissa: neljän koneen työpisteestä tehdään yksi työpisteryhmä tai neljä työpistettä.
2. Töiden synkronointi. Hae varsinaiset työt työvaiheineen ja materiaaleineen sekä avoimet ostotilaukset. SkyPlanner käsittelee tilattua materiaalia saatavilla olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilauksen tilaksi merkitään Delivered.
Ota suunnitteluun vain varsinaiset työt. Työehdotukset pysyvät MRP-tilannekuvassa, kunnes MRP Job Review muuttaa ne töiksi.
3. Aikataulun palautus SYSPROon. Kun suunnittelumoottori sijoittaa työn aikatauluun tai siirtää sitä, SkyPlannerin webhook-kutsu käynnistää tietojen tallennuksen WIP Job Creation and Maintenance -objektiin (WIPTJB). Näin asetetaan työn suunnitellut aloitus- ja lopetuspäivät. Objekti tarkistaa muutoksen täsmälleen samoin kuin Job Entry.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations- tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Päätät itse, palautetaanko toteutuneet ajat SYSPROon. Jos palautetaan, asetus- ja ajoajat viedään työvaihekohtaisesti Labor Posting -toimintoon ja valmistuneet määrät Job Receipts -toimintoon. Muussa tapauksessa työajat kirjataan SYSPROon kuten ennenkin.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäyttöön siirtymistä:
| Tiedot | Omistaja |
|---|---|
| Stock Codes, Structures and Routings, määrät, työn tila | SYSPRO |
| Työvaiheiden järjestys, aloitus- ja lopetusajat, koneen valinta | SkyPlanner |
| Asetusaikamatriisi, työkalu- ja työntekijävaatimukset, vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot ja vapaapäivät | Yksi järjestelmä, joka valitaan määrittelyssä |
| Työaikatoteumat, materiaalien otot ja vastaanotot | SYSPRO: kirjataan suoraan sinne tai siirretään SkyPlannerin aikakirjauksista |
Valitse yksi järjestelmä päivittämään töiden päivämääriä. SkyPlanner ei tarvitse SYSPROn suunnittelumoduulia, joten se korvaa Factory Scheduling-, Visual APS- tai APS (Nexsys) -moduulin suunniteltujen päivämäärien päivittäjänä. Jos jokin niistä päivittää edelleen suunniteltuja päivämääriä, poista päivitys käytöstä SkyPlannerissa suunniteltavilta töiltä. Factory Scheduling -moduulissa Job Entry -asetus on “Update planned dates to scheduled dates.” (Päivitä suunnitellut päivämäärät aikataulun mukaisiksi.)
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä muutamassa viikossa käyttöönoton alkamisesta. Sitä ennen voit varmistaa aikataulun toimivuuden 30 päivän maksuttomalla kokeilujaksolla. Käytä siinä SYSPROsta CSV- tai Excel-muodossa vietyjä työpisteitä, reitityksiä ja avoimia töitä.
- Tietovastaavuudet. Sovi vastaavuustaulukosta, tietojen omistajuussäännöistä ja synkronointiväleistä sekä siitä, palautetaanko työaikatoteumat SYSPROon.
- SYSPRO-käyttöoikeudet. Luo integraation käyttäjä, varmista Business Objects -lisenssit ja ota OData käyttöön siellä, missä sitä käytetään. Testaa ensin yritystietojen kopiolla.
- Alkutuonti. Stock Codes, Structures and Routings, työpisteet, koneet ja kalenterit.
- Töiden ja ostotilausten synkronointi. Toistuvat kyselyt suodatuksineen, sivutuksineen ja uudelleenyrityksineen.
- Rajoitteiden määritys SkyPlannerissa. Asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai henkilöt.
- Aikataulun palautus SYSPROon. WIPTJB-tallennukset SkyPlannerin webhook-kutsujen perusteella sekä työaikatoteumien palautus, jos se otetaan käyttöön.
- Rinnakkaistestaus. Aja SkyPlanneria nykyisen suunnitelman rinnalla, vertaa päivämääriä ja korjaa perustiedot.
- Tuotantokäyttöön siirtyminen. Ota tietojen takaisinkirjoitus käyttöön, kun tiedot täsmäävät.
Mitä SYSPRO-integraatiossa on huomioitava
- _TMP-työt. Job Entry -toiminnon kapasiteetin huomioivat koekuormitukset voivat luoda _TMP-töitä WipMasteriin. Suodata ne pois jokaisella lukukerralla.
- Aloitetut työvaiheet. Forward Finite Scheduling antaa virheen aloitetuista työvaiheista, jotka eivät mahdu aikatauluun. Hae työvaiheiden etenemistiedot SkyPlanneriin ennen jokaista suunnitteluajoa, jotta aikataulu perustuu jo tehtyyn työhön. Running Time Lock lukitsee sen jälkeen seuraavien tuntien työt.
- Reitityksen aikayksiköt. Asetus-, valmistus-, jonotus- ja siirtoajoille on määritettävä oikeat yksiköt ja laskentaperusteet. Jonotus- ja siirtoajat ovat odotusaikaa, eivät koneaikaa. Muunna ajat tuonnin yhteydessä, tai kaikki kestot ovat väärin.
- Alihankintavaiheet. Offsite Days ja Dock to Stock Days kuvaavat kuluvaa aikaa, eivät omaa kapasiteettiasi. Mallinna ne vaiheina, joilla on vain kesto.
Kuka määrittää SYSPRO-integraation ja vastaa sen tuesta?
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tarjoaa tukea tuotantokäytön alettua. Työ kattaa sovitut liiketoimintaobjektit ja OData-kyselyt. Jokainen tehdas käyttää SYSPROa omalla tavallaan, ja tämä osaaminen otetaan huomioon määrityksissä.
- SYSPRO-kumppanisi voi osallistua. Kumppani tuntee järjestelmäsi määritykset, mukautetut lomakkeet ja lisensoinnin. Hän voi määrittää käyttäjätunnuksen ja OData-käyttöoikeudet yhdessä SkyPlanner-tiimin kanssa.
- Omat kehittäjäsi voivat laajentaa integraatiota SkyPlannerin REST API -rajapinnan kautta API-tokenilla. Aloittamiseen riittää API-token, ja SkyPlanner-tiimi auttaa tarvittaessa. Ohjeet löytyvät SkyPlannerin integraatiodokumentaatiosta.
SkyPlannerin hinta on alkaen 199 € kuukaudessa kuukausilaskutuksella, ja hintaan sisältyy 5 työpistettä. Integraatiosta annetaan etukäteen prosessisi ja tarpeidesi mukainen tarjous tilauksesi yhteydessä. Tutustu hinnoitteluun, SYSPRO-hienokuormitukseen, SYSPRO-sivuun ja ERP-integraatioiden koontisivuun.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästöä joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kytkinlaitteet
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono saadaan linjalle sekunneissa.
+90%tuotannon tehokkuuteen
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-päällikkö
Laboratory & Allied · Lääkkeiden valmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikkien työpisteiden optimoidun kolmen kuukauden suunnitelman laatiminen vie alle 30 minuuttia.
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.
99,2%toimitusvarmuus
”SkyPlanner on tehnyt tuotannon pullonkaulat näkyviksi ja selkeyttänyt tuotannonohjausta.”
Toni Tuori, tuotantopäällikkö
Piristeel · Kattoturvatuotteet ja sadevesijärjestelmät
Toimitusvarmuus nousi tänä vuonna 99,2 %:iin, ja tuotannonsuunnittelussa säästyy jopa neljä tuntia työaikaa päivässä.
Usein kysytyt kysymykset
Onko SYSPROssa rajapinta tuotantotöiden käsittelyyn?
Kyllä. e.net Solutions Business Objects -objekteilla voi hakea ja kirjoittaa SYSPRO-tietoja. Niihin kuuluu WIPTJB, jolla luodaan ja ylläpidetään tuotantotöitä. SYSPRO OData -palvelu tarjoaa lisäksi RESTful-lukurajapinnan taulukoihin ja Business Activity Queries -kyselyihin.
Tukeeko SYSPRO webhookeja?
Lähteviä webhookeja ei ole. Electronic Signature Transaction Setup -toiminnon liipaisimia ei ole tarkoitettu käynnistymään liiketoimintaobjektien kutsuista, joten integraatio hakee päivitykset SYSPROsta tehdaskohtaisesti määritetyin väliajoin. SkyPlannerin omat webhookit välittävät suunnitelman muutokset heti niiden tapahtuessa.
Miten suunnitellut päivämäärät kirjoitetaan takaisin SYSPROon?
WIP Job Creation and Maintenance -liiketoimintaobjektin (WIPTJB) kautta. Se asettaa työn suunnitellut aloitus- ja lopetuspäivämäärät. SYSPRO tarkistaa kirjoitettavat tiedot samoilla säännöillä kuin Job Entry -toiminnossa.
Toimiiko integraatio SYSPRO Cloud ERP:n kanssa?
Kyllä. SkyPlanner lukee Cloud ERP -tiedot SYSPRO OData -palvelun kautta. SYSPROn mukaan se on ainoa tapa hakea tietoja kyseisestä ympäristöstä. SkyPlanner-tiimi määrittää takaisin kirjoittamisen toteutustavan kanssasi ja SYSPRO-kumppanisi kanssa määrittelyvaiheessa.
Kannattaako SYSPRO-kumppanin ehdottaa SYSPRO MOM Visual APS:ää vai SkyPlanneria?
SkyPlanneria, kun asiakas haluaa toimivan hienokuormituksen käyttöön viikoissa. Visual APS kuuluu SYSPRO MOM -kokonaisuuteen, vaatii oman lisenssin ja asennetaan käyttämään SYSPROn SQL Server -palvelinta. MOM Workbench -käyttäjät tarvitsevat käyttäjäkohtaiset lisenssit (SYSPROn ohje). SkyPlanner yhdistetään e.net Business Objects -objektien ja ODatan kautta. Se päivittää suunnitelman automaattisesti ja huomioi suunnittelussa vaihdot, työkalut, työryhmät ja materiaalit. Käyttäjämäärää ei ole rajoitettu, ja hinta on alkaen 199 € kuukaudessa.
Voimmeko kokeilla SkyPlanneria ennen integraation rakentamista?
Kyllä. Ilmaisessa 30 päivän kokeilussa voi käyttää enintään 20 työpistettä ja tuoda tiedot SYSPROsta CSV- tai Excel-tiedostoina. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
