Integraatiot / ERP / monday.com
monday.com-integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä monday.com-integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten monday.com-taulut yhdistetään SkyPlanner APS:ään. SkyPlannerin ja monday.comin integraatio toimii molempiin suuntiin:
- SkyPlanneriin tuodaan tilaukset sekä niiden tuote, määrä, määräpäivä, prioriteetti ja tila.
- Suunniteltu aloitus- ja lopetusaika kirjoitetaan Timeline-sarakkeeseen ja työpiste omaan sarakkeeseensa.
- Tuotantolattian työntekijöiden kirjaukset töiden edistymisestä päivittävät Status-sarakkeen.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlanner-tiimi määrittää integraation tauluihisi 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 integraation SkyPlannerin dokumentoidun REST API -rajapinnan pohjalta (API-viite).
monday.com-alustan API
monday.com tarjoaa yhden GraphQL API -rajapinnan osoitteessa POST https://api.monday.com/v2. Siitä julkaistaan versio neljännesvuosittain, ja käytettävä versio lukitaan API-Version-otsakkeella. Käytöstä poistamisesta ilmoitetaan vähintään kuusi kuukautta etukäteen. (API-versiointi)
Tuotannonsuunnittelun integraatiossa käytettävät objektit:
- Boards ja groups, joita käytetään usein vaiheiden tai viikkojen jaotteluun.
- Items ja subitems. Item on yleensä tilaus tai työ, ja subitems sisältävät työvaiheet.
- Sarakkeiden arvot: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards ja Mirror.
- Webhookit muutostapahtumille.
Tiedot luetaan taulun tai ryhmän sisään sijoitetulla items_page-kyselyllä. Oletuksena sivulla on 25 kohdetta, ja enimmäismäärästä todetaan: “the maximum is 500.” (tämä on kohteiden enimmäismäärä). Lukemista jatketaan next_items_page-kyselyllä. Kursorin voimassaolosta todetaan: “each cursor will expire 60 minutes after the first request.” (kukin kursori vanhenee mainitun minuuttimäärän kuluttua ensimmäisestä pyynnöstä). Rajaa luku vain avoimiin tilauksiin query_params-suodattimella. (items_page)
Kirjoittamiseen käytetään operaatioita create_item, create_subitem, change_column_value ja change_multiple_column_values. Viimeinen päivittää yhden kohteen useita sarakkeita yhdellä kutsulla. Juuri tätä tarvitaan aikataulun takaisinkirjoituksessa.
Suurten tietomäärien tuontiin API-versio 2026-07 ja sitä uudemmat versiot tarjoavat operaatiot ingest_items ja backfill_items. Lataa CSV-tiedosto ennalta allekirjoitettuun URL-osoitteeseen ja tarkista tuontiajon tila toistuvilla kyselyillä. (massatuonti)
Todennus
monday.com tukee kolmea token-tyyppiä:
- Henkilökohtainen API-token. “Each token is unique to a user” (jokainen token on käyttäjäkohtainen), ja sillä on kyseisen käyttäjän käyttöoikeudet. Sopii toteutettavuuden kokeiluun.
- Sovellustoken integraatiosovellukselle, rajatuilla käyttöoikeuksilla.
- OAuth osoitteiden
auth.monday.com/oauth2/authorizeja/oauth2/tokenkautta. Käyttöoikeusalueita ovat esimerkiksiboards:read,boards:write,webhooks:readjawebhooks:write.
Käytä tuotantoympäristössä sovellus- tai OAuth-tokenia. Henkilökohtainen token lakkaa toimimasta, kun sen omistaja luo sen uudelleen. (todennus)
SkyPlannerin REST API käyttää todennukseen API-tokenia (SkyPlanner Settings > API), ja sen dokumentaatio on Swagger/OpenAPI-muodossa. Alkuun pääsee pelkällä API-tokenilla, ja integraatio-ohje opastaa ensimmäisten kutsujen tekemisessä.
Webhookit ja tietojen täsmäytys
Luo tapahtumatilaus kutsulla create_webhook(board_id, url, event, config). Tuotannonsuunnittelun integraatio tarvitsee seuraavat tapahtumat:
create_itemjacreate_subitemuusille tilauksille ja työvaiheille.change_column_valuetaichange_specific_column_valuemääräpäivän, määrän tai prioriteetin muutoksille.change_status_column_valuekäyttäjien tekemille tilamuutoksille.item_archived,item_deletedjaitem_moved_to_specific_groupperutuille tai valmistuneille tilauksille.
Vastaanottavan URL-osoitteen on vastattava haastetokeniin webhookia luotaessa. Epäonnistuneita toimituksia yritetään uudelleen seuraavasti: “retry once a minute for 30 minutes,” (yritys toistetaan kerran minuutissa mainitun ajan), minkä jälkeen yritykset loppuvat. Siksi integraatio myös täsmäyttää tiedot säännöllisesti items_page-kyselyllä, joka suodatetaan äskettäin päivitettyihin kohteisiin. (webhookit)
Toiseen suuntaan SkyPlanner lähettää webhookeja tilan tai aikataulun muuttuessa. Integraatiopalvelu vastaanottaa ne ja kirjoittaa uudet päivämäärät monday.comiin. Takaisinkirjoitus on siis tapahtumapohjaista.
Tietojen vastaavuudet
monday.comissa ei ole vakiomuotoista tilausobjektia, joten saraketunnisteiden vastaavuudet määritetään tilikohtaisesti. Tyypillinen määritys on seuraava:
| monday.com-objekti | SkyPlannerin objekti | Suunta | Siirtotiheys |
|---|---|---|---|
| Tuotantotaulun kohde: Name, Numbers (määrä), Date (määräpäivä), Status tai Dropdown (prioriteetti) | Tilaus, joka sisältää tuotteen, määrän, määräpäivän ja prioriteetin | monday.com → SkyPlanner | Webhook luotaessa ja muutettaessa sekä tietojen täsmäytys |
| Alikohteet tai Connect Boards -toiminnolla linkitetyn taulun kohteet | Työvaiheet kestoineen | monday.com → SkyPlanner | Tilauksen mukana |
| Tuotetaulun kohteet (tuotetiedot Mirror-toiminnolla) | Tuotteet ja tuoterakenne | monday.com → SkyPlanner | Alkutuonti, sen jälkeen muutosten yhteydessä |
| Varasto- tai materiaalitaulun kohteet, jos tietoja ylläpidetään monday.comissa | Materiaalit ja varastosaldot | monday.com → SkyPlanner | Ajastettu luku |
| Ostotilaustaulun kohteet odotettuine toimituspäivineen | Saapuva materiaali, joka on käytettävissä toimituspäivänä | monday.com → SkyPlanner | Webhook tai ajastettu luku |
| Henkilöt ja tiimit | Henkilöstö, jos työntekijät sisältyvät tuotantosuunnitelmaan | monday.com → SkyPlanner | Alkutuonti |
| Ei ylläpidetä monday.comissa | Työpisteet, työvuorot, asetusaikamatriisi, työkalut, vaihtoehtoiset koneet | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
| Timeline-sarake | Suunniteltu aloitus- ja lopetusaika | SkyPlanner → monday.com | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
| Status-, Dropdown- tai Text-sarake | Työlle osoitettu työpiste | SkyPlanner → monday.com | Aikataulun muuttuessa |
| Status-sarake (esimerkiksi Tuotannossa, Valmis) | Työn edistyminen Mobile Confirmations -toiminnosta | SkyPlanner → monday.com | Jokaisen kuittauksen yhteydessä |
Integraation toimintamallit
1. Perustietojen alkutuonti. Lue tuotteet, materiaalit ja avoimet tilaukset items_page-kyselyllä. Luo työpisteet, työvuorot ja rajoitteet SkyPlannerissa tai tuo ne Excelistä. Päätä ajoissa, tallennetaanko työvaiheet alikohteiksi vai linkitettyyn tauluun.
2. Tilausten synkronointi. Tuotantotaulun webhookit lähettävät uudet ja muuttuneet kohteet SkyPlanneriin tilauksina. Jos seuraat ostotilauksia taulussa, SkyPlanner käsittelee tilattua materiaalia toimituspäivänä käytettävissä olevana ja päivittää varastosaldon, kun ostotilaus merkitään toimitetuksi.
3. Aikataulun takaisinkirjoitus. Integraatio tekee change_multiple_column_values-kutsun jokaiselle tilaukselle, jonka laskentamoottori on sijoittanut aikatauluun tai siirtänyt. Se asettaa Timeline-sarakkeeseen suunnitellun aloitus- ja lopetusajan ja täyttää työpistesarakkeen. Yksi kutsu kohdetta kohti pitää pyyntömäärän pienenä.
4. Töiden edistyminen tuotantolattialla. Työntekijät kirjaavat työt Mobile Confirmations-, Production Timer- tai Quick Log Mode -toiminnolla. Aikakirjaukset pitävät aikataulun ajan tasalla, ja vastaava Status-arvo palautuu tauluun. Myynti näkee näin töiden edistymisen kysymättä.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäytön aloittamista:
| Tiedot | Omistaja |
|---|---|
| Tilaus, asiakas, määrä, määräpäivä, prioriteetti | monday.com |
| Työvaiheiden järjestys, aloitus- ja lopetusaika, työpiste | SkyPlanner |
| Työvuorot, asetustyöt, työkalut, vaihtoehtoiset koneet | SkyPlanner |
| Edistymistä kuvaavat Status-arvot | SkyPlanner kirjoittaa, monday.com näyttää |
Ristiriitoja aiheuttaa eniten Timeline-sarakkeen muokkaaminen käsin. Sopikaa, että vain SkyPlanner kirjoittaa sarakkeeseen, tai käsitelkää käsin tehty muutos pyyntönä, jonka perusteella SkyPlanner suunnittelee aikataulun uudelleen. Autopilot suunnittelee aikataulun automaattisesti uudelleen tuotannon muuttuessa.
Projektin tyypilliset vaiheet
Toteutus valmistuu tavallisesti viikkojen kuluessa käyttöönoton alkamisesta. Sitä ennen voit käyttää omia tietojasi 30 päivän maksuttomassa kokeilussa: vie tuotantotaulu Exceliin ja tuo se SkyPlanneriin.
- Taulujen kartoitus. Kartoita taulut, ryhmät, sarakkeiden tunnisteet ja tilatunnisteet sekä tarkista monday.com-tilauspaketti.
- Tietojen vastaavuudet ja omistajuus. Vahvista vastaavuustaulukko, tietojen omistajuussäännöt ja synkronointivälit.
- Rajoitteiden määritys SkyPlannerissa. Työpisteet, työvuorot, asetusaikamatriisi, työkalut ja vaihtoehtoiset koneet.
- Tilausten synkronointi. Webhookit, tietojen luku täsmäytystä varten ja tokenien käsittely.
- Takaisinkirjoitus. Timeline-sarake sekä työpiste- ja tilasarakkeet.
- Rinnakkaistestaus. Käytä SkyPlanneria nykyisen taulun rinnalla, vertaa päivämääriä ja korjaa tiedot.
- Tuotantokäyttöön siirtyminen. Ota takaisinkirjoitus käyttöön, kun päivämäärät täsmäävät.
Mitä monday.com-integraation suunnittelussa on huomioitava
- Jokaisella tilillä tilaukset mallinnetaan eri tavalla. Käytössä voi olla taulu kullekin asiakkaalle, työvaiheet kohteina tai alikohteina ja koneet People- tai Status-sarakkeina. Määritä vastaavuudet tilikohtaisesti sarakkeiden tunnisteiden perusteella, älä koskaan sarakkeen otsikon perusteella.
- Tilauspakettien rajoitukset. Free, Basic ja Standard sallivat 1 000 API-kutsua päivässä, Pro 10 000 ja Enterprise 25 000. Käytä muutosten välittämiseen webhookeja ja tee takaisinkirjoitus erissä kutsulla
change_multiple_column_values. (Kutsurajoitukset) - Yhdistettyjen taulujen määrää on rajoitettu. Basic sallii yhden tauluyhteyden ja Standard viisi, mikä rajoittaa linkitettyjen työvaihe- tai tuotetaulujen käyttöä. (Connect Boards -rajoitukset)
- Lukitse API-versio. Versiot vaihtuvat neljännesvuosittain. Ennen versiota 2026-04 oletusarvoinen boards-kysely ei palauttanut monitasoisia tauluja.
- Kursorin vanheneminen.
items_page-kursori on voimassa 60 minuuttia. Pitkät täsmäytysajot on voitava käynnistää uudelleen puhtaasti alusta. - Webhookien rajoitukset. URL-osoitteen pituus saa olla enintään 255 merkkiä, ja uudelleenyritykset päättyvät 30 minuutin kuluttua. Vastaanottajan on oltava idempotentti.
- Yksiköt ja kestot. Numbers-sarakkeissa ei ole yksikköä. Sovi ennen ensimmäistä tuontia, ilmoitetaanko kesto minuutteina vai tunteina.
Kuka määrittää monday.com-integraation ja vastaa sen tuesta?
Työhön kuuluu taulujen ja sarakkeiden vastaavuuksien määritys sekä niiden rajoitteiden määrittely, joita monday.com ei sisällä: työpisteet, työvuorot, asetusaikamatriisi, työkalut ja vaihtoehtoiset koneet.
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja vastaa tuesta tuotantokäyttöön siirtymisen jälkeen. Jokainen yritys rakentaa taulunsa eri tavalla, ja juuri tässä tiimin osaamista tarvitaan.
- monday.com-kumppanisi voi osallistua. Kumppani tuntee taulusi ja automaatiosi ja voi tarkistaa sarakkeiden vastaavuudet ja tokenien määritykset.
- Omat kehittäjäsi voivat jatkokehittää integraatiota SkyPlannerin dokumentoidun REST API -rajapinnan kautta API-tunnisteella. Alkuun pääsee pelkällä API-tunnisteella, ja SkyPlanner-tiimi auttaa tarvittaessa. Julkinen tuotedokumentaatio löytyy SkyPlannerin ohjeista.
SkyPlannerin hinta on alkaen 199 € kuukaudessa kuukausilaskutuksella, ja hintaan sisältyy 5 työpistettä. Saat integraatiosta prosessisi ja tarpeidesi mukaisen tarjouksen etukäteen tilauspakettisi yhteydessä, joten tiedät kokonaiskustannukset ennen aloittamista. Katso, miten monday.comin omat näkymät vertautuvat SkyPlanneriin, sivulta monday.com ja hienokuormitus. Yleiskatsaus löytyy monday.com-sivulta ja muut järjestelmät ERP-integraatioiden koontisivulta.
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 kytkinlaitteistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono välittyy 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.
6 kuukauttaeteenpäin – myynti näkee vapaan kapasiteetin
”SkyPlanner luo perustan ja tuo luotettavuutta kaikkeen tuotannonsuunnitteluun.”
Anu Järvinen, tuotantopäällikkö
Fredman Operations · Elintarvikekelpoiset pakkauspaperit
Myynti näkee vapaan kapasiteetin kuusi kuukautta eteenpäin, ja aikataulujen muutospyyntöihin vastataan sekunneissa aiemman tunnin tai pidemmän ajan sijaan.
Usein kysytyt kysymykset
Mitä monday.comin API-rajapintaa integraatio käyttää?
Integraatio käyttää monday.comin alustan GraphQL API -rajapintaa osoitteessa api.monday.com/v2. Versio lukitaan API-Version-otsakkeella. Tietojen lukuun käytetään items_page-kyselyä ja kirjoittamiseen change_multiple_column_values-kutsua. Webhookit ilmoittavat muutoksista.
Mitä monday.comissa pitää määrittää?
Käyttöoikeudet ja kaksi saraketta. monday.com-pääkäyttäjäsi valtuuttaa kerran OAuth- tai sovellustunnisteen, jonka käyttöoikeudet on rajattu. Tauluun lisätään Timeline-sarake ja työpistesarake takaisinkirjoitusta varten. Taulusi ja automaatiosi säilyvät ennallaan.
Minkä monday.com-tilauspaketin tarvitsemme?
Päivittäisten API-kutsujen enimmäismäärä kasvaa tilauspaketin mukaan: Standardissa ja sitä alemmissa paketeissa 1 000, Prossa 10 000 ja Enterprisessa 25 000. Pro tai Enterprise sopii kaksisuuntaiseen synkronointiin, jossa muutoksia tulee usein. SkyPlanner-tiimi tarkistaa tilauspakettisi ja tietomääräsi taulujen kartoituksen yhteydessä.
Voiko monday.com lähettää muutokset reaaliajassa?
Kyllä. Webhookit laukeavat, kun kohde luodaan tai sarakkeen arvo tai tila muuttuu. Tiedot luetaan ja täsmäytetään säännöllisesti, jotta mukaan saadaan myös muutokset, joiden ilmoitusten toimitus ei onnistu monday.comin 30 minuutin uudelleenyritysajan kuluessa.
Miten suunnitellut päivämäärät kirjoitetaan takaisin monday.comiin?
Jokaiselle kohteelle tehdään change_multiple_column_values-kutsu. Timeline-sarakkeeseen tallennetaan suunniteltu aloitus ja lopetus, ja työpiste- ja tilasarakkeet päivitetään samalla kutsulla.
Voimmeko kokeilla SkyPlanneria ennen integraation rakentamista?
Kyllä. Ilmaisessa 30 päivän kokeilussa voit käyttää enintään 20 työpistettä tuomalla taulusi tiedot Excel-vientinä. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation laajuuden määrittämiseksi.
