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

Fulcrum je jednotný cloudový produkt s architekturou pro více zákazníků, takže všichni zákazníci používají stejné API. Vývojářský portál jej popisuje jako veřejné API pro „REST API calls directly into your Fulcrum site.“ (volání REST API přímo do vaší instance Fulcrum).

• Specifikace. OpenAPI „Fulcrum PublicAPI“ v1 je ke stažení na https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum doporučuje vygenerovat z ní typovaného klienta. Stránka History uvádí všechny změny včetně data.
• Hostitelé. Standardní instance používají https://api.fulcrumpro.com. Instance ITAR používají api.fulcrumpro.us; s tokenem ITAR vrací hostitel .com chybu 401.
• Způsob volání. Seznamy se načítají přes POST .../list s filtrem v těle požadavku, stránkováním pomocí Skip a Take a řazením pomocí Sort.Field / Sort.Dir. Řada objektů podporuje PUT, zakázky navíc podporují JSON Patch.

Endpointy používané při integraci rozvrhování výroby:

Fulcrum na své stránce o integracích otevřeně uvádí, co je potřeba: „Every system is a little bit different and requires some configuration.“ (Každý systém je trochu jiný a vyžaduje určitou konfiguraci.) Právě tuto konfiguraci během zavádění zajišťuje tým SkyPlanner.

Fulcrum podporuje webhooky, které konfiguruje správce. Od září 2026 se neúspěšné webhooky pozastavují a znovu testují každý den, místo aby se jejich volání opakovalo donekonečna. Historie API uvádí například události PurchaseOrderUpdated a ItemUpdated.

Integrace načítá data z Fulcrum takto:

• Každých několik minut se dotazuje na otevřené zakázky filtrované podle stavů scheduled a inProgress s podmínkou hasIncompleteOperations: true. Tento filtr uvádí přímo Fulcrum pro získání dat odpovídajících jeho stránce s rozvrhem.
• Nákupní objednávky a skladové zásoby se načítají před každým sestavením rozvrhu nebo při přijetí webhooku PurchaseOrderUpdated, pokud je nakonfigurován.
• Položky, technologické postupy, zařízení a směny se načítají při změně nebo každou noc.

V opačném směru odesílají vlastní webhooky SkyPlanner změny rozvrhu ihned, jakmile nastanou. Zpětný zápis je tedy řízen událostmi.

1. Úvodní načtení kmenových dat. Načtěte položky, materiály, technologické postupy, pracoviště a zařízení, poté směny oddělení a odstávky. Z každého pracoviště Fulcrum vznikne ve SkyPlanner skupina pracovišť, jejímiž členy budou příslušná zařízení. Zařízení vybraná u každé operace technologického postupu se pro tuto operaci stanou povolenými pracovišti. Zařízení s nastavením Unlimited Capacity, například pece a lakovací kabiny, se převedou na dávkové operace.

2. Synchronizace zakázek. Načtěte otevřené zakázky včetně položek k výrobě a operací a také otevřené nákupní objednávky a skladové zásoby. SkyPlanner považuje objednaný materiál za dostupný k datu dodání na nákupní objednávce a aktualizuje zásoby, jakmile je objednávka označena stavem Delivered. Při každém přeplánování se kontrolují skladové zásoby i očekávané dodávky z nákupních objednávek.

3. Zpětný zápis rozvrhu. Fulcrum samo vypočítává scheduledStartUtc, scheduledEndUtc a scheduledEquipmentId a vrací je pouze pro čtení. Při aktualizaci operace lze zapisovat do customFields. SkyPlanner zapisuje plánovaný začátek, plánované dokončení a pracoviště do vlastních polí každé operace zakázky. Plánované dokončení zakázky zapisuje také do vlastního pole zakázky. Obchodní a nákupní oddělení tak u zakázky ve Fulcrum vidí termíny ze SkyPlanner.

4. Odvádění práce ve výrobním provozu. Operátoři zaznamenávají práci v systému SkyPlanner pomocí Mobile Confirmations, Production Timer nebo Quick Log Mode. SkyPlanner odesílá časy do systému Fulcrum přes /api/job-tracking-timers/start a /stop, případně jako dokončený časový blok přes /api/timers. Množství se předává přes add-quantity-completed a konečný počet včetně zmetků přes complete. Náklady na zakázky v systému Fulcrum zůstávají průběžně aktuální.

5. Pravidla odpovědnosti za data a řešení konfliktů. Plánovač systému Fulcrum „dictates the order of operations in Job Tracking.“ (určuje pořadí operací v Job Tracking). Pro každou operaci proto zvolte jediný způsob zadávání práce: frontu operátora v systému SkyPlanner, nebo Fulcrum Job Tracking. Před spuštěním ostrého provozu pravidla písemně stanovte:

• Personální kapacitu vyjadřují počty ve směnách. Parametr Max Equipment pro jednotlivé směny v systému Fulcrum „is usually determined by how many people you have working in a certain area at that time.“ (obvykle závisí na tom, kolik lidí v danou dobu pracuje v dané oblasti). Konkrétní operátoři a jejich směny se nastavují v systému SkyPlanner. Jména poskytují uživatelské záznamy z /api/users.
• Operace se rozvrhují na zařízení. Pracoviště v systému Fulcrum jsou skupiny vzájemně zastupitelných zařízení. Dbejte na správný výběr zařízení v technologickém postupu: právě z nich bude plánovací algoritmus vybírat alternativy.
• Výrobní příkazy sdružují zakázky. Výrobní příkaz sdružuje operace několika zakázek, například v rámci nářezového plánu. Spuštěním časovače u sdružené operace se místo něj spustí časovač výrobního příkazu, který pokrývá všechny operace zakázek v dané skupině.
• Omezení časových záznamů. Zpětně zadávané bloky přes /api/timers „may not be in the future, older than 30 days, or longer than 7 days“ (nesmějí být v budoucnosti ani překročit uvedené limity stáří a délky). Čas přenášejte průběžně, jak jej operátoři vykazují.
• Formáty času se liší. Směny používají místní čas ve formátu HHmm, odstávky a naplánované termíny jsou v UTC a odhadované doby operací se předávají v sekundách.
• Aktualizace zařízení nahrazuje celý záznam. Požadavek PUT pro zařízení vymaže každé pole, které v něm není uvedeno. SkyPlanner data zařízení pouze čte a nikdy do nich nezapisuje.
• Prostředí podléhající ITAR. Použijte hostitele .us a token ITAR.