Průvodce integrací ProShop ERP pro rozvrhování výroby se SkyPlanner APS
Tento průvodce integrací ProShop ukazuje správcům, konzultantům a IT týmům, jak propojit ProShop ERP se SkyPlanner APS. SkyPlanner se s ProShop propojuje obousměrně prostřednictvím vlastního API systému ProShop:
- Do SkyPlanner se přenášejí Work Orders včetně operací, Parts, záznamy Work Order BOM, Work Cells, Users, Tools, Fixtures a Purchase Orders.
- Plánované termíny zahájení a dokončení se zapisují zpět do výrobních příkazů.
- Pokud se tak rozhodnete, mohou se časy operátorů zapisovat zpět do ProShop Time Tracking.
- Webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Tým SkyPlanner během zavádění přizpůsobí integraci vašemu nastavení ProShop a po spuštění ostrého provozu zajišťuje její podporu. Tento průvodce je určen partnerům a vývojářům, kteří se chtějí zapojit nebo sami vyvíjet řešení nad zdokumentovaným REST API systému SkyPlanner (referenční dokumentace API).
Integrační rozhraní ProShop
ProShop nabízí externímu rozvrhovacímu systému dvě možnosti, popsané v dokumentaci ProShop API Developer Documents:
- ProShop GraphQL API. „ProShop provides a GraphQL API, available via HTTP(S).“ (ProShop poskytuje GraphQL API dostupné přes HTTP(S).) K dispozici je jediný koncový bod: každé volání je požadavek HTTP POST na
<proshop root>/api/graphqls položkamiquery,variablesaoperationNamev těle ve formátu JSON. Každý modul má dotaz v jednotném čísle pro jeden záznam a dotaz v množném čísle pro seznamy. Seznamy se stránkují pomocípageSize(výchozí hodnota 20) apageStart, vracejírecordsatotalRecordsa přijímají argumentyfilteraquery, které odpovídají funkci Advanced Search v daném modulu. Schéma podporuje introspekci. (Úvod do ProShop API) - Recently Updated Records API. „A simple REST interface allows external integrations to request information between arbitrary points in time.“ (Jednoduché rozhraní REST umožňuje externím integracím získávat informace za libovolné časové období.) Volejte
<proshop root>/recentlyupdatedrecordss parametremstart(ISO 8601) a volitelnými parametryendafilterby, napříkladworkorders,workcells,purchaseorders,timetracking,deletions. Tým ProShop musí nejprve aktivovat index. (Recently Updated Records API)
Zápis probíhá prostřednictvím mutací GraphQL. Zdokumentovaným příkladem je Time Tracking Login. Oprávnění k zápisu se uděluje pro jednotlivé moduly pomocí rozsahů oprávnění.
Autentizace a rozsahy oprávnění
- Přístupový token při každém volání. Odesílejte jej jako
Authorization: Bearer <token>nebo jako parametr dotazutoken. - OAuth 2.0 Client Credentials (ProShop 5.2.3 a novější). Správce systému ProShop otevře System Config > Manage Authorizations, vytvoří záznam Authorization s hodnotami Name a Maximum Scope a zaškrtne Direct Login a Active. Hodnoty Unique ID a Shared Secret se použijí jako
client_idaclient_secret. Aplikace odešle požadavek POST sgrant_type=client_credentialsna<proshop root>/home/member/oauth/accesstokena získá token Bearer sexpires_in. Obnovovací token není k dispozici, proto po vypršení platnosti požádejte o nový token. (Průběh autentizace pomocí přihlašovacích údajů klienta) - OAuth 2.0 Authorization Flow pro volání, která vyžadují kontext uživatele, například Time Tracking Login.
- Rozsahy oprávnění. Používá se formát
SCOPE_NAME:[{r|w|d|p}]pro čtení, zápis, mazání a předvolby. Rozvrhovací systém obvykle požadujeworkorders:rw parts:r purchaseorders:r users:r tools:ra navíc Time Tracking, pokud se časy zapisují zpět. Od verze ProShop 5.1.9 platí: „a scope grant request is now required on all connections to the API.“ (Při každém připojení k API je nyní nutné požádat o udělení rozsahu oprávnění.) (Rozsahy oprávnění) - Auditní stopa. U volání s přihlašovacími údaji klienta se zobrazuje název aplikace, nikoli uživatel.
Přístup k REST API systému SkyPlanner se ověřuje pomocí API tokenu v hlavičce Authorization-Token (SkyPlanner Settings > API). API je zdokumentováno ve Swagger/OpenAPI. Prvními voláními vás provede návod k integraci.
Události a pravidelné dotazování
Vývojářská dokumentace ProShop nepopisuje žádné odchozí webhooky ani odběry GraphQL. Změny na straně ProShop se zjišťují pravidelným dotazováním. Recently Updated Records API přitom udržuje nároky na toto dotazování nízké: vyžádejte si vše, co bylo od posledního běhu vytvořeno, změněno nebo smazáno, a výsledek omezte na typy záznamů potřebné pro rozvrh. Poté přes GraphQL načtěte změněné výrobní příkazy podle čísla. Podle ProShop je to rychlejší než dotazování podle lastModifiedTime.
Pro výrobní příkazy a evidenci času se obvykle volí pětiminutový interval, pro díly a nákupní objednávky hodinový. SkyPlanner odesílá webhooky při změně stavu nebo rozvrhu, takže zpětný zápis je řízen událostmi.
Mapování dat
| Objekt ProShop (API) | Objekt ve SkyPlanner | Směr | Četnost |
|---|---|---|---|
Parts, COTS (rozsah oprávnění GraphQL parts) | Produkty a materiály | ProShop → SkyPlanner | Úvodní načtení, poté při změně |
| Záznamy Work Order BOM | Struktura výrobku, materiál pro jednotlivé zakázky | ProShop → SkyPlanner | S každým výrobním příkazem |
| Operace výrobního příkazu: pracoviště, odhadovaný čas seřízení a čas cyklu (cílové časy) | Kroky postupu s dobou trvání, časy seřízení a ukončovacích prací | ProShop → SkyPlanner | S každým výrobním příkazem |
| Work Cells (stroj, pracovní stůl, zařízení) | Pracoviště, skupiny pracovišť, efektivita | ProShop → SkyPlanner | Úvodní načtení, poté jen zřídka |
| Work Cells přiřazené lidem, Users | Personál a přiřazení operátorů | ProShop → SkyPlanner | Úvodní načtení, poté při změně |
| Rozvrhy pracovišť (dostupné hodiny, směny) | Směny a nepracovní dny | ProShop → SkyPlanner | Denně, nebo správa vlastních směn ve SkyPlanner |
| Work Orders (množství, termín dokončení, stav) | Zakázky a operace s termíny dokončení a prioritou | ProShop → SkyPlanner | Dotazování každých několik minut |
| Tools, Toolpots, Fixtures, RTAs | Nástroje jako sdílené zdroje s omezenou kapacitou | ProShop → SkyPlanner | Úvodní načtení, poté při změně |
| Purchase Orders s termíny dodání | Nákupní objednávky, příchozí materiál podle termínu dodání | ProShop → SkyPlanner | Dotazování každou hodinu nebo při spuštění rozvrhování |
Plánované zahájení a dokončení výrobního příkazu (mutace GraphQL, workorders:w) | Plánované zahájení a dokončení každé operace | SkyPlanner → ProShop | Při změně rozvrhu prostřednictvím webhooku SkyPlanner |
| Time Tracking: čas seřízení a chodu, dokončené kusy pro jednotlivé operace výrobního příkazu | Časové záznamy a potvrzení operátorů | SkyPlanner → ProShop | Při každém potvrzení nebo za směnu, pokud tuto možnost zvolíte |
| Není v ProShop | Matice časů seřízení, operace s více operátory, alternativní stroje a personál | Spravuje se ve SkyPlanner | Nastavení během zavádění |
Způsoby integrace
1. Úvodní načtení kmenových dat. Pomocí dotazů GraphQL v množném čísle projděte po stránkách Parts, Work Cells, Users, Tools a Fixtures. Pro první načtení nastavte vysokou hodnotu pageSize a pokračujte ve smyčce podle totalRecords. Určete mapování pracovišť: strojové záznamy Work Cells se převedou na pracoviště a personální záznamy Work Cells na personál. Jedna operace tak může současně rezervovat stroj i jeho obsluhu.
2. Synchronizace výrobních příkazů. Načtěte aktivní výrobní příkazy včetně operací, cílových časů a záznamů kusovníku a také otevřené nákupní objednávky. SkyPlanner považuje objednaný materiál za dostupný k datu dodání nákupní objednávky a aktualizuje sklad, jakmile je objednávka označena stavem Delivered. Změny se zjišťují přes Recently Updated Records s filterby=workorders,purchaseorders,deletions.
3. Zpětný zápis rozvrhu. Když rozvrhovací jádro zařadí nebo přesune operaci, webhook SkyPlanner spustí mutaci GraphQL, která nastaví plánované termíny výrobního příkazu. Použije se k tomu Authorization s workorders:w. Odhad včasného dokončení a termíny potřeby pro nákup v ProShop pak vycházejí z termínů SkyPlanner.
4. Potvrzování ve výrobě. Operátoři vykazují práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer a časové záznamy udržují rozvrh aktuální. Sami rozhodnete, zda se skutečné časy budou zapisovat zpět do ProShop Time Tracking k příslušné operaci výrobního příkazu. Pokud ne, operátoři nadále evidují čas v ProShop a SkyPlanner jej načítá přes timetracking.
5. Odpovědnost za data a pravidla řešení konfliktů. Před spuštěním ostrého provozu je písemně stanovte:
| Data | Odpovědný systém |
|---|---|
| Díly, operace, cílové časy, množství, stav výrobního příkazu | ProShop |
| Pořadí operací, časy zahájení a dokončení, přiřazení stroje a operátora | SkyPlanner |
| Matice časů seřízení a přechodů, požadavky na nástroje a operátory, alternativní výrobní zdroje | SkyPlanner |
| Směny a nepracovní dny | Jeden systém zvolený při vymezení rozsahu |
| Time Tracking, sklad, nákup, kalkulace nákladů zakázek | ProShop; data se zadávají přímo v něm nebo přenášejí z časových záznamů SkyPlanner |
Určete jediný systém, který bude zapisovat termíny výrobních příkazů. Jakmile pracoviště rozvrhuje SkyPlanner, plánovači přestanou měnit pořadí v seznamu tohoto pracoviště v ProShop. Oba plány si tak nikdy nebudou konkurovat.
Obvyklý postup projektu
Implementace bývá hotová během několika týdnů od zahájení zavádění. Ještě předtím ověřte rozvrh v 30denní bezplatné zkušební verzi s pracovišti, operacemi a otevřenými výrobními příkazy exportovanými z ProShop do CSV nebo Excelu.
- Mapování. Stanovte mapovací tabulku, pravidla vlastnictví dat, intervaly synchronizace a to, zda se časy budou zapisovat zpět.
- Přístup do ProShop. Správce vytvoří Authorization s dohodnutou hodnotou Maximum Scope a požádá tým ProShop o aktivaci Recently Updated Records.
- Úvodní načtení. Parts, Work Cells, Users, Tools, Fixtures a rozvrhy pracovišť.
- Synchronizace výrobních příkazů a nákupních objednávek. Pravidelné dotazování na změny se stránkováním a opakováním neúspěšných požadavků.
- Nastavení omezení ve SkyPlanner. Matice časů seřízení, nástroje, počty operátorů pro jednotlivé operace a alternativní stroje nebo personál.
- Zpětný zápis rozvrhu. Mutace spouštěné webhooky SkyPlanner a případně také Time Tracking, pokud tuto možnost zvolíte.
- Souběžné testování. Provozujte SkyPlanner souběžně se stávajícím rozvrhem v ProShop, porovnávejte termíny a opravujte normované časy.
- Spuštění ostrého provozu. Jakmile se data shodují, zapněte zpětný zápis.
S čím počítat při integraci s ProShop
- Normované časy rozhodují o všem. ProShop počítá dobu trvání z odhadovaných časů seřízení a cyklů. Načítejte aktuální normované časy, nikoli původní odhad. Oddělte čas seřízení od času zpracování, aby matice časů seřízení mohla nahradit jedinou hodnotu pro seřízení.
- Pracoviště představující osoby. Pracoviště může představovat i konkrétního člověka. Taková pracoviště mapujte na personál ve SkyPlanner, nikoli na stroje. Jinak se z každého operátora stane další paralelně dostupný stroj.
- Time Tracking vyžaduje uživatele. Od dubna 2026 mutace Time Tracking Login „requires user context“ (vyžaduje kontext uživatele) a nelze ji autorizovat pomocí Client Credentials. Časy operátorů zapisujte přes OAuth 2.0 Authorization Flow, nebo je dál evidujte v ProShop a odtud je načítejte.
- Nechte aktivovat index změn. Recently Updated Records funguje až po aktivaci týmem ProShop. Požádejte o ni v prvním týdnu.
- Záznamy podléhající ITAR. ProShop filtruje záznamy omezené předpisy ITAR pro každé připojení zvlášť. Nastavení v Developer System Config určuje, zda se vrátí jako hodnoty null, nebo se z výsledků vynechají. Dohodněte se, ke kterým výrobním příkazům bude mít integrace přístup, a při každém čtení ošetřete hodnoty null.
- Kooperace. Operace u dodavatelů představují dobu trvání, nikoli zatížení vašich kapacit. Modelujte je jako kroky, které mají pouze dobu trvání.
Kdo nastavuje integraci s ProShop a zajišťuje její podporu
- Tým SkyPlanner nastaví integraci při zavádění a po spuštění zajišťuje její podporu. Ta zahrnuje dohodnuté dotazy a mutace GraphQL i pravidelné dotazování na změny. Každý výrobní podnik používá ProShop jinak a právě při tomto nastavení se tyto znalosti uplatní.
- Zapojí se i váš správce nebo konzultant ProShop. Vytvoří Authorization, nastaví rozsahy oprávnění a požádá o aktivaci indexu změn. Zná také nastavení vašich pracovišť.
- Integraci mohou dále rozvíjet i vaši vývojáři prostřednictvím REST API systému SkyPlanner s využitím API tokenu. Pro začátek stačí API token a tým SkyPlanner v případě potřeby pomůže. Podklady najdete v dokumentaci integrací SkyPlanner.
Cena SkyPlanner začíná na 199 € měsíčně a zahrnuje 5 pracovišť. Fakturace probíhá měsíčně. Cenu integrace vám spolu s tarifem nabídneme předem podle vašich procesů a potřeb. Podívejte se na ceník, plánování výroby s ohledem na skutečné kapacity strojů a pracovníků pro ProShop, stránku ProShop ERP, funkce SkyPlanner a přehled integrací s ERP.
Jak výrobní firmy hodnotí SkyPlanner
2 hušetřené každý týden
„Díky SkyPlanner jsme přešli od plánování výroby v tabulkách Excelu k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista dodavatelského řetězce
UTU · Elektrické rozváděče a spínací zařízení
Plánování výroby šetří každý týden 2 hodiny práce a nová fronta operací se na linku dostane během několika sekund.
+90 %efektivita výroby
„Efektivita výroby vzrostla o 90 %.“
Abdul Rucyinga, vedoucí IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrostla o 90 % a vytvoření optimalizovaného plánu na tři měsíce pro všechna pracoviště trvá méně než 30 minut.
98 %včasnost dodávek oproti původním přibližně 50 %
„SkyPlanner hraje rozhodující roli v tom, že dokážeme udržet včasnost dodávek.“
Hannu Lahtinen, výkonný ředitel
KJH-Comp · Zpracování plechu a zakázková výroba
Včasnost dodávek vzrostla z přibližně 50 % až na 98 % a rozvrhování nyní zajišťuje jeden mistr místo dvou.
1 000+automaticky rozvržených výrobních příkazů
„Výrobu máme pod kontrolou úplně jinak a náš přehled o kapacitách je na zcela jiné úrovni.“
Hannu Ryynänen, generální ředitel
Mamec · Průmyslová míchadla, čerpadla a technologicky náročná zakázková výroba
Tisíce výrobních příkazů se rozvrhují automaticky a celá organizace má přehled o výrobě v reálném čase.
Časté dotazy
Má ProShop API?
Ano. ProShop má GraphQL API na adrese <proshop root>/api/graphql s ověřováním přes OAuth 2.0 nebo Basic Authentication a s rozsahy oprávnění pro jednotlivé moduly. REST endpoint Recently Updated Records vrací záznamy vytvořené, změněné nebo smazané v daném časovém intervalu.
Podporuje ProShop webhooky?
Vývojářská dokumentace ProShop nepopisuje žádné odchozí webhooky. Integrace se pravidelně dotazuje rozhraní Recently Updated Records API v intervalu nastaveném pro daný výrobní podnik. Vlastní webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Jak se plánované termíny zapisují zpět do ProShop?
Pomocí mutace GraphQL nad výrobním příkazem s využitím Authorization s oprávněním k zápisu do workorders. SkyPlanner ji spouští prostřednictvím webhooku při každé změně rozvrhu.
Kdo vytváří přístupové údaje k API ProShop?
Správce systému ProShop v nabídce System Config > Manage Authorizations. Direct Login povoluje tok Client Credentials a Maximum Scope omezuje, co může integrace číst a zapisovat.
Má konzultant ProShop doporučit rozvrhování v ProShop, nebo SkyPlanner?
SkyPlanner, pokud u zákazníka o dodržení termínů rozhoduje pořadí operací. Rozvrh v ProShop zobrazuje priority a předpovědi včasného dokončení pro jednotlivá pracoviště a plánovači priority upravují. SkyPlanner se připojuje přes GraphQL API, automaticky optimalizuje celý plán a plánuje přeseřízení, operátory, nástroje i materiál. Nabízí neomezený počet uživatelů za cenu od 199 € měsíčně.
Můžeme SkyPlanner vyzkoušet před vytvořením integrace?
Ano. Bezplatná 30denní zkušební verze podporuje až 20 pracovišť a import dat z ProShop ve formátu CSV nebo Excel. Platební karta není potřeba. Vyzkoušejte ji nebo kontaktujte obchodní tým a vymezte s ním rozsah integrace.
