Integrácie / ERP / Exact
Sprievodca integráciou Exact Online so SkyPlanner APS na rozvrhovanie výroby
Tento sprievodca integráciou Exact Online ukazuje partnerom Exact a IT tímom, ako prepojiť Exact Online Manufacturing so SkyPlanner APS. SkyPlanner sa s Exact Online prepája obojsmerne:
- Cez REST API systému Exact Online sa načítavajú výrobné príkazy, kroky technologických postupov, materiálové plány, pracoviská, operácie a kusovníky.
- Načítavajú sa položky, stavy zásob, nákupné a predajné objednávky. Zmeny sa prenášajú pomocou webhookov systému Exact Online.
- Plánované dátumy začiatku a konca sa zapisujú späť ku každému kroku technologického postupu aj k výrobnému príkazu.
- Časové záznamy operátorov sa zapisujú ako časové transakcie a hotové množstvá ako príjemky z výrobných príkazov.
Tím SkyPlanner počas úvodného nasadenia prispôsobí integráciu vášmu nastaveniu Exact Online a po spustení ostrej prevádzky jej poskytuje podporu. Tento sprievodca je určený partnerom a vývojárom, ktorí sa chcú zapojiť alebo sami využiť zdokumentované REST API systému SkyPlanner (referenčná dokumentácia API). Na konci nájdete aj krátku časť o Exact Globe+.
REST API systému Exact Online pre výrobu
Exact Online sprístupňuje dáta cez jedno REST API, v ktorom sú zdroje zoskupené podľa služieb. Základná cesta je /api/v1/{division}/<service>/<resource>, pričom division označuje spoločnosť v Exact Online. Referenčná dokumentácia REST API uvádza pri službe pre výrobu tieto zdroje využiteľné pri rozvrhovaní:
| Zdroj | Obsah | Metódy |
|---|---|---|
manufacturing/ShopOrders | Číslo výrobného príkazu, položka, PlannedQuantity, PlannedStartDate, PlannedDate, stav, príznak uvoľnenia | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Krok technologického postupu pre výrobný príkaz: operácia, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Materiálové riadky pre výrobný príkaz | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Kód, typ, výrobná oblasť, hodnota kapacity, sadzby | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Operácie a pracoviská, na ktorých sa vykonávajú, časy prípravy a spracovania | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Verzie kusovníkov, komponenty a technologický postup | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Hodiny vykázané na výrobný príkaz a krok technologického postupu | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Hotové množstvá prijaté z výrobného príkazu | GET, POST |
manufacturing/MaterialIssues | Materiál vydaný na výrobný príkaz | GET, POST |
manufacturing/ShopOrderPriorities | Režim priority pre výrobný príkaz | GET, PUT |
Z ostatných služieb:
| Zdroj | Obsah |
|---|---|
logistics/Items | Kmeňové dáta položiek |
inventory/ItemWarehouses | Zásoby podľa položky a skladu |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Otvorené nákupné objednávky a dátumy príjmu |
salesorder/SalesOrders, SalesOrderLines | Dopyt zákazníkov a termíny dodania |
Autentifikácia a prístup
Exact Online používa OAuth 2.0 s tokom autorizačného kódu a obnovovacími tokenmi. Exact uvádza: „Before you can start integration with Exact Online, you must first register your app in the App Store.“ (Pred začatím integrácie s Exact Online musíte najprv zaregistrovať svoju aplikáciu v App Store.) (Pomocník Exact Online) Na registráciu aplikácií potrebujete predplatné Exact Online Developer (Exact App Store).
- Integrácia sa zaregistruje ako aplikácia s URI na presmerovanie.
- Používateľ Exact Online s prístupom k výrobe, zásobám a nákupu udelí jednorazový súhlas.
- Každá požiadavka odosiela
Authorization: Bearer <access_token>a v ceste uvádza spoločnosť (division). - Prístupové tokeny sa obnovujú pomocou obnovovacieho tokenu. Exact obmedzuje frekvenciu žiadostí o nový token, preto token uchovávajte vo vyrovnávacej pamäti až do skončenia jeho platnosti.
Exact tiež obmedzuje počet volaní za minútu a za deň pre každú aplikáciu a spoločnosť a požaduje postupné volania namiesto paralelných. Aktuálne limity nájdete v článku Exact o limitoch API. Integrácia tieto limity zohľadňuje: pri čítaní filtruje dáta pomocou $filter a $select a na hromadné zmeny používa Sync API.
Na strane SkyPlanner sa prístup k REST API overuje pomocou tokenu API v hlavičke Authorization-Token (SkyPlanner Settings > API). Dokumentácia je dostupná vo formáte Swagger/OpenAPI. Návod na integráciu vás prevedie prvými volaniami.
Webhooky a pravidelné načítavanie
Keď sa zmení téma, ktorej odber máte prihlásený, webhooky Exact Online odošlú na vašu URL pre spätné volania požiadavku POST podpísanú hashom HMAC SHA256 (webhooky). Medzi témy patria Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders a SalesOrderLines. Zmeny zásob, nákupu a dopytu sa tak prenášajú do SkyPlanner hneď, ako nastanú.
Výrobné príkazy a kroky technologických postupov sa načítavajú v pravidelných intervaloch. Filtrujte ShopOrders a ShopOrderRoutingStepPlans podľa Modified a na hromadné čítanie používajte Sync API (obmedzenia API).
SkyPlanner pri zmene rozvrhu odosiela vlastné webhooky, takže spätný zápis do Exact Online sa spúšťa na základe udalostí.
Mapovanie dát
| Zdroj v Exact Online | Objekt v SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
Items | Výrobky a materiály | Exact Online → SkyPlanner | Načítanie, potom webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Štruktúra výrobku, podvýrobky, materiály pre jednotlivé výrobky | Exact Online → SkyPlanner | Pri zmene |
Workcenters, OperationResources | Pracoviská, skupiny pracovísk | Exact Online → SkyPlanner | Úvodné načítanie |
Operations, BillOfMaterialRoutings | Kroky procesu s časmi prípravy a spracovania | Exact Online → SkyPlanner | Pri zmene |
ShopOrders | Zákazky s množstvom a termínom dokončenia | Exact Online → SkyPlanner | Každých pár minút |
ShopOrderRoutingStepPlans | Operácie s poradím, pracoviskom a časmi prípravy a spracovania v hodinách | Exact Online → SkyPlanner | Každých pár minút |
ShopOrderMaterialPlans | Materiály pre jednotlivé operácie | Exact Online → SkyPlanner | Každých pár minút |
ItemWarehouses, StockPosition | Stavy zásob | Exact Online → SkyPlanner | Webhook |
PurchaseOrderLines | Nákupné objednávky s očakávaným dátumom dodania | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Termíny dodania zákazníkom a priorita | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Plánovaný začiatok, koniec a pracovisko pre každú operáciu | SkyPlanner → Exact Online | Pri zmene, cez webhook |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Začiatok a dokončenie výrobného príkazu | SkyPlanner → Exact Online | Pri zmene, cez webhook |
TimeTransactions (POST) | Záznamy odpracovaného času a potvrdenia operátorov | SkyPlanner → Exact Online | Pri každom potvrdení alebo za každú zmenu |
ShopOrderReceipts (POST) | Dokončené množstvo pri poslednej operácii | SkyPlanner → Exact Online | Pri každom potvrdení |
| Neeviduje sa v Exact Online | Matica prípravných časov, nástroje ako zdroje s obmedzenou kapacitou, operátori pre jednotlivé operácie, alternatívne pracoviská, pracovné zmeny | Spravuje sa v SkyPlanner | Úvodné nastavenie |
Spôsoby integrácie
1. Úvodné načítanie kmeňových dát. Načítajte Workcenters, Operations a OperationResources, potom položky a verzie kusovníkov s ich technologickými postupmi. Pracovisko s tromi strojmi sa zmení na tri pracoviská alebo jednu skupinu pracovísk. Pracovné zmeny, neprítomnosti a nadčasy sa nastavujú v SkyPlanner, pretože pracovisko v Exact má len jednu hodnotu kapacity.
2. Synchronizácia výrobných príkazov. Načítajte otvorené ShopOrders s ich ShopOrderRoutingStepPlans a ShopOrderMaterialPlans, ako aj zásoby a riadky nákupných objednávok. Pri rozvrhovaní sa kontrolujú zásoby aj očakávané dodávky z nákupu. MRP naďalej poskytuje návrhy objednávok v Exact Online a SkyPlanner rozvrhuje výrobné príkazy, ktoré vytvoríte.
3. Spätný zápis rozvrhu. Pre každú operáciu technologického postupu, ktorú plánovací algoritmus zaradil alebo presunul, odošle SkyPlanner požiadavku PUT do ShopOrderRoutingStepPlans s údajmi PlannedStartDate, PlannedEndDate a Workcenter. Hodnoty PlannedStartDate a PlannedDate výrobného príkazu sa odvíjajú od prvej a poslednej operácie. Množstvá, materiálové plány a kalkulácie nákladov zostávajú v Exact Online.
4. Potvrdenia z dielne. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations alebo Production Timer a záznamy odpracovaného času udržiavajú rozvrh aktuálny. Zaznamenané hodiny sa zapisujú ako TimeTransactions k výrobnému príkazu a operácii technologického postupu, a to ako čas prípravy alebo samotnej výroby. Záverečné potvrdenie vytvorí záznam ShopOrderReceipts pre dokončené množstvo. Ak už váš závod eviduje čas v Shop Floor Control, vyberte si jeden spôsob evidencie.
5. Pravidlá správy dát a riešenia konfliktov. Spíšte ich pred spustením do ostrej prevádzky:
| Dáta | Zodpovedný systém |
|---|---|
| Položky, kusovníky, množstvá výrobných príkazov, materiálové plány, náklady | Exact Online |
| Poradie operácií technologického postupu, časy začiatku a konca, priradenie pracoviska | SkyPlanner |
| Matica prípravných časov, nástroje, operátori pre jednotlivé operácie, alternatívne zdroje, pracovné zmeny | SkyPlanner |
| Záznamy odpracovaného času a príjemky | Exact Online, s dátami zo SkyPlanner |
Hlavným zdrojom konfliktov sú ručné úpravy dátumov. Ak plánovači naďalej menia dátumy výrobných príkazov v Exact Online, dátumy spravujú dva systémy. Správu dátumov operácií technologického postupu prenechajte SkyPlanner. S funkciou Autopilot SkyPlanner automaticky upraví rozvrh pri zmenách vo výrobe.
Typický priebeh projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku úvodného nastavenia. Ešte predtým si overte rozvrh počas 30-dňového bezplatného skúšobného obdobia pomocou exportu otvorených výrobných príkazov a operácií technologických postupov vo formáte CSV alebo Excel. Projekt potom prebieha takto:
- Definovanie rozsahu. Potvrďte edíciu, divízie, frekvencie synchronizácie, spôsob evidencie času a zápisu príjemiek.
- Aplikácia a súhlas. Zaregistrujte aplikáciu. Používateľ Exact Online potom udelí súhlas OAuth pre každú divíziu.
- Úvodné načítanie. Pracoviská, operácie, položky, verzie kusovníkov a technologické postupy.
- Synchronizácia výrobných príkazov. Výrobné príkazy, plány operácií technologických postupov a materiálové plány v nastavených intervaloch, zásoby a nákup cez webhook.
- Nastavenie obmedzení v SkyPlanner. Pracovné zmeny, matica prípravných časov, nástroje, počty operátorov pre jednotlivé operácie a alternatívne stroje alebo pracovníci.
- Spätný zápis rozvrhu. Plánované dátumy operácií technologických postupov do Exact Online, potom záznamy odpracovaného času a príjemky.
- Paralelné testovanie a spustenie do ostrej prevádzky. Porovnajte dátumy s aktuálnym plánom, opravte kmeňové dáta a potom zapnite spätný zápis.
S čím počítať pri integrácii s Exact Online
- Časy operácií technologického postupu.
PlannedSetupHoursaPlannedRunHourspochádzajú z technologického postupu kusovníka. Najprv ich porovnajte so skutočnými výrobnými časmi. - Zoskupovanie pracovísk. Exact uchováva pre každé pracovisko jednu hodnotu kapacity. Pri každom rozhodnite, či ho v SkyPlanner vytvoríte ako jedno pracovisko, viacero pracovísk alebo skupinu.
- Kalendáre. Pracovné zmeny, sviatky a neprítomnosti sa evidujú v SkyPlanner. Nastavte ich pred vytvorením prvého rozvrhu.
- Limity volaní. Exact obmedzuje počet volaní pre každú aplikáciu a spoločnosť a vyžaduje postupné volania. Tam, kde sú dostupné témy, používajte webhooky, na pole
Modifiedaplikujte$filtera na hromadné načítanie používajte Sync API. - Viacero divízií. Každá divízia v Exact Online predstavuje spoločnosť s vlastnou cestou a vlastným súhlasom. Každý závod priraďte k príslušnej divízii.
- Uvoľnené výrobné príkazy. Dohodnite sa, pri ktorých stavoch môže SkyPlanner meniť dátumy: pri otvorených aj uvoľnených príkazoch alebo len pri otvorených.
- Jeden systém zodpovedný za dátumy. Keď správu dátumov operácií technologických postupov prevezme SkyPlanner, prestaňte ručne upravovať dátumy v Exact Online.
Exact Globe+
Exact Globe+ je ERP systém spoločnosti Exact, ktorý predávajú a implementujú partneri Exact Globe+. Exact uvádza, že sa „koppelt eenvoudig en snel met andere systemen“ (jednoducho a rýchlo prepája s inými systémami) (Exact Globe+). SkyPlanner rozvrhuje výrobné príkazy z Exact Globe+ rovnakým spôsobom: načítava výrobné príkazy, technologické postupy, zdroje a zásoby a späť odosiela plánované dátumy a zaznamenané hodiny. Váš partner Exact Globe+ a tím SkyPlanner sa pri definovaní rozsahu dohodnú na rozhraní a objektoch pre spätný zápis.
Integrácia s Exact Online: kto ju nastavuje a zabezpečuje jej podporu
- Tím SkyPlanner ju nakonfiguruje počas úvodného nastavenia a po spustení do ostrej prevádzky poskytuje podporu.
- Zapojiť sa môže aj váš partner Exact. Pozná vaše edície, divízie a nastavenie výroby.
- Vaši vývojári ju môžu ďalej rozvíjať pomocou zdokumentovaného REST API systému SkyPlanner. Na začiatok stačí API token a tím SkyPlanner v prípade potreby pomôže.
Po prepojení plánovací algoritmus Arcturus rozvrhuje výrobu na základe aktuálnych výrobných príkazov z Exact Online a plánované dátumy sa zapíšu ku každej operácii technologického postupu. SkyPlanner je dostupný od 199 € mesačne s 5 pracoviskami v cene a mesačnou fakturáciou. Cenovú ponuku na integráciu dostanete vopred podľa vašich procesov a potrieb spolu s cenou vášho programu, takže ešte pred začiatkom poznáte celkové náklady. Pozrite si cenník, funkcie a porovnanie s vlastným plánovaním Exact Online v článku Plánovanie výroby v Exact Online s ohľadom na reálne kapacity strojov a pracovníkov. Prehľad nájdete na stránke Exact Online a ďalšie ERP systémy v prehľade integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
Menej prestojov pre nedostatok materiálu
„Prínos SkyPlanner pre nás spočíva v tom, že je to nástroj, ktorý funguje pri každodennom používaní, najmä pri stanovovaní termínov dodania.“
Tommi Männistö, manažér plánovania výroby
Eskomatic · Zákazkové obrábanie
Automatické rozvrhovanie vyťaženia umožňuje presnejšie určovať termíny dodania a počet prestojov vo výrobe spôsobených nedostatkom materiálu výrazne klesol.
1 000 a viac automaticky rozvrhnutých výrobných príkazov
„Výrobu máme pod kontrolou celkom inak a náš prehľad o kapacitách je na úplne inej úrovni.“
Hannu Ryynänen, generálny riaditeľ
Mamec · Priemyselné miešadlá, čerpadlá a technologicky vyspelá zákazková výroba
Tisíce výrobných príkazov sa rozvrhujú automaticky a celá organizácia má prehľad o výrobe v reálnom čase.
Často kladené otázky
Zahŕňa API systému Exact Online výrobné príkazy a operácie technologických postupov?
Áno. Služba pre výrobu poskytuje ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations a zdroje pre kusovníky. Všetky umožňujú čítanie aj zápis. Čas sa zapisuje cez TimeTransactions a dokončené množstvá cez ShopOrderReceipts.
Ako sa plánované termíny zapisujú späť do Exact Online?
Pre každý krok, ktorý SkyPlanner zaradí do rozvrhu alebo presunie, odošle požiadavku PUT na ShopOrderRoutingStepPlans s hodnotami PlannedStartDate, PlannedEndDate a Workcenter. Hodnoty PlannedStartDate a PlannedDate výrobného príkazu sa aktualizujú tak, aby zodpovedali týmto termínom.
Kto vytvára integráciu s Exact Online?
Tím SkyPlanner pri zavádzaní nastaví obojsmernú integráciu podľa vašej konfigurácie Exact Online a po spustení do ostrej prevádzky zabezpečuje jej podporu. Zapojiť sa môže aj váš partner pre Exact. Integráciu môžu vytvoriť aj vaši vlastní vývojári pomocou zdokumentovaného REST API systému SkyPlanner. Na začiatok stačí API token.
Dokáže Exact Online odosielať zmeny v reálnom čase?
Webhooky Exact Online odosielajú zmeny položiek, stavov zásob, nákupných objednávok a predajných objednávok. Výrobné príkazy a operácie technologických postupov sa načítavajú v krátkych intervaloch pomocou filtrovaných požiadaviek. V opačnom smere webhooky systému SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Môžeme si SkyPlanner vyskúšať ešte pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk a umožňuje importovať výrobné príkazy zo súborov CSV alebo Excel. Platobnú kartu nepotrebujete. Spustite skúšobnú verziu alebo kontaktujte obchodný tím a definujte rozsah integrácie.