Integracijos / ERP / Sage 200
Sage 200 integravimo vadovas: gamybos tvarkaraščių sudarymas su SkyPlanner APS
Šiame Sage 200 integravimo vadove verslo partneriams ir IT komandoms paaiškinama, kaip sujungti Sage 200 Professional ir jos gamybos priedą su SkyPlanner APS. SkyPlanner ir Sage 200 keičiasi duomenimis abiem kryptimis:
- Produktų, sandėlio likučių, pirkimo ir pardavimo užsakymų duomenys gaunami per Sage 200 REST API.
- Gamybos užsakymų, operacijų, darbuotojų ir įrenginių duomenys gaunami iš jūsų gamybos priedo.
- Suplanuotos operacijų datos įrašomos atgal į gamybos užsakymus.
- Operatorių darbo laiko įrašai grąžinami kiekvienos operacijos laiko apskaitai.
Diegimo metu SkyPlanner komanda pritaiko integraciją prie jūsų Sage 200 aplinkos ir prižiūri ją pradėjus naudoti. Šis vadovas skirtas partneriams ir programuotojams, norintiems prisidėti arba patiems kurti sprendimus naudojant dokumentuotą SkyPlanner REST API (API žinynas).
Du šaltiniai vienoje Sage 200 sistemoje
Gamybos įmonės Sage 200 aplinką sudaro du sluoksniai, o integracija skaito abiejų duomenis.
1. Sage 200 REST API komerciniams ir atsargų duomenims. Sage teigia, kad API „lets your application read and modify data in a Sage 200 site” (leidžia jūsų programai skaityti ir keisti duomenis šioje aplinkoje). Tai apima klientus, tiekėjus, produktus, pardavimo ir pirkimo užsakymus bei didžiosios knygos sąskaitas. Sage 200 Professional žinyne (2025.02) API ištekliai suskirstyti į Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP ir Stock grupes. Tvarkaraščiams sudaryti svarbūs šie ištekliai:
| Išteklius | Saugomi duomenys |
|---|---|
products | Kodas, pavadinimas, atsargų matavimo vienetas, BOM pozicijos tipas, norminė savikaina |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Neįvykdyti pirkimo užsakymai, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Klientų paklausa, requested_delivery_date, promised_delivery_date |
warehouses, units | Padaliniai ir matavimo vienetai |
2. Gamybos priedas gamybos užsakymams. Sage 200 API neturi gamybos užsakymams, operacijoms ar ištekliams skirtų prieigos taškų. Gamybos užsakymai saugomi Sicon Works Order Processing, Cim200 arba senajame Sage 200 Manufacturing modulyje. Integracija skaito gamybos užsakymus, operacijas ir išteklius priedo palaikomu būdu. Šis būdas suderinamas su jumis ir jūsų Sage 200 partneriu apibrėžiant projekto apimtį.
Autentifikavimas ir prieiga
Sage 200 API „uses OAuth 2.0 with OpenID Connect” (naudoja OAuth su OpenID Connect), taikydama autorizavimo kodo suteikimo procedūrą. Prisijungiama per Sage ID.
- Prisijunkite prie Sage 200 API Developer Programme ir paprašykite prieigos duomenų.
- Susiekite Sage ID su Sage 200 naudotoju, turinčiu prieigą prie įmonės ir funkcijų, kurių reikia naudojamiems API prieigos taškams.
- Paprašykite
offline_accessprieigos srities, kitaip atnaujinimo prieigos raktas nebus išduotas. - Su kiekviena užklausa į duomenų bazę siųskite
Authorization: Bearer <access_token>,X-SiteirX-Company. Abu identifikatoriai gaunami iš/sites.
Sage 200 Professional bazinis URL: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Užklausose naudojami GET, POST, PUT ir DELETE metodai bei OData užklausų parinktys $filter, $select, $top, $skip, $orderby ir $expand.
Sage 200 Professional API įjungia kliento techninės priežiūros paslaugų teikėjas. Pagal Sage kontrolinį sąrašą jis patvirtina, kad „the API is enabled” (API įjungta) ir „each required user has a Sage ID assigned.” (kiekvienam reikiamam naudotojui priskirtas Sage ID). Sage 200 Standard API įjungta pagal numatytuosius nustatymus.
Projektuojant integraciją reikia atsižvelgti į prieigos raktų galiojimo laiką. Prieigos raktai galioja 8 valandas. Atnaujinimo prieigos raktai galioja nuo 1 iki 90 dienų, o „The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (atnaujinimo laikotarpis skaičiuojamas nuo pirmojo naudotojo prisijungimo, o ne nuo paskutinio atnaujinimo). Sage nurodo, kad pakartotinis autentifikavimas „is unavoidable” (yra neišvengiamas). Numatykite įspėjimą apie būtinybę iš naujo suteikti sutikimą dar nepasibaigus šiam laikotarpiui.
SkyPlanner REST API autentifikavimui naudoja API prieigos raktą (SkyPlanner Settings > API), o jos dokumentacija pateikta Swagger/OpenAPI formatu. Integravimo instrukcijoje paaiškinta, kaip atlikti pirmąsias užklausas.
Pakeitimų aptikimas
Sage 200 API žinyne nėra nei webhook, nei prenumeratos ištekliaus. Pakeitimai aptinkami periodinėmis užklausomis. Įrašuose yra date_time_created ir date_time_updated laukai, todėl kiekvienoje užklausoje duomenys filtruojami pagal date_time_updated naudojant $filter, o puslapiuojami naudojant $top ir $skip.
Gamybos užsakymus tikrinkite kas kelias minutes, o atsargų duomenis ir pirkimo užsakymų eilutes – kas valandą. Pasikeitus tvarkaraščiui, SkyPlanner siunčia webhook pranešimus, tad duomenys įrašomi atgal pagal įvykius.
Duomenų susiejimas
| Sage 200 objektas (šaltinis) | SkyPlanner objektas | Kryptis | Dažnumas |
|---|---|---|---|
products, units (API) | Produktai ir medžiagos | Sage 200 → SkyPlanner | Pradinis įkėlimas, vėliau – periodinės užklausos |
| BOM komponentai (priedas arba BOM modulis) | Gaminio struktūra, pusgaminiai, medžiagos kiekvienam gaminiui | Sage 200 → SkyPlanner | Pasikeitus duomenims |
| Darbuotojai ir įrenginiai, išteklių grupės (priedas) | Darbo centrai, darbo centrų grupės, personalas | Sage 200 → SkyPlanner | Pradinis įkėlimas |
| Išteklių prieinamumas: prastovos, techninė priežiūra, atostogos (priedas) | Pamainos, neatvykimai | Sage 200 → SkyPlanner | Kasdien |
| Gamybos užsakymai ir jų operacijos, kiekvienos operacijos laikas (priedas) | Užsakymai ir užduotys su etapais, trukmėmis ir įvykdymo terminais | Sage 200 → SkyPlanner | Kas kelias minutes |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Pristatymo klientams terminai | Sage 200 → SkyPlanner | Periodinės užklausos |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Atsargų likučiai | Sage 200 → SkyPlanner | Kas valandą |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Pirkimo užsakymai su numatoma pristatymo data | Sage 200 → SkyPlanner | Kas valandą |
| Gamybos užsakymo operacijos planuojama pradžia ir pabaiga, išteklius | Kiekvienos operacijos planuojama pradžia, pabaiga ir darbo centras | SkyPlanner → Sage 200 | Pasikeitus duomenims, per webhook |
| Operacijos laiko apskaita (priedas) | Darbo laiko įrašai ir operatorių patvirtinimai | SkyPlanner → Sage 200 | Po kiekvieno patvirtinimo arba kiekvieną pamainą |
| SkyPlanner apribojimų duomenys | Paruošimo laikų matrica, įrankiai kaip riboti ištekliai, alternatyvūs įrenginiai ir darbuotojai | Tvarkoma SkyPlanner sistemoje | Diegimo metu |
Integravimo scenarijai
1. Pradinis pagrindinių duomenų įkėlimas. Iš API nuskaitykite produktus ir matavimo vienetus, o iš priedo – išteklius, jų grupes ir BOM operacijas. Trijų vienodų įrenginių išteklių grupę galima atvaizduoti kaip vieną darbo centrų grupę arba tris darbo centrus.
2. Užsakymų sinchronizavimas. Iš priedo nuskaitykite neįvykdytus gamybos užsakymus su jų operacijomis, o iš API – neįvykdytas pop_order_lines ir warehouse_holdings. Sudarant tvarkaraštį tikrinamos ir turimos atsargos, ir numatomi tiekimai pagal pirkimo užsakymus. MRP ir toliau siūlo gamybos užsakymus Sage 200 sistemoje, o SkyPlanner įtraukia į tvarkaraštį tuos, kuriuos sukuriate.
3. Tvarkaraščio duomenų įrašymas atgal. Kiekvienos operacijos, kurią planavimo variklis įtraukė į tvarkaraštį arba perkėlė, planuojamą pradžią, pabaigą ir išteklių SkyPlanner grąžina į gamybos užsakymą. Kiekiai, atsargų rezervavimas ir savikainos skaičiavimas lieka priedo žinioje.
4. Patvirtinimai gamybos ceche. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations arba Production Timer, o darbo laiko įrašai leidžia palaikyti aktualų tvarkaraštį. Užregistruotas laikas grąžinamas į gamybos užsakymo operacijos laiko apskaitą, todėl skaičiuojant savikainą Sage 200 sistemoje naudojamos faktinės darbo valandos.
Jei jūsų gamykloje darbo laikas jau registruojamas naudojant Sicon Shop Floor Data Capture arba Cim200 Shop Floor Data Capture, pasirinkite vieną laiko registravimo kanalą.
5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami naudoti integraciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Gaminiai, BOM, gamybos užsakymų kiekiai, rezervavimai, sąnaudos | Sage 200 ir priedas |
| Operacijų seka, pradžios ir pabaigos laikas, priskyrimas darbo centrams | SkyPlanner |
| Paruošimo laikų matrica, įrankių ir operatorių poreikis, alternatyvūs ištekliai | SkyPlanner |
| Darbo laiko apskaita | Sage 200, gaunanti SkyPlanner darbo laiko įrašus |
Pagrindinis konfliktų šaltinis – pajėgumų diagrama. Jei planuotojai ir toliau pele perkelia gamybos užsakymus ar operacijas Sicon Rough Cut Capacity Planning arba Cim200 Graphical Scheduler, datas valdo dvi sistemos. Operacijų datas patikėkite valdyti SkyPlanner. Naudojant Autopilot, SkyPlanner automatiškai perskaičiuoja tvarkaraštį, kai gamyboje įvyksta pokyčių.
Įprasti projekto etapai
Diegimas paprastai užbaigiamas per kelias savaites nuo pasirengimo darbui pradžios. Prieš tai patikrinkite tvarkaraštį per 30 dienų nemokamą bandomąjį laikotarpį, naudodami nebaigtų gamybos užsakymų eksportą CSV arba Excel formatu. Toliau projektas vykdomas šiais etapais:
- Apimties apibrėžimas. Patvirtinkite priedą ir jo versiją, gamybos užsakymų nuskaitymo bei duomenų įrašymo atgal būdus, sinchronizavimo dažnumą ir darbo laiko apskaitos kanalą.
- Prieiga prie API. Techninės priežiūros paslaugų teikėjas įjungia Sage 200 API, susieja Sage ID su Sage 200 naudotoju ir nustato prieigos prie įmonių bei funkcijų teises.
- Pradinis duomenų įkėlimas. Gaminiai, matavimo vienetai, ištekliai, išteklių grupės, BOM operacijos ir prieinamumas.
- Užsakymų sinchronizavimas. Gamybos užsakymai, pirkimo užsakymų eilutės ir atsargos sinchronizuojami periodinėmis užklausomis; nustatomas įspėjimas, kad reikia iš naujo suteikti sutikimą.
- Apribojimų nustatymas SkyPlanner sistemoje. Paruošimo laikų matrica, įrankiai, kiekvienai užduočiai reikalingų operatorių skaičius ir alternatyvios staklės ar darbuotojai.
- Tvarkaraščio įrašymas atgal. Suplanuotos operacijų datos įrašomos į gamybos užsakymus; šiame etape įtraukiama ir darbo laiko apskaita.
- Lygiagretus testavimas ir paleidimas. Palyginkite datas su dabartiniu planu, ištaisykite pagrindinius duomenis, tada įjunkite duomenų įrašymą atgal.
Į ką atsižvelgti planuojant Sage 200 integraciją
- Naujoje versijoje nebepalaikomas modulis. Nuo Sage 200 Professional 2025 R2 senojo Sage 200 Manufacturing modulio naudoti nebegalima. Prieš pradėdami derinti duomenų atitiktis, patvirtinkite, koks gamybos sprendimas bus naudojamas paleidimo metu.
- Operacijų trukmė pagal sąnaudų duomenis. Sicon MRP apskaičiuoja darbo ir staklių laiką pagal Sage 200 BOM sąnaudų eilutes. Pirmiausia palyginkite šiuos įverčius su faktine operacijų trukme.
- Sąnaudų kategorijų neatitikimai. Sage įspėja, kad BOM operacijų ir sąnaudų kategorijų laukai Nominal, Overhead Nominal ir Overhead Recovery % turi sutapti, kitaip „there will be cost discrepancies.“ (atsiras sąnaudų neatitikimų).
- Atnaujinimo terminas. Maksimalus 90 dienų laikotarpis skaičiuojamas nuo pirmojo prisijungimo. Jei sutikimas niekada nesuteikiamas iš naujo, integracija nustoja veikti tą pačią kiekvieno ketvirčio dieną.
- Kelios įmonės vienoje aplinkoje. Vienoje aplinkoje gali būti kelios įmonės, todėl su kiekviena užklausa siųskite teisingą
X-Companyreikšmę.
Sage 200 integracija: kas ją konfigūruoja ir prižiūri
- SkyPlanner komanda integraciją sukonfigūruoja diegimo metu ir prižiūri ją po paleidimo.
- Gali dalyvauti ir jūsų Sage 200 partneris. Partneris išmano jūsų naudojamą priedą ir įjungia API Sage 200 Professional sistemoje.
- Jūsų programuotojai gali toliau plėtoti integraciją naudodami tą pačią dokumentuotą REST API ir API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda.
Sujungus sistemas, Arcturus variklis sudaro tvarkaraštį pagal aktualius Sage 200 gamybos užsakymus, o suplanuotos datos įrašomos į šių užsakymų operacijas. SkyPlanner kaina prasideda nuo 199 € per mėnesį, įskaitant 5 darbo centrus; atsiskaitoma kas mėnesį. Integracijos kaina pagal jūsų procesą ir poreikius pateikiama iš anksto kartu su pasirinktu planu, todėl visas išlaidas žinote dar prieš pradėdami. Peržiūrėkite kainas, funkcijas ir palyginimą su pačios Sage 200 planavimo galimybėmis puslapyje Sage 200 gamybos planavimas pagal realius staklių ir darbuotojų pajėgumus. Apžvalgą rasite Sage 200 puslapyje, o kitas ERP sistemas – ERP integracijų skiltyje.
Gamintojų atsiliepimai apie SkyPlanner
2 hsutaupoma kas savaitę
„SkyPlanner padėjo mums pereiti nuo gamybos planavimo Excel lentelėse prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skydai ir skirstymo įrenginiai
Planuojant gamybą kas savaitę sutaupomos 2 darbo valandos, o nauja darbų eilė gamybos liniją pasiekia per kelias sekundes.
1 000 ir daugiauautomatiškai suplanuotų gamybos užsakymų
„Dabar gamybą valdome kitaip, o mūsų supratimas apie pajėgumus – visiškai kito lygio.“
Hannu Ryynänen, generalinis direktorius
Mamec · Pramoniniai maišytuvai, siurbliai ir aukštųjų technologijų sutartinė gamyba
Tūkstančiai gamybos užsakymų suplanuojami automatiškai, o visa organizacija mato gamybos būklę realiuoju laiku.
Dažniausiai užduodami klausimai
Ar Sage 200 API apima gamybos užsakymus?
Ne. Sage 200 Professional API apima gaminius, atsargas, pardavimo ir pirkimo užsakymus, finansus bei kitas sritis, tačiau neturi gamybos užsakymų ar operacijų išteklių. Gamybos užsakymai gaunami iš jūsų gamybos priedo, pavyzdžiui, Sicon Works Order Processing arba Cim200, tokiu būdu, dėl kurio susitariama apibrėžiant apimtį.
Kas kuria Sage 200 integraciją?
SkyPlanner komanda diegimo metu sukonfigūruoja abipusę integraciją pagal jūsų Sage 200 aplinką ir prižiūri ją po paleidimo. Jūsų Sage 200 partneris įjungia API ir gali dalyvauti projekte. Jūsų programuotojai taip pat gali kurti sprendimus naudodami dokumentuotą SkyPlanner REST API – pradžiai pakanka API prieigos rakto.
Ar Sage 200 gali siųsti pakeitimus realiuoju laiku?
Sage 200 API neturi įvykių pranešimų funkcijos. Atsargų ir pirkimo užsakymų pakeitimai tikrinami periodinėmis užklausomis pagal date_time_updated, o gamybos užsakymai nuskaitomi iš jūsų priedo kas kelias minutes. Priešinga kryptimi SkyPlanner įvykių pranešimai perduoda tvarkaraščio pakeitimus vos jiems įvykus.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti gamybos užsakymus CSV arba Excel formatu. Kredito kortelės nereikia. Pradėkite nemokamą bandymą arba susisiekite su pardavimų komanda, kad apibrėžtumėte integracijos apimtį.
