Guide till Business Central-integration för produktionsplanering med SkyPlanner APS

Integrationen använder två gränssnitt som redan ingår i Business Central:

1. API v2.0 för affärs- och lagerdata. Det exponerar items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers och employees. Det saknar entiteter för tillverkning, så produktionsdata hämtas via det andra gränssnittet.
2. OData v4-webbtjänster för tillverkning. Alla sidor i Business Central kan publiceras som OData v4-webbtjänster på sidan Web Services. Välj objekttypen Page, sidans ID och ett tjänstenamn och markera sedan Published. Då är ändpunkten aktiv, utan AL-kod eller något tillägg att driftsätta. Integrationen publicerar standardsidorna för frisläppta produktionsorder, Prod. Order Routing Lines, produktionsgrupper, maskingrupper och operationsföljder. De blir tillgängliga under /ODataV4/Company('{name}')/{ServiceName}.

Publicerade sidor stöder både läsning och skrivning. 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,” (om en redigerbar sida exponeras som en webbtjänst kan data i den underliggande tabellen läsas och ändras med ett OData-anrop). Uppdateringar görs med PATCH. Så förs planerade datum tillbaka till Business Central, via samma sida och med samma validering som en planerare använder.

Välj bort SOAP. Microsoft har markerat SOAP-webbtjänster som föråldrade, och möjligheten att publicera Microsofts gränssnittssidor som SOAP tas bort i 2026 release wave 2 (v29).

Business Central stöder webhook-prenumerationer via POST /api/v2.0/subscriptions för API v2.0-entiteter som items och salesOrders. Följande regler gäller:

• När en prenumeration skapas krävs en handskakning: din ändpunkt måste returnera validationToken med 200 OK.
• Prenumerationerna löper ut efter tre dagar. Förnya med PATCH, så görs handskakningen om.
• Aviseringarna innehåller resurssökvägen, changeType och ditt clientState, inte hela posten. Posten läser du in efteråt.
• Aviseringarna är fördröjda: Business Central online väntar 30 sekunder efter den första ändringen. Om fler än 1 000 poster ändras under den tiden skickas de som en enda collection-avisering.
• Högst 200 webhook-prenumerationer per onlinemiljö.

Produktionsorder, operationsrader och inköpsorder hämtas med några minuters mellanrum via de publicerade sidorna och purchaseOrders. Genom att filtrera på öppna order och använda sidindelning hålls antalet anrop väl inom gränserna i Business Central.

SkyPlanner skickar webhooks när status eller planeringen ändras, så återföringen av data är händelsestyrd.

1. Första inläsning av grunddata. Hämta operationsföljder och tillverknings-BOM:ar med status Certified samt produktionsgrupper och maskingrupper från de publicerade sidorna. Hämta artiklar och måttenheter från API v2.0. Gör ett medvetet val när varje produktionsgrupp eller maskingrupp mappas till en produktionsgrupp i SkyPlanner: bestäm om en produktionsgrupp med tre maskingrupper ska bli en samlad grupp eller tre separata produktionsgrupper.

2. Ordersynkronisering. Läs in tillverkningsorder med status Released (och Firm Planned, om ni planerar dem) med tillhörande operationsrader och komponenter från de publicerade sidorna. Läs också in öppna inköpsorderrader från API v2.0. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagret när inköpsordern markeras som Delivered. Planeringen tar därmed hänsyn till både lagersaldo och kommande inleveranser.

Planera aldrig tillverkningsorder med status Planned. Microsoft skriver att Business Central ”deletes them the next time you run planning.” (tar bort dem nästa gång du kör planeringen). Planning Worksheet fortsätter att föreslå försörjning, och SkyPlanner planerar de fastställda orderna mot verklig kapacitet.

3. Återskrivning av planen. Standardsidan Prod. Order Routing publiceras som en OData v4-webbtjänst. För varje operation som motorn har placerat eller flyttat skickar SkyPlanner ett PATCH-anrop till motsvarande operationsrad med ETag i If-Match. Anropet anger Starting Date-Time och Ending Date-Time samt Type och No. om operationen har flyttats till en alternativ maskin.

PATCH kör sidans och tabellens triggers, så Business Central validerar fälten med sin egen logik, precis som när en planerare redigerar sidan Prod. Order Routing. Tillverkningsorderradens Starting and Ending Date-Time uppdateras i sin tur. Business Central behåller ansvaret för kvantiteter, status och kostnader.

4. Återrapportering från produktionen. Operatörerna registrerar arbete med SkyPlanner Mobile Confirmations eller Production Timer, och tidregistreringarna håller planeringen aktuell. Produktionen kan rapporteras i Business Central som tidigare, via Production Journal eller Output Journal.

Om ni vill bokföra produktion och förbrukning helt automatiskt läggs en standard-API-sida i Business Central till för bokföring via Output Journal. SkyPlanner bokför då ställtid, körtid och producerad kvantitet per operation. Bokföringen uppdaterar Capacity Ledger Entries, och rapportering på den sista operationen i operationsföljden lägger artikeln i lager.

Välj en enda kanal för produktionsbokföring. Om ni bokför från både SkyPlanner och Production Journal i Business Central blir posterna dubblerade.

5. Regler för dataägarskap och konflikter. Dokumentera dem före driftstart:

Den främsta konfliktkällan är åtgärderna Refresh och Replan på tillverkningsorder. 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.” (Om du använder åtgärden Refresh för att beräkna om tillverkningsorderrader tar Business Central bort de befintliga raderna och beräknar nya.) Replan kan också ändra kapacitetsbehovet, och en omberäkning av komponenter ”deletes previous changes in the components.” (tar bort tidigare ändringar av komponenterna).

Behandla en uppdaterad order som en ny version, synkronisera den igen och låt SkyPlanner planera om. Med Autopilot planerar SkyPlanner om automatiskt när produktionen ändras.

• Enheter i operationsföljder. Setup Time gäller per tillverkningsorder, Run Time per producerad artikel, och båda har en egen Unit of Measure Code. Wait Time och Move Time förbrukar ingen kapacitet i produktionsgruppen. Om produktionsgruppens enhet är Days motsvarar en dag 24 timmar, inte ett åttatimmarsskift. Räkna om vid importen, annars blir alla tidslängder fel.
• Inaktuella kalendrar. Kapacitet finns först när Calculate Work Center Calendar har körts för planeringshorisonten. Kontrollera fältet Calendar Entries Available Until före den första inläsningen.
• Dold kapacitet i maskingrupper. När Consolidated Calendar är avstängt planeras bara produktionsgruppens egen kapacitet: ”The machine center capacity is excluded.” (Maskingruppens kapacitet räknas inte med.) Läs maskingruppernas kapacitet direkt i stället för att förlita er på produktionsgruppens totalsiffror.
• Capacity och Efficiency. Business Central beräknar tidsåtgången som Run Time / Efficiency / Capacity, och de beräknade kalenderposterna tar redan hänsyn till båda. Mappa Efficiency till produktionsgruppens effektivitet i SkyPlanner en gång, inte två.
• Alternate Work Center är bara information. Microsoft skriver att det ”isn’t automatically included in planning processes.” (inte automatiskt tas med i planeringsprocesser). Lägg uttryckligen upp alternativen som alternativa produktionsgrupper i SkyPlanner.
• Anropsbegränsning. Online gäller gränserna per användare, och en tjänstidentitet räknas som en användare: 6 000 OData-anrop under ett rullande intervall på 5 minuter och 5 samtidiga anrop. Sidstorleken är begränsad till 20 000, en $batch till 100 operationer, och en operation får timeout efter 8 minuter. Om anropsfrekvensen överskrids returneras 429. Använd batchanrop, sidindelning och polling av ändringar i stället för att läsa in allt på nytt.
• Licensiering. Tillverkning finns bara i Premium-upplevelsen. Användare med Essentials kan inte logga in i ett företag som är inställt på Premium.