Integrácie / ERP / ProShop ERP
Sprievodca integráciou ProShop ERP na rozvrhovanie výroby so SkyPlanner APS
Tento sprievodca integráciou ProShop ukazuje správcom, konzultantom a IT tímom, ako prepojiť ProShop ERP so SkyPlanner APS. SkyPlanner sa s ProShop prepája obojsmerne prostredníctvom vlastného API systému ProShop:
- Do SkyPlanner sa prenášajú Work Orders s ich operáciami, Parts, záznamy Work Order BOM, Work Cells, Users, Tools, Fixtures a Purchase Orders.
- Plánované dátumy začatia a dokončenia sa zapisujú späť do výrobných príkazov.
- Ak si to zvolíte, odpracovaný čas operátorov sa môže zapisovať späť do ProShop Time Tracking.
- Webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas zavádzania prispôsobí integráciu vášmu nastaveniu ProShop 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 pomocou zdokumentovaného REST API SkyPlanner (referenčná dokumentácia API).
Integračné rozhrania ProShop
ProShop ponúka externému nástroju na rozvrhovanie dve možnosti pripojenia, ktoré opisuje vývojárska dokumentácia ProShop API:
- ProShop GraphQL API. „ProShop provides a GraphQL API, available via HTTP(S).“ (ProShop poskytuje GraphQL API dostupné cez HTTP(S).) K dispozícii je jeden koncový bod: každé volanie je požiadavka HTTP POST na
<proshop root>/api/graphqls položkamiquery,variablesaoperationNamev tele vo formáte JSON. Každý modul má na načítanie jedného záznamu dotaz s názvom v jednotnom čísle a na načítanie zoznamov dotaz s názvom v množnom čísle. Zoznamy sa stránkujú pomocoupageSize(predvolená hodnota 20) apageStart, vracajúrecordsatotalRecordsa prijímajú argumentyfilteraquery, ktoré zodpovedajú funkcii Advanced Search v danom module. Schéma podporuje introspekciu. (Úvod do ProShop API) - Recently Updated Records API. „A simple REST interface allows external integrations to request information between arbitrary points in time.“ (Jednoduché rozhranie REST umožňuje externým integráciám vyžiadať si informácie za ľubovoľný časový interval.) Volajte
<proshop root>/recentlyupdatedrecordss parametromstart(ISO 8601) a voliteľnými parametramiendafilterby, napríkladworkorders,workcells,purchaseorders,timetracking,deletions. Tím ProShop musí najprv povoliť index. (Recently Updated Records API)
Zápis sa vykonáva prostredníctvom mutácií GraphQL. Zdokumentovaným príkladom je Time Tracking Login. Prístup na zápis sa udeľuje pre každý modul prostredníctvom rozsahov oprávnení.
Autentifikácia a rozsahy oprávnení
- Prístupový token pri každom volaní. Posielajte ho ako
Authorization: Bearer <token>alebo ako parameter dotazutoken. - OAuth 2.0 Client Credentials (ProShop 5.2.3 a novší). Správca systému ProShop otvorí System Config > Manage Authorizations, vytvorí Authorization s hodnotami Name a Maximum Scope a začiarkne Direct Login a Active. Unique ID a Shared Secret sa použijú ako
client_idaclient_secret. Aplikácia odošle požiadavkou POSTgrant_type=client_credentialsna<proshop root>/home/member/oauth/accesstokena získa token Bearer s údajomexpires_in. Obnovovací token nie je k dispozícii, preto po uplynutí platnosti požiadajte o nový token. (Postup Client Credentials) - OAuth 2.0 Authorization Flow pre volania, ktoré vyžadujú kontext používateľa, napríklad Time Tracking Login.
- Rozsahy oprávnení. Používajú formát
SCOPE_NAME:[{r|w|d|p}]pre čítanie, zápis, mazanie a predvoľby. Nástroj na rozvrhovanie zvyčajne požadujeworkorders:rw parts:r purchaseorders:r users:r tools:ra navyše Time Tracking, ak sa čas zapisuje späť. Od verzie ProShop 5.1.9 platí: „a scope grant request is now required on all connections to the API.“ (Pri každom pripojení k API sa teraz vyžaduje žiadosť o udelenie rozsahu oprávnení.) (Rozsahy oprávnení) - Auditná stopa. Pri volaniach s prihlasovacími údajmi klienta sa uvádza názov aplikácie, nie používateľ.
Volania REST API SkyPlanner sa autentifikujú pomocou API tokenu v hlavičke Authorization-Token (SkyPlanner Settings > API). Dokumentácia API je vo formáte Swagger/OpenAPI. Návod na integráciu vás prevedie prvými volaniami.
Udalosti a pravidelné dopytovanie
Vývojárska dokumentácia ProShop neopisuje žiadne odchádzajúce webhooky ani odbery GraphQL. Údaje z ProShop sa získavajú pravidelným dopytovaním a Recently Updated Records API znižuje jeho náročnosť: vyžiadajte si všetko, čo bolo od posledného spustenia vytvorené, zmenené alebo odstránené, a výsledky obmedzte na typy záznamov potrebné pre rozvrh. Zmenené výrobné príkazy potom načítajte podľa čísla cez GraphQL. Podľa ProShop je to rýchlejšie než dotazovanie podľa lastModifiedTime.
Bežne sa volí päťminútový interval pre výrobné príkazy a evidenciu času a hodinový interval pre diely a nákupné objednávky. SkyPlanner odosiela webhooky pri zmene stavu alebo rozvrhu, takže spätný zápis sa riadi udalosťami.
Mapovanie dát
| Objekt ProShop (API) | Objekt v SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
Parts, COTS (rozsah oprávnení GraphQL parts) | Produkty a materiály | ProShop → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Záznamy Work Order BOM | Štruktúra výrobku, materiál pre jednotlivé výrobné príkazy | ProShop → SkyPlanner | S každým výrobným príkazom |
| Operácie výrobného príkazu: pracovná bunka, odhadovaný čas prípravy a čas cyklu (cieľové časy) | Procesné kroky s časmi trvania, prípravy a ukončovacích prác | ProShop → SkyPlanner | S každým výrobným príkazom |
| Work Cells (stroj, pracovný stôl, zariadenie) | Pracoviská, skupiny pracovísk, účinnosť | ProShop → SkyPlanner | Úvodné načítanie, potom len zriedka |
| Work Cells priradené ľuďom, Users | Personál a priradenia operátorov | ProShop → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Rozvrhy pracovných buniek (dostupné hodiny, zmeny) | Zmeny a nepracovné dni | ProShop → SkyPlanner | Denne alebo správa zmien v SkyPlanner |
| Work Orders (množstvo, termín dokončenia, stav) | Objednávky a operácie s termínmi dokončenia a prioritou | ProShop → SkyPlanner | Dopytovanie každých niekoľko minút |
| Tools, Toolpots, Fixtures, RTAs | Nástroje ako zdieľané zdroje s obmedzenou kapacitou | ProShop → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Purchase Orders s termínmi dodania | Nákupné objednávky, prichádzajúci materiál podľa dátumu dodania | ProShop → SkyPlanner | Dopytovanie každú hodinu alebo pri spustení rozvrhovania |
Plánované začatie a dokončenie výrobného príkazu (mutácia GraphQL, workorders:w) | Plánované začatie a ukončenie každej operácie | SkyPlanner → ProShop | Pri zmene rozvrhu prostredníctvom webhooku SkyPlanner |
| Time Tracking: čas prípravy a výroby, dokončené diely podľa operácie výrobného príkazu | Časové záznamy a potvrdenia operátorov | SkyPlanner → ProShop | Pri každom potvrdení alebo za každú zmenu, ak si to zvolíte |
| Nie je v ProShop | Matica prípravných časov, operácie s viacerými operátormi, alternatívne stroje a personál | Spravuje sa v SkyPlanner | Nastavenie počas zavádzania |
Integračné postupy
1. Úvodné načítanie kmeňových dát. Pomocou dotazov GraphQL v množnom čísle postupne načítajte stránky záznamov Parts, Work Cells, Users, Tools a Fixtures. Pri prvom načítaní nastavte vysokú hodnotu pageSize a pokračujte v cykle podľa totalRecords. Určte mapovanie pracovných buniek: bunky predstavujúce stroje sa prevedú na pracoviská a bunky predstavujúce ľudí na personál. Tá istá operácia tak môže súčasne rezervovať stroj aj jeho operátora.
2. Synchronizácia výrobných príkazov. Načítajte aktívne výrobné príkazy s ich operáciami, cieľovými časmi a záznamami BOM spolu s otvorenými nákupnými objednávkami. SkyPlanner považuje objednaný materiál za dostupný v deň dodania uvedený na nákupnej objednávke a aktualizuje zásoby, keď je objednávka označená stavom Delivered. Zmeny sa zisťujú cez Recently Updated Records s parametrom filterby=workorders,purchaseorders,deletions.
3. Spätný zápis rozvrhu. Keď plánovací mechanizmus zaradí alebo presunie operáciu, webhook SkyPlanner spustí mutáciu GraphQL, ktorá nastaví plánované dátumy výrobného príkazu. Použije sa pritom Authorization s oprávnením workorders:w. Prognóza včasného dokončenia v ProShop a termíny potreby nakupovaného materiálu potom vychádzajú z dátumov SkyPlanner.
4. Potvrdenia z výroby. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations alebo Production Timer a časové záznamy udržiavajú rozvrh aktuálny. Vy rozhodnete, či sa skutočne odpracovaný čas zapíše späť do ProShop Time Tracking k príslušnej operácii výrobného príkazu. Ak nie, operátori evidujú čas v ProShop ako doteraz a SkyPlanner ho načítava cez timetracking.
5. Pravidlá vlastníctva dát a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Dáta | Vlastník |
|---|---|
| Diely, operácie, cieľové časy, množstvá, stav výrobného príkazu | ProShop |
| Poradie operácií, časy začatia a dokončenia, priradenie stroja a operátora | SkyPlanner |
| Matica časov prestavenia, požiadavky na nástroje a operátorov, alternatívne zdroje | SkyPlanner |
| Pracovné zmeny a nepracovné dni | Jeden systém zvolený pri definovaní rozsahu |
| Time Tracking, zásoby, nákup, kalkulácia nákladov zákazky | ProShop; údaje sa zadávajú priamo v ňom alebo prenášajú z časových záznamov SkyPlanner |
Určte jeden systém, ktorý bude zapisovať dátumy výrobných príkazov. Keď SkyPlanner prevezme rozvrhovanie pracovnej bunky, plánovači prestanú meniť poradie položiek v zozname tejto bunky v ProShop. Oba plány si tak nikdy nebudú konkurovať.
Typický priebeh projektu
Implementácia sa zvyčajne dokončí do niekoľkých týždňov od začiatku zavádzania. Ešte predtým si overte rozvrh počas 30-dňového bezplatného skúšobného obdobia s pracovnými bunkami, operáciami a otvorenými výrobnými príkazmi exportovanými z ProShop vo formáte CSV alebo Excel.
- Mapovanie. Dohodnite konečnú podobu mapovacej tabuľky, pravidlá zodpovednosti za údaje, intervaly synchronizácie a to, či sa čas bude zapisovať späť.
- Prístup do ProShop. Správca vytvorí Authorization s dohodnutou hodnotou Maximum Scope a požiada tím ProShop o povolenie Recently Updated Records.
- Úvodné načítanie. Parts, Work Cells, Users, Tools, Fixtures a rozvrhy pracovných buniek.
- Synchronizácia výrobných príkazov a nákupných objednávok. Pravidelné dopytovanie zmien so stránkovaním a opakovaním neúspešných požiadaviek.
- Nastavenie obmedzení v SkyPlanner. Matica prípravných časov, nástroje, počty operátorov na operáciu a alternatívne stroje alebo personál.
- Spätný zápis rozvrhu. Mutácie spúšťané webhookmi SkyPlanner a voliteľne aj zápis do Time Tracking.
- Paralelné testovanie. Používajte SkyPlanner súbežne s aktuálnym rozvrhom v ProShop, porovnajte termíny a opravte cieľové časy.
- Spustenie do ostrej prevádzky. Keď sa dáta zhodujú, zapnite spätný zápis.
S čím počítať pri integrácii s ProShop
- Cieľové časy rozhodujú o všetkom. ProShop počíta trvanie z odhadovaných časov prípravy a cyklových časov. Načítajte aktuálne cieľové časy, nie pôvodný odhad. Oddeľte čas prípravy od času spracovania, aby matica prípravných časov mohla nahradiť jednu pevnú hodnotu prípravy.
- Pracovné bunky predstavujúce osoby. Pracovná bunka môže predstavovať aj osobu. Takéto bunky priraďte k pracovníkom v SkyPlanner, nie k strojom. Inak sa každý operátor bude považovať za paralelne dostupný stroj.
- Time Tracking vyžaduje používateľa. Od apríla 2026 mutácia Time Tracking Login „requires user context“ (vyžaduje kontext používateľa) a nemožno ju autorizovať pomocou Client Credentials. Čas operátorov zapisujte cez OAuth 2.0 Authorization Flow alebo ho naďalej evidujte v ProShop a odtiaľ načítavajte.
- Aktivujte index zmien. Recently Updated Records funguje až po aktivácii tímom ProShop. Požiadajte o ňu v prvom týždni.
- Záznamy podliehajúce ITAR. ProShop filtruje záznamy s obmedzeniami ITAR pre každé pripojenie osobitne. Nastavenie v Developer System Config určuje, či sa vrátia ako hodnoty null, alebo sa vynechajú. Dohodnite sa, ku ktorým výrobným príkazom bude mať integrácia prístup, a pri každom čítaní ošetrite hodnoty null.
- Externé spracovanie. Operácie u dodávateľov zaberajú čas, nie vašu kapacitu. Modelujte ich ako kroky, ktoré majú iba trvanie.
Kto nastavuje integráciu s ProShop a poskytuje jej podporu
- Tím SkyPlanner nastaví integráciu počas zavádzania a po spustení ostrej prevádzky poskytuje podporu. Tá zahŕňa dohodnuté dotazy a mutácie GraphQL aj pravidelné zisťovanie zmien. Každý výrobný podnik používa ProShop inak a práve pri tejto práci sa uplatní znalosť jeho konkrétneho nastavenia.
- Zapája sa aj váš správca alebo konzultant ProShop. Vytvorí Authorization, nastaví rozsahy oprávnení, požiada o index zmien a pozná nastavenie vašich pracovných buniek.
- Vaši vývojári môžu integráciu ďalej rozvíjať cez REST API systému SkyPlanner s použitím API tokenu. Na začiatok stačí API token a tím SkyPlanner v prípade potreby pomôže. Dokumentácia integrácie je dostupná na stránke Dokumentácia integrácie SkyPlanner.
Cena SkyPlanner začína od 199 € mesačne a zahŕňa 5 pracovísk, s mesačnou fakturáciou. Cenovú ponuku integrácie dostanete vopred spolu s ponukou programu, podľa vašich procesov a potrieb. Pozrite si cenník, plánovanie výroby s ProShop so zohľadnením reálnych kapacít strojov a pracovníkov, stránku ProShop ERP, funkcie SkyPlanner a prehľad integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
2 hušetrené každý týždeň
„Vďaka SkyPlanner sme prešli od plánovania výroby v excelových tabuľkách 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 ušetrí každý týždeň 2 hodiny pracovného času a nový zoznam operácií sa dostane na linku za pár sekúnd.
+90%efektívnosť výroby
„Efektívnosť výroby sa zvýšila o 90 %.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektívnosť 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.
98%spoľahlivosť dodávok, nárast z približne 50 %
„SkyPlanner zohráva rozhodujúcu úlohu pri udržiavaní našej spoľahlivosti dodávok.“
Hannu Lahtinen, výkonný riaditeľ
KJH-Comp · Spracovanie plechu a zákazková výroba
Spoľahlivosť dodávok vzrástla z približne 50 % až na 98 % a rozvrhovanie teraz zvládne jeden majster namiesto dvoch.
1 000+automaticky rozvrhnutých výrobných príkazov
„Výrobu máme pod kontrolou úplne inak a náš prehľad o kapacitách je na celkom inej úrovni.“
Hannu Ryynänen, generálny riaditeľ
Mamec · Priemyselné miešadlá, čerpadlá a technologicky náročná 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
Má ProShop API?
Áno. ProShop má GraphQL API na adrese <proshop root>/api/graphql, s autentifikáciou OAuth 2.0 alebo Basic Authentication a rozsahmi oprávnení pre jednotlivé moduly. Koncový bod REST Recently Updated Records vracia záznamy vytvorené, upravené alebo odstránené v danom časovom intervale.
Podporuje ProShop webhooky?
Vývojárska dokumentácia ProShop neuvádza žiadne odchádzajúce webhooky. Integrácia sa pravidelne dopytuje na Recently Updated Records API v intervaloch nastavených pre konkrétny výrobný podnik. Vlastné webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Ako sa plánované termíny zapisujú späť do ProShop?
Pomocou mutácie GraphQL na výrobnom príkaze, s použitím Authorization s oprávnením na zápis do workorders. SkyPlanner ju spustí cez webhook pri každej zmene rozvrhu.
Kto vytvára prístupové údaje k ProShop API?
Správca systému ProShop v časti System Config > Manage Authorizations. Direct Login povoľuje postup Client Credentials a Maximum Scope obmedzuje, čo môže integrácia čítať a zapisovať.
Má konzultant ProShop odporučiť rozvrhovanie v ProShop alebo SkyPlanner?
SkyPlanner, ak o dodávkach rozhoduje poradie operácií v zákazníkovej výrobe. Rozvrh ProShop zobrazuje priority a predpoklad dodržania termínov pre jednotlivé pracovné bunky a plánovači upravujú priority. SkyPlanner sa pripája cez GraphQL API, automaticky optimalizuje celý plán a plánuje prestavenia, operátorov, nástroje aj materiál. Ponúka neobmedzený počet používateľov od 199 € mesačne.
Môžeme SkyPlanner otestovať ešte pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk s importom z ProShop cez CSV alebo Excel, bez potreby platobnej karty. Vyskúšajte ju alebo kontaktujte obchodný tím a spolu definujte rozsah integrácie.
