Handleiding voor de Fulcrum-integratie voor productieschema’s met SkyPlanner APS

Fulcrum is één multi-tenant cloudproduct, dus alle klanten gebruiken dezelfde API. De ontwikkelaarsportal beschrijft deze als een openbare API voor “REST API calls directly into your Fulcrum site.” (REST API-aanroepen rechtstreeks naar uw Fulcrum-omgeving).

• Specificatie. OpenAPI “Fulcrum PublicAPI” v1, te downloaden via https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum raadt aan om hiermee een getypeerde client te genereren. Op de pagina History staan alle wijzigingen met datum.
• Hosts. https://api.fulcrumpro.com voor standaardomgevingen. ITAR-omgevingen gebruiken api.fulcrumpro.us. ITAR-tokens krijgen op de .com-host een 401-respons.
• Opzet. Lijsten worden opgevraagd met POST .../list, met een filter in de requestbody, paginering via Skip en Take en sortering via Sort.Field / Sort.Dir. Veel objecten ondersteunen PUT; taken ondersteunen ook JSON Patch.

Een integratie voor productieschema’s gebruikt de volgende endpoints:

Fulcrum is op zijn eigen integratiepagina duidelijk over het benodigde werk: “Every system is a little bit different and requires some configuration.” (Elk systeem is net iets anders en vraagt om enige configuratie.) Precies die configuratie neemt het SkyPlanner-team tijdens de onboarding voor zijn rekening.

Fulcrum ondersteunt webhooks, die door een beheerder worden ingesteld. Sinds september 2026 worden webhooks die mislukken gepauzeerd en dagelijks opnieuw getest, in plaats van eindeloos opnieuw te worden geprobeerd. De API History vermeldt events zoals PurchaseOrderUpdated en ItemUpdated.

De integratie leest Fulcrum als volgt uit:

• Openstaande taken worden om de paar minuten opgehaald, gefilterd op scheduled en inProgress met hasIncompleteOperations: true. Dit is het filter dat Fulcrum zelf opgeeft om dezelfde selectie als op de planningspagina te krijgen.
• Inkooporders en voorraad worden vóór elke planningsrun opgehaald, of bij een PurchaseOrderUpdated-webhook als die is ingesteld.
• Artikelen, bewerkingsvolgorden, machines en diensten worden bij wijzigingen of elke nacht opgehaald.

In de andere richting sturen de eigen webhooks van SkyPlanner planningswijzigingen direct door. Het terugschrijven is dus eventgestuurd.

1. Eerste import van stamgegevens. Haal artikelen, materialen, bewerkingsvolgorden, werkcentra en machines op, gevolgd door afdelingsdiensten en stilstandstijden. Elk werkcentrum in Fulcrum wordt in SkyPlanner een groep werkcentra met de bijbehorende machines als leden. De machines die voor elke bewerking in de bewerkingsvolgorde zijn geselecteerd, worden de toegestane werkcentra voor die bewerking. Machines met Unlimited Capacity, zoals ovens en spuitcabines, worden als batchtaken gemodelleerd.

2. Ordersynchronisatie. Lees openstaande taken in met de te produceren artikelen en bewerkingen, plus openstaande inkooporders en voorraad. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra die order als Delivered is gemarkeerd. Bij elke herplanning worden de voorraad en verwachte inkopen gecontroleerd.

3. Het productieschema terugschrijven. Fulcrum berekent scheduledStartUtc, scheduledEndUtc en scheduledEquipmentId zelf en geeft ze als alleen-lezenvelden terug. Bij het bijwerken van een bewerking wordt customFields geaccepteerd. SkyPlanner schrijft de geplande start, het geplande einde en het werkcentrum naar aangepaste velden van elke bewerking van een taak. Het geplande einde wordt ook naar een aangepast veld van de taak geschreven. Verkoop en inkoop zien de datums van SkyPlanner bij de taak in Fulcrum.

4. Terugmeldingen vanaf de productievloer. Operators registreren hun werk in SkyPlanner met Mobile Confirmations, Production Timer of Quick Log Mode. SkyPlanner stuurt de geregistreerde tijd naar Fulcrum via /api/job-tracking-timers/start en /stop, of als afgesloten tijdblok via /api/timers. Aantallen worden doorgegeven via add-quantity-completed, en het definitieve aantal inclusief uitval via complete. De kostencalculatie per taak in Fulcrum blijft actueel.

5. Afspraken over eigenaarschap en conflicten. De planningsfunctie van Fulcrum “dictates the order of operations in Job Tracking.” (bepaalt de volgorde van bewerkingen in Job Tracking). Kies daarom per bewerking één kanaal voor de werkaansturing: de takenlijst voor operators in SkyPlanner of Fulcrum Job Tracking. Leg de afspraken vóór ingebruikname vast:

• Personeelscapaciteit wordt uitgedrukt in aantallen per dienst. Fulcrums Max Equipment per dienst “is usually determined by how many people you have working in a certain area at that time.” (wordt meestal bepaald door het aantal mensen dat op dat moment in een bepaalde zone werkt). Individuele operators en hun diensten worden in SkyPlanner ingesteld. De gebruikers in /api/users leveren de namen.
• De planning gebeurt op machineniveau. Werkcentra in Fulcrum zijn groepen onderling uitwisselbare machines. Zorg dat de geselecteerde machines in de bewerkingsvolgorde kloppen: dit zijn de alternatieven waaruit de planningsengine kiest.
• Productieorders groeperen taken. Een productieorder groepeert bewerkingen van meerdere taken, bijvoorbeeld in een nest. Als u een timer start op een gegroepeerde bewerking, start in plaats daarvan de timer van de productieorder. Die omvat alle taakbewerkingen in de groep.
• Beperkingen voor tijdregistraties. Achteraf ingevoerde tijdblokken via /api/timers “may not be in the future, older than 30 days, or longer than 7 days.” (mogen niet in de toekomst liggen of de genoemde grenzen voor ouderdom en duur overschrijden). Stuur de tijden door zodra operators ze registreren.
• Tijdnotaties verschillen. Diensten gebruiken lokale HHmm-waarden, stilstand en geplande datums staan in UTC en de geschatte bewerkingsduur wordt in seconden aangeleverd.
• Machine-updates vervangen het volledige record. Een PUT voor een machine maakt elk niet-meegestuurd veld leeg. SkyPlanner leest machinegegevens alleen en schrijft ze nooit weg.
• ITAR-omgevingen. Gebruik de .us-host en een ITAR-token.