Vodnik za integracijo sistema Fulcrum s SkyPlanner APS za terminiranje proizvodnje

Fulcrum je enoten izdelek v oblaku z več najemniki, zato vse stranke uporabljajo isti API. Portal za razvijalce ga opisuje kot javni API za “REST API calls directly into your Fulcrum site.” (klice REST API neposredno v vaše okolje Fulcrum).

• Specifikacija. OpenAPI “Fulcrum PublicAPI” v1 je na voljo za prenos na https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum priporoča, da iz nje ustvarite odjemalca s tipizacijo. Na strani History so navedene vse spremembe z datumi.
• Gostitelji. Za standardna okolja se uporablja https://api.fulcrumpro.com. Okolja ITAR uporabljajo api.fulcrumpro.us; žetoni ITAR na gostitelju .com prejmejo odgovor 401.
• Način klicanja. Seznami se pridobivajo s klici POST .../list, pri katerih telo zahteve vsebuje filter, za ostranjevanje se uporabljata Skip in Take, za razvrščanje pa Sort.Field / Sort.Dir. Številni objekti podpirajo PUT, nalogi pa tudi JSON Patch.

Končne točke, ki jih uporablja integracija za terminiranje:

Fulcrum na svoji strani o integracijah jasno pove, kaj je treba opraviti: “Every system is a little bit different and requires some configuration.” (Vsak sistem je nekoliko drugačen in zahteva nekaj konfiguracije.) Prav to konfiguracijo med uvajanjem prevzame ekipa SkyPlanner.

Fulcrum podpira spletne kavlje, ki jih konfigurira skrbnik. Od septembra 2026 se spletni kavlji, pri katerih prihaja do napak, začasno ustavijo in znova preizkusijo vsak dan, namesto da bi se poskusi ponavljali v nedogled. V zgodovini API so navedeni dogodki, kot sta PurchaseOrderUpdated in ItemUpdated.

Integracija podatke iz sistema Fulcrum bere takole:

• Odprte naloge s statusoma scheduled in inProgress ter filtrom hasIncompleteOperations: true pridobiva vsakih nekaj minut. Ta filter priporoča tudi Fulcrum, da se rezultati ujemajo z njegovo stranjo s terminskim planom.
• Nabavna naročila in zaloge prebere pred vsakim terminiranjem ali ob spletnem kavlju PurchaseOrderUpdated, če je ta konfiguriran.
• Artikle, tehnološke postopke, opremo in izmene prebere ob spremembi ali vsako noč.

V nasprotni smeri spletni kavlji sistema SkyPlanner pošljejo spremembe terminskega plana takoj, ko nastanejo, zato zapisovanje nazaj v Fulcrum temelji na dogodkih.

1. Začetni prenos matičnih podatkov. Pridobite artikle, materiale, tehnološke postopke, delovne centre in opremo, nato še izmene oddelkov in zastoje. Vsak delovni center v sistemu Fulcrum se preslika v skupino delovnih centrov v sistemu SkyPlanner, njegova oprema pa v člane te skupine. Oprema, izbrana za posamezno operacijo tehnološkega postopka, določa dovoljene delovne centre za to operacijo. Oprema z nastavitvijo Unlimited Capacity, kot so peči in lakirne kabine, se preslika v šaržne operacije.

2. Sinhronizacija naročil. Preberite odprte naloge z artikli za izdelavo in operacijami ter odprta nabavna naročila in zaloge. SkyPlanner naročeni material obravnava kot razpoložljiv na datum dobave iz nabavnega naročila in posodobi zalogo, ko je naročilo označeno s statusom Delivered. Ob vsakem ponovnem terminiranju preveri zaloge in pričakovane dobave.

3. Zapis terminskega plana nazaj v Fulcrum. Fulcrum sam izračuna scheduledStartUtc, scheduledEndUtc in scheduledEquipmentId ter jih vrne samo za branje. Pri posodobitvi operacije je mogoče poslati customFields. SkyPlanner v polja po meri pri vsaki operaciji naloga zapiše planirani začetek, planirani konec in delovni center, v polje po meri na ravni naloga pa planirani konec. Prodaja in nabava tako na nalogu v sistemu Fulcrum vidita datume iz sistema SkyPlanner.

4. Potrjevanje dela v proizvodnji. Operaterji beležijo delo v SkyPlanner s funkcijami Mobile Confirmations, Production Timer ali Quick Log Mode. SkyPlanner pošlje podatke o času v Fulcrum prek /api/job-tracking-timers/start in /stop ali kot zaključen časovni blok prek /api/timers. Količine se prenašajo prek add-quantity-completed, končna količina skupaj z izmetom pa prek complete. Obračun stroškov nalogov v sistemu Fulcrum tako ostaja sproti posodobljen.

5. Pravila o skrbništvu podatkov in reševanju navzkrižij. Fulcrumov terminirnik “dictates the order of operations in Job Tracking.” (določa vrstni red operacij v modulu Job Tracking). Zato za vsako operacijo izberite en kanal za dodeljevanje dela: čakalno vrsto za operaterje v SkyPlanner ali Fulcrum Job Tracking. Pred zagonom zapišite pravila:

• Število enot opreme na izmeno je odvisno od razpoložljivega osebja. Fulcrumova nastavitev Max Equipment za posamezno izmeno “is usually determined by how many people you have working in a certain area at that time.” (je običajno določena s številom ljudi, ki takrat delajo na določenem območju). Posamezne operaterje in njihove izmene nastavite v SkyPlanner. Imena pridobite iz uporabnikov v /api/users.
• Operacije se terminirajo na opremo. Delovni centri v sistemu Fulcrum so skupine medsebojno zamenljive opreme. Poskrbite, da je oprema v tehnološkem postopku pravilno izbrana, saj predstavlja alternative, med katerimi izbira mehanizem za terminiranje.
• Delovni nalogi združujejo proizvodne naloge. Delovni nalog združuje operacije več proizvodnih nalogov, na primer pri skupnem razrezu. Ob zagonu merilnika časa za združeno operacijo se namesto tega zažene merilnik časa delovnega naloga, ki zajema vse operacije nalogov v skupini.
• Omejitve merjenja časa. Za naknadno vnesene bloke /api/timers velja: “may not be in the future, older than 30 days, or longer than 7 days.” (ne smejo segati v prihodnost ali presegati navedenih omejitev starosti in trajanja). Podatke o času prenašajte sproti, ko jih operaterji beležijo.
• Časovni zapisi se razlikujejo. Izmene uporabljajo lokalni čas v obliki HHmm, zastoji in načrtovani datumi so v UTC, ocenjena trajanja operacij pa se prenašajo v sekundah.
• Posodobitev opreme zamenja celoten zapis. Zahteva PUT za opremo počisti vsa polja, ki jih ne vsebuje. SkyPlanner podatke o opremi samo bere in jih nikoli ne zapisuje.
• Okolja ITAR. Uporabite gostitelja .us in žeton ITAR.