Průvodce integrací Sylob ERP pro plánování výroby se SkyPlanner APS

Sylob dokumentuje dvě veřejná REST API: „L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \“webservices\“) qui autorise la lecture et l’écriture de données.“ (ERP Sylob zpřístupňuje dva typy veřejných REST API, označovaných také jako webové služby, které umožňují čtení a zápis dat.) (Znalostní báze Forterro)

1. API REST Système d’information (čtení). Spouští uložený dotaz (requête) vytvořený v aktivitě „Interroger le système d’information“. URL pro volání konkrétního dotazu získáte přes „Autres actions“ > „Afficher le web service“. Má tvar /rest/query/{identifiantQuery}/resultat. Parametry určují limit výsledků, formát čísel, proměnné dotazu a strukturu výsledku. Výsledky se standardně vracejí jako XML, s hlavičkou Accept: application/json jako JSON. Toto API je součástí ERP.
2. API REST Action (čtení a zápis). Spouští akci definovanou v aktivitě „Gérer les actions web service“, která slouží jako katalog akcí Sylob. Nabízí dvě operace: GET /rest/v2/action/{code}/describe vrací datové schéma akce a POST /rest/v2/action/{code}/execute ji spouští s tělem požadavku ve formátu JSON. Mezi typy akcí patří:

– Modification de données: mění jedno nebo více polí záznamu pomocí mechanismu rychlých úprav v Sylob. Describe vypisuje pole, která lze upravovat. – Message EDI: vytváří, mění nebo maže záznamy prostřednictvím zprávy EDI. – Scénario de saisie: spouští scénář zadávání postupně, otázku po otázce. Sylob jako příklad uvádí „Déclarer un début ou une fin“, tedy hlášení začátku nebo konce operace (Sylob_Action_006). – Publikování, nahrávání a stahování dokumentů.

1. Zprávy EDI. Modul EDI v Sylob zajišťuje exporty a importy. Standardní zpráva Sylob_Recup_Decl_Pro načítá výrobní hlášení. (Forterro)
2. Soubory a ETL. Sylob ERP Cloud nabízí „Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.“ (Integraci souborů přes SFTP pro snadnou migraci stávajících integrací.) (Sylob) Výsledky dotazů lze také exportovat do Excelu. To je rychlá cesta, jak si SkyPlanner vyzkoušet.

Veřejná znalostní báze Sylob nepopisuje možnost přihlásit se k odběru odchozích webhooků. Změny se do SkyPlanner přenášejí pravidelným spouštěním uložených dotazů, které filtrují otevřené OF a nedávné změny. Interval dotazování si nastavíte sami.

Sylob chrání ERP před nadměrnou zátěží z dotazů. Od verze 2025.Q2 lze firemním parametrem „Protection des API“ zapnout omezování volání podle uživatele a stránkování rozsáhlých výsledků. Od verze 2026.Q2 Sylob avizuje plošné uplatnění této ochrany. Odpovědi obsahují hlavičky RateLimit a volání nad stanovený limit vrací HTTP 429 Too Many Requests s hodnotou Retry-After. (Forterro) Počítejte s tím při návrhu synchronizace: používejte přírůstkové dotazy, stránkování a při odpovědi 429 odložte další pokus.

SkyPlanner naopak při změně stavu nebo plánu odesílá webhooky, takže zpětný zápis do Sylob spouštějí události.

1. Úvodní načtení kmenových dat. Pro každý objekt (položky, kusovníky, technologické postupy, pracoviště, zaměstnance) vytvořte jeden uložený dotaz a načítejte data přes API Système d’information. Případně je jednorázově načtěte z exportu do Excelu. Pečlivě promyslete mapování pracovišť. Sylob centre de charge představuje skupinu zdrojů, takže ze střediska se třemi stroji obvykle v SkyPlanner vznikne skupina pracovišť se třemi pracovišti.

2. Synchronizace zakázek. Načítejte potvrzené OF včetně operací, 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, když je objednávka označena stavem Delivered. Při sestavování plánu tak kontroluje zásoby i očekávané nákupy.

Plánujte potvrzené OF, nikoli návrhy CBN. Návrhy se při příštím výpočtu čistých potřeb změní.

3. Zpětný zápis plánu. Pro každou operaci, kterou plánovací algoritmus zařadil nebo přesunul, integrace zavolá akci Modification de données nad operací OF (Opération d’ordre de fabrication). Předá jí plánovaný začátek, plánovaný konec a pracoviště. Akce využívá vlastní logiku rychlých úprav Sylob, stejně jako když operaci upravuje plánovač. Describe vrací pole, která lze upravovat, takže integrace před prvním voláním ověří odesílaná data. Pokud záznam právě upravuje uživatel, volání skončí očekávanou chybou; při příští změně pokus opakujte.

4. Hlášení z výroby. Operátoři zaznamenávají práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer. Začátek a konec se zpětně přenášejí přes scénář „Déclarer un début ou une fin“. Z časových záznamů a množství vznikají výrobní hlášení ke stejné operaci OF: čas seřízení, čas zpracování, vyrobené množství, zmetky a dokončení operace. Pokud váš závod již hlásí výrobu přes Sylob Apps nebo výrobní terminály, ponechte pro hlášení jediný kanál, abyste předešli duplicitním záznamům.

5. Pravidla odpovědnosti za data a řešení konfliktů. Sepište je před spuštěním do ostrého provozu:

SkyPlanner nepotřebuje CADPLAN ani úlohy plánování výroby v Sylob, které zohledňují omezenou kapacitu. Správu termínů operací ponechte systému SkyPlanner, protože pokud do stejných termínů zapisují dva plánovací systémy, navzájem si je přepisují. Jakmile termíny spravuje SkyPlanner, Autopilot při každé významné změně automaticky přeplánuje výrobu a nové termíny se zapíší zpět do Sylob.

• Licence pro Action API. Čtení prostřednictvím uložených dotazů je zahrnuto. Zápis přes katalog akcí vyžaduje modul Sylob „Webservice“ nebo licenci API v MyForterro. Vyřešte ji se svým kontaktem pro Sylob před zahájením zpětného zápisu.
• Dotazy určují rozhraní. Čtení dat závisí na uložených dotazech. Pojmenujte je srozumitelně, filtry předávejte při spuštění jako proměnné atributy a dotazy verzujte společně s integrací.
• Skupiny pracovišť. Jedno pracoviště v Sylob může zahrnovat několik strojů. U každého rozhodněte, zda je SkyPlanner převezme jako jednu skupinu pracovišť, nebo jako jednotlivé stroje.
• Zpětné plánování a výpočty zatížení. Sylob plánuje zpětně od požadovaných termínů a naplánovaný výpočet zatížení může přeplánovat opožděné OF. Dohodněte se, zda po převzetí správy termínů systémem SkyPlanner smí některá úloha nadále zapisovat termíny operací, a pokud ano, která.
• Jednotky časů seřízení a výroby. Před importem zkontrolujte jednotky a ověřte, zda se čas seřízení vztahuje na celý OF, nebo na kus. Nesprávné jednotky zkreslí všechny doby trvání.
• Kalendáře. Týdenní rozvrhy pracovišť a výjimky musí pokrývat celý plánovací horizont, jinak kapacita z plánu zmizí.
• Omezení počtu volání. Sylob omezuje počet volání na uživatele a rozsáhlé výsledky stránkuje. Pravidelné načítání pouze změněných dat ponechává v rámci kvóty dostatečnou rezervu.
• CORS a prohlížeče. Na volání mezi servery se CORS nevztahuje. Pro klienty v prohlížeči je nutné na straně Sylob nastavit povolené zdroje.