Integrationer / ERP / Microsoft Dynamics 365 Supply Chain Management
Guide till integration av Dynamics 365 Supply Chain Management för produktionsplanering med SkyPlanner APS
Den här guiden till integration med Dynamics 365 Supply Chain Management visar partner och IT-team hur Microsoft Dynamics 365 Supply Chain Management ansluts till SkyPlanner APS. SkyPlanner integreras med Dynamics 365 Supply Chain Management i båda riktningarna via systemets standardiserade dataentiteter:
- Produktionsorder, flödesoperationer, flödesjobb, BOM-rader, resurser, kalendrar, frisläppta produkter, lagerbehållning och inköpsorderrader läses in.
- Planerade start- och sluttider samt vald resurs skrivs tillbaka till produktionsordern och dess flödesoperationer.
- Operatörstimmar och kvantiteter återförs via flödeskortjournalen.
- SkyPlanners webhooks skickar planändringar direkt när de sker.
Under införandet konfigurerar SkyPlanner-teamet integrationen för er konfiguration av Supply Chain Management och ger support efter driftstart. Guiden riktar sig till partner och utvecklare som vill medverka eller själva bygga vidare med SkyPlanners dokumenterade REST API (API-referens).
Integrationsalternativ för Dynamics 365 SCM
Supply Chain Management gör sina data tillgängliga via dataentiteter. Fyra alternativ är relevanta för produktionsplaneringen:
- OData v4 REST-endpoint.
[Your organization's root URL]/datager full åtkomst för att skapa, läsa, uppdatera och ta bort data i varje dataentitet som är märkt med IsPublic. Det finns stöd för$filter,$count,$orderby,$skip,$top,$selectoch$expandpå första nivån. Sidindelningen styrs av servern med högst 10 000 poster, och batchanrop kan gruppera skrivningar i ändringsuppsättningar. OData är synkront. (källa) - Batch data API. Data management package REST API och återkommande integrationer överför stora datamängder asynkront. Microsoft: ”If the volume is more than a few hundred thousand records, use the batch data API.” (Om volymen överstiger några hundra tusen poster, använd batch data API.) Det är också det API som stöds i lokala installationer. (källa)
- Affärshändelser. Ekonomi- och driftappar publicerar affärshändelser till Azure Service Bus, Event Grid, HTTPS-endpoints eller Power Automate. (källa)
- Anpassade tjänster och OData-åtgärder. Anpassade X++-tjänster och bundna OData-åtgärder kör affärslogik på begäran.
SkyPlanner-integrationen använder OData-endpointen för den dagliga trafiken och batch data API vid stora initiala inläsningar. Inget installeras i Supply Chain Management.
Autentisering
Registrera en applikation i Microsoft Entra ID (service principal). Koppla sedan applikationen till en användare i Supply Chain Management med de säkerhetsroller som integrationen behöver. Integrationen läser produktions-, resurs- och lagerdata och skriver planeringsdata för produktionsorder samt journaler. Token begärs från Entra ID med klientautentiseringsuppgifter.
Två regler avgör vilka data integrationen ser:
- Juridiska personer. OData returnerar standardföretagets data om inte
?cross-company=trueläggs till i anropet. Verksamheter med flera anläggningar filtrerar pådataAreaId. - Publika namn. Entitetsnamnen nedan är namnen i datahanteringen. De publika OData-samlingarna kan ha andra namn, så hämta dem från
/data/$metadatai er miljö.
På SkyPlanner-sidan använder REST API en API-token för autentisering (SkyPlanner Settings > API) och är dokumenterat i Swagger/OpenAPI. Integrationshandledningen går igenom de första anropen.
Datamappning
| Entitet i D365 SCM | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
| Frisläppta produkter (ItemNumber) | Produkter och material | SCM → SkyPlanner | Initial inläsning, därefter ändringar |
| Produktions-BOM-rader (ProdProductionOrderBillOfMaterialsLineEntity), BOM-rader | Produktstruktur, material per order | SCM → SkyPlanner | Vid varje ordersynkronisering |
| Flöde, flödesversioner, flödesoperationer, operationsegenskaper (RouteOperationPropertiesV2Entity) | Processteg med ställ- och körtider | SCM → SkyPlanner | Initial inläsning, därefter vid ändringar |
| Resurser (OpResOperationsResourceEntity), resursgrupper, kapabiliteter | Produktionsgrupper, grupperingar av produktionsgrupper, effektivitetsvärden | SCM → SkyPlanner | Initial inläsning, sällan därefter |
| Arbetstidskalendrar, kalenderdagar och tidsintervall, kalendertilldelningar | Skift | SCM → SkyPlanner | Dagligen, alternativt hanteras skiften i SkyPlanner |
| Produktionsorderhuvuden (ProdProductionOrderHeaderEntity) | Order med förfallodatum och status | SCM → SkyPlanner | Med några minuters mellanrum eller vid en affärshändelse |
| Flödesoperationer (ProdProductionOrderRouteOperationEntity), flödesjobb (ProdProductionOrderRouteJobEntity) | Operationer med varaktighet och resurskrav | SCM → SkyPlanner | Vid varje ordersynkronisering |
| Lagerbehållning | Lagersaldon | SCM → SkyPlanner | Varje timme eller vid planeringskörning |
| Inköpsorderrader med leveransdatum | Inkommande material; lagret uppdateras när inköpsordern markeras som Delivered | SCM → SkyPlanner | Varje timme eller vid planeringskörning |
| Planerade start- och slutdatum med klockslag samt produktionsresurs för varje flödesoperation | Planerad start, planerat slut och produktionsgrupp per operation | SkyPlanner → SCM | Vid ändringar i planen, via SkyPlanners webhook |
| Flödeskortjournal (ProdRouteCardProductionJournalEntryEntity: RegisteredHours, ReportedGoodInventoryQuantity) | Tidsregistreringar och kvantiteter | SkyPlanner → SCM | Per rapportering eller per skift, om detta väljs |
| Inställningar för begränsningar i SkyPlanner | Ställtidsmatris, verktyg som resurser med begränsad kapacitet, antal operatörer, alternativa resurser | Underhålls i SkyPlanner | Konfigureras under införandet |
Integrationsmönster
1. Initial inläsning av grunddata. Läs in resurser, resursgrupper, kalendrar, frisläppta produkter, flöden och BOM. Använd batch data API när volymerna uppgår till hundratusentals poster, annars OData med sidindelning. Mappa varje SCM-resurs till en produktionsgrupp i SkyPlanner. Mappa inte enbart resursgrupper: grovplaneringen bokar grupper, men produktionen körs på enskilda resurser.
2. Ordersynkronisering. Läs in fastställda produktionsorder med de statusar som SkyPlanner ansvarar för, vanligtvis Scheduled och Released, tillsammans med deras flödesoperationer, flödesjobb och BOM-rader. Läs även in öppna inköpsorderrader. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagret när inköpsordern markeras som Delivered.
Utelämna planerade produktionsorder om de inte uttryckligen ingår i omfattningen. Planning Optimization återskapar dem vid varje körning.
3. Återföring av planen. För varje operation som planeringsmotorn har placerat eller flyttat skriver SkyPlanner tillbaka planerade start- och slutdatum med klockslag samt produktionsresurs till flödesoperationen. Fältnamnen hämtas från /data/$metadata i er miljö. Ändringarna skickas i OData-batchar med ändringsuppsättningar, så att varje planeringskörning förs över som en sammanhängande uppdatering.
4. Rapportering från produktionen. Operatörerna registrerar arbete med SkyPlanner Mobile Confirmations eller Production Timer, och tidsregistreringarna håller planen aktuell. Timmar och godkända kvantiteter kan återföras som rader i flödeskortjournalen. Färdigrapporteringen ligger kvar där ni gör den i dag, i SCM eller Production floor execution.
Välj en kanal för varje bokföring. Om samma timmar registreras från både SkyPlanner och Production floor execution blir de dubbelregistrerade.
5. Dataägarskap och konfliktregler. Dokumentera dem före driftstart:
| Data | Ägare |
|---|---|
| Produkter, BOM, flöden, kvantiteter, orderstatus, kostnadsberäkning | Supply Chain Management |
| Planerade produktionsorder | Planning Optimization |
| Operationsföljd, planerad start och planerat slut, resurstilldelning | SkyPlanner |
| Ställtidsmatris, verktyg, antal operatörer, alternativa resurser | SkyPlanner |
| Skift och frånvaro | Ett system, som väljs under kartläggningen |
| Bokföring av timmar och producerade kvantiteter | Supply Chain Management, från SkyPlanners tidsregistreringar om det alternativet väljs |
Den främsta konfliktkällan är SCM:s egen finplanering. Om en planerare planerar om en order i SCM skrivs SkyPlanners datum över. Använd IsProductionOrderSchedulingLocked på tillverkningsorderns huvud för order som SkyPlanner ansvarar för. Behandla varje order som ändras i SCM som en ny version och synkronisera den igen. Autopilot planerar automatiskt om när produktionen ändras.
Det här ingår i projektet
Implementeringen blir normalt klar inom några veckor efter att introduktionen har startat. Innan dess kan ni använda era egna data under den kostnadsfria provperioden på 30 dagar. Exportera resurser, flöden och öppna tillverkningsorder med ett exportprojekt i datahanteringen eller Excel-tillägget. Importera dem som CSV eller Excel och kontrollera planen.
- Kartläggning. Fastställ mappningstabellen, vilka statusar SkyPlanner ansvarar för, synkroniseringsfrekvenser och kanal för rapportering.
- Åtkomst. Registrera Entra ID-applikationen, koppla den till en SCM-användare med roller som bara ger nödvändiga behörigheter och bekräfta de publika entitetsnamnen i
/data/$metadata. Börja i en sandbox och gå sedan vidare till produktionsmiljön. - Första inläsningen. Resurser, kalendrar, frisläppta produkter, flöden och strukturlistor.
- Synkronisering av order och inköpsorder. Hämta ändrade poster regelbundet med
$filteroch komplettera med affärshändelser där sådana finns i er katalog. - Ställ in begränsningar i SkyPlanner. Ställtidsmatris, verktyg, antal operatörer samt alternativa maskiner eller personal.
- Återskrivning av planen. Uppdatera flödesoperationer i batch och lås planeringen för order som SkyPlanner ansvarar för.
- Parallelltestning. Kör SkyPlanner parallellt med den befintliga planen, jämför datum och rätta grunddata.
- Driftsättning. Aktivera återskrivningen när uppgifterna stämmer överens.
Att tänka på vid en integration med Dynamics 365 SCM
- Effektiviteten kan räknas dubbelt. SCM beräknar tiden så här: ”Scheduling time = Time x 100 / Efficiency percentage.” (Planeringstiden beräknas utifrån tiden och effektivitetsprocenten.) Mappa effektiviteten till produktionsgruppens effektivitet i SkyPlanner en gång. Tillämpa den inte på tider som redan har justerats för effektivitet.
- Kalendrar är kopplade till resursgrupper. Läs in kalendertilldelningen för varje resursgrupp och resurs, annars blir kapaciteten fel.
- Grovplanering kontra finplanering. Order som har grovplanerats saknar start- och sluttider och har ingen specifik resurs. Synkronisera flödesoperationer och resurskrav, inte bara datumen.
- Inställningar för begränsad kapacitet. Resurser där Finite capacity är satt till No kan överbokas i SCM. Modellera varje faktisk kapacitetsbegränsning i SkyPlanner så att kapaciteten inte kan överskridas.
- 32 resurser per operation. SCM begränsar finplaneringen till 32 resurser per operation. I SkyPlanner hanteras alternativen genom grupper av produktionsgrupper och alternativa produktionsgrupper.
- Sidindelning och datavolymer. OData delar upp resultaten i sidor med 10 000 poster och expanderar en nivå nedåt. Använd batchdata-API:et för stora första inläsningar.
- Juridiska personer. Utan
cross-company=trueoch filter pådataAreaIdsynkroniseras bara standardföretaget för en anläggning som omfattar flera företag.
Vem konfigurerar integrationen?
Arbetet omfattar mappning mot era flöden, resurser och inställningar i SCM samt inställning av begränsningar i SkyPlanner: ställtidsmatris, verktyg, antal operatörer och alternativa resurser.
- SkyPlanner-teamet konfigurerar integrationen under introduktionen och ger support efter driftsättningen. Det omfattar SkyPlanner-sidan och de överenskomna dataentiteterna i SCM. Varje anläggning använder D365 SCM på sitt sätt, och här kommer den kunskapen till användning.
- Er Dynamics-partner kan medverka. Partnern känner till er konfiguration, era tillägg och säkerhetsroller och kan konfigurera Entra ID-applikationen och åtkomsten till entiteter. SkyPlanner tillhandahåller REST API, dokumentation för Swagger/OpenAPI och webhooks.
- Era egna utvecklare kan bygga vidare på integrationen via samma dokumenterade REST API med en API-token. Det räcker med en API-token för att komma igång, och SkyPlanner-teamet hjälper till vid behov.
När anslutningen är på plats planerar Arcturus-motorn utifrån aktuella tillverkningsorder i SCM, och de planerade datumen skrivs till flödesoperationerna. SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Ni får en offert på integrationen utifrån er process och era behov, tillsammans med abonnemanget, så att ni ser hela kostnaden innan ni börjar.
Se hur SCM:s egen planering står sig i jämförelsen i Finplanering i Dynamics 365 SCM. En översikt finns på sidan om Dynamics 365 SCM, och andra ERP-system hittar ni i översikten över ERP-integrationer.
Tillverkningsföretagens omdömen om SkyPlanner
2 hsparas varje vecka
”SkyPlanner har tagit vår produktionsplanering från Excel-kalkylblad till produktionsoptimering i realtid.”
Kalle Kalliomäki, specialist på försörjningskedjor
UTU · Elcentraler och ställverk
Produktionsplaneringen sparar 2 timmars arbetstid varje vecka, och en ny körplan når produktionslinjen på några sekunder.
+90%produktionseffektivitet
”Effektiviteten i produktionen har ökat med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Läkemedelstillverkning
Produktionseffektiviteten har ökat med 90%, och det tar under 30 minuter att skapa en optimerad plan för tre månader som omfattar alla produktionsgrupper.
100%leveransprecision sedan 2021
”SkyPlanner ger oss överblick över kapaciteten och gör planeringen förutsägbar.”
Dan Berglund, COO/CFO
Opes Corporation · Kemikalie- och livsmedelstillverkning
Leveransprecisionen har varit 100% under hela tiden SkyPlanner har använts, sedan 2021.
1 000-talsarbetsorder planeras automatiskt
”Vi har kontroll över produktionen på ett annat sätt, och vår förståelse för kapaciteten är på en helt annan nivå.”
Hannu Ryynänen, vd
Mamec · Industriella omrörare, pumpar och högteknologisk kontraktstillverkning
Tusentals arbetsorder planeras automatiskt, och hela organisationen får en realtidsbild av produktionen.
Vanliga frågor
Vilket API i D365 SCM använder integrationen?
REST-slutpunkten för OData v4 på /data, som ger åtkomst till alla publika dataentiteter med fullt stöd för att skapa, läsa, uppdatera och ta bort. Vid stora initiala datainläsningar används batchdata-API:et. Affärshändelser ger utlösare i nära realtid där sådana finns i er katalog.
Behöver vi installera något i Supply Chain Management?
Nej. Integrationen använder standarddataentiteter via OData. Er administratör registrerar en Microsoft Entra ID-applikation och kopplar den till en SCM-användare med de roller som behövs.
Hur skrivs planerade datum tillbaka till Supply Chain Management?
SkyPlanner skriver planerade start- och slutdatum med klockslag samt operationsresursen till tillverkningsorderns flödesoperationer med hjälp av batch changesets i OData. Order som SkyPlanner ansvarar för skyddas med IsProductionOrderSchedulingLocked.
Varför ansluta SkyPlanner i stället för att finjustera finplaneringen i SCM?
Planning Optimization tar bara hänsyn till begränsad kapacitet inom tidsgränsen för kapacitetsbegränsning och planerar med obegränsad kapacitet utanför den (källa). SCM:s finplanering planerar en tillverkningsorder i taget utifrån den kapacitet som återstår efter befintliga reservationer, och ställtiden räknas in i operationens tid (källa). Microsoft avråder dessutom från huvudplanering med begränsad kapacitet när skift ändrar kapaciteten (källa). SkyPlanner planerar alla bekräftade order tillsammans med en ställtidsmatris, och Autopilot planerar automatiskt om vid varje betydande förändring. SkyPlanner-teamet konfigurerar tvåvägsintegrationen och ger support, och er Dynamics-partner kan ansvara för SCM-sidan.
Bör planerade tillverkningsorder ingå i SkyPlanners produktionsplanering?
Normalt inte. Planning Optimization skapar om planerade tillverkningsorder vid varje körning. SkyPlanner planerar bekräftade tillverkningsorder med de statusar som ni kommer överens om under kartläggningen.
Fungerar integrationen med lokalt installerad Supply Chain Management?
För lokala installationer körs integrationen via batchdata-API:et, som Microsoft stöder där. SkyPlanner-sidan använder samma REST API oavsett installation, och integrationsvägen fastställs under kartläggningen.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan ni använda upp till 20 produktionsgrupper och importera CSV- eller Excel-filer från Supply Chain Management. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för att kartlägga integrationen.
