Průvodce integrací Monitor ERP pro rozvrhování výroby se SkyPlanner APS

Zdokumentovaným integračním rozhraním Monitor G5 je Monitor ERP API v1. Kombinuje CQRS a REST a přenáší JSON přes HTTPS. (Monitor ERP API)

• Dotazy čtou data metodou GET. Podporují parametry ve stylu OData: $filter, $select, $expand, $orderby, $top a $skip.
• Příkazy zapisují data metodou POST, například Manufacturing/ManufacturingOrderOperations/Update.
• Batch provede několik příkazů v jediné transakci typu vše, nebo nic přes POST /api/v1/Batch. Připojením /Simulate nebo /Validate dávku otestujete a její změny vrátíte zpět. Takto lze bezpečně zapsat celý rozvrh. (Batch)

Základní URL je https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Číslo společnosti se skládá z čísla databáze a ID společnosti, například 004.1.

K licencování Monitor uvádí: „It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.“ (Všichni naši zákazníci mohou přes API zdarma zadávat dotazy a získávat informace. Pro používání příkazů a zápis dat do ERP je však nutné zakoupit Monitor ERP API.) S licencí pro zápis počítejte v projektu od samého začátku. (api.monitor.se)

Referenční dokumentace Monitor ERP API nepopisuje žádné webhooky ani odběr událostí. Změny se zjišťují pravidelným dotazováním (pollingem):

• Common/EntityChangeLogs (od verze 2.33) vrací ChangeType (Update, Create, Delete), EntityTypeId, EntityId a ModifiedTimestamp. Dotazujte se každých několik minut a načítejte pouze změněné záznamy. (EntityChangeLog)
• Dotazy na výrobní příkazy omezte na otevřené příkazy a výsledky stránkujte pomocí $top a $skip.

SkyPlanner při změně stavu nebo rozvrhu odesílá webhooky, takže zpětný zápis je řízen událostmi.

1. Počáteční načtení kmenových dat. Načtěte pracoviště, řádky operací, řádky alternativních operací, materiálové řádky, položky a rozvrhy směn. Pečlivě určete, kterému pracovišti ve SkyPlanner bude každé pracoviště odpovídat. Z pracoviště typu Pool vznikne skupina pracovišť a z pracovišť, která sdružuje, vzniknou jednotlivá pracoviště, mezi nimiž bude plánovací jádro vybírat.

2. Synchronizace zakázek. Načtěte otevřené výrobní příkazy včetně jejich uzlů, operací a materiálů, dále zásoby a otevřené nákupní objednávky. 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. Po prvním načtení se přírůstkové aktualizace řídí podle Common/EntityChangeLogs.

3. Zpětný zápis rozvrhu. Pro každou operaci, kterou plánovací jádro zařadilo nebo přesunulo, odešle SkyPlanner ManufacturingOrderOperations/Update s PlannedStartDate a PlannedFinishDate. Pokud jádro přesunulo operaci na jiný stroj ve skupině, nejprve se provede SetWorkCenter. Příkazy pro jednu zakázku se odešlou v jedné dávce Batch, takže je Monitor přijme buď všechny, nebo žádný. Při testování spusťte dávku přes /Validate.

Ve verzích Monitor před 24.5 nelze plánované termíny zapisovat přes Update. Místo toho použijte ManufacturingOrders/ReplanOperation (od verze 2.40) se StartDate a FinishDate a nastavte RestrictToOrderBounds podle svých pravidel.

4. Odvádění výroby. Používejte pouze jeden kanál pro vykazování:

• Vykazování zůstává v systému Monitor. Operátoři vykazují práci přes Recording terminal nebo prostřednictvím integrace strojů stejně jako dosud. SkyPlanner načítá průběh výroby z ManufacturingOrderOperationReportings a podle něj přeplánovává.
• Vykazování přebírá SkyPlanner. Operátoři zaznamenávají práci pomocí Mobile Confirmations nebo Production Timer a SkyPlanner odesílá do systému Monitor ReportManufacturingOrderOperation.

Při vykazování v obou systémech se časy a množství započítají dvakrát.

5. Odpovědnost za data a pravidla řešení konfliktů. Před spuštěním ostrého provozu je písemně stanovte:

Hlavním zdrojem konfliktů jsou další úpravy prioritního plánu ze strany plánovačů. Rescheduling according to New finish a přetahování řádků v Priority planning přepisují termíny zapsané systémem SkyPlanner. Jakmile pořadí operací řídí SkyPlanner, slouží Priority planning už jen k prohlížení. S funkcí Autopilot SkyPlanner při změnách ve výrobě automaticky přeplánuje rozvrh.

• Koeficient dostupnosti. Monitor přepočítává hrubou kapacitu na čistou pomocí koeficientu dostupnosti. U nového pracoviště je výchozí hodnota 80 %. Zohledněte jej pouze jednou: buď jako efektivitu v systému SkyPlanner, nebo zkrácením směn, nikdy obojím.
• Časová přesnost. Pracoviště v Day planning mají kapacitu vyjádřenou jako základní čas na den, bez časů směn. Namapujte do systému SkyPlanner skutečné směny z výrobních kalendářů, aby se práce rozvrhovala do pracovní doby.
• Čekací doba a překrytí. Řádky operací obsahují čekací dobu a překrytí v %. Při vymezení rozsahu rozhodněte, jak se obě hodnoty převedou do systému SkyPlanner. Jinak se po spuštění ostrého provozu změní průběžné doby.
• Skupiny pracovišť. Skupinová pracoviště se plánují v Pool planning, nikoli v Priority planning. Načítejte i zařazená pracoviště, ne pouze řádek skupiny.
• Požadavky na verzi. Zápis plánovaných termínů pomocí Update vyžaduje verzi 24.5. Pole kapacity pracovišť v API vyžadují verzi 24.3 a OIDC verzi 25.8. Před vymezením rozsahu zkontrolujte sestavení systému.
• Síť a certifikát. Lokálně provozovaný Monitor poskytuje API na portu 8001 s certifikátem podepsaným svým držitelem. SkyPlanner běží v cloudu, proto naplánujte pravidlo firewallu nebo přenos přes prostředníka a certifikát výslovně nastavte jako důvěryhodný.
• Licence. Každá aplikace třetí strany, která zapisuje data, potřebuje vlastní licencované uživatele API. Součástí každého systému je jeden uživatel API s přístupem pouze pro čtení.