Integraatiot / ERP / Katana
Katana-integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Katana-integraatio-opas kertoo konsulteille ja IT-tiimeille, miten Katana Cloud Inventory (Katana MRP) yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Katanan välinen integraatio toimii molempiin suuntiin julkisen Katana API:n kautta:
- SkyPlanneriin tuodaan valmistustilaukset, työvaiherivit, tuotereseptit, tuotannon työvaiheet, resurssit, varastotiedot ja ostotilaukset.
- Suunniteltu työjärjestys palautetaan Katanan Schedule-välilehdelle, ja jokaiselle valmistustilaukselle asetetaan tuotannon määräpäivä.
- Työvaiheen tila ja toteutunut aika palautetaan työvaiheriveille.
- Katanan webhookit ilmoittavat muutoksista SkyPlanneriin, ja SkyPlannerin webhookit välittävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlannerin tiimi määrittää integraation Katana-ympäristöösi 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 ratkaisuja SkyPlannerin dokumentoidun REST API:n pohjalta (API-dokumentaatio).
Katana API
Katana on yksi yhteinen, monivuokralaisarkkitehtuuriin perustuva pilvituote, joten kaikilla asiakkailla on käytössään sama API. REST API:n versio v1 on osoitteessa https://api.katanamrp.com/v1, ja sen OpenAPI 3.0 -määritys löytyy osoitteesta https://api.katanamrp.com/v1/openapi.json. Dokumentaatio on Katana Developer Hub -sivustolla.
Tuotannonsuunnittelussa tarvittavat rajapinnan päätepisteet:
- Nimikkeiden perustiedot:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Tilaukset:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Järjestys:
/manufacturing_order_rerank. - Tarjonta ja kysyntä:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Rajapinnassa ei ole /resources-päätepistettä. Resurssit löytyvät tuotteiden ja valmistustilausten työvaiheriveiltä kentistä resource_id ja resource_name.
Tunnistautuminen ja rajoitukset
Todennuksessa käytetään API-avainta bearer-tokenina: Authorization: Bearer <api key>. Luo avain kohdassa Settings > API > Add new API key. (lähde)
Huomioi nämä rajoitukset synkronoinnin suunnittelussa:
- Oletusarvoisesti Katana API sallii 60 pyyntöä 60 sekunnissa (lähde)
- Rajan ylittyessä API palauttaa tilakoodin 429 ja
Retry-After-otsakkeen.X-Ratelimit-Remainingkertoo, kuinka monta pyyntöä on vielä käytettävissä. - Listauksia palauttavat päätepisteet sivuttavat tulokset ja tukevat suodatusta päivityspäivän perusteella, joten kerralla siirrettävien muutosten määrä pysyy pienenä.
SkyPlannerin REST API käyttää todennukseen API-tokenia (SkyPlanner Settings > API), ja sen dokumentaatio on Swagger/OpenAPI-muodossa. Integraatio-ohje käy läpi ensimmäiset kutsut.
Webhookit
Rekisteröi webhook POST-kutsulla päätepisteeseen /webhooks ja määritä HTTPS-osoite sekä tarvitsemasi tapahtumat. (lähde) Tuotannonsuunnittelussa hyödylliset tapahtumat:
manufacturing_order.created,.updated,.deleted,.in_progress,.blocked,.donemanufacturing_order_operation_row.created,.updated,.in_progress,.paused,.completedcurrent_inventory.material_updated,.material_out_of_stockpurchase_order.*japurchase_order_row.*, myös vastaanottotapahtumatproduct.*,product_recipe_row.*jasales_order.*
Viestien sisältö on suppea: resurssityyppi, toiminto ja href. Vastaanottaja hakee koko objektin href-osoitteesta. Jokaisessa viestissä on x-sha2-signature-otsake (HMAC SHA-256) aitouden varmistamista varten. Päätepisteesi on vastattava 20X-tilakoodilla 10 sekunnin kuluessa. Katana yrittää toimitusta uudelleen kolme kertaa: 30 sekunnin, 2 minuutin ja 15 minuutin kuluttua.
Tietojen vastaavuudet
| Katanan objekti (päätepiste) | SkyPlanner-objekti | Suunta | Siirtotiheys |
|---|---|---|---|
Tuotteet, materiaalit, variantit (/products, /materials, /variants) | Tuotteet ja materiaalit | Katana → SkyPlanner | Alkusiirto, sen jälkeen webhookin perusteella |
Tuoteresepti / BOM (/recipe_rows, /bom_rows) | Tuoterakenne, alituotteet | Katana → SkyPlanner | Alkusiirto, sen jälkeen webhookin perusteella |
Tuotannon työvaiheet (/product_operation_rows): tyyppi, resurssi, aika | Työvaiheet kestoineen ja asetusaikoineen | Katana → SkyPlanner | Alkulataus, sitten muutosten yhteydessä |
Resurssit (resource_id, resource_name työvaiheriveillä) | Työpisteet, työpisteryhmät | Katana → SkyPlanner | Alkusiirto ja uuden resurssin luonnin yhteydessä |
Valmistustilaus työvaiheriveineen (/manufacturing_orders, /manufacturing_order_operation_rows) | Tilaukset ja työt | Katana → SkyPlanner | Reaaliaikaisesti webhookin kautta |
Valmistustilauksen materiaalit (/manufacturing_order_recipe_rows) | Työkohtaiset materiaalit | Katana → SkyPlanner | Reaaliaikaisesti webhookin kautta |
Varastotiedot, ostotilaukset saapumispäivineen (/inventory, /purchase_order_rows) | Varastosaldot ja saapuva materiaali | Katana → SkyPlanner | Reaaliaikaisesti webhookin kautta |
Myyntitilauksen delivery_date (/sales_orders) | Tilauksen määräpäivä, asiakkaan prioriteetti | Katana → SkyPlanner | Reaaliaikaisesti webhookin kautta |
Valmistustilausten järjestys (POST /manufacturing_order_rerank) | Avointen valmistustilausten suunniteltu järjestys | SkyPlanner → Katana | Aikataulun muuttuessa |
Valmistustilauksen production_deadline_date (PATCH /manufacturing_orders/{id}) | Suunniteltu valmistumisaika | SkyPlanner → Katana | Aikataulun muuttuessa |
Työvaiherivin status, total_actual_time (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, aikakirjaukset | SkyPlanner → Katana | Työkirjausten yhteydessä |
| Ei Katanassa | Työvuorot, poissaolot, asetusaikamatriisi, työkalut, työntekijämäärät, vaihtoehtoiset työpisteet | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutustavat
1. Perustietojen alkusiirto. Hae tuotteet, materiaalit, variantit, reseptirivit ja tuotteiden työvaiherivit sivu kerrallaan. Rajoita kutsutahtia niin, ettei kutsuraja ylity. Luo SkyPlannerin työpisteet työvaiherivien erillisistä resursseista ja säilytä avainten 1:1-vastaavuus. Määritä työvuorot, vapaat ja ylityöt SkyPlannerissa työpistekohtaisesti, sillä Katanassa ei ole resurssikalenteria.
2. Tilausten synkronointi. Tilaa valmistustilausten, työvaiherivien, varaston ja ostotilausten tapahtumat. Hae jokaisen tapahtuman yhteydessä objekti sen href-osoitteesta ja päivitä työ. SkyPlanner katsoo tilatun materiaalin olevan käytettävissä ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilaus vastaanotetaan. Öinen täsmäytys päivityspäivän suodattimilla kattaa mahdolliset väliin jääneet tapahtumat.
3. Aikataulun kirjoittaminen takaisin. Suunnitelma siirretään Katanaan kahdella kutsulla:
- POST
/manufacturing_order_rerank“moves one or more manufacturing orders to an exact place in the production schedule” (siirtää yhden tai useamman valmistustilauksen täsmälliseen kohtaan tuotantoaikataulussa). Yhdellä pyynnöllä voi siirtää enintään 250 avointa valmistustilausta alkuun, loppuun tai tietyn valmistustilauksen edelle tai perään. (lähde) - PATCH
/manufacturing_orders/{id}asettaaproduction_deadline_date-kentän arvon. Katana hyväksyy sen vain, kun kyseisen tehdastoimipaikan automaattinen määräpäivän laskenta on pois käytöstä. (lähde)
Järjestyksen muuttaminen vaikuttaa muuhunkin kuin listaan. Katanassa “higher-priority MOs reserve required materials and subassemblies first” (korkeamman prioriteetin valmistustilaukset varaavat tarvittavat materiaalit ja osakokoonpanot ensin), joten SkyPlannerin määrittämä järjestys ratkaisee myös sen, mille valmistustilaukselle varastossa olevat nimikkeet varataan Katanassa.
4. Tuotannon työkuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations-, Production Timer- tai Quick Log Mode -toiminnolla. SkyPlanner kirjoittaa tilan ja toteutuneen ajan valmistustilauksen työvaiheriville. Jos tehtaalla jatketaan sen sijaan Katana Shop Floor App -sovelluksen käyttöä, SkyPlanner lukee työvaiherivien tapahtumat. Valitse kullekin tehtaalle yksi raportointikanava.
5. Tietojen omistajuus ja ristiriitojen ratkaisu. Kirjaa säännöt ennen tuotantokäytön aloittamista:
| Tiedot | Omistaja |
|---|---|
| Tuotteet, reseptit, tuotannon työvaiheet, varastotiedot, ostot, myyntitilaukset | Katana |
| Työvaiheiden järjestys, alku- ja loppuajat, työvaihekohtainen työpiste | SkyPlanner |
| Valmistustilauksen sijainti Schedule-välilehdellä ja tuotannon määräpäivä | SkyPlanner, tiedot kirjoitetaan Katanaan |
| Työvuorot, poissaolot, asetusaikamatriisi, työkalut, vaihtoehtoiset resurssit | SkyPlanner |
| Työvaiheen tila ja kirjattu aika | Yksi kanava, joka valitaan määrittelyssä |
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä muutamassa viikossa käyttöönoton aloituksesta. Sitä ennen voit kokeilla ohjelmistoa maksutta 30 päivän ajan omilla tiedoillasi, jotka tuodaan Katanasta CSV-tiedostona esimerkiksi Make-näkymän Tasks-listasta.
Varsinainen projekti sisältää seuraavat vaiheet:
- Tilauspaketti ja avain. Varmista, että Katanan tilauspakettiin sisältyvät API ja Manufacturing Management, ja luo API-avain.
- Määräaikojen määritystapa. Sopikaa automaattisten määräaikojen poistamisesta käytöstä tehtaan toimipaikassa, jotta SkyPlanner vastaa tuotannon määräajoista.
- Tietojen vastaavuudet. Vahvistakaa vastaavuustaulukko, resurssien avaimet, tietojen omistajuussäännöt ja raportointikanava.
- Alkulataus. Tuotteet, variantit, reseptit, tuotannon työvaiheet ja resurssit.
- Tapahtumien synkronointi. Webhookit tilauksille, työvaiheille, varastolle ja ostotilauksille sekä tietojen öinen täsmäytys.
- Rajoitteiden määritys SkyPlannerissa. Työvuorot, asetusaikamatriisi, työkalut, työntekijämäärät ja vaihtoehtoiset työpisteet.
- Tietojen kirjoittaminen takaisin. Ensin järjestys ja määräajat, sitten työvaiheiden tila ja aika.
- Rinnakkaistestaus ja tuotantokäytön aloitus. Verratkaa SkyPlannerin päivämääriä nykyiseen Schedule-välilehteen, korjatkaa perustiedot ja ottakaa sitten tietojen kirjoittaminen takaisin käyttöön.
Mitä Katana-integraatiossa on otettava huomioon
- Automaattiset määräajat korvaavat aiemmat päivämäärät. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Kun automaattinen tila otetaan käyttöön, kaikki käsin asetetut määräajat korvataan, eikä niitä voi palauttaa.) Päättäkää määritystapa kerralla projektin aloituksessa.
- Ei resurssikalenteria. Älä johda työvuoroja pelkästä Weekly throughput -arvosta. Määritä ne työpistekohtaisesti SkyPlannerissa.
- Resurssit ovat vain työvaiheriveillä. Pidä resurssien nimet Katanassa muuttumattomina, sillä ne toimivat avaimina SkyPlannerin työpisteisiin.
- Aikayksiköt.
planned_time_parameterilmoitetaan sekunteina: kappalekohtaisissa työvaiheissa yhtä kappaletta kohti ja tyypeissä process, setup ja fixed kokonaisaikana. Määritä tyypin vastaavuus oikein, tai kestot ovat kappalemäärän verran liian suuria tai pieniä. - Tilausohjautuvan tuotannon ryhmät. Kun järjestystä muutetaan, samaan myyntitilaukseen liittyvät valmistustilaukset pysyvät yhdessä. Määritä siis niiden paikka järjestyksessä yhtenä ryhmänä.
- rerank-toimintatapa on muuttunut. 7. lokakuuta 2026 alkaen rerank-rajapintapisteet sijoittavat tilaukset täsmälleen pyydettyyn kohtaan. Vanhan toimintatavan mukaan rakennetut integraatiot on testattava uudelleen. (lähde)
Katana-integraatio: kuka määrittää sen ja vastaa tuesta
Työssä käydään läpi resurssinne, tuotannon työvaiheet, tilausvirta ja määräaikojen määritystapa. Samalla lisätään tiedot, joita Katanassa ei ole: työvuorot, asetusaikamatriisi, työkalut, työntekijämäärät ja vaihtoehtoiset resurssit.
- SkyPlannerin tiimi määrittää integraation käyttöönoton aikana ja vastaa tuesta tuotantokäytön alettua. Jokainen tehdas määrittää Katanan resurssit ja työvaiheet eri tavalla. Tämä osaaminen hyödynnetään integraation määrityksessä.
- Katana-konsulttinne tai integraatiokumppaninne voi rakentaa integraation. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Omat kehittäjänne voivat rakentaa ratkaisun rajapinnan avulla. Alkuun pääsee pelkällä API-tokenilla, ja SkyPlannerin tiimi auttaa tarvittaessa. Tuotedokumentaatio, mukaan lukien ostotilaukset sekä tuotteiden ja materiaalien API, löytyy SkyPlannerin dokumentaatiosta.
SkyPlanner maksaa alkaen 199 € kuukaudessa, ja hintaan sisältyy 5 työpistettä. Laskutus on kuukausittainen. Integraatiosta annetaan etukäteen prosessinne ja tarpeidenne mukainen tarjous yhdessä tilauspaketin kanssa, joten näette kokonaiskustannukset ennen aloittamista. Tutustu hinnastoon ja ominaisuuksiin sekä vertaa Katanan omaa tuotannonsuunnittelua SkyPlanneriin sivulla Katanan hienokuormitus. Yleiskatsaus löytyy Katana-sivulta ja muut ERP-järjestelmät ERP-integraatioiden koontisivulta.
Valmistavien yritysten 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 linjalle 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 kolmelle kuukaudelle syntyy alle 30 minuutissa.
Vähemmänmateriaalipuutteista johtuvia seisokkeja
”SkyPlannerin arvo meille on siinä, että se on arjessa toimiva työkalu etenkin toimituspäivien määrittämiseen.”
Tommi Männistö, tuotannonsuunnittelupäällikkö
Eskomatic · Sopimuskoneistus
Automaattinen kuormitussuunnittelu tarkentaa toimituspäiviä, ja materiaalipuutteista johtuvat tuotantoseisokit ovat vähentyneet huomattavasti.
1 000:iatyötilauksia 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 suunnittelu hoituu automaattisesti, ja koko organisaatiolla on reaaliaikainen näkymä tuotantoon.
Usein kysytyt kysymykset
Onko Katanassa API, ja minkä tilauspaketin tarvitsen?
Kyllä. Katana tarjoaa julkisen REST API -rajapinnan, jonka versio on v1 ja määritys OpenAPI 3.0. Katanan hinnastosivun mukaan API sisältyy Free- ja Advantage-tilauspaketteihin. Tunnistautuminen tapahtuu bearer-tyyppisellä API-avaimella, joka saadaan kohdasta Settings > API.
Voiko SkyPlanner kirjoittaa tuotantosuunnitelman takaisin Katanaan?
Kyllä. SkyPlanner siirtää avoimet valmistustilaukset suunnitelmansa mukaiseen järjestykseen Katanan Schedule-välilehdellä /manufacturing_order_rerank-rajapintapisteen kautta ja kirjoittaa kunkin valmistustilauksen production_deadline_date-arvon. Työvaiheen tila ja toteutunut aika siirtyvät valmistustilauksen työvaiheriveille. Kunkin työpisteen aikataulu on SkyPlannerissa, jossa työntekijät työskentelevät oman työjononsa mukaan.
Lähettääkö Katana muutokset reaaliajassa?
Kyllä. Katanan webhookit kattavat valmistustilaukset, työvaiherivit, varaston, ostotilaukset ja myyntitilaukset. SkyPlanner hakee jokaisen muuttuneen objektin ja täsmäyttää tiedot öisin, joten väliin jäänyt tapahtuma ei koskaan jätä työn tietoja vanhentuneiksi.
Miten Katanan resursseista muodostetaan SkyPlannerin työpisteet?
Jokaisesta Katanan työvaiheriveillä olevasta erillisestä resurssista muodostetaan SkyPlanneriin työpiste 1:1-avainvastaavuudella. Sen jälkeen työvuorot, poissaolot ja vaihtoehtoiset työpisteet määritetään SkyPlannerissa.
Voimmeko kokeilla SkyPlanneria ennen integraation rakentamista?
Kyllä. Maksuton 30 päivän kokeilu tukee enintään 20 työpistettä, ja tiedot voi tuoda Katanasta CSV-tiedostona. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
