Integraatiot / ERP / Sage 100
Sage 100 -integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Sage 100 -integraatio-opas kertoo Sage-kumppaneille ja IT-tiimeille, miten Sage 100 yhdistetään SkyPlanner APS:ään. Opas kattaa molemmat samannimiset tuotteet: Yhdysvalloissa ja Kanadassa käytettävän Sage 100:n ja sen Production Management -moduulin sekä Saksassa ja Itävallassa käytettävän Sage 100:n ja sen Sage 100 Produktion -moduulin. SkyPlannerin ja Sage 100:n välinen integraatio toimii molempiin suuntiin:
- SkyPlanneriin tuodaan työmääräykset (Work tickets tai Fertigungsaufträge) vaiheineen (steps tai Arbeitsgänge) sekä työpisteet, nimikkeet, varastosaldot ja ostotilaukset.
- Suunnitellut päivämäärät palautetaan kullekin vaiheelle (step tai Arbeitsgang).
- Työntekijöiden aikakirjaukset palautetaan työkirjauksina (labor entries, US) tai tuotantokuittauksina (Rückmeldungen, DE).
SkyPlanner-tiimi määrittää integraation Sage 100 -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 integraation itse SkyPlannerin dokumentoidun REST API:n avulla (API-dokumentaatio).
Yhdysvaltain Sage 100: integraatiorajapinnat
Yhdysvaltain Sage 100 toimii paikallisesti asennettuna Standard-, Advanced- tai Premium-versiona. Sen integraatiorajapinnat sijaitsevat Sage 100 -palvelimella.
Business Object Interface (BOI).
“The Business Objects Interface allows third-party developers with the necessary skills to access Sage 100 programs and applications using Component Object Model (COM).” (Business Objects Interface antaa ulkopuolisille kehittäjille, joilla on tarvittava osaaminen, pääsyn ohjelmiin ja sovelluksiin Component Object Model (COM) -tekniikalla.) (Sage 100 -ohje) Sagen kehittäjäportaali kuvaa sitä näin: “Sage 100’s internal API layer, giving you access to the same logic used by the application itself.” (Sisäinen API-kerros, jonka kautta voi käyttää samaa logiikkaa kuin sovellus itse.) (developer.sage.com) BOI:n kautta kirjoitetaan tietoja: jokainen luonti ja päivitys käy läpi samat tarkistukset kuin käyttäjän Sage 100:ssa tekemä toiminto.
ODBC.
ProvideX ODBC -ajurilla luetaan Sage 100:n tauluja raportointia ja massalukuja varten. Advanced-versioon on saatavilla asiakas-palvelinmallin mukainen ODBC-ajuri. Integraatio lukee työmääräykset, nimikkeet ja ostotilaukset massana ODBC:n kautta ja kirjoittaa tiedot BOI:n kautta.
Visual Integrator (VI).
VI:n tuonti- ja vientiajot siirtävät tietoja Sage 100:n ja tiedostojen tai ODBC-tietolähteiden välillä. Sage kuvaa toimintoa näin: “One of the most powerful features of the Visual Integrator module is its ability to directly import data from and export data to an ODBC data source.” (Visual Integrator -moduulin keskeisiä vahvuuksia on mahdollisuus tuoda tietoja suoraan ODBC-tietolähteestä ja viedä niitä siihen.) (lähde) VI kuuluu Essentials-pakettiin ja sopii tiedostopohjaiseen tiedonsiirtoon.
eBusiness Web Services käyttää SOAP-protokollaa ja kattaa “the Sage 100 sales order, customer, and customer contact entities.” (Järjestelmän myyntitilaus-, asiakas- ja asiakasyhteyshenkilöobjektit.) (lähde) Sen kautta voidaan siirtää myyntitilauksia, kun taas tuotantotiedot kulkevat BOI:n ja ODBC:n kautta.
Integraatio toimii Sage 100:n rinnalla Sage 100 -käyttäjätunnuksella, jolla on oikeudet sen käyttämiin Production Management-, Inventory- ja Purchase Order -toimintoihin. Ulospäin suuntautuva liikenne kulkee SkyPlannerin REST API:in HTTPS-yhteydellä.
Saksan Sage 100: integraatiorajapinnat
Saksan Sage 100 toimii Microsoft SQL Serverillä joko paikallisesti asennettuna tai pilviversiona. Sagen mukaan siihen voi “Partnerlösungen via API-Schnittstelle ergänzen” (lisätä kumppaniratkaisuja API-rajapinnan kautta) (Sage 100). Sagen listaamat tuotannon lisäosat perustuvat Sage AppDesigneriin ja Sage 100:n liiketoimintaobjekteihin.
Integraatio käyttää samaa toteutustapaa kuin Sagen kumppaniratkaisut. Sage 100:n SQL Server -tietokannasta luetaan Fertigungsaufträge-, Arbeitsgänge-, Arbeitsplätze-, Ressourcenlisten-, Artikel- ja Bestellungen-tiedot. Arbeitsgang-vaiheiden päivämäärät ja Rückmeldungen-kuittaukset palautetaan kirjoitusreittiä pitkin, jonka Sage-kumppanisi ja SkyPlanner-tiimi sopivat määrittelyssä. Näin kirjaukset noudattavat Sage 100:n omaa logiikkaa. Sage-kumppanisi vahvistaa version (esimerkiksi 9.0) ja yhteys- ja käyttöoikeusasetukset.
Tunnistautuminen ja käyttöoikeudet
| Järjestelmä ja rajapinta | Tunnistautumistapa |
|---|---|
| Yhdysvaltain Sage 100, BOI | Sage 100 -käyttäjäistunto Sage 100 -palvelimella sekä roolin mukaiset oikeudet kaikkiin käytettäviin toimintoihin |
| Yhdysvaltain Sage 100, ODBC | Sage 100 -asennuksen DSN, lukuoikeudet |
| Saksan Sage 100 | Sage-kumppanisi kanssa sovitut Sage 100 -käyttäjätunnus takaisinkirjoitusta varten ja SQL Serverin lukuoikeudet |
| SkyPlanner | API-tunnus Authorization-Token-otsakkeessa; tunnus luodaan SkyPlannerin kohdassa Settings > API |
SkyPlannerin REST API on dokumentoitu Swagger/OpenAPI-muodossa. Integraation opas käy läpi ensimmäiset kutsut.
Muutosten tunnistaminen
Sage 100:n muutokset poimitaan ajastetuilla lukukerroilla. Lue avoimet työmääräykset (Work tickets tai Fertigungsaufträge) tiheästi ja varastosaldot sekä ostotilaukset tunnin välein. Suodata tilan ja muutospäivämäärien perusteella, jotta kullakin lukukerralla siirtyvät vain muuttuneet tiedot.
SkyPlanner lähettää webhook-ilmoituksia tuotantosuunnitelman muuttuessa, joten takaisinkirjoitus Sage 100:aan on tapahtumapohjaista.
Tietojen vastaavuudet
| Sage 100 (US) | Sage 100 (DE) | SkyPlannerin objekti | Suunta | Siirtoväli |
|---|---|---|---|---|
| Item | Artikel | Tuotteet ja materiaalit | Sage 100 → SkyPlanner | Alkulataus, sen jälkeen päivittäin |
| Bill of Materials, mallien materiaalit | Stückliste osana Ressourcenliste-rakennetta | Tuoterakenne, alituotteet, tuotekohtaiset materiaalit | Sage 100 → SkyPlanner | Tietojen muuttuessa |
| Work center: työntekijät tai koneet, viikonpäiväkohtaiset työtunnit, käyttökatkot | Arbeitsplatz, Ressource (Mitarbeiter, Maschine) | Työpisteet, työpisteryhmät, henkilöstö, työvuorot | Sage 100 → SkyPlanner | Alkulataus |
| Työmääräysmallin vaiheet, toimintokoodit | Arbeitsplan, Arbeitsgänge sekä Rüst- ja Stückzeiten | Työvaiheet sekä asetus- ja ajoajat | Sage 100 → SkyPlanner | Tietojen muuttuessa |
| Työmääräys vaiheineen ja määräpäivineen | Fertigungsauftrag sekä Arbeitsgänge ja Liefertermin | Tilaukset ja työt määräpäivineen | Sage 100 → SkyPlanner | Tiheä lukuväli |
| Varastokohtaiset määrät | Lagerbestand | Varastosaldot | Sage 100 → SkyPlanner | Tunnin välein |
| Ostotilausrivit, tarvepäivämäärät | Bestellungen, Liefertermine | Ostotilaukset odotettuine toimituspäivineen | Sage 100 → SkyPlanner | Tunnin välein |
| Myyntitilausrivit, luvatut toimituspäivät | Kundenaufträge | Asiakkaiden määräpäivät ja prioriteetit | Sage 100 → SkyPlanner | Tiheä lukuväli |
| Työmääräyksen vaiheiden päivämäärät (BOI) | Arbeitsgang-Termine | Vaihekohtaiset suunnitellut alku- ja loppuajat sekä työpiste | SkyPlanner → Sage 100 | Tietojen muuttuessa webhookin kautta |
| Labor Entry, työmääräyksen valmistumiskuittaus (BOI) | Rückmeldung: ajat ja määrät | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → Sage 100 | Kuittaus- tai työvuorokohtaisesti |
| Ei ylläpidetä Sage 100:ssa | Ei ylläpidetä Sage 100:ssa | Asetusaikamatriisi, työkalut rajallisen kapasiteetin resursseina, työkohtaiset työntekijät, vaihtoehtoiset työpisteet | Ylläpidetään SkyPlannerissa | Käyttöönotto |
Integraation toimintamallit
1. Perustietojen alkulataus. Lataa ensin nimikkeet ja työpisteet, sitten mallit tai Arbeitspläne vaiheineen. Yhdysvaltain version työpisteestä, jossa on kolme konetta ja kaksi työntekijää, muodostetaan SkyPlanneriin kolme työpistettä, työpisteryhmä ja kaksi henkilöä. Kukin saa oman aikajanansa.
2. Tilausten synkronointi. Lue avoimet työmääräykset (Work tickets tai Fertigungsaufträge) vaiheineen sekä varastosaldot ja avoimet ostotilaukset. SkyPlanner tarkistaa sekä varastosaldot että saapuvat toimitukset ennen työn sijoittamista tuotantosuunnitelmaan. Sage 100 ehdottaa edelleen töitä, ja SkyPlanner suunnittelee vapauttamiesi tilausten tuotannon.
3. Tuotantosuunnitelman takaisinkirjoitus. SkyPlanner lähettää suunnitellun alkuajan, loppuajan ja työpisteen jokaisesta vaiheesta, jonka laskentamoottori on sijoittanut suunnitelmaan tai siirtänyt. Yhdysvaltain Sage 100:ssa integraatio päivittää työmääräyksen vaiheiden päivämäärät BOI:n kautta. Saksan Sage 100:ssa se päivittää Arbeitsgang-vaiheiden päivämäärät määrittelyssä sovittua reittiä pitkin. Määrät, varaukset ja kustannuslaskenta pysyvät Sage 100:n vastuulla.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työt SkyPlanner Mobile Confirmations- tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Sage 100:n Yhdysvaltain versiossa kirjattu aika siirtyy työmääräimen vaiheelle Labor Entry -kirjauksena, ja viimeinen kuittaus merkitsee työmääräimen valmiiksi. Sage 100:n Saksan versiossa siitä muodostuu Rückmeldung, joka sisältää ajat ja määrät. Jos tehtaasi kirjaa ajat jo Betriebsdatenerfassung-järjestelmään tai viivakoodisovellukseen, valitse yksi kirjauskanava.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäyttöön siirtymistä:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, tuoterakenteet, mallipohjat, tilausmäärät, kustannukset | Sage 100 |
| Vaiheiden järjestys, alku- ja loppuajat, työpisteiden valinta | SkyPlanner |
| Asetusaikamatriisi, työkalut, työkohtaiset työntekijät, vaihtoehtoiset resurssit | SkyPlanner |
| Työaikakirjaukset ja Rückmeldungen | Sage 100, johon tiedot tulevat SkyPlannerin aikakirjauksista |
Ristiriitoja aiheuttaa ennen kaikkea toinen suunnittelujärjestelmä. Jos suunnittelijat jatkavat Enhanced Scheduling -ajoja Sage 100:n Yhdysvaltain versiossa tai tehtävien siirtelyä Sage 100:n Saksan version Plantafel-näkymässä, päivämääriä hallitaan kahdessa järjestelmässä. Anna SkyPlannerin hallita vaiheiden päivämääriä. Autopilot-toiminnolla SkyPlanner päivittää aikataulun automaattisesti tuotannon muuttuessa.
Projektin tyypilliset vaiheet
Käyttöönotto valmistuu yleensä viikoissa sen aloittamisesta. Varmista sitä ennen aikataulun toimivuus 30 päivän maksuttomassa kokeilussa tuomalla avoimet työmääräimet tai Fertigungsaufträge CSV- tai Excel-tiedostona. Projekti etenee tämän jälkeen näin:
- Määrittely. Varmista tuote (Sage 100:n Yhdysvaltain tai Saksan versio), versionumero ja asennusympäristö sekä tietojen luku- ja kirjoitustavat, synkronointivälit ja työajan kirjauskanava.
- Käyttöoikeudet. Sage-kumppanisi luo Sage 100 -käyttäjän, määrittää sen oikeudet ja järjestää tietokantayhteyden.
- Ensimmäinen tietojen tuonti. Nimikkeet, työpisteet, mallipohjat tai Arbeitspläne, tuoterakenteet ja työvuorot.
- Tilausten synkronointi. Työmääräimet tai Fertigungsaufträge, ostotilaukset ja varastosaldot siirretään ajastetusti.
- Rajoitteiden määrittäminen SkyPlannerissa. Asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai henkilöt.
- Aikataulun kirjoittaminen takaisin. Suunnitellut vaiheiden päivämäärät siirretään Sage 100:aan, minkä jälkeen siirretään työaikakirjaukset ja Rückmeldungen.
- Rinnakkaistestaus ja tuotantokäyttöön siirtyminen. Vertaa päivämääriä nykyiseen suunnitelmaan, korjaa perustiedot ja ota sitten takaisinkirjoitus käyttöön.
Mitä Sage 100 -integraatiossa on huomioitava
- Selvitä, mitä Sage 100 -tuotetta käytät. Sage 100:n Yhdysvaltain ja Saksan versioissa on erilaiset tietomallit ja rajapinnat. Kerro tuote ja versionumero heti ensimmäisessä määrittelypalaverissa.
- Useita koneita saman työpisteen alla. Yhdysvaltain versiossa työpiste on yksi kapasiteettiyksikkö, joka koostuu määritelmän mukaan ”one or more persons or machines” (yhdestä tai useammasta henkilöstä tai koneesta). Päätä kunkin työpisteen osalta, mallinnetaanko se yhdeksi työpisteeksi, useaksi työpisteeksi vai ryhmäksi.
- Asetus- ja ajoajat. Mallipohjat ja Arbeitspläne sisältävät ajat, joiden perusteella SkyPlanner laatii aikataulun. Vertaa niitä todellisiin ajoaikoihin ennen tuotantokäyttöön siirtymistä.
- Kalenterit. Yhdysvaltain version työpisteille on määritetty viikonpäiväkohtaiset työtunnit ja seisokit. Tuo ne SkyPlanneriin työvuoroina ja lisää sitten kunkin työntekijän työvuorot ja poissaolot SkyPlannerissa.
- Mittayksiköt. Vaiheiden perusteena voi olla kappale, erä tai tunti. Määritä yksiköiden vastaavuudet vaihekohtaisesti.
- BOI-käyttöoikeudet. BOI noudattaa Sage 100:n roolipohjaisia käyttöoikeuksia. Puuttuva tehtäväkohtainen oikeus estää kirjoituksen. Testaa kaikki kirjoitukset integraation käyttäjätunnuksella.
- Yksi järjestelmä hallitsee päivämääriä. Lopeta rinnakkaiset suunnitteluajot ja siirrot Plantafel-näkymässä, kun SkyPlanner ottaa päivämäärät hallintaansa.
Kuka määrittää Sage 100 -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-kumppanisi voi osallistua. Kumppani tuntee Sage 100 -versiosi, määrittää käyttäjät ja käyttöoikeudet sekä varmistaa tietokantayhteyden.
- Myös omat kehittäjäsi voivat jatkokehittää integraatiota SkyPlannerin dokumentoidun REST API -rajapinnan avulla. Alkuun pääsee API-tokenilla, ja SkyPlanner-tiimi auttaa tarvittaessa.
Kun yhteys on luotu, Arcturus-moottori laatii aikataulun Sage 100:n ajantasaisten tilausten perusteella, ja suunnitellut päivämäärät siirtyvät kullekin vaiheelle. SkyPlanner maksaa alkaen 199 € kuukaudessa ja sisältää 5 työpistettä. Laskutus tapahtuu kuukausittain. Saat integraatiosta prosessisi ja tarpeidesi mukaisen tarjouksen etukäteen yhdessä tilaamasi palvelupaketin kanssa, joten tiedät kokonaiskustannukset ennen aloittamista. Tutustu hinnoitteluun ja ominaisuuksiin sekä vertaa Sage 100:n omaa suunnittelua artikkelissa Sage 100:n hienokuormitus. Yleiskatsaus löytyy Sage 100 -sivulta. Sage 200:n ja Sage X3:n omat oppaat löytyvät Sage 200– ja Sage X3 -sivuilta. Muut ERP-järjestelmät löydät ERP-integraatioiden koontisivulta.
Valmistavan teollisuuden kokemuksia SkyPlannerista
6 kuukaudenvapaa kapasiteetti myynnin nähtävissä
”SkyPlanner luo luotettavan pohjan kaikelle tuotannonsuunnittelulle.”
Anu Järvinen, tuotantopäällikkö
Fredman Operations · Elintarvikekelpoiset pakkauspaperit
Myynti näkee vapaan kapasiteetin kuusi kuukautta eteenpäin. Aikataulumuutospyyntöihin, joiden käsittely vei aiemmin tunnin tai enemmän, vastataan nyt sekunneissa.
100%toimitusvarmuus vuodesta 2021
”SkyPlanner antaa meille näkyvyyden kapasiteettiin ja tekee suunnittelusta ennakoitavaa.”
Dan Berglund, COO/CFO
Opes Corporation · Kemikaalien ja elintarvikkeiden valmistus
Toimitusvarmuus on ollut 100% koko SkyPlannerin käytön ajan, vuodesta 2021 lähtien.
Usein kysytyt kysymykset
Onko Sage 100:ssa REST API -rajapinta työmääräimille?
Sage 100:n Yhdysvaltain versio tarjoaa liiketoimintalogiikkansa Business Object Interface -rajapinnan kautta. Tietojen lukemiseen käytetään ODBC:tä ja tiedostoajoihin Visual Integratoria. SkyPlanner lukee työmääräimet ODBC:n ja BOI:n kautta sekä kirjoittaa vaiheiden päivämäärät ja työaikakirjaukset BOI:n kautta. Sage 100:n Saksan version tiedot luetaan sen SQL Server -tietokannasta. Takaisin kirjoituksen toteutustapa sovitaan Sage-kumppanisi kanssa määrittelyssä.
Kuka toteuttaa Sage 100 -integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation Sage 100 -ympäristöösi käyttöönoton aikana ja vastaa sen tuesta tuotantokäyttöön siirtymisen jälkeen. Sage-kumppanisi määrittää käyttäjät, käyttöoikeudet ja tietokantayhteyden ja voi osallistua toteutukseen. Myös omat kehittäjäsi voivat kehittää integraatiota SkyPlannerin dokumentoidun REST API -rajapinnan avulla. Alkuun pääsee API-tokenilla.
Miten suunnitellut päivämäärät kirjoitetaan takaisin Sage 100:aan?
Sage 100:n Yhdysvaltain versiossa integraatio päivittää kunkin työmääräimen vaiheen suunnitellut päivämäärät BOI:n kautta ja muodostaa työntekijöiden aikakirjauksista Labor Entry -kirjaukset. Sage 100:n Saksan versiossa se päivittää kunkin Fertigungsauftrag-tilauksen Arbeitsgang-vaiheiden päivämäärät ja tekee Rückmeldungen-kirjaukset. Kirjoitukseen käytetään toteutustapaa, jonka Sage-kumppanisi ja SkyPlanner-tiimi sopivat määrittelyssä.
Voiko Sage 100 lähettää muutokset reaaliajassa?
SkyPlanner lukee Sage 100:n muuttuneet tiedot ajastetusti: avoimet tilaukset lyhyin väliajoin sekä varastosaldot ja ostotilaukset tunnin välein. Toiseen suuntaan SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
Voimmeko testata SkyPlanneria ennen integraation toteutusta?
Kyllä. Maksuton 30 päivän kokeilu tukee enintään 20 työpistettä. Voit tuoda työmääräimet tai Fertigungsaufträge CSV- tai Excel-tiedostoina, eikä luottokorttia tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
