Integrasjoner / ERP / Exact
Integrasjonsveiledning for Exact Online: produksjonsplanlegging med SkyPlanner APS
Denne integrasjonsveiledningen viser Exact-partnere og IT-team hvordan de kobler Exact Online Manufacturing til SkyPlanner APS. SkyPlanner utveksler data med Exact Online i begge retninger:
- Produksjonsordrer, trinn i produksjonsruten, materialplaner, arbeidssentre, operasjoner og stykklister hentes inn via Exact Online REST API.
- Artikler, lagerbeholdninger, innkjøpsordrer og salgsordrer hentes inn, og endringer meldes via webhooks fra Exact Online.
- Planlagte start- og sluttdatoer skrives tilbake til hvert trinn i produksjonsruten og til produksjonsordren.
- Operatørenes tidsregistreringer bokføres som tidstransaksjoner, og ferdigproduserte mengder som mottak fra produksjonsordrer.
SkyPlanner-teamet tilpasser integrasjonen til Exact Online-oppsettet ditt under innføringen og gir støtte etter produksjonssetting. Denne veiledningen er for partnere og utviklere som vil delta i arbeidet eller selv bygge videre på SkyPlanners dokumenterte REST API (API-referanse). Til slutt følger en kort del om Exact Globe+.
Exact Online REST API for produksjon
Exact Online gjør dataene tilgjengelige gjennom ett REST API, med ressurser gruppert etter tjeneste. Basisstien er /api/v1/{division}/<service>/<resource>, der division er selskapet i Exact Online. REST API-referansen oppgir disse ressursene for produksjonsplanlegging i produksjonstjenesten:
| Ressurs | Innhold | Metoder |
|---|---|---|
manufacturing/ShopOrders | Produksjonsordrenummer, artikkel, PlannedQuantity, PlannedStartDate, PlannedDate, status, frigivelsesflagg | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Trinn i produksjonsruten per produksjonsordre: operasjon, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Materiallinjer per produksjonsordre | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Kode, type, produksjonsområde, kapasitetsverdi, satser | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Operasjoner med tilhørende arbeidssentre, omstillings- og kjøretider | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | BOM-versjoner, komponenter og produksjonsrute | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Timer ført per produksjonsordre og trinn i produksjonsruten | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Ferdigproduserte mengder mottatt fra en produksjonsordre | GET, POST |
manufacturing/MaterialIssues | Materialer tatt ut til en produksjonsordre | GET, POST |
manufacturing/ShopOrderPriorities | Prioritetsmodus per produksjonsordre | GET, PUT |
Fra de andre tjenestene:
| Ressurs | Innhold |
|---|---|
logistics/Items | Artikkelregister |
inventory/ItemWarehouses | Beholdning per artikkel og lager |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Åpne innkjøpsordrer og mottaksdatoer |
salesorder/SalesOrders, SalesOrderLines | Kundebehov og leveringsdatoer |
Autentisering og tilgang
Exact Online bruker OAuth 2.0 med authorization code-flyt og refresh tokens. Exact skriver: «Before you can start integration with Exact Online, you must first register your app in the App Store.» (Før du kan integrere med Exact Online, må du registrere appen din i App Store.) (Hjelp for Exact Online) Registrering av apper krever et Exact Online Developer-abonnement (Exact App Store).
- Integrasjonen registreres som en app med en omdirigerings-URI.
- En Exact Online-bruker med tilgang til produksjon, lager og innkjøp gir samtykke én gang.
- Hver forespørsel sender
Authorization: Bearer <access_token>og division i stien. - Access tokens fornyes med et refresh token. Exact begrenser hvor ofte du kan be om et nytt token, så mellomlagre tokenet til det utløper.
Exact setter også grenser for antall kall per minutt og per dag for hver app og hvert selskap, og ber om at kall kjøres sekvensielt i stedet for parallelt. Gjeldende grenser står i Exacts artikkel om API-grenser. Integrasjonen er utformet med hensyn til disse: filtrert lesing med $filter og $select, og Sync API for masseendringer.
SkyPlanners REST API bruker et API-token i Authorization-Token-headeren til autentisering (SkyPlanner Settings > API) og er dokumentert i Swagger/OpenAPI. Integrasjonsveiledningen viser deg de første kallene.
Webhooks og polling
Webhooks fra Exact Online sender en POST til callback-URL-en din når det skjer en endring i et emne du abonnerer på. Forespørselen signeres med en HMAC SHA256-hash (webhooks). Emnene omfatter Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders og SalesOrderLines. Disse sender endringer i lagerbeholdning, innkjøp og etterspørsel til SkyPlanner når de skjer.
Produksjonsordrer og trinn i produksjonsruten leses med faste intervaller. Filtrer ShopOrders og ShopOrderRoutingStepPlans på Modified, og bruk Sync API for masselesing (API-begrensninger).
SkyPlanner sender egne webhooks når produksjonsplanen endres, slik at tilbakeskriving til Exact Online er hendelsesstyrt.
Datakobling
| Ressurs i Exact Online | Objekt i SkyPlanner | Retning | Hyppighet |
|---|---|---|---|
Items | Produkter og materialer | Exact Online → SkyPlanner | Innlasting, deretter webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Produktstruktur, delprodukter, materialer per produkt | Exact Online → SkyPlanner | Ved endring |
Workcenters, OperationResources | Arbeidsstasjoner, arbeidsstasjonsgrupper | Exact Online → SkyPlanner | Førstegangsinnlasting |
Operations, BillOfMaterialRoutings | Prosesstrinn med omstillings- og kjøretider | Exact Online → SkyPlanner | Ved endring |
ShopOrders | Ordrer med mengde og frist | Exact Online → SkyPlanner | Med noen minutters mellomrom |
ShopOrderRoutingStepPlans | Jobber med rekkefølge, arbeidssenter, omstillings- og kjøretimer | Exact Online → SkyPlanner | Med noen minutters mellomrom |
ShopOrderMaterialPlans | Materialer per jobb | Exact Online → SkyPlanner | Med noen minutters mellomrom |
ItemWarehouses, StockPosition | Lagerbeholdninger | Exact Online → SkyPlanner | Webhook |
PurchaseOrderLines | Innkjøpsordrer med forventet leveringsdato | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Leveringsfrister og prioritet for kundeordrer | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Planlagt start, slutt og arbeidsstasjon per operasjon | SkyPlanner → Exact Online | Ved endring, via webhook |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Start og slutt for ordren | SkyPlanner → Exact Online | Ved endring, via webhook |
TimeTransactions (POST) | Tidsregistreringer og operatørbekreftelser | SkyPlanner → Exact Online | Per bekreftelse eller per skift |
ShopOrderReceipts (POST) | Ferdigprodusert antall ved siste operasjon | SkyPlanner → Exact Online | Per bekreftelse |
| Lagres ikke i Exact Online | Omstillingstidsmatrise, verktøy som ressurser med begrenset kapasitet, operatører per jobb, alternative arbeidsstasjoner, skift | Vedlikeholdes i SkyPlanner | Oppstart |
Integrasjonsmønstre
1. Førstegangsinnlasting av grunndata. Les inn Workcenters, Operations og OperationResources, deretter varer og BOM-versjoner med tilhørende produksjonsruter. Et arbeidssenter med tre maskiner blir til tre arbeidsstasjoner eller én gruppe med arbeidsstasjoner. Skift, fravær og overtid settes opp i SkyPlanner, fordi et arbeidssenter i Exact har én kapasitetsverdi.
2. Ordresynkronisering. Les inn åpne ShopOrders med tilhørende ShopOrderRoutingStepPlans og ShopOrderMaterialPlans, samt lagerbeholdning og innkjøpsordrelinjer. Planleggingen kontrollerer både lagerbeholdningen og forventede innkjøpsleveranser. MRP fortsetter å gi ordreforslag i Exact Online, og SkyPlanner planlegger produksjonsordrene du oppretter.
3. Tilbakeskriving av planen. For hver operasjon motoren har plassert eller flyttet, sender SkyPlanner en PUT til ShopOrderRoutingStepPlans med PlannedStartDate, PlannedEndDate og Workcenter. Produksjonsordrens PlannedStartDate og PlannedDate følger første og siste operasjon. Exact Online beholder ansvaret for antall, materialplaner og kostnadsberegning.
4. Bekreftelser fra produksjonsgulvet. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringene holder planen oppdatert. Registrerte timer bokføres som TimeTransactions på produksjonsordren og operasjonen, enten som omstilling eller kjøring. Den siste bekreftelsen oppretter en ShopOrderReceipts-post for ferdigprodusert antall. Hvis fabrikken allerede registrerer tid i Shop Floor Control, må dere velge én kanal for registrering.
5. Regler for dataeierskap og konflikthåndtering. Skriv dem ned før produksjonssetting:
| Data | Eier |
|---|---|
| Varer, BOM-er, antall på produksjonsordrer, materialplaner, kostnader | Exact Online |
| Operasjonsrekkefølge, start- og sluttider, tildeling av arbeidssenter | SkyPlanner |
| Omstillingstidsmatrise, verktøy, operatører per jobb, alternative ressurser, skift | SkyPlanner |
| Tidstransaksjoner og ferdigmeldinger | Exact Online, med data fra SkyPlanner |
Manuelle datoendringer er den viktigste kilden til konflikter. Hvis planleggerne fortsetter å endre datoene på produksjonsordrer i Exact Online, har to systemer ansvar for datoene. La SkyPlanner styre datoene for operasjonene. Med Autopilot planlegger SkyPlanner automatisk på nytt når produksjonen endrer seg.
Typiske prosjekttrinn
Implementeringen fullføres normalt i løpet av noen uker etter at oppstartsarbeidet begynner. Før det kan du validere planen i den gratis prøveperioden på 30 dager med en CSV- eller Excel-eksport av åpne produksjonsordrer og operasjoner. Deretter følger prosjektet disse trinnene:
- Avklaring. Bekreft utgave, divisjoner, synkroniseringsfrekvenser, kanal for tidsregistrering og bokføring av ferdigmeldinger.
- App og samtykke. Registrer appen. Deretter gir en Exact Online-bruker OAuth-samtykke for hver divisjon.
- Førstegangsinnlasting. Arbeidssentre, operasjoner, varer, BOM-versjoner og produksjonsruter.
- Ordresynkronisering. Produksjonsordrer, operasjonsplaner og materialplaner synkroniseres til faste tider, mens lagerbeholdning og innkjøp synkroniseres via webhook.
- Oppsett av begrensninger i SkyPlanner. Skift, omstillingstidsmatrise, verktøy, antall operatører per jobb og alternative maskiner eller medarbeidere.
- Tilbakeskriving av planen. Planlagte operasjonsdatoer overføres til Exact Online, deretter tidstransaksjoner og ferdigmeldinger.
- Parallell testing og produksjonssetting. Sammenlign datoene med gjeldende plan, rett opp grunndata og aktiver deretter tilbakeskriving.
Dette bør du ta høyde for i en Exact Online-integrasjon
- Operasjonstider.
PlannedSetupHoursogPlannedRunHourshentes fra produksjonsruten i BOM-en. Kontroller dem mot faktiske kjøretider først. - Gruppering av arbeidssentre. Exact lagrer én kapasitetsverdi per arbeidssenter. Avgjør for hvert arbeidssenter om det skal bli én arbeidsstasjon, flere arbeidsstasjoner eller en gruppe.
- Kalendere. Skift, helligdager og fravær administreres i SkyPlanner. Legg dem inn før den første planen lages.
- Kallbudsjett. Exact begrenser antall kall per app og selskap og forventer at kallene gjøres sekvensielt. Bruk webhooks der det finnes emner,
$filterpåModifiedog Sync API for masseinnlesing. - Flere divisjoner. Hver divisjon i Exact Online er et selskap med egen sti og eget samtykke. Knytt hver fabrikk til riktig divisjon.
- Frigitte produksjonsordrer. Avtal hvilke statuser SkyPlanner kan endre datoer for: åpne og frigitte ordrer, eller bare åpne ordrer.
- Ett system styrer datoene. Slutt å endre datoer manuelt i Exact Online når SkyPlanner har overtatt ansvaret for operasjonsdatoene.
Exact Globe+
Exact Globe+ er Exacts ERP-system og selges og implementeres gjennom Exact Globe+-partnere. Exact sier at det «koppelt eenvoudig en snel met andere systemen» (kobles enkelt og raskt til andre systemer) (Exact Globe+). SkyPlanner planlegger produksjonsordrer fra Exact Globe+ på samme måte: Produksjonsordrer, produksjonsruter, ressurser og lagerbeholdning hentes inn, mens planlagte datoer og registrerte timer sendes tilbake. Exact Globe+-partneren din og SkyPlanner-teamet avtaler grensesnittet og hvilke objekter det skal skrives tilbake til, under avklaringen.
Exact Online-integrasjonen: Hvem setter den opp og gir brukerstøtte?
- SkyPlanner-teamet setter opp integrasjonen under oppstarten og gir brukerstøtte etter produksjonssetting.
- Exact-partneren din kan delta. Partneren kjenner utgavene, divisjonene og produksjonsoppsettet deres.
- Egne utviklere kan bygge videre på integrasjonen ved hjelp av SkyPlanners dokumenterte REST API. Et API-token er nok for å komme i gang, og SkyPlanner-teamet hjelper til ved behov.
Når integrasjonen er på plass, planlegger Arcturus-motoren ut fra oppdaterte produksjonsordrer i Exact Online, og hver operasjon får planlagte datoer. SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og faktureres månedlig. På forhånd får du et samlet pristilbud på abonnementet og integrasjonen, der integrasjonen er tilpasset prosessen og behovene dine. Dermed ser du hele kostnaden før du starter. Se priser, funksjoner og hvordan Exact Onlines egen planlegging står seg i sammenligningen i produksjonsplanlegging med reell maskin- og bemanningskapasitet i Exact Online. Du finner oversikten på Exact Online-siden og andre ERP-systemer i oversikten over ERP-integrasjoner.
Produksjonsbedrifters erfaringer med SkyPlanner
Færrestans på grunn av materialmangel
«Verdien av SkyPlanner for oss er at det er et verktøy som fungerer i det daglige, særlig når vi skal fastsette leveringsdatoer.»
Tommi Männistö, produksjonsplanleggingssjef
Eskomatic · Maskinering på oppdrag
Automatisk planlegging av belastningen gir mer presise leveringsdatoer, og produksjonsstans som skyldes materialmangel, har gått kraftig ned.
1 000-tallsarbeidsordrer planlegges automatisk
«Vi har kontroll på produksjonen på en helt annen måte, og forståelsen vår av kapasiteten er på et helt annet nivå.»
Hannu Ryynänen, administrerende direktør
Mamec · Industrielle miksere, pumper og høyteknologisk kontraktsproduksjon
Tusenvis av arbeidsordrer planlegges automatisk, og hele organisasjonen har oversikt over produksjonen i sanntid.
Ofte stilte spørsmål
Omfatter API-et i Exact Online produksjonsordrer og operasjoner i produksjonsruten?
Ja. Produksjonstjenesten har ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations og BOM-ressurser. Alle støtter både lesing og skriving. Tid registreres via TimeTransactions og ferdigproduserte antall via ShopOrderReceipts.
Hvordan skrives planlagte datoer tilbake til Exact Online?
SkyPlanner sender en PUT-forespørsel til ShopOrderRoutingStepPlans med PlannedStartDate, PlannedEndDate og Workcenter for hver operasjon som planlegges eller flyttes. Produksjonsordrens PlannedStartDate og PlannedDate oppdateres tilsvarende.
Hvem bygger integrasjonen med Exact Online?
SkyPlanner-teamet konfigurerer toveisintegrasjonen for deres Exact Online-oppsett under innføringen og gir støtte etter at løsningen er satt i drift. Exact-partneren deres kan delta. Deres egne utviklere kan også bygge på det dokumenterte REST API-et til SkyPlanner. Et API-token er nok til å komme i gang.
Kan Exact Online sende endringer i sanntid?
Exact Online sender endringer i varer, lagerbeholdninger, innkjøpsordrer og salgsordrer via webhooks. Produksjonsordrer og operasjoner i produksjonsruten leses med korte intervaller gjennom filtrerte forespørsler. I motsatt retning sender SkyPlanner endringer i produksjonsplanen via webhooks så snart de skjer.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner, med import av produksjonsordrer fra CSV eller Excel. Kredittkort er ikke nødvendig. Start prøveperioden, eller snakk med salg for å avklare omfanget av integrasjonen.