Integraatiot / ERP / Exact
Exact Online -integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Exact Online -integraatio-opas kertoo Exact-kumppaneille ja IT-tiimeille, miten Exact Online Manufacturing yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Exact Onlinen integraatio toimii molempiin suuntiin:
- Tuotantotilaukset, reitityksen työvaiheet, materiaalisuunnitelmat, työpisteet, työvaiheet ja osaluettelot tuodaan Exact Onlinen REST API:n kautta.
- Nimikkeet, varastosaldot, ostotilaukset ja myyntitilaukset tuodaan SkyPlanneriin. Muutoksista saadaan tieto Exact Onlinen webhookeilla.
- Suunnitellut aloitus- ja lopetuspäivät palautetaan kullekin reitityksen työvaiheelle ja tuotantotilaukselle.
- Työntekijöiden työaikakirjaukset viedään aikatapahtumiksi ja valmistuneet määrät tuotantotilausten vastaanotoiksi.
SkyPlannerin tiimi määrittää integraation Exact Online -ympäristöösi sopivaksi käyttöönoton yhteydessä ja tukee sitä myös tuotantokäytön alettua. Tämä opas on kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa itse SkyPlannerin dokumentoidun REST API:n varaan (API-dokumentaatio). Lopussa on lyhyt osio Exact Globe+:sta.
Exact Onlinen REST API valmistukseen
Exact Online tarjoaa tietonsa yhden REST API:n kautta. Resurssit on ryhmitelty palveluittain. Peruspolku on /api/v1/{division}/<service>/<resource>, jossa division tarkoittaa Exact Online -yritystä. REST API -dokumentaatiossa luetellaan manufacturing-palvelun seuraavat tuotannonsuunnittelussa käytettävät resurssit:
| Resurssi | Sisältö | Metodit |
|---|---|---|
manufacturing/ShopOrders | Tuotantotilauksen numero, nimike, PlannedQuantity, PlannedStartDate, PlannedDate, tila, vapautuksen ilmaisin | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Tuotantotilauskohtainen reitityksen työvaihe: työvaihe, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Tuotantotilauskohtaiset materiaalirivit | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Koodi, tyyppi, tuotantoalue, kapasiteetti, tuntihinnat | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Työvaiheet ja kunkin työvaiheen työpiste sekä asetus- ja suoritusajat | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Osaluettelon versiot, komponentit ja reititys | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Tuotantotilaukselle ja reitityksen työvaiheelle kirjatut tunnit | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Tuotantotilaukselta vastaanotetut valmistuneet määrät | GET, POST |
manufacturing/MaterialIssues | Tuotantotilaukselle otettu materiaali | GET, POST |
manufacturing/ShopOrderPriorities | Tuotantotilauskohtainen prioriteettitila | GET, PUT |
Muiden palvelujen resurssit:
| Resurssi | Sisältö |
|---|---|
logistics/Items | Nimikkeiden perustiedot |
inventory/ItemWarehouses | Varastosaldot nimikkeittäin ja varastoittain |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Avoimet ostotilaukset ja vastaanottopäivät |
salesorder/SalesOrders, SalesOrderLines | Asiakaskysyntä ja toimituspäivät |
Todennus ja käyttöoikeudet
Exact Online käyttää OAuth 2.0 -todennusta authorization code -menettelyllä ja päivitystunnuksilla. Exactin ohjeessa todetaan: “Before you can start integration with Exact Online, you must first register your app in the App Store.” (Ennen Exact Online -integraation aloittamista sovellus on rekisteröitävä App Storessa.) (Exact Onlinen ohje) Sovellusten rekisteröinti edellyttää Exact Online Developer -tilausta (Exact App Store).
- Integraatio rekisteröidään sovellukseksi, jolle määritetään uudelleenohjaus-URI.
- Exact Online -käyttäjä, jolla on käyttöoikeudet valmistukseen, varastoon ja ostoihin, antaa suostumuksen kerran.
- Jokaisessa pyynnössä lähetetään
Authorization: Bearer <access_token>ja polussa yrityksen division-tunnus. - Pääsytunnukset uusitaan päivitystunnuksella. Exact rajoittaa sitä, kuinka usein uutta tunnusta voi pyytää, joten säilytä tunnus välimuistissa sen vanhenemiseen asti.
Exact rajoittaa myös kutsujen määrää minuutissa ja vuorokaudessa sovellus- ja yrityskohtaisesti sekä pyytää tekemään kutsut peräkkäin rinnakkaisten kutsujen sijaan. Ajantasaiset rajoitukset löytyvät Exactin API-rajoituksia käsittelevästä artikkelista. Integraatio on suunniteltu nämä rajat huomioiden: lukupyynnöt rajataan parametreilla $filter ja $select, ja suurten muutosmäärien käsittelyyn käytetään Sync API:a.
SkyPlannerin REST API:ssa tunnistaudutaan API-tunnuksella, joka lähetetään Authorization-Token-otsakkeessa (SkyPlanner Settings > API). Rajapinta on dokumentoitu Swagger/OpenAPI-muodossa. Integraatio-ohje opastaa ensimmäisten kutsujen tekemisessä.
Webhookit ja määräaikaiskyselyt
Exact Onlinen webhookit lähettävät callback-URL-osoitteeseesi POST-pyynnön, kun tilatussa aiheessa tapahtuu muutos. Pyyntö allekirjoitetaan HMAC SHA256 -tiivisteellä (webhookit). Aiheita ovat muun muassa Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders ja SalesOrderLines. Näiden avulla varaston, ostojen ja kysynnän muutokset välittyvät SkyPlanneriin heti niiden tapahtuessa.
Tuotantotilaukset ja reitityksen työvaiheet luetaan määräajoin. Suodata resurssit ShopOrders ja ShopOrderRoutingStepPlans kentän Modified perusteella ja käytä suurten tietomäärien lukemiseen Sync API:a (API-rajoitukset).
SkyPlanner lähettää omat webhookinsa aikataulun muuttuessa, joten tietojen kirjoitus takaisin Exact Onlineen on tapahtumapohjaista.
Tietojen vastaavuudet
| Exact Onlinen resurssi | SkyPlannerin objekti | Suunta | Päivitystiheys |
|---|---|---|---|
Items | Tuotteet ja materiaalit | Exact Online → SkyPlanner | Alkulataus, sitten webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Tuoterakenne, alituotteet ja tuotekohtaiset materiaalit | Exact Online → SkyPlanner | Muutoksen yhteydessä |
Workcenters, OperationResources | Työpisteet ja työpisteryhmät | Exact Online → SkyPlanner | Alkulataus |
Operations, BillOfMaterialRoutings | Työvaiheet asetus- ja suoritusaikoineen | Exact Online → SkyPlanner | Muutoksen yhteydessä |
ShopOrders | Tilaukset määrineen ja määräpäivineen | Exact Online → SkyPlanner | Muutaman minuutin välein |
ShopOrderRoutingStepPlans | Työt sekä niiden järjestys, työpiste, asetustunnit ja suoritustunnit | Exact Online → SkyPlanner | Muutaman minuutin välein |
ShopOrderMaterialPlans | Työkohtaiset materiaalit | Exact Online → SkyPlanner | Muutaman minuutin välein |
ItemWarehouses, StockPosition | Varastosaldot | Exact Online → SkyPlanner | Webhook |
PurchaseOrderLines | Ostotilaukset ja odotetut toimituspäivät | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Asiakkaiden toimituspäivät ja prioriteetti | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Suunniteltu alku, loppu ja työpiste työvaiheittain | SkyPlanner → Exact Online | Muutoksen yhteydessä webhookilla |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Tuotantotilauksen alku ja loppu | SkyPlanner → Exact Online | Muutoksen yhteydessä webhookilla |
TimeTransactions (POST) | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → Exact Online | Kuittauksittain tai työvuoroittain |
ShopOrderReceipts (POST) | Viimeisessä työvaiheessa valmistunut määrä | SkyPlanner → Exact Online | Kuittauksittain |
| Ei ylläpidetä Exact Onlinessa | Asetusaikamatriisi, työkalut rajallisen kapasiteetin resursseina, työkohtaiset työntekijät, vaihtoehtoiset työpisteet, työvuorot | Ylläpidetään SkyPlannerissa | Käyttöönotto |
Integraation toimintamalli
1. Perustietojen alkulataus. Lue ensin Workcenters, Operations ja OperationResources, sitten nimikkeet ja BOM-versiot reitityksineen. Kolmen koneen työpisteestä muodostetaan kolme työpistettä tai yksi työpisteryhmä. Työvuorot, poissaolot ja ylityöt määritellään SkyPlannerissa, koska Exactin työpisteellä on yksi kapasiteettiarvo.
2. Tilausten synkronointi. Lue avoimet ShopOrders-tietueet sekä niihin liittyvät ShopOrderRoutingStepPlans– ja ShopOrderMaterialPlans-tietueet, varastosaldot ja ostotilausrivit. Suunnitelmassa huomioidaan sekä varasto että saapuvat ostot. MRP tuottaa edelleen tilausehdotukset Exact Onlinessa, ja SkyPlanner suunnittelee luomiesi tuotantotilausten aikataulun.
3. Aikataulun palautus Exact Onlineen. SkyPlanner lähettää jokaisesta suunnittelumoottorin sijoittamasta tai siirtämästä työvaiheesta PUT-pyynnön kohteeseen ShopOrderRoutingStepPlans. Mukana ovat PlannedStartDate, PlannedEndDate ja Workcenter. Tuotantotilauksen PlannedStartDate ja PlannedDate määräytyvät ensimmäisen ja viimeisen työvaiheen mukaan. Määrät, materiaalisuunnitelmat ja kustannuslaskenta säilyvät Exact Onlinessa.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations- tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Kirjatut tunnit viedään TimeTransactions-tietueina tuotantotilaukselle ja työvaiheelle joko asetus- tai ajoaikana. Viimeinen kuittaus luo valmistuneesta määrästä ShopOrderReceipts-tietueen. Jos tehtaallasi kirjataan jo työaikaa Shop Floor Controlissa, valitse yksi kirjauskanava.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäyttöä:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, BOM-rakenteet, tuotantotilausten määrät, materiaalisuunnitelmat, kustannukset | Exact Online |
| Työvaiheiden järjestys, alku- ja loppuajat, työpisteiden valinta | SkyPlanner |
| Asetusaikamatriisi, työkalut, työkohtaiset työntekijät, vaihtoehtoiset resurssit, työvuorot | SkyPlanner |
| Aikakirjaukset ja valmistumiskuittaukset | Exact Online, tiedot SkyPlannerista |
Ristiriidat johtuvat useimmiten päivämäärien käsin tehdyistä muutoksista. Jos suunnittelijat muuttavat edelleen tuotantotilausten päivämääriä Exact Onlinessa, samoja päivämääriä hallitaan kahdessa järjestelmässä. Anna SkyPlannerin hallita työvaiheiden päivämääriä. Autopilotin avulla SkyPlanner päivittää aikataulun automaattisesti tuotannon muuttuessa.
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä viikkojen kuluessa käyttöönoton aloittamisesta. Varmista sitä ennen aikataulun toimivuus 30 päivän maksuttomassa kokeilussa tuomalla avoimet tuotantotilaukset ja työvaiheet CSV- tai Excel-tiedostosta. Sen jälkeen projekti etenee näin:
- Määrittely. Vahvista tuoteversio, yritykset, synkronointitiheydet, aikakirjausten kanava ja valmistumiskuittausten vienti.
- Sovellus ja valtuutus. Rekisteröi sovellus. Sen jälkeen Exact Online -käyttäjä antaa OAuth-valtuutuksen kullekin yritykselle.
- Alkulataus. Työpisteet, työvaiheet, nimikkeet, BOM-versiot ja reititykset.
- Tilausten synkronointi. Tuotantotilaukset, työvaihesuunnitelmat ja materiaalisuunnitelmat siirretään ajastetusti, varasto- ja ostotiedot webhookilla.
- Rajoitteiden määrittely SkyPlannerissa. Työvuorot, asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai työntekijät.
- Aikataulun palautus Exact Onlineen. Ensin suunnitellut työvaiheiden päivämäärät, sitten aikakirjaukset ja valmistumiskuittaukset.
- Rinnakkaistestaus ja tuotantokäyttöön siirtyminen. Vertaa päivämääriä nykyiseen suunnitelmaan, korjaa perustiedot ja ota sitten tietojen palautus käyttöön.
Mitä Exact Online -integraatiossa on huomioitava
- Työvaiheiden ajat.
PlannedSetupHoursjaPlannedRunHourstulevat BOM-rakenteen reitityksestä. Vertaa niitä ensin todellisiin tuotantoaikoihin. - Työpisteiden ryhmittely. Exactissa on yksi kapasiteettiarvo työpistettä kohden. Päätä jokaiselle työpisteelle erikseen, muodostetaanko siitä yksi työpiste, useita työpisteitä vai ryhmä.
- Kalenterit. SkyPlannerissa ylläpidetään työvuoroja, vapaapäiviä ja poissaoloja. Määrittele ne ennen ensimmäisen aikataulun laatimista.
- Rajapintakutsujen kiintiö. Exact rajoittaa kutsujen määrää sovellus- ja yrityskohtaisesti ja edellyttää peräkkäisiä kutsuja. Käytä webhookeja, kun tarvittavat aiheet ovat saatavilla,
$filter-suodatustaModified-kentän perusteella ja Sync API -rajapintaa suurten tietomäärien lukemiseen. - Useita yrityksiä. Jokainen Exact Onlinen division on yritys, jolla on oma polkunsa ja valtuutuksensa. Kohdista kukin tehdas omaan yritykseensä.
- Vapautetut tuotantotilaukset. Sovi, missä tiloissa olevien tilausten päivämääriä SkyPlanner saa muuttaa: avointen ja vapautettujen vai vain avointen tilausten.
- Yksi omistaja päivämäärille. Lopeta päivämäärien muuttaminen käsin Exact Onlinessa, kun SkyPlanner hallitsee työvaiheiden päivämääriä.
Exact Globe+
Exact Globe+ on Exactin ERP-järjestelmä, jota myydään ja otetaan käyttöön Exact Globe+ -kumppanien kautta. Exact kuvaa sitä näin: ”koppelt eenvoudig en snel met andere systemen” (yhdistyy helposti ja nopeasti muihin järjestelmiin) (Exact Globe+). SkyPlanner suunnittelee Exact Globe+ -tuotantotilausten aikataulun samalla tavalla: tuotantotilaukset, reititykset, resurssit ja varastotiedot tuodaan SkyPlanneriin, ja suunnitellut päivämäärät sekä kirjatut tunnit palautetaan. Exact Globe+ -kumppanisi ja SkyPlanner-tiimi sopivat rajapinnasta ja palautettavista objekteista määrittelyvaiheessa.
Kuka määrittää Exact Online -integraation ja vastaa sen tuesta
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja vastaa sen tuesta tuotantokäytössä.
- Exact-kumppanisi voi osallistua. Kumppani tuntee tuoteversiosi, yrityksesi ja tuotannon määritykset.
- Omat kehittäjäsi voivat laajentaa integraatiota SkyPlannerin dokumentoidun REST API -rajapinnan avulla. Alkuun pääsee API-tokenilla, ja SkyPlanner-tiimi auttaa tarvittaessa.
Kun yhteys on käytössä, Arcturus-moottori laatii aikataulun Exact Onlinen ajantasaisten tuotantotilausten perusteella, ja suunnitellut päivämäärät siirtyvät jokaiseen työvaiheeseen. SkyPlanner maksaa alkaen 199 € kuukaudessa, sisältää 5 työpistettä ja laskutetaan kuukausittain. Saat etukäteen tarjouksen sekä palvelupaketista että prosessiisi ja tarpeisiisi sopivasta integraatiosta, joten tiedät kokonaiskustannukset ennen aloittamista. Tutustu hinnoitteluun ja ominaisuuksiin sekä vertaa Exact Onlinen omaa suunnittelua artikkelissa Exact Online ja hienokuormitus. Yleiskatsauksen löydät Exact Online -sivulta ja muut ERP-järjestelmät ERP-integraatioiden koontisivulta.
Valmistavien yritysten kokemuksia SkyPlannerista
Vähemmän materiaalipuutteista johtuvia seisokkeja
”SkyPlannerin arvo meille on siinä, että se toimii päivittäisen työn työkaluna, erityisesti toimituspäivien määrittämisessä.”
Tommi Männistö, tuotannonsuunnittelupäällikkö
Eskomatic · Sopimuskoneistus
Automaattinen kuormituksen suunnittelu tarkentaa toimituspäiviä, ja materiaalipuutteista johtuvat tuotantoseisokit ovat vähentyneet merkittävästi.
1 000:t työtilaukset suunnitellaan automaattisesti
”Tuotanto on eri tavalla hallinnassa, ja ymmärryksemme kapasiteetista on aivan eri tasolla.”
Hannu Ryynänen, toimitusjohtaja
Mamec · Teollisuussekoittimet, pumput ja korkean teknologian sopimusvalmistus
Tuhansien työtilausten aikataulut suunnitellaan automaattisesti, ja koko organisaatiolla on reaaliaikainen näkymä tuotantoon.
Usein kysytyt kysymykset
Sisältääkö Exact Online API tuotantotilaukset ja reitityksen työvaiheet?
Kyllä. Tuotannon palvelu sisältää resurssit ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters ja Operations sekä BOM-resurssit. Niitä kaikkia voi sekä lukea että kirjoittaa. Työajat kirjataan TimeTransactions-resurssin ja valmistuneet määrät ShopOrderReceipts-resurssin kautta.
Miten suunnitellut päivämäärät kirjoitetaan takaisin Exact Onlineen?
SkyPlanner lähettää ShopOrderRoutingStepPlans-resurssiin PUT-pyynnön jokaisesta työvaiheesta, jonka se sijoittaa aikatauluun tai siirtää. Pyyntö sisältää kentät PlannedStartDate, PlannedEndDate ja Workcenter. Tuotantotilauksen PlannedStartDate– ja PlannedDate-kentät päivitetään vastaamaan näitä tietoja.
Kuka toteuttaa Exact Online -integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation Exact Online -ympäristöösi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Exact-kumppanisi voi osallistua toteutukseen. Myös omat kehittäjäsi voivat rakentaa integraation SkyPlannerin dokumentoidun REST API -rajapinnan avulla. Alkuun pääsee API-tokenilla.
Voiko Exact Online lähettää muutokset reaaliajassa?
Exact Onlinen webhookit lähettävät nimikkeiden, varastosaldojen, ostotilausten ja myyntitilausten muutokset. Tuotantotilaukset ja reitityksen työvaiheet luetaan lyhyin väliajoin suodatetuilla pyynnöillä. Toiseen suuntaan SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
Voimmeko kokeilla SkyPlanneria ennen integraation toteuttamista?
Kyllä. Maksuton 30 päivän kokeilu tukee enintään 20 työpistettä, ja voit tuoda tuotantotilauksesi CSV- tai Excel-tiedostoina. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
