Sprievodca integráciou Fulcrum na rozvrhovanie výroby so SkyPlanner APS

Fulcrum je jednotný cloudový produkt s architektúrou pre viacerých nájomcov, takže všetci zákazníci používajú rovnaké API. Vývojársky portál ho opisuje ako verejné API na „REST API calls directly into your Fulcrum site.“ (volania REST API priamo do vašej inštancie Fulcrum).

• Špecifikácia. OpenAPI „Fulcrum PublicAPI“ v1 je k dispozícii na stiahnutie na https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum odporúča vygenerovať z nej typovaného klienta. Stránka History uvádza všetky zmeny aj s dátumami.
• Hostitelia. Štandardné inštancie používajú https://api.fulcrumpro.com. Inštancie ITAR používajú api.fulcrumpro.us; tokeny ITAR dostanú na hostiteľovi .com odpoveď 401.
• Spôsob volania. Zoznamy sa získavajú cez POST .../list s filtrom v tele požiadavky, stránkovaním pomocou Skip a Take a zoradením cez Sort.Field / Sort.Dir. Mnohé objekty podporujú PUT a zákazky aj JSON Patch.

Koncové body používané pri integrácii rozvrhovania:

Fulcrum na svojej stránke o integráciách otvorene uvádza, čo táto práca obnáša: „Every system is a little bit different and requires some configuration.“ (Každý systém je trochu iný a vyžaduje určité nastavenie.) Práve toto nastavenie preberá počas zavádzania tím SkyPlanner.

Fulcrum podporuje webhooky, ktoré nastavuje správca. Od septembra 2026 sa webhooky pri zlyhaní pozastavia a denne sa znova testujú namiesto neustáleho opakovania pokusov. API History uvádza udalosti ako PurchaseOrderUpdated a ItemUpdated.

Integrácia načítava dáta z Fulcrum takto:

• Otvorené zákazky sa načítavajú každých pár minút s filtrom na stavy scheduled a inProgress a podmienkou hasIncompleteOperations: true. Tento filter odporúča samotný Fulcrum, aby výsledky zodpovedali jeho stránke s rozvrhom.
• Nákupné objednávky a skladové zásoby sa načítavajú pred každým spustením rozvrhovania alebo pri udalosti webhooku PurchaseOrderUpdated, ak je nastavený.
• Položky, technologické postupy, zariadenia a zmeny sa načítavajú pri zmene alebo každú noc.

V opačnom smere odosielajú vlastné webhooky SkyPlanner zmeny rozvrhu hneď, ako nastanú. Spätný zápis je teda riadený udalosťami.

1. Úvodné načítanie kmeňových dát. Načítajte položky, materiály, technologické postupy, pracoviská a zariadenia, potom zmeny oddelení a odstávky. Každé pracovisko Fulcrum sa v SkyPlanner zmení na skupinu pracovísk, do ktorej patria jeho zariadenia. Zariadenia vybrané pre každú operáciu technologického postupu sa stanú jej povolenými pracoviskami. Zariadenia s nastavením Unlimited Capacity, napríklad pece a lakovacie kabíny, sa modelujú ako dávkové operácie.

2. Synchronizácia objednávok. Načítajte otvorené zákazky vrátane položiek na výrobu a operácií, ako aj otvorené nákupné objednávky a skladové zásoby. SkyPlanner považuje objednaný materiál za dostupný v deň dodania nákupnej objednávky a aktualizuje zásoby, keď sa objednávka označí ako Delivered. Pri každom preplánovaní sa kontrolujú skladové zásoby aj očakávané nákupné dodávky.

3. Spätný zápis rozvrhu. Fulcrum sám vypočítava scheduledStartUtc, scheduledEndUtc a scheduledEquipmentId a vracia ich len na čítanie. Aktualizácia operácie prijíma customFields. SkyPlanner zapisuje plánovaný začiatok, plánované dokončenie a pracovisko do vlastných polí každej operácie zákazky a plánované dokončenie aj do vlastného poľa zákazky. Obchod a nákup tak vidia termíny zo SkyPlanner priamo pri zákazke vo Fulcrum.

4. Hlásenia z dielne. Operátori zaznamenávajú prácu v SkyPlanner pomocou Mobile Confirmations, Production Timer alebo Quick Log Mode. SkyPlanner odosiela čas do Fulcrum cez /api/job-tracking-timers/start a /stop alebo ako uzavretý časový blok cez /api/timers. Množstvá sa odosielajú cez add-quantity-completed a konečný počet vrátane nepodarkov cez complete. Kalkulácia nákladov na zákazky vo Fulcrum zostáva priebežne aktuálna.

5. Pravidlá zodpovednosti za dáta a riešenia konfliktov. Plánovač Fulcrum „dictates the order of operations in Job Tracking.“ (určuje poradie operácií v Job Tracking). Pre každú operáciu preto vyberte jeden spôsob zadávania práce: rad operácií pre operátora v SkyPlanner alebo Fulcrum Job Tracking. Pred spustením ostrej prevádzky pravidlá spíšte:

• Kapacita pracovníkov závisí od počtu ľudí na zmene. Hodnota Max Equipment pre zmenu vo Fulcrum „is usually determined by how many people you have working in a certain area at that time.“ (zvyčajne závisí od počtu ľudí, ktorí v danom čase pracujú v príslušnej oblasti). Konkrétni operátori a ich zmeny sa nastavujú v SkyPlanner. Ich mená poskytujú záznamy používateľov v /api/users.
• Výroba sa rozvrhuje na zariadenia. Pracoviská vo Fulcrum sú skupiny vzájomne zastupiteľných zariadení. Dbajte na správny výber zariadení v technologickom postupe, pretože práve z nich bude plánovací mechanizmus vyberať alternatívy.
• Výrobné príkazy zoskupujú zákazky. Výrobný príkaz zoskupuje operácie viacerých zákaziek, napríklad pri spoločnom rozložení dielov na rezanie. Spustenie časovača na zoskupenej operácii namiesto toho spustí časovač výrobného príkazu, ktorý pokrýva všetky operácie zákaziek v skupine.
• Obmedzenia časových záznamov. Spätne zapisované bloky /api/timers „may not be in the future, older than 30 days, or longer than 7 days.“ (nesmú byť v budúcnosti ani prekročiť uvedené limity veku a trvania). Čas odosielajte priebežne, ako ho operátori zaznamenávajú.
• Formáty času sa líšia. Zmeny používajú miestny čas vo formáte HHmm, odstávky a naplánované termíny sú v UTC a odhadované trvania operácií sa uvádzajú v sekundách.
• Aktualizácia zariadenia nahrádza celý záznam. Požiadavka PUT pre zariadenie vymaže každé pole, ktoré v nej chýba. SkyPlanner údaje o zariadeniach iba číta a nikdy ich nezapisuje.
• Prostredia ITAR. Použite hostiteľa .us a token ITAR.