Ghid de integrare Fulcrum pentru programarea producției cu SkyPlanner APS

Fulcrum este un singur produs cloud cu arhitectură multi-tenant, astfel că toți clienții folosesc același API. Portalul pentru dezvoltatori îl descrie ca pe un API public pentru “REST API calls directly into your Fulcrum site.” (apeluri REST API direct către instanța dumneavoastră Fulcrum).

• Specificație. OpenAPI “Fulcrum PublicAPI” v1, disponibilă pentru descărcare la https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum recomandă generarea unui client cu tipuri de date pe baza acesteia. Pagina History prezintă fiecare modificare și data ei.
• Gazde. https://api.fulcrumpro.com pentru instanțele standard. Instanțele ITAR folosesc api.fulcrumpro.us, iar tokenurile ITAR primesc răspunsul 401 pe gazda .com.
• Convenții. Listele se obțin prin POST .../list, cu filtre în corpul cererii, paginare prin Skip și Take și sortare prin Sort.Field / Sort.Dir. Multe obiecte acceptă PUT, iar lucrările acceptă și JSON Patch.

Endpointurile folosite de o integrare pentru programarea producției:

Pagina de integrări Fulcrum spune clar ce presupune acest lucru: “Every system is a little bit different and requires some configuration.” (Fiecare sistem este puțin diferit și necesită anumite configurări.) Echipa SkyPlanner se ocupă exact de aceste configurări în etapa de implementare.

Fulcrum acceptă webhookuri, configurate de un administrator. Din septembrie 2026, webhookurile care eșuează sunt suspendate și retestate zilnic, în loc ca încercările să se repete la nesfârșit. API History menționează evenimente precum PurchaseOrderUpdated și ItemUpdated.

Integrarea citește datele din Fulcrum astfel:

• Lucrările deschise se interoghează la fiecare câteva minute, filtrate după scheduled și inProgress, cu hasIncompleteOperations: true. Acesta este filtrul recomandat chiar de Fulcrum pentru a obține aceleași rezultate ca în pagina sa de programare.
• Comenzile de achiziție și stocurile se citesc înainte de fiecare rulare a programării sau la primirea unui webhook PurchaseOrderUpdated, dacă acesta este configurat.
• Articolele, fluxurile tehnologice, echipamentele și schimburile se citesc la modificare sau în fiecare noapte.

În sens invers, webhookurile proprii SkyPlanner transmit modificările programului imediat ce apar, astfel că scrierea datelor înapoi în Fulcrum este declanșată de evenimente.

1. Încărcarea inițială a nomenclatoarelor. Preluați articolele, materialele, fluxurile tehnologice, centrele de lucru și echipamentele, apoi schimburile pe departamente și perioadele de indisponibilitate. Fiecare centru de lucru Fulcrum devine un grup de centre de lucru în SkyPlanner, având ca membri echipamentele sale. Echipamentele selectate pentru fiecare operație din fluxul tehnologic devin centrele de lucru permise pentru acea operație. Echipamentele cu Unlimited Capacity, precum cuptoarele și cabinele de vopsire, devin operații pe loturi.

2. Sincronizarea comenzilor. Citiți lucrările deschise cu articolele de fabricat și operațiile aferente, precum și comenzile de achiziție deschise și stocurile. SkyPlanner consideră materialul comandat disponibil la data de livrare a comenzii de achiziție și actualizează stocul când comanda este marcată Delivered. La fiecare reprogramare, sistemul verifică stocurile și achizițiile în curs de livrare.

3. Scrierea programului înapoi în Fulcrum. Fulcrum calculează singur scheduledStartUtc, scheduledEndUtc și scheduledEquipmentId și le returnează doar pentru citire. Actualizarea operației acceptă customFields. SkyPlanner scrie începutul planificat, sfârșitul planificat și centrul de lucru în câmpuri personalizate pentru fiecare operație a lucrării, iar sfârșitul planificat într-un câmp personalizat al lucrării. Echipele de vânzări și achiziții văd datele SkyPlanner în lucrarea din Fulcrum.

4. Confirmări din secția de producție. Operatorii înregistrează activitatea în SkyPlanner folosind Mobile Confirmations, Production Timer sau Quick Log Mode. SkyPlanner transmite timpul în Fulcrum prin /api/job-tracking-timers/start și /stop sau ca interval încheiat prin /api/timers. Cantitățile se transmit prin add-quantity-completed, iar cantitatea finală, inclusiv rebuturile, prin complete. Calculul costurilor pe lucrări în Fulcrum rămâne actualizat în timp real.

5. Responsabilitatea asupra datelor și regulile pentru conflicte. Modulul de programare din Fulcrum „dictates the order of operations in Job Tracking.” (stabilește ordinea operațiilor în Job Tracking). Alegeți, așadar, pentru fiecare operație un singur canal de transmitere către producție: lista operatorului din SkyPlanner sau Fulcrum Job Tracking. Documentați regulile înainte de punerea în funcțiune:

• Capacitatea de personal se reflectă în efectivele pe schimb. Parametrul Max Equipment per shift din Fulcrum „is usually determined by how many people you have working in a certain area at that time.” (este determinat, de regulă, de numărul persoanelor care lucrează într-o anumită zonă la momentul respectiv). Operatorii nominalizați și schimburile lor se configurează în SkyPlanner. Numele se obțin din utilizatorii returnați de /api/users.
• Programarea se face pe echipamente. Centrele de lucru din Fulcrum sunt grupuri de echipamente interschimbabile. Asigurați-vă că echipamentele selectate în fluxul tehnologic sunt corecte: acestea devin alternativele dintre care alege motorul de programare.
• Comenzile de producție grupează lucrări. O comandă de producție grupează operații din mai multe lucrări, de exemplu pentru o debitare comună pe aceeași tablă. Pornirea cronometrării pentru o operație grupată pornește, de fapt, cronometrul comenzii de producție, care acoperă toate operațiile lucrărilor din grup.
• Limitele înregistrărilor de timp. Intervalele înregistrate retroactiv prin /api/timers „may not be in the future, older than 30 days, or longer than 7 days.” (nu pot fi în viitor și nu pot depăși limitele indicate de vechime și durată). Transmiteți timpii pe măsură ce operatorii îi înregistrează.
• Formatele de timp diferă. Schimburile folosesc ora locală în format HHmm, perioadele de indisponibilitate și datele programate sunt în UTC, iar duratele estimate ale operațiilor sunt exprimate în secunde.
• Actualizarea unui echipament înlocuiește întreaga înregistrare. O cerere PUT pentru un echipament golește orice câmp care nu este inclus. SkyPlanner doar citește datele echipamentelor, nu le scrie niciodată.
• Instanțe ITAR. Folosiți gazda .us și un token ITAR.