Integrácie / ERP / Acumatica Cloud ERP
Sprievodca integráciou Acumatica na rozvrhovanie výroby so SkyPlanner APS
Tento sprievodca integráciou Acumatica ukazuje partnerom a IT tímom, ako prepojiť Acumatica Cloud ERP (Manufacturing Edition) so SkyPlanner APS. Integrácia SkyPlanner s Acumatica funguje obojsmerne:
- Do SkyPlanner sa prenášajú výrobné príkazy s operáciami, pracoviská, stroje, nástroje, zmeny, skladové položky a nákupné objednávky.
- Do operácií výrobného príkazu sa zapisujú plánované dátumy začiatku a konca a príkaz sa zafixuje.
- Časové záznamy operátorov sa prenášajú späť ako záznamy práce a presunov.
- Webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas zavádzania nakonfiguruje integráciu podľa vášho nastavenia Acumatica a po spustení ostrej prevádzky zabezpečuje jej podporu. Tento sprievodca je určený partnerom a vývojárom, ktorí sa chcú do integrácie zapojiť alebo sami vyvíjať riešenia nad zdokumentovaným REST API systému SkyPlanner (referenčná dokumentácia API).
Integračné rozhrania Acumatica
Integrácia využíva rozhrania, ktoré sú už súčasťou Acumatica. Do inštancie sa nič neinštaluje.
- REST API založené na kontraktoch. Endpointy sú verzované podľa vydaní systému. Endpoint Manufacturing (napríklad 26.200.001 pre 2026 R2) sprístupňuje
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryaMaterialEntry. Endpoint Default zahŕňaStockItem,PurchaseOrderaSalesOrder. URL majú tvar{instance}/entity/{Endpoint}/{version}/{Entity}. - Akcie na tom istom endpointe.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryaReleaseMaterialEntryspúšťajú rovnakú logiku ako tlačidlá na obrazovkách. - OData. Každý Generic Inquiry (SM208000) možno sprístupniť cez OData. Generic Inquiry s otvorenými výrobnými operáciami a ich dátumami je najrýchlejší spôsob hromadného načítania.
- Push notifikácie (SM302000). Vychádzajú z Generic Inquiry alebo zo vstavaného dotazu a odosielajú vložené a odstránené riadky na URL, ktorú nakonfigurujete.
- Scenáre importu a exportu s poskytovateľmi dát CSV a Excel na hromadné načítanie.
Zoznam entít a akcií nájdete na obrazovke Web Service Endpoints (SM207000) a v repozitári REST klienta Acumatica.
Autentifikácia a limity
Acumatica používa OAuth 2.0 a OpenID Connect prostredníctvom klientskych aplikácií zaregistrovaných na obrazovke Connected Applications (SM303010). Dokumentácia opisuje postupy Authorization Code, Implicit, Resource Owner Password Credentials a Hybrid. Pri serverovej integrácii zaregistrujte samostatného integračného používateľa s rolami, ktoré mu udeľujú len nevyhnutné oprávnenia. Použite Authorization Code s obnovovacím tokenom alebo Resource Owner Password Credentials.
Hornú hranicu určuje vaša licencia: na obrazovke License Monitoring Console (SM604000) sa zobrazuje povolený počet API požiadaviek za minútu a používateľov API.
Na strane SkyPlanner používa REST API na autentifikáciu API token (SkyPlanner Settings > API) a jeho dokumentácia je dostupná vo formáte Swagger/OpenAPI. Integračný návod vás prevedie prvými volaniami.
Mapovanie dát
| Objekt Acumatica (endpoint / formulár) | Objekt SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produkty a materiály | Acumatica → SkyPlanner | Úvodné načítanie, potom len zmeny |
BillOfMaterial (AM208000): materiály, operácie | Štruktúra produktu, čiastkové produkty, materiály pre jednotlivé produkty | Acumatica → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Operácie BOM: Setup, Run, Machine, Queue, Finish, Move Time | Kroky procesu s časmi trvania, prípravy a ukončenia | Acumatica → SkyPlanner | Úvodné načítanie, potom pri zmene |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Pracoviská, skupiny pracovísk, účinnosti, alternatívne pracoviská | Acumatica → SkyPlanner | Úvodné načítanie, potom zriedkavo |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Zmeny a personálna kapacita | Acumatica → SkyPlanner | Denne, alebo sa zmeny spravujú v SkyPlanner |
Tool (AM205500) | Nástroje ako zdroje s obmedzenou kapacitou | Acumatica → SkyPlanner | Úvodné načítanie |
ProductionOrder s OrderOperationDetail (Planned, Released, In Process) | Zákazky a úlohy s termínmi dokončenia, prioritou zaradenia do výroby a materiálovými požiadavkami | Acumatica → SkyPlanner | Push notifikácia alebo dopytovanie každých pár minút |
Riadky PurchaseOrder (Default) | Nákupné objednávky s očakávaným dátumom dodania | Acumatica → SkyPlanner | Dopytovanie každú hodinu alebo pri spustení rozvrhovania |
| Množstvá položiek v skladoch | Skladové zostatky | Acumatica → SkyPlanner | Dopytovanie každú hodinu alebo pri spustení rozvrhovania |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Plánovaný začiatok, koniec a pracovisko pre každú operáciu | SkyPlanner → Acumatica | Pri zmene rozvrhu cez webhook SkyPlanner |
Akcia FirmProductionOrder | Chráni zapísané dátumy pred zmenami zo strany Acumatica APS | SkyPlanner → Acumatica | Po každom spätnom zápise |
LaborEntry, MoveEntry s akciami uvoľnenia | Časové záznamy, dokončené množstvá, potvrdenia operátorov | SkyPlanner → Acumatica | Pri každom potvrdení alebo za každú zmenu |
| Nie je v Acumatica | Matica časov prestavenia, konkrétni operátori, úlohy pre viacerých operátorov | Spravuje sa v SkyPlanner | Nastavenie počas zavádzania |
Integračné postupy
1. Úvodné načítanie kmeňových dát. Najprv načítajte pracoviská, stroje, nástroje, zmeny a kalendáre. Potom načítajte skladové položky a kusovníky. Rozhodnite, ako namapujete pracovisko s viacerými strojmi: ako jednu skupinu pracovísk, kde sú stroje samostatnými pracoviskami, alebo ako jedno pracovisko. Nastavenie Basis for Capacity v Acumatica vám ukáže, ktorý prístup závod používa.
2. Synchronizácia príkazov. Načítavajte výrobné príkazy spolu s ich operáciami; operácie preberajte z príkazov, nie z BOM. Operácie sa kopírujú do príkazu a plánovači ich upravujú práve tam. Pre Generic Inquiry s otvorenými príkazmi a operáciami nastavte odber push notifikácií alebo ho pravidelne dopytujte. Načítajte aj otvorené riadky nákupných objednávok. SkyPlanner považuje objednaný materiál za dostupný k dátumu dodania nákupnej objednávky a aktualizuje zásoby, keď je objednávka označená stavom Delivered.
3. Spätný zápis rozvrhu. Pre každú operáciu, ktorú plánovací mechanizmus zaradil alebo presunul, zapíše SkyPlanner do OrderOperationDetail hodnoty StartDate a EndDate. Ak sa práca presunula na alternatívne pracovisko, zapíše aj pracovisko. Potom zavolá FirmProductionOrder. Acumatica: „When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.“ (Pri spustení plánovania výrobných príkazov so zohľadnením reálnej kapacity systém nepreplánuje zafixované výrobné príkazy.) (zdroj)
4. Potvrdenia z dielne. Operátori zaznamenávajú prácu cez SkyPlanner Mobile Confirmations alebo Production Timer. Z časových záznamov vznikajú doklady LaborEntry (čas a dokončené množstvo za operáciu) alebo MoveEntry (len množstvo), ktoré sa uvoľnia príslušnou akciou. Ak už dielňa vykazuje prácu v Acumatica cez Labor (AM301000) alebo Shop Floor Kiosk, údaje o priebehu výroby sa prenášajú opačným smerom. Vyberte si jeden kanál, nikdy nie oba.
5. Pravidlá vlastníctva dát a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Dáta | Vlastník |
|---|---|
| Skladové položky, kusovníky, množstvá, stav príkazu, kalkulácia nákladov | Acumatica |
| Poradie operácií, časy začiatku a konca, priradenie pracoviska | SkyPlanner |
| Matica časov prestavenia, nástroje, požiadavky na operátorov, alternatívy | SkyPlanner |
| Zmeny a neprítomnosti | Jeden systém vybraný pri definovaní rozsahu |
| Transakcie práce a presunov | Acumatica, so zápisom z časových záznamov SkyPlanner alebo zadaním v dielni |
Hlavným zdrojom konfliktov je vlastné APS systému Acumatica. Rough Cut Planning alebo APS Maintenance Process môžu prepočítať termíny zákaziek, ktoré už rozvrhol SkyPlanner. Tomu zabránite zafixovaním každej zapísanej zákazky. Rozvrhnuté zákazky zároveň vylúčte zo spracovania v APS.
Typický postup projektu
Implementácia sa zvyčajne dokončí do niekoľkých týždňov od začiatku nasadzovania. Ešte predtým si môžete systém počas 30-dňového bezplatného skúšobného obdobia vyskúšať s vlastnými dátami. Z Generic Inquiry exportujte do Excelu pracoviská a otvorené výrobné zákazky aj s operáciami, importujte ich a overte rozvrh.
- Mapovanie. Dohodnite mapovaciu tabuľku, pravidlá určujúce, ktorý systém spravuje jednotlivé dáta, frekvenciu synchronizácie a kanál na zápis záznamov o práci.
- Prístup. Zaregistrujte pripojenú aplikáciu, vytvorte integračného používateľa a roly a overte verziu koncového bodu na obrazovke Web Service Endpoints. Začnite v testovacom prostredí.
- Úvodné načítanie. Pracoviská, stroje, nástroje, zmeny, skladové položky a kusovníky.
- Synchronizácia zákaziek a objednávok. Výrobné zákazky, operácie a nákupné objednávky cez push notifikácie alebo pravidelné dopytovanie.
- Nastavenie obmedzení v SkyPlanner. Matica prípravných časov, konkrétni operátori, práce vyžadujúce viacerých operátorov a alternatívy.
- Spätný zápis. Termíny operácií, fixácia zákaziek a záznamy o odpracovanom čase alebo presunoch.
- Súbežná prevádzka. Porovnajte termíny zo SkyPlanner s aktuálnym plánom a opravte kmeňové dáta.
- Spustenie ostrej prevádzky. Keď sa dáta zhodujú, zapnite spätný zápis.
S čím počítať pri integrácii s Acumatica
- Overte, ktorý výpočtový modul APS je zapnutý. Classic a Optimized ukladajú nastavenia oddelene a zapnutý môže byť iba jeden z nich. Pred prvým spätným zápisom skontrolujte Enable/Disable Features (CS100000).
- Nastavte pevnú verziu koncového bodu. Verzia je súčasťou URL. Aktualizácia systému pridáva novú verziu, preto pri každej aktualizácii zopakujte testy.
- Aktualizácia operácií. Niektoré polia operácií sú cez REST dostupné iba na čítanie a záleží aj na stave zákazky. V testovacom prostredí otestujte postupnosť spätného zápisu pre zákazky v stavoch Released a In Process.
- Jednotky a časové polia. Čas spracovania sa vzťahuje na Run Units, strojový čas na Machine Units. Časy čakania a presunu „affect the calculated schedule but do not occupy work center capacity“ (ovplyvňujú vypočítaný rozvrh, ale nezaberajú kapacitu pracoviska). Pri importe dbajte na správne prepočty.
- Vyhodnotenie dostupnosti materiálu. Classic APS vyžaduje, aby bol všetok materiál dostupný v plnom množstve. SkyPlanner plánuje podľa skladových zásob a termínov dodania nákupných objednávok. Dohodnite sa, ktorým vyhodnotením sa budú plánovači riadiť.
- Limity API. Počet požiadaviek za minútu závisí od licencie. Používajte načítanie zmien a push notifikácie, nie opakované načítavanie všetkých dát.
Kto nastavuje a podporuje integráciu s Acumatica
- Tím SkyPlanner nastaví integráciu počas nasadzovania a poskytuje podporu aj po spustení ostrej prevádzky. Každý závod používa Acumatica inak a práve pri nastavení sa tieto znalosti uplatnia.
- Zapojiť sa môže aj váš partner pre Acumatica. Pozná vaše úpravy, Generic Inquiries aj roly. SkyPlanner poskytuje REST API, dokumentáciu Swagger/OpenAPI a webhooky.
- Integráciu môžu vyvinúť aj vaši vlastní vývojári pomocou toho istého REST API a API tokenu. Na začiatok stačí API token a tím SkyPlanner v prípade potreby pomôže. Touto cestou sa pri SAP Business One vydala spoločnosť Laboratory & Allied: jej interný IT tím vytvoril integráciu prevažne samostatne, s pomocou SkyPlanner.
Cena SkyPlanner sa začína na 199 € mesačne za 5 pracovísk, s mesačnou fakturáciou. Cenovú ponuku na integráciu podľa vašich procesov a potrieb dostanete vopred spolu s ponukou predplatného, takže celkové náklady poznáte ešte pred začiatkom. Porovnanie s vlastným APS systému Acumatica nájdete v článku Plánovanie výroby v Acumatica so zohľadnením reálnych kapacít, prehľad na stránke Acumatica a ďalšie systémy v prehľade integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
2 hušetrené každý týždeň
„Vďaka SkyPlanner sme pri plánovaní výroby prešli od excelových tabuliek k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista dodávateľského reťazca
UTU · Elektrické rozvádzače a spínacie zariadenia
Plánovanie výroby šetrí každý týždeň 2 hodiny pracovného času a nový zoznam úloh sa dostane na linku za niekoľko sekúnd.
+90%efektivita výroby
„Efektivita výroby sa zvýšila o 90 %.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby sa zvýšila o 90 % a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej než 30 minút.
1 000+automaticky rozvrhnutých výrobných zákaziek
„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 zákaziek sa rozvrhujú automaticky a celá organizácia má prehľad o výrobe v reálnom čase.
99,2%spoľahlivosť dodávok
„SkyPlanner nám poskytol prehľad potrebný na identifikáciu úzkych miest a sprehľadnil riadenie výroby.“
Toni Tuori, manažér výroby
Piristeel · Strešné bezpečnostné prvky a systémy na odvod dažďovej vody
Spoľahlivosť dodávok tento rok dosiahla 99,2 % a rozvrhovanie šetrí až štyri hodiny pracovného času denne.
Často kladené otázky
Sprístupňuje API systému Acumatica aj výrobné zákazky?
Áno. Koncový bod Manufacturing v REST API založenom na kontraktoch sprístupňuje ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool, záznamy o odpracovanom čase a presunoch aj akcie, ako je FirmProductionOrder.
Kto vytvorí integráciu s Acumatica?
Tím SkyPlanner počas nasadzovania nastaví obojsmernú integráciu podľa vašej konfigurácie Acumatica a poskytuje podporu aj po spustení ostrej prevádzky. Integráciu môže vytvoriť aj váš partner pre Acumatica alebo vaši vývojári pomocou zdokumentovaného REST API systému SkyPlanner. Na začiatok stačí API token.
Potrebujeme na túto integráciu Acumatica APS?
Nie. Acumatica spúšťa vlastné plánovanie so zohľadnením reálnych kapacít cez formulár Rough Cut Planning a Classic APS plánuje zákazky s dokončením za viac než 120 dní s neobmedzenou kapacitou (zdroj). SkyPlanner sám vytvára podrobný rozvrh rešpektujúci reálne kapacity strojov a pracovníkov na základe výrobných zákaziek, operácií, pracovísk, strojov a nástrojov. Integrácia preto funguje bez ohľadu na to, či je zapnuté APS, ktoré podľa Acumatica „is subject to licensing“ (podlieha licencovaniu). Autopilot udržiava rozvrh aktuálny a operátori zaznamenávajú prácu pomocou Mobile Confirmations.
Ako zabránime tomu, aby Acumatica APS prepísalo termíny zo SkyPlanner?
SkyPlanner po zápise termínov operácií zafixuje každú výrobnú zákazku. Plánovanie v Acumatica, ktoré zohľadňuje reálne kapacity, zafixované zákazky nepreplánuje.
Dokáže Acumatica odosielať zmeny v reálnom čase?
Áno. Push notifikácie (SM302000) nastavené pre Generic Inquiry odosielajú zmenené riadky na URL hneď, ako dôjde k zmene. Vlastné webhooky systému SkyPlanner odosielajú zmeny rozvrhu opačným smerom.
Aké overovanie má integrácia používať?
OAuth 2.0 cez klienta zaregistrovaného na obrazovke Connected Applications (SM303010), so samostatným integračným používateľom a rolami s minimálnymi potrebnými oprávneniami. Postup overovania pre vašu inštanciu sa potvrdí počas definovania rozsahu.
Môžeme si SkyPlanner vyskúšať ešte pred vytvorením integrácie?
Áno. Počas 30-dňového bezplatného skúšobného obdobia môžete používať až 20 pracovísk a importovať dáta z Acumatica Generic Inquiry cez Excel alebo CSV. Platobnú kartu nepotrebujete. Vyskúšajte si systém alebo kontaktujte obchodný tím a dohodnite rozsah integrácie.
