Integraatiot / ERP / Fulcrum
Fulcrum-integraation opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Fulcrum-integraation opas kertoo konsulteille ja IT-tiimeille, miten Fulcrum (Fulcrum Pro) yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Fulcrumin välinen integraatio toimii molempiin suuntiin Fulcrum Public API -rajapinnan kautta:
- SkyPlanneriin tuodaan työt sekä niiden valmistettavat nimikkeet ja työvaiheet, nimikkeiden reititykset, työpisteet, laitteet, osastojen työvuorot, seisokit, varastotiedot ja ostotilaukset.
- Suunniteltu aloitus, suunniteltu lopetus ja työpiste kirjoitetaan kunkin työn työvaiheen mukautettuihin kenttiin.
- Työntekijöiden työajat ja valmistuneet määrät palautetaan Fulcrumiin ajastintietoina ja määrien päivityksinä.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlanner-tiimi määrittää integraation Fulcrum-ympäristöönne sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on tarkoitettu konsulteille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa itse SkyPlannerin dokumentoidun REST API -rajapinnan varaan (rajapintakuvaus).
Fulcrum Public API
Fulcrum on yksi usean asiakkaan yhteinen pilvituote, joten kaikilla asiakkailla on käytössä sama API. Kehittäjäsivusto kuvaa sitä julkiseksi rajapinnaksi, jolla voi tehdä “REST API calls directly into your Fulcrum site.” (REST API -kutsuja suoraan omaan Fulcrum-ympäristöön).
- Rajapintakuvaus. OpenAPI “Fulcrum PublicAPI” v1 on ladattavissa osoitteesta
https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum suosittelee tyypitetyn asiakaskirjaston generointia sen pohjalta. History-sivulla on lueteltu kaikki muutokset päivämäärineen. - Palvelimet. Tavalliset ympäristöt käyttävät osoitetta
https://api.fulcrumpro.com. ITAR-ympäristöt käyttävät osoitettaapi.fulcrumpro.us, ja ITAR-tokenit saavat .com-palvelimelta vastauksen 401. - Kutsukäytännöt. Listat haetaan kutsulla
POST .../list, jonka rungossa annetaan suodatus. Sivutukseen käytetään kenttiäSkipjaTakeja lajitteluun kenttiäSort.Field/Sort.Dir. Monet objektit tukevat PUT-pyyntöjä, ja työt tukevat myös JSON Patch -päivityksiä.
Tuotannonsuunnittelun integraatiossa käytettävät päätepisteet:
| Osa-alue | Päätepisteet |
|---|---|
| Nimikkeet ja reititykset | /api/items, /api/items/{itemId}/routing, /routing/operations, /routing/input-items, /routing/input-materials |
| Tuotannon asetukset | /api/work-centers, /api/equipment, /api/operations, /api/department-shifts, /api/equipment-downtimes |
| Työt | /api/jobs, /api/jobs/{jobId}/items-to-make/{itemToMakeId}/operations, /api/work-orders |
| Materiaalit | /api/inventory, /api/materials, /api/purchase-orders, /api/reporting/material-requirements/list |
| Tuotantolattia | /api/job-tracking-timers/start ja /stop, /api/timers, .../operations/{operationId}/add-quantity-completed, .../complete |
Fulcrumin oma integraatiosivu kuvaa tarvittavaa työtä suoraan: “Every system is a little bit different and requires some configuration.” (Jokainen järjestelmä on hieman erilainen ja vaatii määrityksiä.) Juuri näistä määrityksistä SkyPlanner-tiimi huolehtii käyttöönoton aikana.
Tunnistautuminen
Fulcrum käyttää Bearer-tokenia Authorization-otsakkeessa. “A public API token can be generated within your fulcrum site via Business Setup -> System Data -> Public Api.” (Julkisen API:n tokenin voi luoda omassa Fulcrum-ympäristössä polussa Business Setup -> System Data -> Public Api.) Jokaisella tokenilla on nimi, kuvaus ja vanhenemispäivä. Voit luoda niitä niin monta kuin tarvitset ja poistaa tokenin käytöstä poistamalla sen. Luo SkyPlanner-integraatiolle oma token ja aseta muistutus ennen sen vanhenemista.
SkyPlannerin REST API käyttää tunnistautumiseen API-tokenia Authorization-Token-otsakkeessa (SkyPlanner Settings > API). Rajapinta on dokumentoitu Swagger/OpenAPI-muodossa. Integraatio-opas käy läpi ensimmäiset kutsut.
Tapahtumat ja säännölliset kyselyt
Fulcrum tukee webhookeja, jotka ylläpitäjä määrittää. Syyskuusta 2026 alkaen epäonnistuvat webhookit keskeytetään ja niitä testataan uudelleen päivittäin sen sijaan, että yrityksiä jatkettaisiin loputtomasti. API:n History-sivulla mainitaan esimerkiksi tapahtumat PurchaseOrderUpdated ja ItemUpdated.
Integraatio lukee Fulcrumin tietoja seuraavasti:
- Avoimet työt haetaan muutaman minuutin välein. Haku rajataan tiloihin
scheduledjainProgressehdollahasIncompleteOperations: true. Fulcrum itse suosittelee tätä suodatusta, kun haun halutaan vastaavan sen suunnittelunäkymää. - Ostotilaukset ja varastotiedot haetaan ennen jokaista suunnitteluajoa tai
PurchaseOrderUpdated-webhookin perusteella, jos se on määritetty käyttöön. - Nimikkeet, reititykset, laitteet ja työvuorot haetaan muutosten yhteydessä tai öisin.
Toiseen suuntaan SkyPlannerin omat webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa, joten tietojen kirjoittaminen takaisin Fulcrumiin on tapahtumaohjattua.
Tietojen vastaavuudet
| Fulcrum-objekti (päätepiste) | SkyPlanner-objekti | Suunta | Siirtotiheys |
|---|---|---|---|
Item, Materials (/api/items, /api/materials) | Tuotteet ja materiaalit | Fulcrum → SkyPlanner | Alkusiirto, sen jälkeen öisin |
Reitityksessä tarvittavat nimikkeet ja materiaalit (/routing/input-items, /input-materials) | Tuoterakenne, alituotteet ja tuotekohtaiset materiaalit | Fulcrum → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
Reitityksen työvaiheet (/routing/operations): setupTime, laborTime, machineTime (kiinteä tai yksikkökohtainen), selectedEquipmentIds | Työvaiheet, asetusajat, kestot ja sallitut työpisteet | Fulcrum → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
Work Center (/api/work-centers) | Työpisteryhmä | Fulcrum → SkyPlanner | Alkusiirto, sen jälkeen harvoin |
Equipment (/api/equipment): unlimitedCapacity, canRunUnattended, status | Työpisteet, erätyöt ja miehittämätön ajo | Fulcrum → SkyPlanner | Alkusiirto, tilatiedot päivittäin |
Department Shifts (/api/department-shifts), Equipment Downtimes | Työvuorot ja poissaolot | Fulcrum → SkyPlanner | Alkusiirto, sen jälkeen päivittäin |
Job ja sen työvaiheet (/api/jobs, .../items-to-make/{id}/operations): priority, productionDueDate, earliestStartDate, arviot | Tilaukset ja työt | Fulcrum → SkyPlanner | Kysely muutaman minuutin välein |
| Inventory, Purchase Orders ja niiden Expected Receive -päivämäärät | Varastosaldot ja saapuvat materiaalit | Fulcrum → SkyPlanner | Ennen jokaista suunnitteluajoa |
Työn työvaiheen customFields (POST .../operations/{operationId}) | Suunniteltu aloitus, suunniteltu lopetus ja työpiste | SkyPlanner → Fulcrum | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
Työn customFields (PUT /api/jobs/{jobId}/custom-fields) | Työn suunniteltu valmistuminen | SkyPlanner → Fulcrum | Aikataulun muuttuessa |
Työnseurannan ajastimet, /api/timers, add-quantity-completed, complete | Aikakirjaukset, valmistuneet määrät ja hylkymäärät | SkyPlanner → Fulcrum | Työntekijöiden kirjatessa töitä |
| Ei Fulcrumissa | Nimetyt työntekijät, asetusaikamatriisi, rajallisesti saatavilla olevat työkalut ja vaihtoehtoiset työpisteet | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toimintamallit
1. Perustietojen alkusiirto. Hae ensin nimikkeet, materiaalit, reititykset, työpisteet ja laitteet, sitten osastojen työvuorot ja seisokit. Jokaisesta Fulcrumin työpisteestä muodostetaan SkyPlanneriin työpisteryhmä, jonka jäseniksi tulevat sen laitteet. Kunkin reitityksen työvaiheelle valitut laitteet määritetään sen sallituiksi työpisteiksi. Unlimited Capacity -laitteet, kuten uunit ja maalauskammiot, mallinnetaan erätöinä.
2. Tilausten synkronointi. Lue avoimet työt sekä niiden valmistettavat nimikkeet ja työvaiheet, avoimet ostotilaukset ja varastotiedot. SkyPlanner käsittelee tilatun materiaalin saatavilla olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilauksen tilaksi merkitään Delivered. Varastosaldot ja saapuvat ostot tarkistetaan aina, kun aikataulu suunnitellaan uudelleen.
3. Suunnitelman palautus. Fulcrum laskee itse kenttien scheduledStartUtc, scheduledEndUtc ja scheduledEquipmentId arvot ja palauttaa ne vain luettavina. Työvaiheen päivitys hyväksyy customFields-kentät. SkyPlanner kirjoittaa suunnitellun aloituksen, valmistumisen ja työpisteen kunkin työn työvaiheen mukautettuihin kenttiin sekä suunnitellun valmistumisen työn mukautettuun kenttään. Myynti ja osto näkevät SkyPlannerin päivämäärät työn tiedoissa Fulcrumissa.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlannerissa toiminnoilla Mobile Confirmations, Production Timer tai Quick Log Mode. SkyPlanner lähettää työajan Fulcrumiin rajapintojen /api/job-tracking-timers/start ja /stop kautta tai valmiina aikajaksona rajapinnan /api/timers kautta. Määrät siirretään toiminnolla add-quantity-completed ja lopullinen määrä hylkymäärineen toiminnolla complete. Työkohtainen kustannuslaskenta pysyy Fulcrumissa ajan tasalla.
5. Tietovastuut ja ristiriitojen hallinta. Fulcrumin suunnittelutoiminto ”dictates the order of operations in Job Tracking.” (määrää työvaiheiden järjestyksen Job Trackingissa). Valitse siksi kullekin työvaiheelle vain yksi työnjakokanava: SkyPlannerin työntekijän työjono tai Fulcrum Job Tracking. Kirjaa säännöt ennen tuotantokäyttöön siirtymistä:
| Tiedot | Vastuujärjestelmä |
|---|---|
| Nimikkeet, reititykset, arviot, varastotiedot, ostot, kustannuslaskenta | Fulcrum |
| Työvaiheiden järjestys, alkamis- ja päättymisajat, työpisteiden valinta | SkyPlanner |
| Työntekijät, asetusaikamatriisi, työkalut, vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot ja seisokit | Yksi järjestelmä, joka valitaan määrittelyssä |
| Kirjattu työaika ja valmistuneet määrät | SkyPlanner, tiedot siirretään Fulcrumiin |
Projektin tyypilliset vaiheet
Toteutus valmistuu tavallisesti viikoissa käyttöönoton aloittamisesta. Sitä ennen voit kokeilla ohjelmistoa maksutta 30 päivän ajan omilla tiedoillasi. Vie nimikkeet, reititykset ja avoimet työt Fulcrumin taulukkonäkymistä CSV-tiedostoiksi, tuo ne SkyPlanneriin ja tarkista suunnitelma.
Varsinainen projekti sisältää seuraavat vaiheet:
- Tunniste ja määrittely. Luo Public API -tunniste ja sovi mukautetuista kentistä, joihin tiedot palautetaan.
- Tietojen vastaavuudet. Vahvista vastaavuustaulukko, tietovastuut ja työnjakokanava.
- Alkulataus. Nimikkeet, materiaalit, reititykset, työpisteet, laitteet, työvuorot ja seisokit.
- Tilausten ja ostotilausten synkronointi. Töiden muutosten säännöllinen kysely sekä ostotilausten ja varastotietojen synkronointi.
- Rajoitteiden määritys SkyPlannerissa. Työntekijät ja heidän työvuoronsa, asetusaikamatriisi, työkalut ja vaihtoehtoiset työpisteet.
- Tietojen palautus. Töiden ja työvaiheiden mukautetut kentät.
- Tuotannon kirjausten siirto. Ajastimet ja määrät Fulcrumiin.
- Rinnakkaistestaus ja tuotantokäyttö. Käytä SkyPlanneria Fulcrumin suunnitelman rinnalla, vertaa päivämääriä ja korjaa perustiedot. Siirry sitten jakamaan työt SkyPlannerin suunnitelman mukaan.
Mitä Fulcrum-integraatiossa on huomioitava
- Työvoima huomioidaan vuorokohtaisissa määrissä. Fulcrumin Max Equipment per shift ”is usually determined by how many people you have working in a certain area at that time.” (määräytyy yleensä sen mukaan, kuinka monta henkilöä tietyllä alueella on tuolloin töissä). Nimetyt työntekijät ja heidän työvuoronsa määritetään SkyPlannerissa. Nimet saadaan rajapinnan
/api/userskäyttäjätiedoista. - Työt suunnitellaan laitteille. Fulcrumin työpisteet ovat keskenään vaihtokelpoisten laitteiden ryhmiä. Pidä reititykseen valitut laitteet ajan tasalla, sillä ne muodostavat vaihtoehdot, joiden väliltä suunnittelumoottori valitsee.
- Työmääräimet ryhmittelevät töitä. Työmääräin kokoaa yhteen useiden töiden työvaiheita esimerkiksi nestausta varten. Ryhmitetyn työvaiheen ajastimen käynnistys käynnistääkin työmääräimen ajastimen, joka kattaa ryhmän kaikkien töiden työvaiheet.
- Ajastimien rajoitukset. Jälkikäteen kirjattavat
/api/timers-aikajaksot ”may not be in the future, older than 30 days, or longer than 7 days.” (eivät saa sijoittua tulevaisuuteen eivätkä ylittää mainittuja ikä- ja kestorajoja). Siirrä työaika sitä mukaa kuin työntekijät kirjaavat sitä. - Aikatietojen esitysmuodot vaihtelevat. Työvuoroissa käytetään paikallisia HHmm-arvoja, seisokit ja suunnitellut päivämäärät ovat UTC-ajassa, ja työvaiheiden aika-arviot tulevat sekunteina.
- Laitepäivitys korvaa koko tietueen. Laitteen PUT-pyyntö tyhjentää kaikki kentät, joita pyynnössä ei ole mukana. SkyPlanner vain lukee laitetietoja eikä koskaan kirjoita niitä.
- ITAR-ympäristöt. Käytä
.us-palvelinta ja ITAR-tunnistetta.
Kuka määrittää Fulcrum-integraation ja tukee sitä?
Työhön kuuluu osastojen, työpisteiden, laitteiden ja reititysten vastaavuuksien määrittely. Lisäksi määritetään rajoitteet, joita Fulcrum ei sisällä: nimetyt työntekijät, asetusaikamatriisi, työkalut ja vaihtoehtoiset resurssit.
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen. Jokainen tehdas käyttää Fulcrumia omalla tavallaan, ja tämä käytännön tuntemus hyödynnetään määrityksissä.
- Fulcrum-konsulttisi tai integraatiokumppanisi voi toteuttaa integraation. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Myös omat kehittäjänne voivat toteuttaa integraation. Alkuun pääsee API-tunnisteella, ja SkyPlanner-tiimi auttaa tarvittaessa. Tuotedokumentaatio, mukaan lukien ostotilaukset sekä tuotteiden ja materiaalien API, löytyy SkyPlannerin dokumentaatiosta.
SkyPlannerin hinta on alkaen 199 € kuukaudessa kuukausilaskutuksella, ja hintaan sisältyy 5 työpistettä. Integraatiosta annetaan etukäteen prosessisi ja tarpeidesi mukainen tarjous yhdessä tilauksesi kanssa, joten tiedät kokonaiskustannukset ennen aloittamista. Tutustu hinnastoon ja ominaisuuksiin sekä vertaa Fulcrumin omaa suunnittelutoimintoa artikkelissa Fulcrumin hienokuormitus. Yleiskatsaus on Fulcrum-sivulla, ja muut ERP-järjestelmät löytyvä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 kojeistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono saadaan tuotantolinjalle sekunneissa.
+90%tuotannon tehokkuuteen
”Tuotannon tehokkuus on kasvanut 90%.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkevalmistus
Tuotannon tehokkuus on kasvanut 90%, ja kaikki työpisteet kattava optimoitu suunnitelma kolmeksi kuukaudeksi syntyy alle 30 minuutissa.
99,2%toimitusvarmuus
”SkyPlanner on auttanut tunnistamaan pullonkaulat 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ä.
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 parhaimmillaan 98%:iin, ja tuotannonsuunnitteluun tarvitaan nyt kahden työnjohtajan sijaan yksi.
Usein kysytyt kysymykset
Onko Fulcrumissa API-rajapinta?
Kyllä. Fulcrum Public API on REST API -rajapinta, jolla on OpenAPI v1 -määritys. Tunnistautuminen tapahtuu Bearer-tunnisteella, joka luodaan kohdassa Business Setup > System Data > Public Api. ITAR-ympäristöt käyttävät erillistä .us-palvelinta.
Voiko SkyPlanner palauttaa tuotantosuunnitelman Fulcrumiin?
Kyllä. Fulcrumin omat suunnitellut päivämäärät ovat vain luettavissa, joten SkyPlanner kirjoittaa suunnitellun aloituksen, valmistumisen ja työpisteen kunkin työn työvaiheen mukautettuihin kenttiin sekä suunnitellun valmistumisen työn tietoihin. Työntekijöiden työajat ja valmistuneet määrät palautetaan ajastimina ja määräpäivityksinä.
Lähettääkö Fulcrum muutokset reaaliajassa?
Fulcrumissa on pääkäyttäjän määrittämiä webhookeja esimerkiksi tapahtumalle PurchaseOrderUpdated. Avoimet työt haetaan muutaman minuutin välein samalla suodattimella, jota Fulcrum käyttää suunnittelusivullaan. SkyPlannerin omat webhookit lähettävät suunnitelman muutokset heti niiden tapahtuessa.
Kuka toteuttaa Fulcrum-integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen. Myös Fulcrum-konsulttisi, integraatiokumppani tai omat kehittäjänne voivat toteuttaa integraation SkyPlannerin dokumentoidun REST API -rajapinnan avulla.
Voimmeko testata SkyPlanneria ennen integraation toteuttamista?
Kyllä. Maksuton 30 päivän kokeilu tukee enintään 20 työpistettä ja tietojen tuontia Fulcrumista CSV-tiedostoina. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
