Integrasjonsguide for Business Central: produksjonsplanlegging med SkyPlanner APS

Integrasjonen bruker to grensesnitt som allerede følger med Business Central:

1. API v2.0 for salgs-, innkjøps- og lagerdata. Det gir tilgang til items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers og employees. Det har ingen produksjonsentiteter, så produksjonsdata hentes gjennom det andre grensesnittet.
2. OData v4-nettjenester for produksjon. Alle sider i Business Central kan publiseres som OData v4-nettjenester fra siden Web Services. Velg objekttypen Page, side-ID og et tjenestenavn, og merk deretter av for Published. Da er endepunktet tilgjengelig, uten AL-kode og uten at du må distribuere en utvidelse. Integrasjonen publiserer standardsidene for frigitte produksjonsordrer, Prod. Order Routing Lines, arbeidssentre, maskinsentre og produksjonsruter. De er tilgjengelige under /ODataV4/Company('{name}')/{ServiceName}.

Publiserte sider støtter både lesing og skriving. Microsoft skriver: «If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,» (Hvis en redigerbar side gjøres tilgjengelig som en nettjeneste, kan dataene i den underliggende tabellen leses og endres med et OData-kall), med PATCH for oppdateringer. Slik skrives planlagte datoer tilbake til Business Central, gjennom samme side og med samme validering som planleggeren bruker.

Dropp SOAP. Microsoft har merket SOAP-nettjenester som foreldet, og muligheten til å publisere Microsofts brukergrensesnittsider som SOAP fjernes i 2026 release wave 2 (v29).

Business Central støtter webhook-abonnementer via POST /api/v2.0/subscriptions for API v2.0-entiteter som items og salesOrders. Følgende regler gjelder:

• Når et abonnement opprettes, kreves en håndtrykksutveksling: Endepunktet ditt må returnere validationToken med 200 OK.
• Abonnementer utløper etter tre dager. Forny med PATCH, så kjøres håndtrykket på nytt.
• Varslene inneholder ressursbanen, changeType og din clientState, ikke hele posten. Selve posten henter du etterpå.
• Varslene er forsinket: Business Central online venter 30 sekunder etter den første endringen. Hvis mer enn 1 000 poster endres i dette tidsrommet, sendes de som ett collection-varsel.
• Maksimalt 200 webhook-abonnementer per miljø i nettversjonen.

Produksjonsordrer, produksjonsrutelinjer og innkjøpsordrer hentes med noen minutters mellomrom fra de publiserte sidene og fra purchaseOrders. Ved å filtrere på åpne ordrer og hente data sidevis holdes antallet forespørsler godt innenfor grensene i Business Central.

SkyPlanner sender webhooks når tilstanden eller planen endres, så tilbakeskrivingen er hendelsesstyrt.

1. Første innlasting av grunndata. Hent produksjonsruter og produksjonsstykklister med status Certified samt arbeidssentre og maskinsentre fra de publiserte sidene. Hent varer og måleenheter fra API v2.0. Avklar hvordan hvert arbeids- eller maskinsenter skal kobles til en arbeidsstasjon i SkyPlanner: Skal et arbeidssenter med tre maskinsentre bli én arbeidsstasjonsgruppe eller tre arbeidsstasjoner?

2. Ordresynkronisering. Les produksjonsordrer med status Released (og Firm Planned hvis dere planlegger dem), med tilhørende produksjonsrutelinjer og komponenter, fra de publiserte sidene. Hent også åpne innkjøpsordrelinjer fra API v2.0. SkyPlanner regner bestilt materiale som tilgjengelig på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes Delivered. Planen tar dermed hensyn til både lagerbeholdning og innkommende innkjøp.

Planlegg aldri produksjonsordrer med status Planned: Microsoft sier at Business Central «deletes them the next time you run planning.» (sletter dem neste gang du kjører planlegging). Planning Worksheet fortsetter å foreslå forsyninger, mens SkyPlanner planlegger de fastlagte ordrene mot faktisk kapasitet.

3. Tilbakeskriving av planen. Standardsiden Prod. Order Routing publiseres som en OData v4-nettjeneste. For hver operasjon motoren har plassert eller flyttet, sender SkyPlanner en PATCH til den aktuelle produksjonsrutelinjen med ETag i If-Match. Den angir Starting Date-Time og Ending Date-Time, samt Type og No. når operasjonen er flyttet til en alternativ maskin.

PATCH kjører side- og tabelltriggerne, slik at Business Central validerer feltene med sin egen logikk, akkurat som når en planlegger redigerer siden Prod. Order Routing. Produksjonsordrelinjens Starting og Ending Date-Time oppdateres tilsvarende. Business Central beholder ansvaret for mengder, status og kostnader.

4. Tilbakemeldinger fra produksjonen. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringene holder planen oppdatert. Produsert mengde kan rapporteres i Business Central som før, fra Production Journal eller Output Journal.

Hvis dere vil bokføre produsert mengde og forbruk helt automatisk, legges det til en standard API-side i Business Central for bokføring i avgangskladden. SkyPlanner bokfører da omstillingstid, kjøretid og produsert mengde per operasjon. Bokføringen oppdaterer Capacity Ledger Entries, og rapportert produsert mengde på siste operasjon i produksjonsruten legger varen til lagerbeholdningen.

Velg én kanal for bokføring av produsert mengde. Bokføring fra både SkyPlanner og Production Journal i Business Central gir doble posteringer.

5. Regler for dataeierskap og konflikter. Skriv dem ned før produksjonssetting:

Den viktigste kilden til konflikter er Refresh og Replan på produksjonsordrer. Microsoft skriver: «If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.» (Hvis du bruker handlingen Refresh til å beregne produksjonsordrelinjer på nytt, sletter Business Central de eksisterende produksjonsordrelinjene og beregner nye.) Replan kan også endre kapasitetsbehovet, og ny beregning av komponenter «deletes previous changes in the components.» (sletter tidligere endringer i komponentene).

Behandle en oppdatert ordre som en ny versjon, synkroniser den på nytt, og la SkyPlanner planlegge den på nytt. Med Autopilot planlegger SkyPlanner automatisk på nytt når produksjonen endres.

• Enheter i produksjonsruter. Setup Time gjelder per produksjonsordre, Run Time per produsert vare, og begge har sin egen Unit of Measure Code. Wait Time og Move Time bruker ikke kapasitet på arbeidssenteret. Hvis arbeidssenterets enhet er Days, er én dag 24 timer, ikke et skift på åtte timer. Konverter ved import, ellers blir alle varigheter feil.
• Utdaterte kalendere. Kapasitet finnes først når Calculate Work Center Calendar er kjørt for planleggingshorisonten. Kontroller feltet Calendar Entries Available Until før første innlasting.
• Skjult maskinsenterkapasitet. Når Consolidated Calendar er slått av, planlegges bare arbeidssenterets egen kapasitet: «The machine center capacity is excluded.» (Maskinsenterets kapasitet er ikke inkludert.) Les maskinsenterets kapasitet direkte i stedet for å stole på arbeidssenterets totaler.
• Capacity og Efficiency. Business Central beregner varighet som Run Time / Efficiency / Capacity, og de beregnede kalenderpostene inkluderer allerede begge faktorene. Koble Efficiency til arbeidsstasjonens effektivitet i SkyPlanner én gang, ikke to.
• Alternate Work Center er bare til informasjon. Microsoft skriver at det «isn’t automatically included in planning processes.» (ikke tas med automatisk i planleggingsprosesser). Legg alternativene eksplisitt inn som alternative arbeidsstasjoner i SkyPlanner.
• Begrensning av forespørsler. Grensene i nettversjonen gjelder per bruker, og en tjenestekontohaver regnes som én bruker: 6 000 OData-forespørsler i et rullerende tidsvindu på 5 minutter og 5 samtidige forespørsler. Sidestørrelsen er begrenset til 20 000, en $batch til 100 operasjoner, og en operasjon får tidsavbrudd etter 8 minutter. Hvis forespørselsgrensen overskrides, returneres 429. Bruk batcher, sidevis henting og polling av endringer i stedet for å laste inn alt på nytt.
• Lisensiering. Produksjonsfunksjonene finnes bare i Premium. Brukere med Essentials kan ikke logge på et selskap som er satt til Premium.