Integraatiot / ERP / Sage 200
Sage 200 -integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Sage 200 -integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten Sage 200 Professional ja sen valmistuksen lisäosa yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Sage 200:n integraatio toimii molempiin suuntiin:
- Tuotteet, varastosaldot, ostotilaukset ja myyntitilaukset tuodaan Sage 200 REST API -rajapinnan kautta.
- Työmääräimet, työvaiheet sekä henkilö- ja koneresurssit tuodaan valmistuksen lisäosasta.
- Työvaiheiden suunnitellut päivämäärät palautetaan työmääräimille.
- Työntekijöiden aikakirjaukset palautetaan kunkin työvaiheen tuntikirjauksiksi.
SkyPlanner-tiimi määrittää integraation Sage 200 -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 (API-viite).
Kaksi tietolähdettä samassa Sage 200 -järjestelmässä
Valmistavan yrityksen Sage 200 -ympäristössä on kaksi kerrosta, ja integraatio lukee tietoja molemmista.
1. Sage 200 REST API kaupallisia tietoja ja varastotietoja varten. Sagen mukaan rajapinta “lets your application read and modify data in a Sage 200 site” (antaa sovelluksesi lukea ja muokata ympäristön tietoja). Näihin kuuluvat asiakkaat, toimittajat, tuotteet, myynti- ja ostotilaukset sekä kirjanpitotilit. Sage 200 Professional -viitedokumentaatio (2025.02) ryhmittelee resurssit seuraavasti: Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP ja Stock. Tuotannonsuunnittelun kannalta olennaiset resurssit:
| Resurssi | Sisältö |
|---|---|
products | Tunnus, nimi, varastoyksikkö, BOM-nimiketyyppi, vakiokustannus |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Avoimet ostotilaukset, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Asiakaskysyntä, requested_delivery_date, promised_delivery_date |
warehouses, units | Toimipaikat ja mittayksiköt |
2. Valmistuksen lisäosa työmääräimiä varten. Sage 200 API ei sisällä päätepisteitä työmääräimille, työvaiheille eikä resursseille. Työmääräimet ovat Sicon Works Order Processing -lisäosassa, Cim200:ssa tai vanhassa Sage 200 Manufacturing -moduulissa. Integraatio lukee työmääräimet, työvaiheet ja resurssit lisäosan tukemalla tavalla, josta sovitaan määrittelyssä yhdessä sinun ja Sage 200 -kumppanisi kanssa.
Todennus ja käyttöoikeudet
Sage 200 API “uses OAuth 2.0 with OpenID Connect” (käyttää OAuthia yhdessä OpenID Connectin kanssa) ja authorization code grant -menettelyä. Kirjautuminen tapahtuu Sage ID:n kautta.
- Liity Sage 200 API Developer Programme -ohjelmaan ja pyydä tunnukset.
- Liitä Sage ID sellaiseen Sage 200 -käyttäjään, jolla on käytettävien päätepisteiden edellyttämät yritys- ja toimintokohtaiset käyttöoikeudet.
- Pyydä
offline_access-käyttöoikeusalue, sillä ilman sitä päivitystunnistetta ei myönnetä. - Lähetä jokaisessa tietokantapyynnössä
Authorization: Bearer <access_token>,X-SitejaX-Company. Molemmat tunnukset saadaan/sites-päätepisteestä.
Sage 200 Professionalin perus-URL: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Pyynnöissä käytetään GET-, POST-, PUT- ja DELETE-menetelmiä sekä OData-kyselyvalintoja $filter, $select, $top, $skip, $orderby ja $expand.
Sage 200 Professionalissa asiakkaan tukipalveluntarjoaja ottaa API:n käyttöön. Sagen tarkistuslistan mukaan palveluntarjoaja varmistaa, että “the API is enabled” (API on käytössä) ja että “each required user has a Sage ID assigned.” (jokaiselle tarvittavalle käyttäjälle on määritetty Sage ID). Sage 200 Standardissa API on oletusarvoisesti käytössä.
Tunnisteiden voimassaoloajat on otettava huomioon suunnittelussa. Käyttöoikeustunnisteet ovat voimassa 8 tuntia. Päivitystunnisteiden voimassaoloaika on 1–90 päivää, ja “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (Päivitysjakso lasketaan käyttäjän ensimmäisestä kirjautumisesta, ei viimeisimmästä päivityksestä.) Sagen mukaan uudelleentodennus “is unavoidable” (on väistämätöntä). Suunnittele hälytys, joka pyytää käyttäjää uusimaan suostumuksensa ennen jakson päättymistä.
SkyPlannerin REST API käyttää todennukseen API-tunnistetta (SkyPlanner Settings > API), ja sen dokumentaatio on Swagger/OpenAPI-muodossa. Integraatio-ohje opastaa ensimmäisten kutsujen tekemisessä.
Muutosten tunnistaminen
Sage 200 API:n viitedokumentaatiossa ei ole webhook- eikä tilausresurssia. Muutokset haetaan säännöllisillä kyselyillä. Tietueissa on date_time_created– ja date_time_updated-kentät, joten kukin kysely suodattaa tiedot $filter-valinnalla date_time_updated-kentän perusteella ja sivuttaa tulokset $top– ja $skip-valinnoilla.
Kysele työmääräinten muutokset muutaman minuutin välein sekä varastosaldojen ja ostotilausrivien muutokset tunnin välein. SkyPlanner lähettää webhook-ilmoituksia aikataulun muuttuessa, joten tietojen takaisinkirjoitus on tapahtumapohjaista.
Tietojen vastaavuudet
| Sage 200 -objekti (lähde) | SkyPlanner-objekti | Suunta | Päivitystiheys |
|---|---|---|---|
products, units (API) | Tuotteet ja materiaalit | Sage 200 → SkyPlanner | Alkulataus, sen jälkeen säännölliset kyselyt |
| BOM-komponentit (lisäosa tai BOM-moduuli) | Tuoterakenne, alituotteet, tuotekohtaiset materiaalit | Sage 200 → SkyPlanner | Muutoksen yhteydessä |
| Henkilö- ja koneresurssit, resurssiryhmät (lisäosa) | Työpisteet, työpisteryhmät, henkilöstö | Sage 200 → SkyPlanner | Alkulataus |
| Resurssien käytettävyys: seisokit, huollot, lomat (lisäosa) | Työvuorot, poissaolot | Sage 200 → SkyPlanner | Päivittäin |
| Työmääräimet työvaiheineen, työvaihekohtaiset ajat (lisäosa) | Tilaukset ja työt vaiheineen, kestoineen ja määräpäivineen | Sage 200 → SkyPlanner | Muutaman minuutin välein |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Asiakastilausten määräpäivät | Sage 200 → SkyPlanner | Säännölliset kyselyt |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Varastosaldot | Sage 200 → SkyPlanner | Tunnin välein |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Ostotilaukset ja odotetut toimituspäivät | Sage 200 → SkyPlanner | Tunnin välein |
| Työmääräimen työvaiheen suunniteltu alku ja loppu sekä resurssi | Työvaihekohtainen suunniteltu alku, loppu ja työpiste | SkyPlanner → Sage 200 | Muutoksen yhteydessä webhookilla |
| Työvaiheen tuntikirjaus (lisäosa) | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → Sage 200 | Kuittauksittain tai työvuoroittain |
| SkyPlannerin rajoitetiedot | Asetusaikamatriisi, työkalut rajallisesti käytettävissä olevina resursseina, vaihtoehtoiset koneet ja henkilöt | Ylläpidetään SkyPlannerissa | Käyttöönotto |
Integraation toteutusmallit
1. Perustietojen alkulataus. Hae tuotteet ja yksiköt API:sta ja sen jälkeen resurssit, resurssiryhmät ja BOM-työvaiheet lisäosasta. Kolmen samanlaisen koneen resurssiryhmä voidaan mallintaa yhtenä työpisteryhmänä tai kolmena työpisteenä.
2. Tilausten synkronointi. Lue avoimet työmääräimet työvaiheineen lisäosasta sekä avoimet pop_order_lines-tietueet ja warehouse_holdings-tiedot API:sta. Aikataulua laadittaessa tarkistetaan sekä varastosaldot että saapuvat ostot. MRP ehdottaa edelleen työmääräimiä Sage 200:ssa, ja SkyPlanner suunnittelee luomiesi työmääräinten aikataulut.
3. Aikataulun takaisinkirjoitus. SkyPlanner palauttaa työmääräimelle suunnitellun alun, lopun ja resurssin jokaisesta työvaiheesta, jonka laskentamoottori on sijoittanut aikatauluun tai siirtänyt siinä. Lisäosa säilyttää omat määränsä, varauksensa ja kustannuslaskentansa.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations – tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Kirjattu aika palautetaan työmääräimen työvaiheen tuntikirjauksiksi, joten Sage 200:n kustannuslaskenta saa toteutuneet tunnit.
Jos tehtaallasi kirjataan jo tunnit Sicon Shop Floor Data Capture – tai Cim200 Shop Floor Data Capture -ratkaisulla, valitse yksi kirjauskanava.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäyttöön siirtymistä:
| Tiedot | Omistaja |
|---|---|
| Tuotteet, osaluettelot, valmistustilausten määrät, varaukset, kustannukset | Sage 200 ja lisäosa |
| Työvaiheiden järjestys, alkamis- ja päättymisajat, työpisteiden valinta | SkyPlanner |
| Asetusaikamatriisi, työkalu- ja työntekijävaatimukset, vaihtoehtoiset resurssit | SkyPlanner |
| Aikakirjaukset | Sage 200, johon aikakirjaukset tuodaan SkyPlannerista |
Ristiriitoja syntyy ennen kaikkea kapasiteettikaaviosta. Jos suunnittelijat siirtävät edelleen valmistustilauksia tai työvaiheita vetämällä Sicon Rough Cut Capacity Planning – tai Cim200 Graphical Scheduler -näkymässä, päivämääriä hallitaan kahdessa järjestelmässä. Anna SkyPlannerin hallita työvaiheiden päivämääriä. Autopilot-toiminnon avulla SkyPlanner suunnittelee aikataulun automaattisesti uudelleen, kun tuotanto muuttuu.
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä viikkojen kuluessa käyttöönoton aloittamisesta. Varmista sitä ennen aikataulun toimivuus 30 päivän maksuttomalla kokeilujaksolla tuomalla avoimet valmistustilaukset CSV- tai Excel-tiedostosta. Sen jälkeen projekti etenee näin:
- Määrittely. Vahvista lisäosa ja sen versio, valmistustilausten lukutapa, tietojen takaisinkirjoitustapa, synkronointivälit ja aikakirjausten kanava.
- API-käyttöoikeudet. Tukipalvelun tarjoaja ottaa Sage 200 API -rajapinnan käyttöön, liittää Sage ID:n Sage 200 -käyttäjään ja määrittää yritys- ja toimintokohtaiset käyttöoikeudet.
- Alkulataus. Tuotteet, yksiköt, resurssit, resurssiryhmät, osaluetteloiden työvaiheet ja saatavuustiedot.
- Tilausten synkronointi. Valmistustilaukset, ostotilausrivit ja varastotiedot haetaan säännöllisin kyselyin. Mukaan lisätään hälytys suostumuksen uusimistarpeesta.
- Rajoitteiden määrittäminen SkyPlannerissa. Asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai työntekijät.
- Aikataulun takaisinkirjoitus. Suunnitellut työvaiheiden päivämäärät siirretään valmistustilauksille. Tässä vaiheessa lisätään myös aikakirjaukset.
- Rinnakkaistestaus ja tuotantokäyttöön siirtyminen. Vertaa päivämääriä nykyiseen suunnitelmaan, korjaa perustiedot ja ota sitten takaisinkirjoitus käyttöön.
Mitä Sage 200 -integraatiossa on huomioitava
- Poistunut moduuli uudessa versiossa. Vanhaa Sage 200 Manufacturing -moduulia ei voi käyttää Sage 200 Professional 2025 R2 -versiosta alkaen. Varmista ennen tietovastaavuuksien määrittämistä, mikä valmistusratkaisu on käytössä tuotantokäyttöön siirryttäessä.
- Työvaiheiden ajat kustannustiedoista. Sicon MRP arvioi työ- ja koneajat Sage 200 -osaluetteloiden kustannuserien perusteella. Vertaa niitä ensin todellisiin suoritusaikoihin.
- Kustannuslajien ristiriidat. Sage varoittaa, että kenttien Nominal, Overhead Nominal ja Overhead Recovery % arvojen on oltava samat osaluettelon työvaiheissa ja kustannuslajeissa. Muuten “there will be cost discrepancies.” (kustannuksiin syntyy eroja).
- Uusimisen aikaraja. Enintään 90 päivän jakso alkaa ensimmäisestä kirjautumisesta. Jos suostumusta ei koskaan uusita, integraatio pysähtyy samana päivänä joka vuosineljännes.
- Useita yrityksiä samassa ympäristössä. Yhdessä ympäristössä voi olla useita yrityksiä, joten lähetä oikea
X-Companyjokaisessa pyynnössä.
Kuka määrittää Sage 200 -integraation ja vastaa sen tuesta
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja vastaa sen tuesta tuotantokäyttöön siirtymisen jälkeen.
- Sage 200 -kumppanisi voi osallistua. Kumppani tuntee lisäosasi ja ottaa API-rajapinnan käyttöön Sage 200 Professionalissa.
- Omat kehittäjäsi voivat jatkokehittää integraatiota saman dokumentoidun REST API -rajapinnan kautta API-tunnuksella. Alkuun pääsee pelkällä API-tunnuksella, ja SkyPlanner-tiimi auttaa tarvittaessa.
Kun yhteys on muodostettu, Arcturus-moottori suunnittelee aikataulun ajantasaisten Sage 200 -valmistustilausten perusteella. Suunnitellut päivämäärät siirtyvät valmistustilausten työvaiheille. SkyPlannerin hinta on alkaen 199 € kuukaudessa, ja se sisältää 5 työpistettä. Laskutus on kuukausittainen. Saat prosessisi ja tarpeidesi mukaisen tarjouksen integraatiosta ja tilauksestasi etukäteen, joten tiedät kokonaiskustannukset ennen aloittamista. Tutustu hintoihin ja ominaisuuksiin sekä katso Sage 200:n hienokuormitusta käsittelevästä artikkelista, miten Sage 200:n oma suunnittelu vertautuu SkyPlanneriin. Yleiskatsauksen löydät Sage 200 -sivulta ja muut ERP-järjestelmät ERP-integraatioiden koontisivulta.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästyy 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 siirtyy tuotantolinjalle sekunneissa.
1 000:iatyötilauksia suunnitellaan automaattisesti
”Tuotanto on aivan eri tavalla hallinnassa, ja ymmärryksemme kapasiteetista on täysin uudella 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ö Sage 200 API valmistustilaukset?
Ei. Sage 200 Professional API kattaa muun muassa tuotteet, varastotiedot, myynti- ja ostotilaukset sekä taloushallinnon, mutta siinä ei ole valmistustilauksia tai työvaiheita koskevia API-resursseja. Valmistustilaukset haetaan valmistuksen lisäosasta, kuten Sicon Works Order Processing- tai Cim200-lisäosasta, määrittelyssä sovitulla tavalla.
Kuka toteuttaa Sage 200 -integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation Sage 200 -ympäristöösi käyttöönoton aikana ja vastaa sen tuesta tuotantokäyttöön siirtymisen jälkeen. Sage 200 -kumppanisi ottaa API-rajapinnan käyttöön ja voi osallistua toteutukseen. Myös omat kehittäjäsi voivat rakentaa ratkaisuja SkyPlannerin dokumentoidun REST API -rajapinnan avulla. Alkuun pääsee pelkällä API-tunnuksella.
Voiko Sage 200 lähettää muutokset reaaliajassa?
Sage 200 API ei tue webhookeja. Varastotietojen ja ostotilausten muutokset haetaan säännöllisin kyselyin date_time_updated-kentän perusteella, ja valmistustilaukset luetaan lisäosasta muutaman minuutin välein. Toiseen suuntaan SkyPlannerin omat webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
Voimmeko kokeilla SkyPlanneria ennen integraation toteuttamista?
Kyllä. Maksuttomalla 30 päivän kokeilujaksolla voit käyttää enintään 20 työpistettä ja tuoda valmistustilauksesi CSV- tai Excel-tiedostoista. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
