Integracije / ERP / Sage 200
Vodnik za povezavo Sage 200 s SkyPlanner APS za terminiranje proizvodnje
Ta vodnik za povezavo Sage 200 poslovnim partnerjem in ekipam IT pojasnjuje, kako povezati Sage 200 Professional in njegov proizvodni dodatek s SkyPlanner APS. Povezava med SkyPlanner in Sage 200 deluje v obe smeri:
- Izdelki, skladiščne zaloge ter nabavna in prodajna naročila se prenašajo v SkyPlanner prek Sage 200 REST API.
- Delovni nalogi, operacije ter podatki o delavcih in strojih se prenašajo iz proizvodnega dodatka.
- Planirani datumi operacij se zapisujejo nazaj v delovne naloge.
- Časovni zapisi operaterjev se prenašajo nazaj za knjiženje časa na posamezno operacijo.
Ekipa SkyPlanner med uvajanjem prilagodi povezavo vaši konfiguraciji Sage 200 in zanjo zagotavlja podporo tudi po zagonu. Ta vodnik je namenjen partnerjem in razvijalcem, ki želijo sodelovati ali sami razvijati rešitve z dokumentiranim REST API sistema SkyPlanner (referenčna dokumentacija API).
Dva vira v enem sistemu Sage 200
Okolje Sage 200 v proizvodnem podjetju ima dve plasti, povezava pa bere podatke iz obeh.
1. Sage 200 REST API za komercialne podatke in podatke o zalogah. Sage navaja, da API “lets your application read and modify data in a Sage 200 site” (vaši aplikaciji omogoča branje in spreminjanje podatkov v tem okolju). To vključuje kupce, dobavitelje, izdelke, prodajna in nabavna naročila ter konte glavne knjige. Referenčna dokumentacija Sage 200 Professional (2025.02) vire razvršča v skupine Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP in Stock. Za terminiranje so pomembni naslednji viri:
| Vir | Vsebina |
|---|---|
products | Šifra, naziv, enota zaloge, vrsta postavke BOM, standardni strošek |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Odprta nabavna naročila, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Povpraševanje kupcev, requested_delivery_date, promised_delivery_date |
warehouses, units | Lokacije in merske enote |
2. Proizvodni dodatek za delovne naloge. Sage 200 API nima končnih točk za delovne naloge, operacije ali vire. Delovni nalogi so shranjeni v Sicon Works Order Processing, Cim200 ali starejšem modulu Sage 200 Manufacturing. Povezava bere delovne naloge, operacije in vire na način, ki ga dodatek podpira in o katerem se med opredelitvijo obsega dogovorimo z vami in vašim partnerjem za Sage 200.
Avtentikacija in dostop
Sage 200 API “uses OAuth 2.0 with OpenID Connect” (uporablja OAuth z OpenID Connect), in sicer s tokom dodelitve z avtorizacijsko kodo. Prijava poteka prek Sage ID.
- Pridružite se programu Sage 200 API Developer Programme in zaprosite za poverilnice.
- Povežite Sage ID z uporabnikom Sage 200, ki ima dostop do podjetja in funkcij za končne točke, ki jih uporabljate.
- Zahtevajte obseg dovoljenj
offline_access, sicer osvežitveni žeton ne bo izdan. - Pri vsaki zahtevi za dostop do zbirke podatkov pošljite
Authorization: Bearer <access_token>,X-SiteinX-Company. Oba identifikatorja pridobite prek/sites.
Osnovni URL za Sage 200 Professional: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Zahteve uporabljajo metode GET, POST, PUT in DELETE ter poizvedbene možnosti OData $filter, $select, $top, $skip, $orderby in $expand.
Pri Sage 200 Professional API omogoči strankin ponudnik podpore. Na kontrolnem seznamu Sage potrdi, da “the API is enabled” (je API omogočen) in da “each required user has a Sage ID assigned.” (ima vsak uporabnik, ki potrebuje dostop, dodeljen Sage ID). Pri Sage 200 Standard je API privzeto omogočen.
Pri zasnovi je treba upoštevati veljavnost žetonov. Dostopni žetoni veljajo 8 ur. Osvežitveni žetoni veljajo od 1 do 90 dni, pri čemer velja: “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (Obdobje osveževanja se šteje od uporabnikove prve prijave, ne od zadnje osvežitve.) Sage navaja, da ponovna avtentikacija “is unavoidable” (je neizogibna). Predvidite opozorilo za ponovno soglasje, preden se to obdobje izteče.
Na strani SkyPlanner avtentikacija za REST API poteka z žetonom API (SkyPlanner Settings > API), dokumentacija pa je na voljo v obliki Swagger/OpenAPI. Vodič za integracijo vas vodi skozi prve klice.
Zaznavanje sprememb
Referenčna dokumentacija Sage 200 API ne vsebuje vira za spletne kavlje ali naročnine. Spremembe se zaznavajo z rednim poizvedovanjem. Zapisi vsebujejo date_time_created in date_time_updated, zato se pri vsaki poizvedbi podatki filtrirajo z $filter po date_time_updated, za straničenje pa se uporabljata $top in $skip.
Po delovnih nalogih poizvedujte vsakih nekaj minut, po zalogah in postavkah nabavnih naročil pa vsako uro. SkyPlanner ob spremembi terminskega plana pošlje spletne kavlje, zato povratni zapis sprožajo dogodki.
Preslikava podatkov
| Objekt Sage 200 (vir) | Objekt SkyPlanner | Smer | Pogostost |
|---|---|---|---|
products, units (API) | Izdelki in materiali | Sage 200 → SkyPlanner | Prenos, nato redno poizvedovanje |
| Sestavni deli BOM (dodatek ali modul BOM) | Struktura izdelka, podizdelki, materiali po izdelkih | Sage 200 → SkyPlanner | Ob spremembi |
| Delavci in stroji, skupine virov (dodatek) | Delovni centri, skupine delovnih centrov, osebje | Sage 200 → SkyPlanner | Začetni prenos |
| Razpoložljivost virov: zaustavitve, vzdrževanje, dopusti (dodatek) | Izmene, odsotnosti | Sage 200 → SkyPlanner | Dnevno |
| Delovni nalogi z operacijami in časi posameznih operacij (dodatek) | Naročila in operacije s koraki, trajanji in roki | Sage 200 → SkyPlanner | Vsakih nekaj minut |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Dobavni roki za kupce | Sage 200 → SkyPlanner | Redno poizvedovanje |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Stanje zalog | Sage 200 → SkyPlanner | Vsako uro |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Nabavna naročila s pričakovanim datumom dobave | Sage 200 → SkyPlanner | Vsako uro |
| Planirani začetek in konec ter vir za operacijo delovnega naloga | Planirani začetek, konec in delovni center za posamezno operacijo | SkyPlanner → Sage 200 | Ob spremembi prek spletnega kavlja |
| Knjiženje časa na operacijo (dodatek) | Časovni zapisi in potrditve operaterjev | SkyPlanner → Sage 200 | Ob vsaki potrditvi ali po izmeni |
| Podatki o omejitvah v SkyPlanner | Matrika pripravljalnih časov, orodja kot viri z omejeno razpoložljivostjo, nadomestni stroji in osebje | Vzdrževanje v SkyPlanner | Med uvajanjem |
Načini povezovanja
1. Začetni prenos matičnih podatkov. Prek API pridobite izdelke in enote, nato pa iz dodatka še vire, skupine virov in operacije BOM. Skupino virov s tremi enakimi stroji lahko predstavite kot eno skupino delovnih centrov ali kot tri delovne centre.
2. Sinhronizacija nalogov. Iz dodatka preberite odprte delovne naloge z operacijami, prek API pa še odprte postavke pop_order_lines in podatke warehouse_holdings. Pri terminiranju se preverjajo tako zaloge kot pričakovane dobave iz nabave. MRP še naprej predlaga delovne naloge v Sage 200, SkyPlanner pa terminira tiste, ki jih ustvarite.
3. Povratni zapis terminskega plana. Za vsako operacijo, ki jo je mehanizem razporedil ali premaknil, SkyPlanner pošlje planirani začetek, konec in vir nazaj v delovni nalog. Dodatek ohrani svoje količine, rezervacije in obračun stroškov.
4. Potrditve iz proizvodnje. Operaterji beležijo delo s SkyPlanner Mobile Confirmations ali Production Timer, časovni zapisi pa skrbijo za ažurnost terminskega plana. Zabeleženi čas se prenese nazaj in knjiži na operacijo delovnega naloga, zato obračun stroškov v Sage 200 upošteva dejanske ure.
Če v vašem obratu čas že knjižite v Sicon Shop Floor Data Capture ali Cim200 Shop Floor Data Capture, izberite en kanal za knjiženje.
5. Pravila o lastništvu podatkov in reševanju konfliktov. Zapišite jih pred zagonom:
| Podatki | Lastnik |
|---|---|
| Izdelki, kosovnice, količine na delovnih nalogih, rezervacije, stroški | Sage 200 in dodatek |
| Zaporedje operacij, časi začetka in konca, dodelitev delovnim centrom | SkyPlanner |
| Matrika pripravljalnih časov, zahteve glede orodij in izvajalcev, nadomestni viri | SkyPlanner |
| Knjiženje časa | Sage 200 na podlagi časovnih zapisov iz SkyPlanner |
Glavni vir neskladij je prikaz kapacitet. Če planerji še naprej z vlečenjem premikajo delovne naloge ali operacije v Sicon Rough Cut Capacity Planning ali Cim200 Graphical Scheduler, datume določata dva sistema. Za datume operacij naj bo pristojen SkyPlanner. S funkcijo Autopilot SkyPlanner ob spremembah v proizvodnji samodejno prilagodi terminski plan.
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem preverite terminski plan v 30-dnevnem brezplačnem preizkusu z izvozom odprtih delovnih nalogov v obliki CSV ali Excel. Projekt nato poteka takole:
- Opredelitev obsega. Potrdite dodatek in različico, način branja delovnih nalogov, način povratnega zapisovanja, pogostost sinhronizacije in kanal za knjiženje časa.
- Dostop do API. Ponudnik podpore omogoči Sage 200 API, poveže Sage ID z uporabnikom Sage 200 ter nastavi dostop do podjetij in funkcij.
- Začetni prenos. Izdelki, enote, viri, skupine virov, operacije v kosovnicah in razpoložljivost.
- Sinhronizacija nalogov in naročil. Periodično poizvedovanje po delovnih nalogih, postavkah nabavnih naročil in zalogi, z opozorilom za ponovno soglasje.
- Nastavitev omejitev v SkyPlanner. Matrika pripravljalnih časov, orodja, število izvajalcev na operacijo ter nadomestni stroji ali osebje.
- Povratni zapis terminskega plana. Zapis načrtovanih datumov operacij v delovne naloge; v tem koraku se doda tudi knjiženje časa.
- Vzporedno testiranje in zagon. Primerjajte datume s trenutnim planom, popravite matične podatke in nato vključite povratno zapisovanje.
Kaj upoštevati pri integraciji s Sage 200
- Ukinjeni modul v novi različici. Starega modula Sage 200 Manufacturing od različice Sage 200 Professional 2025 R2 naprej ni mogoče uporabljati. Preden začnete preslikovati podatke, potrdite, katera rešitev za proizvodnjo bo v uporabi ob zagonu.
- Časi operacij iz podatkov o stroških. Sicon MRP oceni čase dela in strojne čase na podlagi stroškovnih postavk kosovnic v Sage 200. Najprej jih primerjajte z dejanskimi časi izvajanja.
- Neskladja med stroškovnimi kategorijami. Sage opozarja, da se morajo vrednosti Nominal, Overhead Nominal in Overhead Recovery % pri operacijah v kosovnicah in stroškovnih kategorijah ujemati, sicer “there will be cost discrepancies.” (prišlo bo do neskladij pri stroških).
- Rok za obnovitev. Najdaljše obdobje 90 dni se šteje od prve prijave. Integracija brez ponovnega soglasja se ustavi na isti dan vsakega četrtletja.
- Okolja z več podjetji. Eno okolje lahko vsebuje več podjetij, zato pri vsaki zahtevi pošljite pravilno vrednost
X-Company.
Integracija s Sage 200: kdo jo nastavi in zagotavlja podporo
- Ekipa SkyPlanner jo nastavi med uvajanjem in zagotavlja podporo po zagonu.
- Sodeluje lahko tudi vaš poslovni partner za Sage 200. Partner pozna vaš dodatek in omogoči API v Sage 200 Professional.
- Rešitev lahko nadgradijo tudi vaši razvijalci, ki uporabijo isti dokumentirani REST API z žetonom API. Za začetek zadostuje žeton API, ekipa SkyPlanner pa po potrebi pomaga.
Po vzpostavitvi povezave mehanizem Arcturus terminira proizvodnjo na podlagi aktualnih delovnih nalogov iz Sage 200, načrtovani datumi pa se zapišejo v operacije na delovnih nalogih. Cena za SkyPlanner se začne pri 199 € na mesec in vključuje 5 delovnih centrov, obračunavanje pa je mesečno. Ponudbo za integracijo pripravimo vnaprej glede na vaš proces in potrebe, skupaj z naročniškim paketom, tako da že pred začetkom poznate celoten strošek. Oglejte si cene, funkcije in primerjavo z lastnim planiranjem v Sage 200 na strani Terminiranje proizvodnje v Sage 200. Pregled najdete na strani Sage 200, druge sisteme ERP pa v pregledu integracij s sistemi ERP.
Mnenja proizvodnih podjetij o sistemu SkyPlanner
2 hprihranka vsak teden
»S sistemom SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za oskrbovalno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri dela, novo zaporedje delovnih nalogov pa pride do proizvodne linije v nekaj sekundah.
1.000 in večsamodejno terminiranih delovnih nalogov
»Proizvodnjo obvladujemo drugače, naše razumevanje kapacitet pa je na povsem drugi ravni.«
Hannu Ryynänen, direktor
Mamec · Industrijska mešala, črpalke in visokotehnološka pogodbena proizvodnja
Na tisoče delovnih nalogov se terminira samodejno, celotna organizacija pa ima vpogled v proizvodnjo v realnem času.
Pogosta vprašanja
Ali Sage 200 API vključuje delovne naloge?
Ne. Sage 200 Professional API pokriva izdelke, zalogo, prodajna in nabavna naročila, finance in drugo, ne vključuje pa virov API za delovne naloge ali operacije. Delovni nalogi se pridobijo iz vašega proizvodnega dodatka, kot sta Sicon Works Order Processing ali Cim200, na način, dogovorjen pri opredelitvi obsega.
Kdo vzpostavi integracijo s Sage 200?
Ekipa SkyPlanner med uvajanjem nastavi dvosmerno integracijo glede na vašo konfiguracijo Sage 200 in zagotavlja podporo po zagonu. Vaš poslovni partner za Sage 200 omogoči API in lahko sodeluje pri projektu. Tudi vaši razvijalci lahko razvijajo rešitve z dokumentiranim REST API sistema SkyPlanner; za začetek zadostuje žeton API.
Ali lahko Sage 200 sproti pošilja spremembe?
Sage 200 API ne podpira webhookov. Spremembe zaloge in nabavnih naročil se preverjajo s periodičnimi poizvedbami po polju date_time_updated, delovni nalogi pa se berejo iz vašega dodatka vsakih nekaj minut. V nasprotni smeri webhooki sistema SkyPlanner pošiljajo spremembe terminskega plana takoj, ko nastanejo.
Ali lahko SkyPlanner preizkusimo pred vzpostavitvijo integracije?
Da. V 30-dnevnem brezplačnem preizkusu lahko uporabite do 20 delovnih centrov in uvozite delovne naloge v obliki CSV ali Excel. Kreditna kartica ni potrebna. Začnite preizkus ali se obrnite na prodajo, da opredelite obseg integracije.
