Guide til Fulcrum-integrasjon for produksjonsplanlegging med SkyPlanner APS

Fulcrum er ett skyprodukt med flerleietakerarkitektur, så alle kunder bruker samme API. Utviklerportalen beskriver det som et offentlig API for «REST API calls directly into your Fulcrum site.» (REST API-kall direkte til Fulcrum-miljøet ditt).

• Spesifikasjon. OpenAPI «Fulcrum PublicAPI» v1 kan lastes ned fra https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum anbefaler å generere en typet klient fra spesifikasjonen. History-siden viser alle endringer med dato.
• Verter. https://api.fulcrumpro.com brukes for standardmiljøer. ITAR-miljøer bruker api.fulcrumpro.us, og ITAR-tokener får svarkoden 401 fra .com-verten.
• Kallmønster. Lister hentes med POST .../list, med filter i forespørselskroppen, sideinndeling via Skip og Take og sortering via Sort.Field / Sort.Dir. Mange objekter støtter PUT, og jobber støtter også JSON Patch.

Endepunktene som brukes i en integrasjon for produksjonsplanlegging:

Fulcrums egen integrasjonsside er tydelig om arbeidet: «Every system is a little bit different and requires some configuration.» (Alle systemer er litt forskjellige og krever noe konfigurering.) Det er nettopp denne konfigureringen SkyPlanner-teamet tar seg av under innføringen.

Fulcrum støtter webhooks som konfigureres av en administrator. Siden september 2026 settes webhooks som feiler, på pause og testes på nytt daglig, i stedet for at nye forsøk fortsetter i det uendelige. API-ets History-side oppgir hendelser som PurchaseOrderUpdated og ItemUpdated.

Integrasjonen henter data fra Fulcrum slik:

• Åpne jobber hentes med noen minutters mellomrom, filtrert på scheduled og inProgress med hasIncompleteOperations: true. Dette er filteret Fulcrum selv oppgir for å få samme utvalg som på planleggingssiden.
• Innkjøpsordrer og lagerbeholdning hentes før hver planleggingskjøring, eller ved en PurchaseOrderUpdated-webhook der denne er konfigurert.
• Varer, produksjonsruter, utstyr og skift hentes ved endringer eller hver natt.

I motsatt retning sender SkyPlanners egne webhooks planendringer fortløpende. Tilbakeskrivingen er dermed hendelsesstyrt.

1. Førstegangsinnlasting av grunndata. Hent varer, materialer, produksjonsruter, arbeidssentre og utstyr, deretter avdelingsskift og driftsstans. Hvert arbeidssenter i Fulcrum blir en gruppe av arbeidsstasjoner i SkyPlanner, med utstyret som medlemmer. Utstyret som er valgt for hver operasjon i produksjonsruten, blir operasjonens tillatte arbeidsstasjoner. Utstyr med Unlimited Capacity, som ovner og lakkeringsbokser, blir batchjobber.

2. Ordresynkronisering. Hent åpne jobber med tilhørende varer som skal produseres og operasjoner, samt åpne innkjøpsordrer og lagerbeholdning. SkyPlanner regner bestilte materialer som tilgjengelige på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered. Ved hver omplanlegging kontrolleres lagerbeholdning og innkommende innkjøp.

3. Tilbakeskriving av planen. Fulcrum beregner selv scheduledStartUtc, scheduledEndUtc og scheduledEquipmentId og returnerer dem som skrivebeskyttede verdier. Ved oppdatering av operasjoner godtas customFields. SkyPlanner skriver planlagt start, planlagt slutt og arbeidsstasjon til egendefinerte felt på hver jobboperasjon, og planlagt slutt til et egendefinert felt på jobben. Salg og innkjøp ser datoene fra SkyPlanner på jobben i Fulcrum.

4. Registreringer fra produksjonsgulvet. Operatørene registrerer arbeid i SkyPlanner med Mobile Confirmations, Production Timer eller Quick Log Mode. SkyPlanner sender tiden til Fulcrum via /api/job-tracking-timers/start og /stop, eller som en avsluttet tidsblokk via /api/timers. Mengder sendes via add-quantity-completed, og sluttantallet med vrak via complete. Jobbkostnadene i Fulcrum holdes løpende oppdatert.

5. Regler for eierskap og konflikter. Planleggingsfunksjonen i Fulcrum «dictates the order of operations in Job Tracking.» (bestemmer rekkefølgen på operasjonene i Job Tracking). Velg derfor én kanal for tildeling av arbeid per operasjon: operatørkøen i SkyPlanner eller Fulcrum Job Tracking. Skriv ned reglene før produksjonssetting:

• Bemanningen gjenspeiles i antallet per skift. Max Equipment per shift i Fulcrum «is usually determined by how many people you have working in a certain area at that time.» (bestemmes vanligvis av hvor mange som arbeider i et bestemt område på det tidspunktet). Navngitte operatører og skiftene deres settes opp i SkyPlanner. Navnene hentes fra brukerne i /api/users.
• Arbeidet planlegges på utstyr. Arbeidssentre i Fulcrum er grupper av utstyr som kan brukes om hverandre. Sørg for at utstyrsvalgene i produksjonsruten er riktige, siden disse blir alternativene planleggingsmotoren velger mellom.
• Produksjonsordrer grupperer jobber. En produksjonsordre samler operasjoner fra flere jobber, for eksempel i et skjærereir. Når tidtaking startes på en gruppert operasjon, startes i stedet tidtakingen for produksjonsordren. Den omfatter alle jobboperasjonene i gruppen.
• Grenser for tidsregistrering. Etterregistrerte tidsblokker i /api/timers «may not be in the future, older than 30 days, or longer than 7 days.» (kan ikke ligge i fremtiden eller overskride de oppgitte grensene for alder og varighet). Overfør tiden etter hvert som operatørene registrerer den.
• Tidsformatene varierer. Skift bruker lokale klokkeslett i HHmm-format, driftsstans og planlagte datoer angis i UTC, og tidsestimater for operasjoner oppgis i sekunder.
• Utstyrsoppdateringer erstatter hele posten. En PUT-forespørsel for utstyr tømmer alle felt som ikke er med i forespørselen. SkyPlanner leser utstyrsdata og skriver aldri til dem.
• ITAR-miljøer. Bruk verten på .us og et ITAR-token.