Liidestused / ERP / Fulcrum
Fulcrumi liidestamise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See Fulcrumi liidestamise juhend näitab konsultantidele ja IT-meeskondadele, kuidas ühendada Fulcrum (Fulcrum Pro) SkyPlanner APS-iga. SkyPlanner vahetab Fulcrumiga andmeid mõlemas suunas Fulcrum Public API kaudu:
- SkyPlannerisse tuuakse tööd koos valmistatavate toodete ja operatsioonidega, toodete tehnoloogilised marsruudid, töökeskused, seadmed, osakondade vahetused, seisakud, laoseis ja ostutellimused.
- Planeeritud algus, planeeritud lõpp ja töökeskus kirjutatakse iga tööoperatsiooni kohandatud väljadele.
- Operaatorite tööaeg ja valminud kogused saadetakse tagasi Fulcrumi taimerite ja koguseuuendustena.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe, kui need toimuvad.
SkyPlanneri meeskond seadistab liidese juurutamise käigus teie Fulcrumi seadistusele vastavaks ja pakub tuge ka pärast kasutuselevõttu. See juhend on konsultantidele ja arendajatele, kes soovivad töös osaleda või ise SkyPlanneri dokumenteeritud REST API abil lahendusi luua (API dokumentatsioon).
Fulcrum Public API
Fulcrum on üks mitme rentnikuga pilvetoode, seega kasutavad kõik kliendid sama API-t. Arendajaportaal kirjeldab seda avaliku API-na, mis võimaldab järgmist: “REST API calls directly into your Fulcrum site.” (REST API päringud otse teie Fulcrumi keskkonda.)
- Spetsifikatsioon. OpenAPI “Fulcrum PublicAPI” v1 on allalaaditav aadressilt
https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum soovitab selle põhjal genereerida tüübistatud kliendi. History lehel on kõik muudatused koos kuupäevadega. - Serverid. Tavakeskkondade jaoks on
https://api.fulcrumpro.com. ITAR-keskkonnad kasutavad aadressiapi.fulcrumpro.usning ITAR-tokeniga saab .com-serverist vastuse 401. - Päringute ülesehitus. Loendite pärimiseks kasutatakse
POST .../listpäringuid, mille kehas on filter. Lehekülgjaotust juhivadSkipjaTake, sortimistSort.Field/Sort.Dir. Paljud objektid toetavad PUT-päringuid, tööd ka JSON Patchi.
Tootmise ajakava koostamise liides kasutab järgmisi otspunkte:
| Valdkond | Otspunktid |
|---|---|
| Tooted ja tehnoloogilised marsruudid | /api/items, /api/items/{itemId}/routing, /routing/operations, /routing/input-items, /routing/input-materials |
| Tootmise seadistus | /api/work-centers, /api/equipment, /api/operations, /api/department-shifts, /api/equipment-downtimes |
| Tööd | /api/jobs, /api/jobs/{jobId}/items-to-make/{itemToMakeId}/operations, /api/work-orders |
| Materjalid | /api/inventory, /api/materials, /api/purchase-orders, /api/reporting/material-requirements/list |
| Tootmissaal | /api/job-tracking-timers/start ja /stop, /api/timers, .../operations/{operationId}/add-quantity-completed, .../complete |
Fulcrumi enda liidestuste leht ütleb töö kohta otse: “Every system is a little bit different and requires some configuration.” (Iga süsteem on veidi erinev ja vajab mõningast seadistamist.) Just selle seadistamise võtab SkyPlanneri meeskond juurutamise käigus enda kanda.
Autentimine
Fulcrum kasutab päises Authorization Bearer-tokenit. “A public API token can be generated within your fulcrum site via Business Setup -> System Data -> Public Api.” (Avaliku API tokeni saab luua oma Fulcrumi keskkonnas menüüvalikust Business Setup -> System Data -> Public Api.) Igal tokenil on nimi, kirjeldus ja aegumiskuupäev. Tokeneid saab luua nii palju kui vaja ning tokeni kustutamine tühistab selle. Looge SkyPlanneri liidese jaoks eraldi token ja seadke meeldetuletus enne selle aegumist.
SkyPlanneri REST API kasutab autentimiseks API tokenit päises Authorization-Token (SkyPlanner Settings > API). API on dokumenteeritud Swagger/OpenAPI vormingus. Liidestamise õpetus juhendab esimeste päringute tegemisel.
Sündmused ja perioodilised päringud
Fulcrum toetab veebihaake, mida seadistab administraator. Alates 2026. aasta septembrist peatatakse tõrkuvad veebihaagid ja nende toimimist kontrollitakse iga päev, selle asemel et lõputult uuesti proovida. API History loetleb sündmusi, nagu PurchaseOrderUpdated ja ItemUpdated.
Liides loeb Fulcrumist andmeid järgmiselt:
- Avatud töid päritakse iga paari minuti järel, filtreerides olekute
scheduledjainProgressning tingimusehasIncompleteOperations: truejärgi. Fulcrum ise soovitab seda filtrit oma ajakavavaatega samade tulemuste saamiseks. - Ostutellimusi ja laoseisu päritakse enne iga ajakava koostamist või veebihaagi
PurchaseOrderUpdatedkäivitumisel, kui see on seadistatud. - Tooteid, tehnoloogilisi marsruute, seadmeid ja vahetusi päritakse muudatuse korral või igal ööl.
Vastassuunas edastavad SkyPlanneri enda veebihaagid ajakavamuudatused kohe nende tekkimisel, seega on tagasikirjutus sündmuspõhine.
Andmete vastendamine
| Fulcrumi objekt (otspunkt) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Item, Materials (/api/items, /api/materials) | Tooted ja materjalid | Fulcrum → SkyPlanner | Esmane laadimine, seejärel igal ööl |
Tehnoloogilise marsruudi sisendtooted ja -materjalid (/routing/input-items, /input-materials) | Toote struktuur, alamtooted, toote materjalid | Fulcrum → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
Tehnoloogilise marsruudi operatsioonid (/routing/operations): setupTime, laborTime, machineTime (fikseeritud või ühiku kohta), selectedEquipmentIds | Protsessietapid, seadistusajad, kestused, lubatud töökeskused | Fulcrum → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
Work Center (/api/work-centers) | Töökeskuste rühm | Fulcrum → SkyPlanner | Esmane laadimine, hiljem harva |
Equipment (/api/equipment): unlimitedCapacity, canRunUnattended, status | Töökeskused, partiitööd, järelevalveta töötamine | Fulcrum → SkyPlanner | Esmane laadimine, olekut uuendatakse iga päev |
Department Shifts (/api/department-shifts), Equipment Downtimes | Vahetused ja puudumised | Fulcrum → SkyPlanner | Esmane laadimine, seejärel iga päev |
Job ja tööoperatsioonid (/api/jobs, .../items-to-make/{id}/operations): priority, productionDueDate, earliestStartDate, hinnangud | Tellimused ja tööd | Fulcrum → SkyPlanner | Päringud iga paari minuti järel |
| Inventory, Purchase Orders koos Expected Receive kuupäevadega | Laoseis ja saabuv materjal | Fulcrum → SkyPlanner | Enne iga ajakava koostamist |
Tööoperatsiooni customFields (POST .../operations/{operationId}) | Planeeritud algus, planeeritud lõpp, töökeskus | SkyPlanner → Fulcrum | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
Töö customFields (PUT /api/jobs/{jobId}/custom-fields) | Töö planeeritud lõpp | SkyPlanner → Fulcrum | Ajakava muutumisel |
Tööaja jälgimise taimerid, /api/timers, add-quantity-completed, complete | Tööajakirjed, valminud ja praagi kogused | SkyPlanner → Fulcrum | Kui operaatorid tööd registreerivad |
| Fulcrumis puudub | Nimelised operaatorid, seadistusaegade maatriks, piiratud saadavusega tööriistad, alternatiivsed töökeskused | Hallatakse SkyPlanneris | Seadistatakse juurutamise käigus |
Liidestuse töövood
1. Põhiandmete esmane laadimine. Importige tooted, materjalid, tehnoloogilised marsruudid, töökeskused ja seadmed ning seejärel osakondade vahetused ja seisakud. Igast Fulcrumi töökeskusest saab SkyPlanneris töökeskuste rühm, kuhu kuuluvad selle seadmed. Iga marsruudioperatsiooni jaoks valitud seadmetest saavad selle lubatud töökeskused. Unlimited Capacity seadmeid, näiteks ahjusid ja värvikambreid, käsitletakse partiitöödena.
2. Tellimuste sünkroonimine. Lugege sisse avatud tööd koos valmistatavate toodete ja operatsioonidega ning avatud ostutellimused ja laoseis. SkyPlanner loeb tellitud materjali kättesaadavaks ostutellimuse tarnekuupäeval ning uuendab laoseisu, kui ostutellimuse olekuks märgitakse Delivered. Igal ajakava ümberplaneerimisel kontrollitakse laoseisu ja saabuvaid ostusid.
3. Ajakava tagasikirjutus. Fulcrum arvutab väärtused scheduledStartUtc, scheduledEndUtc ja scheduledEquipmentId ise ning tagastab need kirjutuskaitstuna. Operatsiooni uuendamisel saab edastada välja customFields. SkyPlanner kirjutab planeeritud alguse, planeeritud lõpu ja töökeskuse iga tööoperatsiooni kohandatud väljadele ning töö planeeritud lõpu töö kohandatud väljale. Müügi- ja ostutöötajad näevad SkyPlanneri kuupäevi Fulcrumis vastava töö juures.
4. Tööde kinnitamine tootmissaalis. Operaatorid registreerivad tööd SkyPlanneris funktsioonidega Mobile Confirmations, Production Timer või Quick Log Mode. SkyPlanner saadab tööaja Fulcrumi liideste /api/job-tracking-timers/start ja /stop kaudu või lõpetatud ajavahemikuna liidese /api/timers kaudu. Kogused edastatakse liidese add-quantity-completed kaudu ning lõplik kogus koos praagiga liidese complete kaudu. Tööde kuluarvestus Fulcrumis püsib ajakohane.
5. Andmete haldamise ja vastuolude lahendamise reeglid. Fulcrumi ajakavastaja „dictates the order of operations in Job Tracking.” (määrab operatsioonide järjekorra moodulis Job Tracking). Seega valige iga operatsiooni jaoks üks tööde edastamise kanal: SkyPlanneri operaatori tööjärjekord või Fulcrum Job Tracking. Pange reeglid enne kasutuselevõttu kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Artiklid, tehnoloogilised marsruudid, kalkulatsioonid, laoseis, ostud, kuluarvestus | Fulcrum |
| Operatsioonide järjekord, algus- ja lõpuajad, töökeskuse määramine | SkyPlanner |
| Operaatorid, seadistusaegade maatriks, tööriistad, alternatiivsed ressursid | SkyPlanner |
| Vahetused ja seisakud | Üks süsteem, mis valitakse ulatuse määramisel |
| Registreeritud tööaeg ja valminud kogused | SkyPlanner, andmed edastatakse Fulcrumi |
Projekti tavapärased etapid
Juurutamine lõpeb tavaliselt mõne nädala jooksul pärast kasutuselevõtu ettevalmistuste algust. Enne seda saate 30-päevasel tasuta prooviperioodil kasutada oma andmeid. Eksportige artiklid, tehnoloogilised marsruudid ja avatud tööd Fulcrumi tabelitest CSV-vormingusse, importige need SkyPlannerisse ja kontrollige ajakava.
Projekt ise hõlmab järgmisi etappe:
- Pääsutõend ja ulatuse määramine. Looge Public API pääsutõend ja leppige kokku kohandatud väljad andmete tagasikirjutamiseks.
- Vastendamine. Kinnitage vastendustabel, andmete haldamise reeglid ja tööde edastamise kanal.
- Esmane andmete laadimine. Artiklid, materjalid, tehnoloogilised marsruudid, töökeskused, seadmed, vahetused ja seisakud.
- Tellimuste ja ostutellimuste sünkroonimine. Tööde muudatuste perioodiline pärimine ning ostutellimuste ja laoseisu sünkroonimine.
- Piirangute seadistamine SkyPlanneris. Operaatorid ja nende vahetused, seadistusaegade maatriks, tööriistad ja alternatiivsed töökeskused.
- Tagasikirjutamine. Tööde operatsioonide ja tööde kohandatud väljad.
- Tootmissaali andmete edastamine. Taimeriandmete ja koguste saatmine Fulcrumi.
- Paralleelne testimine ja kasutuselevõtt. Kasutage SkyPlannerit paralleelselt Fulcrumi ajakavaga, võrrelge kuupäevi ja parandage põhiandmed. Seejärel hakake töid tootmisse suunama SkyPlanneri ajakava järgi.
Millega Fulcrumi integratsiooni kavandamisel arvestada
- Tööjõu hulk kajastub vahetuse seadmete arvus. Fulcrumi vahetusepõhine Max Equipment „is usually determined by how many people you have working in a certain area at that time.” (sõltub tavaliselt sellest, kui palju inimesi sel ajal konkreetses piirkonnas töötab). Nimelised operaatorid ja nende vahetused seadistatakse SkyPlanneris. Nimed saadakse liidese
/api/userskasutajaandmetest. - Tööd ajastatakse seadmetele. Fulcrumi töökeskused on omavahel asendatavate seadmete rühmad. Hoidke tehnoloogilise marsruudi seadmevalik täpne, sest need seadmed on alternatiivid, mille vahel planeerimismootor valib.
- Tootmistellimused koondavad töid. Tootmistellimus koondab mitme töö operatsioonid, näiteks ühe lõikepaigutuse. Rühmitatud operatsiooni taimeri käivitamisel käivitub hoopis tootmistellimuse taimer, mis hõlmab rühma kõiki tööoperatsioone.
- Taimerite piirangud. Tagantjärele sisestatud
/api/timersajavahemikud „may not be in the future, older than 30 days, or longer than 7 days.” (ei tohi olla tulevikus ega ületada nimetatud vanuse- või kestuspiire). Edastage tööaeg kohe, kui operaatorid selle registreerivad. - Ajavormingud erinevad. Vahetuste puhul kasutatakse kohalikku aega vormingus HHmm, seisakud ja ajakavasse määratud kuupäevad on UTC järgi ning operatsioonide arvestuslik kestus edastatakse sekundites.
- Seadme uuendamine asendab kogu kirje. Seadme PUT-päring tühjendab kõik väljad, mida päring ei sisalda. SkyPlanner ainult loeb seadmeandmeid ega kirjuta neid kunagi.
- ITAR-i keskkonnad. Kasutage
.ushosti ja ITAR-i pääsutõendit.
Kes Fulcrumi integratsiooni seadistab ja toetab?
Töö hõlmab teie osakondade, töökeskuste, seadmete ja tehnoloogiliste marsruutide vastendamist ning nende piirangute seadistamist, mida Fulcrum ei talleta: nimelised operaatorid, seadistusaegade maatriks, tööriistad ja alternatiivsed ressursid.
- SkyPlanneri meeskond seadistab integratsiooni kasutuselevõtu ettevalmistamise käigus ja pakub tuge pärast kasutuselevõttu. Iga tootmisettevõte kasutab Fulcrumit omamoodi ning just siin rakendatakse neid teadmisi.
- Integratsiooni saab luua teie Fulcrumi konsultant või integratsioonipartner. SkyPlanner pakub selleks REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Ka teie enda arendajad saavad selle põhjal lahendusi luua. Alustamiseks piisab API pääsutõendist ja vajaduse korral aitab SkyPlanneri meeskond. Toote dokumentatsiooni, sealhulgas ostutellimuste ning toodete ja materjalide API kirjeldused, leiate SkyPlanneri dokumentatsioonist.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub kord kuus. Integratsiooni hinnapakkumine koostatakse ette, lähtudes teie protsessist ja vajadustest, ning esitatakse koos paketi hinnaga. Nii näete kogukulu enne alustamist. Tutvuge hindade ja funktsioonidega ning vaadake Fulcrumi enda ajakavastaja võrdlust lehelt tootmise planeerimine Fulcrumis tegeliku masina- ja tööjõuvõimsuse piires. Ülevaate leiate Fulcrumi lehelt, teised ERP-d aga ERP-integratsioonide lehelt.
Tootmisettevõtete kogemused SkyPlanneriga
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest reaalajas tootmise optimeerimiseni.“
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ja uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise tõhusus
„Tootmise tõhusus on kasvanud 90%.“
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise tõhusus on kasvanud 90% ja kõiki töökeskusi hõlmava optimeeritud kolmekuulise plaani koostamine võtab alla 30 minuti.
99,2%tarnekindlus
„SkyPlanner on teinud kitsaskohad nähtavaks ja muutnud tootmisjuhtimise selgemaks.“
Toni Tuori, tootmisjuht
Piristeel · Katuseturvatooted ja vihmaveesüsteemid
Tarnekindlus jõudis sel aastal 99,2%-ni ja ajakava koostamisel säästetakse päevas kuni neli tundi tööaega.
98%tarnekindlus varasema ligikaudu 50% asemel
„SkyPlanneril on meie tarnekindluse hoidmisel otsustav roll.“
Hannu Lahtinen, tegevjuht
KJH-Comp · Lehtmetallitööd ja lepinguline tootmine
Tarnekindlus kasvas ligikaudu 50%-lt koguni 98%-ni ning ajakava koostamisega tegeleb nüüd kahe töödejuhataja asemel üks.
Korduma kippuvad küsimused
Kas Fulcrumil on API?
Jah. Fulcrum Public API on REST API, millel on OpenAPI v1 spetsifikatsioon. Autentimiseks kasutatakse Bearer-pääsutõendit, mis luuakse menüüs Business Setup > System Data > Public Api. ITAR-i keskkondades kasutatakse eraldi .us hosti.
Kas SkyPlanner saab ajakava Fulcrumi tagasi kirjutada?
Jah. Fulcrumi enda ajakava kuupäevad on kirjutuskaitstud, seega kirjutab SkyPlanner planeeritud alguse, lõpu ja töökeskuse iga tööoperatsiooni kohandatud väljadele ning planeeritud lõpu ka tööle. Operaatorite tööaeg ja valminud kogused edastatakse tagasi taimeriandmete ja koguseuuendustena.
Kas Fulcrum edastab muudatusi reaalajas?
Fulcrumil on administraatori seadistatavad veebihaagid sündmustega nagu PurchaseOrderUpdated. Avatud töid päritakse iga mõne minuti järel sama filtriga, mida Fulcrum kasutab oma ajakavalehel. SkyPlanneri enda veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
Kes loob Fulcrumi integratsiooni?
SkyPlanneri meeskond seadistab kahesuunalise integratsiooni kasutuselevõtu ettevalmistamise käigus ja pakub tuge pärast kasutuselevõttu. Lahenduse saavad SkyPlanneri dokumenteeritud REST API põhjal luua ka teie Fulcrumi konsultant, integratsioonipartner või teie enda arendajad.
Kas saame SkyPlannerit enne integratsiooni loomist testida?
Jah. 30-päevasel tasuta prooviperioodil saate kasutada kuni 20 töökeskust ja importida andmeid Fulcrumist CSV-failidena. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata integratsiooni ulatus.
