Integrace / ERP / proALPHA ERP
Průvodce integrací proALPHA se SkyPlanner APS pro rozvrhování výroby
Tento průvodce integrací Proalpha ukazuje partnerům a IT týmům, jak propojit Proalpha ERP se SkyPlanner APS. Integrace SkyPlanner s Proalpha funguje obousměrně:
- Do SkyPlanner přicházejí položky, výrobní příkazy s operacemi, výrobní zdroje, kalendáře, skladové zásoby a nákupní objednávky.
- Plánovaný začátek a konec každé operace se zapisují zpět přes setWorkOrderOperationDates.
- Změny výrobních zdrojů se zapisují zpět přes changeWorkOrderOperationResource.
- Potvrzení od obsluhy se zapisují zpět přes operationDataEntry.
- 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í Proalpha a zajistí její podporu i po spuštění do ostrého provozu. Tento průvodce je určen partnerům a vývojářům, kteří se chtějí zapojit nebo sami vytvořit řešení s využitím zdokumentovaného REST API SkyPlanner (referenční dokumentace API).
Rozhraní Proalpha
Proalpha ERP běží na Progress OpenEdge. S verzí Release 9 přešla platforma na OpenEdge 12. (Proalpha) Pro rozvrhování jsou důležitá čtyři rozhraní.
- Proalpha ERP REST APIs. Veřejný Proalpha API Portal uvádí 108 specifikací OpenAPI 3.0 pod
api/web/v1. Tato rozhraní slouží ke zpětnému zápisu a ke čtení položek a skladových zásob. - Integration Workbench (INWB). Proalpha popisuje INWB slovy „is a central platform which connects different IT systems, machines, sites“ (je centrální platformou propojující různé IT systémy, stroje a provozy) a „converts the data into the format of the target system.“ (převádí data do formátu cílového systému). (Proalpha) Přijímá zprávy pAX přes
POST /api/web/v1/inwb/message. Použijte jej k přenosu výrobních příkazů z Proalpha i do něj. - Proalpha Integration Platform. Platforma založená na n8n byla oznámena v dubnu 2026. Podle oznámení „will be available to customers either on-premises or in the cloud.“ (bude zákazníkům dostupná v jejich vlastní infrastruktuře nebo v cloudu). Proalpha „will rely on an API-centric reference architecture and REST interfaces.“ (bude využívat referenční architekturu postavenou na API a rozhraní REST). (Proalpha)
- EDI a exporty do souborů. INWB zpracovává souborové formáty specifické pro jednotlivá odvětví. Pro vyzkoušení SkyPlanner postačí exporty do souborů.
Koncové body pro výrobu
| API Proalpha | Koncový bod | Využití v integraci |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Plánovaný začátek a konec každé operace (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Výrobní zdroj vybraný při rozvrhování (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Potvrzení: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Položky s poli partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Skladové zásoby podle oblastí MRP |
Autentizace
Zveřejněné specifikace Proalpha používají autentizaci HTTP Basic. Koncové body se liší podle prostředí a mají tvar {schema}://{host}:{port}/api/web/v1/... na vašem serveru Proalpha nebo v Proalpha Cloud. Vytvořte vyhrazený technický účet s oprávněními omezenými na objekty v mapovací tabulce. S IT týmem naplánujte síťový přístup z cloudu SkyPlanner k tomuto koncovému bodu.
REST API SkyPlanner používá k autentizaci API token (SkyPlanner Settings > API) a je zdokumentováno ve Swagger/OpenAPI. Pro začátek stačí API token. Průvodce integrací vás provede prvními voláními.
Události a pravidelné dotazování
Proalpha API Portal neuvádí žádné API pro přihlášení k odběru webhooků. Změny se z Proalpha přenášejí těmito způsoby:
- přes tok zpráv INWB, který odesílá nové a změněné výrobní příkazy včetně jejich operací
- přes workflow n8n na Proalpha Integration Platform
- pravidelným dotazováním na skladové zásoby přes Material API
SkyPlanner odesílá webhooky při změně stavu nebo rozvrhu, takže zpětný zápis do Proalpha je řízen událostmi.
Mapování dat
| Objekt nebo API Proalpha | Objekt SkyPlanner | Směr | Četnost |
|---|---|---|---|
| Part (Part API) | Výrobky a materiály | Proalpha → SkyPlanner | Počáteční načtení, poté při změně |
| Procesní model výrobku: process, activities; řádky kusovníku výrobního příkazu | Struktura výrobku, dílčí výrobky, kroky procesu | Proalpha → SkyPlanner | Počáteční načtení, poté při změně |
| Výrobní příkaz (Fertigungsauftrag) s množstvím a termínem dokončení | Zakázka a operace s termínem dokončení a prioritou | Proalpha → SkyPlanner | Odesílání přes INWB či n8n nebo každých několik minut |
| Operace výrobního příkazu: targetSetupTime, targetProcessTime, resource | Kroky procesu s časy seřízení a dobami trvání | Proalpha → SkyPlanner | Spolu s výrobním příkazem |
| Výrobní zdroje, skupiny výrobních zdrojů, alternativní skupiny výrobních zdrojů | Pracoviště, skupiny pracovišť, alternativní pracoviště | Proalpha → SkyPlanner | Počáteční načtení |
| Bloky kalendáře výrobních zdrojů s poli intensity a overloadIntensity | Směny a účinnost pracovišť | Proalpha → SkyPlanner | Počáteční načtení; poté denně nebo správa ve SkyPlanner |
| Skladové zásoby podle oblastí MRP | Zásoby materiálu | Proalpha → SkyPlanner | Každou hodinu nebo před každým rozvrhováním |
| Nákupní objednávky s datem dodání | Očekávaný materiál k datu dodání | Proalpha → SkyPlanner | Každou hodinu nebo před každým rozvrhováním |
| setWorkOrderOperationDates | Čas zahájení a ukončení každé operace podle rozvrhu | SkyPlanner → Proalpha | Při změně rozvrhu přes webhook SkyPlanner |
| changeWorkOrderOperationResource | Pracoviště vybrané plánovacím algoritmem | SkyPlanner → Proalpha | Při změně rozvrhu |
| operationDataEntry (setup, process, combined) | Časové záznamy a množství z Mobile Confirmations | SkyPlanner → Proalpha | Při každém potvrzení nebo za směnu |
| Pravidla rozvrhování ve SkyPlanner | Matice časů přípravy a přechodů, nástroje jako zdroje s omezenou kapacitou, počty pracovníků obsluhy | Správa ve SkyPlanner | Nastavení během zavádění |
Způsoby integrace
1. Počáteční načtení kmenových dat. Načtěte položky přes Part API a jednorázově přeneste výrobní zdroje, jejich skupiny a kalendáře přes INWB nebo export do souboru. Pečlivě určete, kterému pracovišti SkyPlanner odpovídá každý výrobní zdroj Proalpha. Z alternativních skupin výrobních zdrojů se stanou alternativní pracoviště.
2. Synchronizace příkazů. Tok zpráv INWB nebo workflow n8n odesílá otevřené výrobní příkazy včetně operací, cílových časů a výrobních zdrojů. Údaje o zásobách se načítají přes Material API pro jednotlivé oblasti MRP, otevřené nákupní objednávky přes INWB. SkyPlanner považuje objednaný materiál za dostupný k datu dodání nákupní objednávky a aktualizuje zásoby, jakmile je objednávka označena stavem Delivered.
3. Zpětný zápis rozvrhu. Pro každou operaci, kterou plánovací jádro zařadilo nebo přesunulo, integrace volá setWorkOrderOperationDates s identifikátorem guid operace a časem zahájení a ukončení. Pokud jádro vybralo jiný výrobní zdroj, následuje volání changeWorkOrderOperationResource.
4. Odvádění výroby. Obsluha zaznamenává práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer. Časové záznamy udržují rozvrh aktuální a zapisují se do Proalpha přes operationDataEntry. Pokud už ve vašem závodě odvádíte výrobu na terminálech PDC, používejte jen jeden kanál, abyste předešli duplicitním zápisům.
5. Pravidla odpovědnosti za data a řešení konfliktů. Sepište je před spuštěním ostrého provozu:
| Data | Odpovědný systém |
|---|---|
| Díly, procesní modely, množství, stav výrobních příkazů | Proalpha |
| Pořadí operací, časy zahájení a ukončení, přiřazení výrobních zdrojů | SkyPlanner |
| Matice časů přestaveb, nástroje, počty pracovníků obsluhy | SkyPlanner |
| Směny a absence | Jeden systém zvolený při vymezení rozsahu |
| Odvádění výroby a skladové zápisy | Proalpha, s údaji z časových záznamů SkyPlanner nebo z PDC |
Pokud používáte Proalpha APS nebo Feinplanung, rozhodněte, který systém bude spravovat termíny operací. Dva plánovací systémy zapisující stejné termíny si navzájem přepisují data. S funkcí Autopilot SkyPlanner automaticky přeplánuje rozvrh při změnách ve výrobě.
Typický průběh projektu
Implementace bývá dokončena během několika týdnů od zahájení úvodního nastavení. Ještě předtím si můžete systém 30 dní zdarma vyzkoušet na vlastních datech. Exportujte z Proalpha otevřené výrobní příkazy, operace a výrobní zdroje do CSV nebo Excelu, importujte je a ověřte rozvrh.
- Workshop k mapování. Se svým partnerem pro Proalpha stanovte mapovací tabulku, pravidla odpovědnosti za data, frekvence synchronizace a kanál pro odvádění výroby.
- Nastavení rozhraní. Aktivujte REST API a toky INWB, vytvořte technického uživatele a povolte síťový přístup. Nejprve v testovacím systému, pak v produkčním.
- Úvodní načtení dat. Díly, výrobní zdroje, skupiny výrobních zdrojů a kalendáře.
- Synchronizace příkazů, zásob a nákupních objednávek. Výrobní příkazy se odesílají přes INWB nebo n8n, zásoby se načítají pravidelným dotazováním. Součástí jsou i opakované pokusy při selhání.
- Nastavení omezení v SkyPlanner. Matice časů přestaveb, nástroje, počty pracovníků obsluhy a alternativní pracoviště.
- Zpětný zápis rozvrhu. setWorkOrderOperationDates a changeWorkOrderOperationResource; v tomto kroku se přidává také operationDataEntry.
- Paralelní provoz. Porovnejte termíny ze SkyPlanner se stávajícím plánem a opravte kmenová data.
- Spuštění ostrého provozu. Jakmile data souhlasí, zapněte zpětný zápis.
S čím počítat při integraci s Proalpha
- Chybí objekt technologického postupu. Proalpha plánuje podle procesních modelů produktů. Nástroje převzaté z projektů pro SAP nebo Business Central hledají technologické postupy, a část dat tak nenačtou. Z výrobního příkazu načítejte operace a řádky kusovníku.
- Intenzita v kalendáři. Bloky kalendáře obsahují intensity a overloadIntensity. Namapujte je na směny a efektivitu v SkyPlanner namísto pouhého kopírování hodin.
- Měrné jednotky. Zkontrolujte quantityUnitCode a ověřte, zda je cílový čas seřízení uveden na příkaz, nebo na kus. Nesprávné jednotky zkreslí všechny doby trvání.
- Endpointy hostované u zákazníka. Vrstva REST běží na vašem serveru Proalpha. Nastavení firewallů, portů a certifikátů určuje, kdy může projekt začít, proto potřebné přístupy zajistěte včas.
- Verze systému. Než stanovíte konečné mapování, ověřte s partnerem, která REST API vaše verze Proalpha zpřístupňuje.
- Dokumentace vyžadující přihlášení. Online nápověda Proalpha je dostupná přes Documentation Portal. Názvy polí si ověřte u partnera, neodhadujte je.
Integrace s Proalpha: kdo ji nastavuje a zajišťuje podporu
- Tým SkyPlanner integraci nastaví během úvodního nastavení a po spuštění ostrého provozu zajišťuje podporu. Každá instalace Proalpha má jiný datový model a právě zde se toto know-how uplatní.
- Zapojit se může i váš partner pro Proalpha. Zná vaše procesní modely, toky INWB i verzi systému a může nastavit přístup k API. SkyPlanner poskytuje REST API, dokumentaci Swagger/OpenAPI a webhooky.
- Na integraci mohou navázat i vaši vlastní vývojáři s využitím stejného REST API a API tokenu. Tým SkyPlanner v případě potřeby pomůže. Produktová dokumentace je veřejně dostupná v dokumentaci SkyPlanner.
Cena SkyPlanner začíná na 199 € měsíčně a zahrnuje 5 pracovišť, s měsíční fakturací. Cenovou nabídku na integraci podle vašich procesů a potřeb dostanete předem společně s nabídkou tarifu, takže celkové náklady znáte ještě před zahájením. O plánování kapacit v Proalpha si přečtěte v článku Podporuje proALPHA plánování výroby s ohledem na skutečné kapacity?, přehled najdete na stránce proALPHA a další systémy v přehledu integrací s ERP.
Jak SkyPlanner hodnotí výrobní firmy
2 hušetřené každý týden
„SkyPlanner nás posunul od plánování výroby v excelových tabulkách 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 práce 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.
99,2 %včasnost dodávek
„SkyPlanner nám umožnil lépe odhalovat úzká místa a zpřehlednil řízení výroby.“
Toni Tuori, vedoucí výroby
Piristeel · Střešní bezpečnostní prvky a okapové systémy
Včasnost dodávek letos dosáhla 99,2 % a rozvrhování šetří až čtyři hodiny práce denně.
Méněprostojů kvůli nedostatku materiálu
„Přínos SkyPlanner pro nás spočívá v tom, že je to nástroj, který funguje v každodenní praxi, zejména při stanovování termínů dodání.“
Tommi Männistö, vedoucí plánování výroby
Eskomatic · Zakázkové obrábění
Automatické plánování vytížení umožňuje přesněji stanovovat termíny dodání a výrobních prostojů způsobených nedostatkem materiálu výrazně ubylo.
Časté dotazy
Která rozhraní Proalpha integrace využívá?
REST API Proalpha pro díly, zásoby a zpětný zápis termínů, výrobních zdrojů a odvedené výroby. Toky zpráv INWB nebo Integration Platform založená na n8n přenášejí výrobní příkazy včetně operací. Pro zkušební provoz a hromadné načítání dat slouží exporty do souborů.
Kam se v Proalpha zapisují naplánované termíny?
Do operace výrobního příkazu přes setWorkOrderOperationDates, s časem zahájení a ukončení. Pokud plánovací jádro přesunulo operaci na jiný stroj, changeWorkOrderOperationResource aktualizuje výrobní zdroj.
Podporuje Proalpha webhooky?
Proalpha API Portal neuvádí žádné API pro přihlášení k odběru webhooků. Změny se do SkyPlanner dostávají prostřednictvím toků zpráv INWB, workflow n8n nebo pravidelného dotazování. Vlastní webhooky SkyPlanner umožňují spouštět zpětný zápis na základě událostí.
Lze do Proalpha zapisovat údaje o výrobě, které potvrdila obsluha?
Ano. Časové záznamy ze SkyPlanner Mobile Confirmations se zapisují přes operationDataEntry včetně množství a časů pracovníka i výrobního zdroje. Pokud používáte také terminály PDC, ponechte jen jeden kanál pro odvádění výroby.
Potřebujeme Proalpha APS a co když ho už používáme?
Nepotřebujete ho. SkyPlanner sám plánuje výrobu podle vašich výrobních příkazů, operací a výrobních zdrojů s ohledem na skutečné kapacity strojů a pracovníků. Autopilot udržuje plán aktuální. Pokud používáte Proalpha APS, při vymezení rozsahu rozhodněte, který systém bude spravovat termíny operací. SkyPlanner pak zapisuje pouze termíny, za které odpovídá, takže se oba plány nikdy navzájem nepřepisují.
Můžeme si SkyPlanner vyzkoušet ještě před vytvořením integrace?
Ano. Během 30 dní zdarma můžete pracovat až s 20 pracovišti a využít export svých výrobních příkazů do CSV nebo Excelu. Platební kartu nepotřebujete. Vyzkoušejte SkyPlanner nebo kontaktujte obchodní tým a vymezte rozsah integrace.
