Guide til integration med Business Central til detailplanlægning med SkyPlanner APS

Integrationen bruger to grænseflader, der allerede følger med Business Central:

1. API v2.0 til handels- og lagerdata. Det stiller items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers og employees til rådighed. Det har ingen produktionsentiteter, så produktionsdata hentes via den anden grænseflade.
2. OData v4-webtjenester til produktion. Alle Business Central-sider kan publiceres som OData v4-webtjenester på siden Web Services. Vælg objekttypen Page, sidens ID og et tjenestenavn, og markér derefter Published. Så er endpointet aktivt, uden AL-kode og uden en udvidelse, der skal installeres. Integrationen publicerer standardsiderne for frigivne produktionsordrer, Prod. Order Routing Lines, arbejdscentre, maskincentre og ruter, som tilgås via /ODataV4/Company('{name}')/{ServiceName}.

Publicerede sider giver både læse- og skriveadgang. 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 udstilles som en webservice, kan data i den underliggende tabel læses og ændres via et OData-kald). Opdateringer sker med PATCH. Sådan skrives planlagte datoer tilbage til Business Central gennem den samme side og med den samme validering, som planlæggeren bruger.

Undlad SOAP. Microsoft har markeret SOAP-webservices som forældede, og muligheden for at publicere Microsofts brugergrænsefladesider som SOAP fjernes i 2026 release wave 2 (v29).

Business Central understøtter webhook-abonnementer via POST /api/v2.0/subscriptions på API v2.0-entiteter som items og salesOrders. Følgende regler gælder:

• Oprettelse af et abonnement kræver et handshake: dit endpoint skal returnere validationToken med 200 OK.
• Abonnementer udløber efter tre dage. Forny dem med PATCH, så gennemføres handshaket igen.
• Notifikationer indeholder ressourcestien, changeType og din clientState, ikke hele posten. Du henter posten bagefter.
• Notifikationer sendes med forsinkelse: Business Central online venter 30 sekunder efter den første ændring. Hvis mere end 1.000 poster ændres i det tidsrum, sendes de som én collection-notifikation.
• Højst 200 webhook-abonnementer pr. onlinemiljø.

Produktionsordrer, rutelinjer og købsordrer hentes med polling med få minutters mellemrum fra de publicerede sider og purchaseOrders. Filtrering på åbne ordrer og sideopdeling holder antallet af forespørgsler et godt stykke under grænserne i Business Central.

SkyPlanner sender webhooks, når tilstanden eller tidsplanen ændres. Tilbageskrivningen er derfor hændelsesstyret.

1. Første indlæsning af stamdata. Hent ruter og produktionsstyklister med status Certified samt arbejds- og maskincentre fra de publicerede sider. Hent varer og måleenheder fra API v2.0. Tag bevidst stilling til, hvordan hvert arbejds- eller maskincenter skal svare til en arbejdsstation i SkyPlanner: Skal et arbejdscenter med tre maskincentre blive til én arbejdsstationsgruppe eller tre arbejdsstationer?

2. Ordresynkronisering. Læs produktionsordrer med status Released og deres rutelinjer og komponenter fra de publicerede sider. Medtag også ordrer med status Firm Planned, hvis I detailplanlægger dem. Hent desuden åbne købsordrelinjer fra API v2.0. SkyPlanner betragter bestilte materialer som tilgængelige på købsordrens leveringsdato og opdaterer lagerbeholdningen, når købsordren markeres som Delivered. Tidsplanen tager dermed højde for både lagerbeholdningen og kommende indkøb.

Detailplanlæg aldrig produktionsordrer med status Planned. Microsoft skriver, at Business Central “deletes them the next time you run planning.” (sletter dem, næste gang du kører planlægningen). Planning Worksheet fortsætter med at foreslå forsyninger, mens SkyPlanner planlægger de fastlagte ordrer ud fra den reelle kapacitet.

3. Tilbageskrivning af planen. Standardsiden Prod. Order Routing publiceres som en OData v4-webtjeneste. For hver operation, som motoren har placeret eller flyttet, sender SkyPlanner en PATCH til den pågældende rutelinje med ETag i If-Match. Den angiver Starting Date-Time og Ending Date-Time samt Type og No., når operationen er flyttet til en alternativ maskine.

PATCH-kaldet kører side- og tabeltriggerne, så Business Central validerer felterne med sin egen logik, præcis som når en planlægger redigerer siden Prod. Order Routing. Produktionsordrelinjens Starting and Ending Date-Time opdateres tilsvarende. Business Central bevarer styringen af mængder, status og omkostninger.

4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringerne holder tidsplanen ajour. Færdigmeldt produktion kan rapporteres i Business Central som hidtil via Production Journal eller Output Journal.

Hvis I ønsker fuldautomatisk bogføring af færdigmeldt produktion og forbrug, tilføjes en standard-API-side i Business Central til bogføring via Output Journal. SkyPlanner bogfører derefter omstillingstid, procestid og færdigmeldt antal pr. operation. Bogføringen opdaterer Capacity Ledger Entries, og færdigmelding på den sidste operation i ruten lægger varen på lager.

Vælg én kanal til bogføring af færdigmeldt produktion. Bogføring fra både SkyPlanner og Business Centrals Production Journal giver dobbeltposteringer.

5. Regler for dataejerskab og konflikter. Skriv dem ned inden idriftsættelsen:

Den primære kilde til konflikter er handlingerne Refresh og Replan på produktionsordrer. 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 bruger Refresh til at genberegne produktionsordrelinjer, sletter Business Central de eksisterende linjer og beregner nye). Replan kan også ændre kapacitetsbehovet, og genberegning af komponenter “deletes previous changes in the components.” (sletter tidligere ændringer i komponenterne).

Behandl en opdateret ordre som en ny version, synkroniser den igen, og lad SkyPlanner omlægge tidsplanen. Med Autopilot omlægger SkyPlanner automatisk tidsplanen, når der sker ændringer i produktionen.

• Enheder i ruter. Setup Time gælder pr. produktionsordre, Run Time pr. produceret vare, og de har hver deres Unit of Measure Code. Wait Time og Move Time optager ikke kapacitet på arbejdscentret. Hvis arbejdscentrets enhed er Days, er én dag 24 timer, ikke et skift på otte timer. Omregn ved import, ellers bliver alle varigheder forkerte.
• Forældede kalendere. Der er først kapacitet, når Calculate Work Center Calendar er kørt for planlægningshorisonten. Kontrollér feltet Calendar Entries Available Until før den første indlæsning.
• Skjult kapacitet på maskincentre. Når Consolidated Calendar er slået fra, planlægges kun arbejdscentrets egen kapacitet: “The machine center capacity is excluded.” (Maskincentrets kapacitet er ikke medregnet). Læs kapaciteten direkte fra maskincentrene i stedet for at stole på arbejdscentrets samlede tal.
• Capacity og Efficiency. Business Central beregner varighed som Run Time / Efficiency / Capacity, og de beregnede kalenderposter tager allerede højde for begge dele. Overfør Efficiency til arbejdsstationens effektivitet i SkyPlanner én gang, ikke to.
• Alternate Work Center er kun en oplysning. Microsoft skriver, at det “isn’t automatically included in planning processes.” (ikke automatisk indgår i planlægningsprocesser). Opret alternativerne udtrykkeligt som alternative arbejdsstationer i SkyPlanner.
• Begrænsning af forespørgsler. Onlinegrænserne gælder pr. bruger, og en service principal tæller som én bruger: 6.000 OData-forespørgsler i et rullende vindue på 5 minutter og 5 samtidige forespørgsler. Sidestørrelsen er begrænset til 20.000, en $batch til 100 operationer, og en operation får timeout efter 8 minutter. Overskrides grænsen for forespørgsler, returneres 429. Brug batch, sideopdeling og polling af ændringer i stedet for at genindlæse alle data.
• Licenser. Produktionsfunktionerne findes kun i Premium. Brugere med Essentials kan ikke logge ind i et regnskab, der er indstillet til Premium.