Guide till Fulcrum-integration för produktionsplanering med SkyPlanner APS

Fulcrum är en gemensam molnprodukt med flera klientorganisationer, så alla kunder använder samma API. I utvecklarportalen beskrivs det som ett publikt API för ”REST API calls directly into your Fulcrum site.” (REST API-anrop direkt till er Fulcrum-miljö).

• Specifikation. OpenAPI ”Fulcrum PublicAPI” v1 kan laddas ned från https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum föreslår att en typad klient genereras utifrån den. På sidan History listas alla ändringar med datum.
• Värdar. https://api.fulcrumpro.com används för standardmiljöer. ITAR-miljöer använder api.fulcrumpro.us, och ITAR-token får svaret 401 från .com-värden.
• Anropsmönster. Listor hämtas med POST .../list och filter i anropskroppen, sidindelning med Skip och Take samt sortering med Sort.Field / Sort.Dir. Många objekt stöder PUT, och jobb stöder även JSON Patch.

En integration för produktionsplanering använder följande ändpunkter:

Fulcrums egen integrationssida är tydlig med vad arbetet innebär: ”Every system is a little bit different and requires some configuration.” (Alla system skiljer sig lite åt och kräver viss konfigurering.) Det är just den konfigureringen som SkyPlanner-teamet tar hand om under införandet.

Fulcrum stöder webhooks som konfigureras av en administratör. Sedan september 2026 pausas webhooks som misslyckas och testas på nytt dagligen, i stället för att försöken fortsätter i all oändlighet. I API-historiken anges händelser som PurchaseOrderUpdated och ItemUpdated.

Integrationen läser data från Fulcrum på följande sätt:

• Öppna jobb filtreras på scheduled och inProgress med hasIncompleteOperations: true och hämtas med några minuters mellanrum. Det är det filter som Fulcrum självt anger för att matcha innehållet på sin planeringssida.
• Inköpsorder och lagersaldon hämtas före varje planeringskörning, eller när en PurchaseOrderUpdated-webhook utlöses där en sådan har konfigurerats.
• Artiklar, operationsföljder, utrustning och skift hämtas vid ändring eller varje natt.

I motsatt riktning skickar SkyPlanners egna webhooks planändringar så snart de sker. Återföringen är alltså händelsestyrd.

1. Första inläsningen av grunddata. Hämta artiklar, material, operationsföljder, produktionsgrupper och utrustning, och därefter avdelningsskift och stillestånd. Varje produktionsgrupp i Fulcrum blir en grupp av produktionsgrupper i SkyPlanner, med den tillhörande utrustningen som medlemmar. Den utrustning som valts för varje operation i operationsföljden blir operationens tillåtna produktionsgrupper. Utrustning med Unlimited Capacity, till exempel ugnar och lackeringsbås, blir batchoperationer.

2. Ordersynkronisering. Läs in öppna jobb med tillhörande artiklar som ska tillverkas och operationer, samt öppna inköpsorder och lagersaldon. SkyPlanner betraktar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagersaldot när inköpsordern markeras som Delivered. Vid varje omplanering kontrolleras lagersaldon och inkommande inköp.

3. Återskrivning av planen. Fulcrum beräknar själv scheduledStartUtc, scheduledEndUtc och scheduledEquipmentId och returnerar dem som skrivskyddade värden. Vid uppdatering av en operation accepteras customFields. SkyPlanner skriver planerad start, planerat slut och produktionsgrupp till anpassade fält på varje orderoperation, och planerat slut till ett anpassat fält på ordern. Försäljning och inköp ser SkyPlanners datum på ordern i Fulcrum.

4. Återrapportering från produktionsgolvet. Operatörerna registrerar arbete i SkyPlanner med Mobile Confirmations, Production Timer eller Quick Log Mode. SkyPlanner skickar tiden till Fulcrum via /api/job-tracking-timers/start och /stop, eller som ett avslutat tidsblock via /api/timers. Antal rapporteras via add-quantity-completed, och slutantalet inklusive kassation via complete. Orderkalkylen i Fulcrum hålls uppdaterad.

5. Regler för dataägarskap och konflikter. Fulcrums planeringsfunktion ”dictates the order of operations in Job Tracking.” (styr operationsordningen i Job Tracking). Välj därför en kanal för arbetsfördelning per operation: SkyPlanners operatörskö eller Fulcrum Job Tracking. Dokumentera reglerna före driftstart:

• Bemanningen avspeglas i antalet per skift. Fulcrums Max Equipment per skift ”is usually determined by how many people you have working in a certain area at that time.” (bestäms vanligtvis av hur många personer som arbetar i ett visst område vid den tidpunkten). Namngivna operatörer och deras skift läggs upp i SkyPlanner. Namnen hämtas från användarna i /api/users.
• Planeringen görs mot utrustning. Produktionsgrupper i Fulcrum består av utbytbar utrustning. Se till att rätt utrustning är vald i operationsföljden, eftersom valet avgör vilka alternativ planeringsmotorn kan välja mellan.
• Tillverkningsorder grupperar order. En tillverkningsorder samlar operationer från flera order, till exempel i en skärlayout. När tidtagning startas på en grupperad operation startas i stället tillverkningsorderns tidtagning, som omfattar alla orderoperationer i gruppen.
• Gränser för tidregistrering. Retroaktiva tidsblock i /api/timers ”may not be in the future, older than 30 days, or longer than 7 days.” (får inte ligga i framtiden eller överskrida de angivna gränserna för ålder och längd). Överför tiden allteftersom operatörerna registrerar den.
• Tidsformaten skiljer sig åt. Skift använder lokal tid i formatet HHmm. Stillestånd och planerade datum anges i UTC, medan beräknade operationstider anges i sekunder.
• Uppdateringar av utrustning ersätter hela posten. Ett PUT-anrop för utrustning tömmer alla fält som inte ingår i anropet. SkyPlanner läser utrustningsdata men skriver aldrig till dem.
• ITAR-miljöer. Använd värden med .us och en ITAR-token.