Integrációk / ERP / Sage 200
Sage 200 integrációs útmutató a SkyPlanner APS gyártásütemezéséhez
Ez a Sage 200 integrációs útmutató bemutatja az üzleti partnereknek és az informatikai csapatoknak, hogyan kapcsolhatják össze a Sage 200 Professional rendszert és annak gyártási kiegészítőjét a SkyPlanner APS rendszerrel. A SkyPlanner és a Sage 200 között kétirányú az adatkapcsolat:
- A termékek, raktárkészletek, beszerzési és vevői rendelések adatai a Sage 200 REST API felületén keresztül érkeznek.
- A gyártási rendelések, műveletek, valamint a munkaerő- és gépi erőforrások adatai a gyártási kiegészítőből érkeznek.
- A műveletek tervezett időpontjai visszakerülnek a gyártási rendelésekhez.
- A gépkezelők időráfordítási naplói visszakerülnek a rendszerbe, ahol az időket az egyes műveletekre könyvelik.
A SkyPlanner csapata a bevezetés során az Ön Sage 200 környezetéhez igazítja az integrációt, és az éles indulás után is támogatja azt. Ez az útmutató azoknak a partnereknek és fejlesztőknek szól, akik részt szeretnének venni a munkában, vagy maguk szeretnének fejleszteni a SkyPlanner dokumentált REST API felületére építve (API-referencia).
Két adatforrás egy Sage 200 rendszeren belül
A gyártásban használt Sage 200 környezet két rétegből áll, és az integráció mindkettőből olvas adatokat.
1. Sage 200 REST API a kereskedelmi és készletadatokhoz. A Sage szerint az API „lets your application read and modify data in a Sage 200 site” (lehetővé teszi, hogy az alkalmazás adatokat olvasson és módosítson az adott környezetben). Ide tartoznak a vevők, szállítók, termékek, vevői és beszerzési rendelések, valamint a főkönyvi számlák. A Sage 200 Professional referenciadokumentációja (2025.02) a következő csoportokba sorolja az erőforrásokat: Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP és Stock. Az ütemezés szempontjából fontos erőforrások:
| Erőforrás | Tartalom |
|---|---|
products | Kód, név, készletnyilvántartási egység, BOM-tételtípus, standard költség |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Nyitott beszerzési rendelések, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Vevői igények, requested_delivery_date, promised_delivery_date |
warehouses, units | Telephelyek és mértékegységek |
2. Gyártási kiegészítő a gyártási rendelésekhez. A Sage 200 API nem tartalmaz végpontokat a gyártási rendelésekhez, műveletekhez vagy erőforrásokhoz. A gyártási rendeléseket a Sicon Works Order Processing, a Cim200 vagy a korábbi Sage 200 Manufacturing modul kezeli. Az integráció a kiegészítő által támogatott módon olvassa a gyártási rendeléseket, műveleteket és erőforrásokat. Ennek módját a felmérés során Önnel és Sage 200 partnerével egyeztetjük.
Hitelesítés és hozzáférés
A Sage 200 API „uses OAuth 2.0 with OpenID Connect” (az OAuth-protokollt OpenID Connecttel használja), az authorization code grant folyamatot követve. A bejelentkezés a Sage ID szolgáltatáson keresztül történik.
- Csatlakozzon a Sage 200 API Developer Programme programhoz, és igényeljen hitelesítő adatokat.
- Rendeljen egy Sage ID-t olyan Sage 200 felhasználóhoz, akinek a használt végpontokhoz megfelelő vállalati és funkciószintű hozzáférése van.
- Kérje az
offline_accessjogosultsági hatókört, különben nem kap frissítési tokent. - Minden adatbázis-kérésben küldje el az
Authorization: Bearer <access_token>, azX-Siteés azX-Companyfejlécet. Mindkét azonosító a/sitesvégpontról származik.
A Sage 200 Professional alap-URL-je: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. A kérések GET, POST, PUT és DELETE metódusokat, valamint a következő OData lekérdezési paramétereket használják: $filter, $select, $top, $skip, $orderby és $expand.
A Sage 200 Professional esetében az ügyfél támogatási szolgáltatója engedélyezi az API-t. A Sage ellenőrzőlistáján a szolgáltató igazolja, hogy „the API is enabled” (az API engedélyezve van), és hogy „each required user has a Sage ID assigned.” (minden érintett felhasználóhoz hozzá van rendelve egy Sage ID). A Sage 200 Standard rendszerben az API alapértelmezés szerint engedélyezve van.
A tervezésnél figyelembe kell venni a tokenek élettartamát. A hozzáférési tokenek 8 óráig érvényesek. A frissítési tokenek élettartama 1 és 90 nap közötti, és „The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (A frissítési időablakot a felhasználó első bejelentkezésétől számítják, nem a legutóbbi frissítéstől.) A Sage szerint az újbóli hitelesítés „is unavoidable” (elkerülhetetlen). Tervezzen be figyelmeztetést az újbóli hozzájárulásra, még az időablak lejárta előtt.
A SkyPlanner oldalán a REST API API-tokennel hitelesít (SkyPlanner Settings > API), dokumentációja pedig Swagger/OpenAPI formátumban érhető el. Az integrációs oktatóanyag végigvezeti az első hívásokon.
Változások észlelése
A Sage 200 API referenciadokumentációjában nincs webhook- vagy feliratkozási erőforrás. A változásokat rendszeres lekérdezéssel lehet észlelni. A rekordok tartalmazzák a date_time_created és a date_time_updated mezőt, így minden lekérdezés a $filter paraméterrel szűr a date_time_updated mezőre, a lapozáshoz pedig a $top és a $skip paramétert használja.
A gyártási rendeléseket néhány percenként, a készletadatokat és a beszerzési rendelés tételeit óránként kérdezze le. A SkyPlanner webhookot küld az ütemterv változásakor, így a visszaírás eseményvezérelt.
Adatmegfeleltetés
| Sage 200 objektum (forrás) | SkyPlanner objektum | Irány | Gyakoriság |
|---|---|---|---|
products, units (API) | Termékek és anyagok | Sage 200 → SkyPlanner | Betöltés, majd rendszeres lekérdezés |
| BOM-összetevők (kiegészítő vagy BOM modul) | Termékstruktúra, résztermékek, termékenkénti anyagok | Sage 200 → SkyPlanner | Változáskor |
| Munkaerő- és gépi erőforrások, erőforráscsoportok (kiegészítő) | Munkaállomások, munkaállomás-csoportok, személyzet | Sage 200 → SkyPlanner | Kezdeti betöltés |
| Erőforrások rendelkezésre állása: leállás, karbantartás, szabadság (kiegészítő) | Műszakok, távollétek | Sage 200 → SkyPlanner | Naponta |
| Gyártási rendelések és műveleteik, műveletenkénti idők (kiegészítő) | Rendelések és gyártási feladatok a lépésekkel, időtartamokkal és határidőkkel | Sage 200 → SkyPlanner | Néhány percenként |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Vevői határidők | Sage 200 → SkyPlanner | Rendszeres lekérdezés |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Készletegyenlegek | Sage 200 → SkyPlanner | Óránként |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Beszerzési rendelések a várható szállítási dátummal | Sage 200 → SkyPlanner | Óránként |
| A gyártási rendelés műveletének tervezett kezdete, vége és erőforrása | Műveletenkénti tervezett kezdés, befejezés és munkaállomás | SkyPlanner → Sage 200 | Változáskor, webhookon keresztül |
| Műveleti idők könyvelése (kiegészítő) | Időráfordítási naplók és gépkezelői visszajelentések | SkyPlanner → Sage 200 | Visszajelentésenként vagy műszakonként |
| Ütemezési korlátok adatai a SkyPlannerben | Átállási időmátrix, szerszámok mint korlátozott kapacitású erőforrások, alternatív gépek és személyzet | A SkyPlannerben karbantartva | Bevezetés |
Integrációs minták
1. Törzsadatok kezdeti betöltése. Kérje le a termékeket és mértékegységeket az API-n keresztül, majd az erőforrásokat, erőforráscsoportokat és BOM-műveleteket a kiegészítőből. Egy három azonos gépből álló erőforráscsoport egy munkaállomás-csoportként vagy három munkaállomásként is leképezhető.
2. Rendelések szinkronizálása. Olvassa be a nyitott gyártási rendeléseket és műveleteiket a kiegészítőből, valamint a nyitott pop_order_lines tételeket és a warehouse_holdings adatokat az API-n keresztül. Az ütemezés a készletet és a beérkező beszerzéseket is ellenőrzi. Az MRP továbbra is a Sage 200 rendszerben tesz javaslatot gyártási rendelésekre, a SkyPlanner pedig az Ön által létrehozott rendeléseket ütemezi.
3. Az ütemterv visszaírása. A SkyPlanner minden olyan műveletnél, amelyet az ütemezőmotor elhelyezett vagy áthelyezett, visszaküldi a tervezett kezdést, befejezést és erőforrást a gyártási rendeléshez. A mennyiségeket, foglalásokat és költségszámítást továbbra is a kiegészítő kezeli.
4. Üzemi visszajelentések. A gépkezelők a SkyPlanner Mobile Confirmations vagy a Production Timer segítségével rögzítik a munkát, az időráfordítási naplók pedig naprakészen tartják az ütemtervet. A rögzített idők a gyártási rendelés adott műveletére könyvelt időként kerülnek vissza, így a Sage 200 költségszámítása a tényleges munkaórákkal dolgozik.
Ha az üzemben már a Sicon Shop Floor Data Capture vagy a Cim200 Shop Floor Data Capture rendszerben rögzítik az időket, válasszon egyetlen időkönyvelési csatornát.
5. Adatgazdák és ütközéskezelési szabályok. Ezeket még az éles indulás előtt rögzítse írásban:
| Adatok | Adatgazda |
|---|---|
| Termékek, BOM-ok, gyártási rendelések mennyiségei, foglalások, költségek | Sage 200 és a bővítmény |
| Műveleti sorrend, kezdési és befejezési időpontok, munkaállomások hozzárendelése | SkyPlanner |
| Átállásiidő-mátrix, szerszám- és gépkezelői igények, alternatív erőforrások | SkyPlanner |
| Munkaidő rögzítése | Sage 200, a SkyPlanner időnaplói alapján |
Az ütközések fő forrása a kapacitásdiagram. Ha a tervezők továbbra is áthúzással helyezik át a gyártási rendeléseket vagy műveleteket a Sicon Rough Cut Capacity Planning vagy a Cim200 Graphical Scheduler felületén, két rendszer kezeli az időpontokat. A műveletek időpontjait bízza a SkyPlannerre. Az Autopilot segítségével a SkyPlanner automatikusan újraütemez, amikor változás történik a gyártásban.
A projekt jellemző lépései
A megvalósítás általában a bevezetés kezdetétől számított néhány héten belül lezárul. Előtte ellenőrizze az ütemtervet a 30 napos ingyenes próbaidőszakban, a nyitott gyártási rendelések CSV- vagy Excel-exportjával. A projekt ezután a következő lépésekből áll:
- Felmérés. Egyeztesse a bővítményt és annak verzióját, a gyártási rendelések beolvasásának és az adatok visszaírásának módját, a szinkronizálás gyakoriságát és a munkaidő-rögzítés csatornáját.
- API-hozzáférés. A támogatást nyújtó szolgáltató engedélyezi a Sage 200 API-t, egy Sage ID-t hozzárendel egy Sage 200-felhasználóhoz, és beállítja a cégekhez és funkciókhoz való hozzáférést.
- Kezdeti adatbetöltés. Termékek, mértékegységek, erőforrások, erőforráscsoportok, BOM-műveletek és rendelkezésre állás.
- Rendelések szinkronizálása. Gyártási rendelések, beszerzési rendelési sorok és készletadatok rendszeres lekérdezése, az újbóli hozzájárulás szükségességét jelző értesítéssel.
- Korlátok beállítása a SkyPlannerben. Átállásiidő-mátrix, szerszámok, gyártási feladatonként szükséges gépkezelői létszám, valamint alternatív gépek vagy munkatársak.
- Az ütemterv visszaírása. A műveletek tervezett időpontjainak visszaírása a gyártási rendelésekbe; a munkaidő-rögzítés bekapcsolására is itt kerül sor.
- Párhuzamos tesztelés és éles indulás. Hasonlítsa össze az időpontokat a jelenlegi tervvel, javítsa a törzsadatokat, majd kapcsolja be a visszaírást.
Mire kell felkészülni a Sage 200 integrációjánál?
- Kivezetett modul az új verzióban. A korábbi Sage 200 Manufacturing modul a Sage 200 Professional 2025 R2 verziójától nem használható. Mielőtt bármilyen adatmegfeleltetést végezne, tisztázza, melyik gyártási megoldás lesz használatban az éles induláskor.
- Műveleti idők költségadatokból. A Sicon MRP a Sage 200 BOM költségtételeiből becsüli meg a munka- és gépidőket. Először vesse össze ezeket a tényleges gyártási időkkel.
- Eltérő költségkategória-beállítások. A Sage figyelmeztetése szerint a Nominal, Overhead Nominal és Overhead Recovery % értékének egyeznie kell a BOM-műveletekben és a költségkategóriákban, különben „there will be cost discrepancies.” (költségeltérések keletkeznek).
- Megújítási időablak. A legfeljebb 90 napos időszak az első bejelentkezéstől számít. Ha az integrációhoz nem adják meg újra a hozzájárulást, az minden negyedévben ugyanazon a napon leáll.
- Több céget kezelő környezetek. Egy környezet több céget is tartalmazhat, ezért minden kérésben a megfelelő
X-Companyértéket küldje el.
A Sage 200 integrációja: ki állítja be, és ki nyújt támogatást?
- A SkyPlanner csapata a bevezetés során beállítja az integrációt, az éles indulás után pedig támogatást nyújt hozzá.
- Az Ön Sage 200-partnere is részt vehet a munkában. A partner ismeri az Ön bővítményét, és engedélyezi az API-t a Sage 200 Professional rendszerben.
- Saját fejlesztői is továbbfejleszthetik az integrációt ugyanazon a dokumentált REST API-n keresztül, API-token használatával. Az induláshoz elegendő egy API-token, és a SkyPlanner csapata szükség esetén segít.
A kapcsolat létrehozása után az Arcturus motor a Sage 200 aktuális gyártási rendelései alapján ütemez, a tervezett időpontok pedig bekerülnek a gyártási rendelések műveleteibe. A SkyPlanner havi 199 €-tól érhető el, 5 munkaállomással, havi számlázással. Az integrációra az Ön folyamatai és igényei alapján, a választott csomaggal együtt előzetes árajánlatot adunk, így már az indulás előtt látja a teljes költséget. Tekintse meg az árakat és a funkciókat, a Sage 200 termelésütemezéséről szóló oldalon pedig azt is, hogyan viszonyul ehhez a Sage 200 saját tervezési megoldása. Az áttekintést a Sage 200 oldalán, a többi ERP-rendszert pedig az ERP-integrációk gyűjtőoldalán találja.
Gyártóvállalatok véleménye a SkyPlannerről
2 hmegtakarítás hetente
„A SkyPlannerrel az Excel-táblázatokon alapuló gyártástervezésről áttértünk a gyártás valós idejű optimalizálására.”
Kalle Kalliomäki, ellátásilánc-szakértő
UTU · Elektromos kapcsolószekrények és kapcsolóberendezések
A gyártástervezés hetente 2 óra munkaidőt takarít meg, az új feladatsor pedig másodpercek alatt eljut a gyártósorra.
1 000-es nagyságrendűaz automatikusan ütemezett gyártási rendelések száma
„Egészen másképp tartjuk kézben a gyártást, és teljesen más szinten látjuk át a kapacitásunkat.”
Hannu Ryynänen, vezérigazgató
Mamec · Ipari keverők, szivattyúk és csúcstechnológiás bérgyártás
Gyártási rendelések ezreit ütemezik automatikusan, miközben az egész szervezet valós időben látja át a gyártást.
Gyakori kérdések
Elérhetők a gyártási rendelések a Sage 200 API-n keresztül?
Nem. A Sage 200 Professional API többek között a termékeket, a készletet, a vevői és beszerzési rendeléseket, valamint a pénzügyeket kezeli, de gyártási rendelésekhez és műveletekhez nem biztosít API-erőforrásokat. A gyártási rendelések a gyártási bővítményből, például a Sicon Works Order Processing vagy a Cim200 rendszerből érkeznek, a felmérés során egyeztetett módon.
Ki valósítja meg a Sage 200 integrációját?
A SkyPlanner csapata a bevezetés során az Ön Sage 200-környezetéhez igazítva állítja be a kétirányú integrációt, és az éles indulás után is támogatást nyújt hozzá. Az Ön Sage 200-partnere engedélyezi az API-t, és részt vehet a munkában. Saját fejlesztői is építhetnek a SkyPlanner dokumentált REST API-jára; az induláshoz elegendő egy API-token.
Képes a Sage 200 valós időben továbbítani a változásokat?
A Sage 200 API nem támogat webhookokat. A készletadatokat és a beszerzési rendeléseket a date_time_updated alapján rendszeresen lekérdezzük, a gyártási rendeléseket pedig néhány percenként olvassuk be a bővítményből. A másik irányban a SkyPlanner saját webhookjai azonnal továbbítják az ütemterv változásait.
Kipróbálhatjuk a SkyPlannert az integráció kiépítése előtt?
Igen. A 30 napos ingyenes próbaidőszakban legfeljebb 20 munkaállomást használhat, gyártási rendeléseit pedig CSV- vagy Excel-fájlból importálhatja. Bankkártya nem szükséges. Indítsa el a próbát, vagy vegye fel a kapcsolatot értékesítőinkkel az integráció felméréséhez.
