Integrasjoner / ERP / proALPHA ERP
Veiledning til proALPHA-integrasjon for produksjonsplanlegging med SkyPlanner APS
Denne integrasjonsveiledningen viser partnere og IT-team hvordan de kobler Proalpha ERP til SkyPlanner APS. Integrasjonen mellom SkyPlanner og Proalpha går begge veier:
- Artikler, produksjonsordrer med operasjoner, ressurser, kalendere, lagerbeholdning og innkjøpsordrer hentes inn.
- Planlagt start og slutt for hver operasjon sendes tilbake via setWorkOrderOperationDates.
- Ressursendringer sendes tilbake via changeWorkOrderOperationResource.
- Operatørenes registreringer sendes tilbake via operationDataEntry.
- SkyPlanner sender planendringer via webhooks så snart de skjer.
SkyPlanner-teamet tilpasser integrasjonen til Proalpha-oppsettet ditt under innføringen og gir støtte etter driftsstart. Denne veiledningen er for partnere og utviklere som vil delta, eller som selv vil bygge på det dokumenterte REST API-et til SkyPlanner (API-referanse).
Grensesnittene i Proalpha
Proalpha ERP kjører på Progress OpenEdge, og med Release 9 ble plattformen flyttet til OpenEdge 12. (Proalpha) Fire grensesnitt er relevante for produksjonsplanleggingen.
- Proalpha ERP REST APIs. Den offentlige Proalpha API Portal viser 108 OpenAPI 3.0-spesifikasjoner under
api/web/v1. Disse brukes til tilbakeskriving og til å lese artikler og lagerbeholdning. - Integration Workbench (INWB). Proalpha beskriver INWB slik: «is a central platform which connects different IT systems, machines, sites» (er en sentral plattform som kobler sammen ulike IT-systemer, maskiner og anlegg) og «converts the data into the format of the target system.» (konverterer dataene til målsystemets format). (Proalpha) Den mottar pAX-meldinger via
POST /api/web/v1/inwb/message. Bruk den til å overføre produksjonsordrer ut av og inn i Proalpha. - Proalpha Integration Platform. Plattformen ble kunngjort i april 2026 og er basert på n8n. Den «will be available to customers either on-premises or in the cloud.» (vil være tilgjengelig for kunder enten lokalt eller i skyen). Proalpha «will rely on an API-centric reference architecture and REST interfaces.» (vil basere seg på en API-sentrert referansearkitektur og REST-grensesnitt). (Proalpha)
- EDI og fileksport. INWB håndterer bransjespesifikke filformater, og fileksport dekker behovet i prøveperioden med SkyPlanner.
Endepunkter for produksjon
| Proalpha API | Endepunkt | Bruk i integrasjonen |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Planlagt start og slutt for hver operasjon (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Ressurs valgt under planleggingen (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Registreringer: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Artikler med partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Lagerbeholdning per MRP-område |
Autentisering
De publiserte Proalpha-spesifikasjonene bruker HTTP Basic-autentisering. Endepunktene er miljøspesifikke og ligger på Proalpha-serveren din eller i Proalpha Cloud, med adresseformatet {schema}://{host}:{port}/api/web/v1/.... Opprett en egen teknisk bruker med rettigheter begrenset til objektene i koblingstabellen. Planlegg nettverkstilgangen fra SkyPlanners skymiljø til dette endepunktet sammen med IT-teamet ditt.
På SkyPlanner-siden bruker REST API-et et API-token til autentisering (SkyPlanner Settings > API) og er dokumentert i Swagger/OpenAPI. Et API-token er nok for å komme i gang. Integrasjonsveiledningen tar deg gjennom de første kallene.
Hendelser og polling
Proalpha API Portal viser ikke noe API for å abonnere på webhooks. Endringer fra Proalpha hentes via:
- en meldingsflyt i INWB som sender nye og endrede produksjonsordrer med tilhørende operasjoner
- en n8n-arbeidsflyt på Proalpha Integration Platform
- tidsstyrt polling av Material API for å hente lagerbeholdning
SkyPlanner sender webhooks når status eller planen endres, så tilbakeskrivingen til Proalpha er hendelsesstyrt.
Datakoblinger
| Proalpha-objekt eller API | SkyPlanner-objekt | Retning | Hyppighet |
|---|---|---|---|
| Part (Part API) | Produkter og materialer | Proalpha → SkyPlanner | Førstegangsimport, deretter ved endringer |
| Produktets prosessmodell: prosess, aktiviteter; BOM-linjer i produksjonsordren | Produktstruktur, delprodukter, prosesstrinn | Proalpha → SkyPlanner | Førstegangsimport, deretter ved endringer |
| Produksjonsordre (Fertigungsauftrag) med antall og leveringsfrist | Ordre og jobber med leveringsfrist og prioritet | Proalpha → SkyPlanner | Sendes fra INWB eller n8n, eller med noen minutters mellomrom |
| Operasjoner i produksjonsordren: targetSetupTime, targetProcessTime, resource | Prosesstrinn med omstillingstider og varighet | Proalpha → SkyPlanner | Sammen med produksjonsordren |
| Ressurser, ressursgrupper, alternative ressursgrupper | Arbeidsstasjoner, arbeidsstasjonsgrupper, alternative arbeidsstasjoner | Proalpha → SkyPlanner | Førstegangsimport |
| Tidsblokker i ressurskalenderen med intensity og overloadIntensity | Skift og arbeidsstasjonenes effektivitet | Proalpha → SkyPlanner | Førstegangsimport; deretter daglig eller vedlikehold i SkyPlanner |
| Lagerbeholdning per MRP-område | Materialbeholdning | Proalpha → SkyPlanner | Hver time eller før hver planleggingskjøring |
| Innkjøpsordrer med leveringsdato | Innkommende materiale på leveringsdatoen | Proalpha → SkyPlanner | Hver time eller før hver planleggingskjøring |
| setWorkOrderOperationDates | Planlagt start og slutt for hver operasjon | SkyPlanner → Proalpha | Ved planendringer, via webhook fra SkyPlanner |
| changeWorkOrderOperationResource | Arbeidsstasjonen planleggingsmotoren har valgt | SkyPlanner → Proalpha | Ved planendringer |
| operationDataEntry (setup, process, combined) | Tidsregistreringer og antall fra Mobile Confirmations | SkyPlanner → Proalpha | Per registrering eller per skift |
| Planleggingsregler i SkyPlanner | Omstillingstidsmatrise, verktøy som ressurser med begrenset kapasitet, antall operatører | Vedlikeholdes i SkyPlanner | Settes opp under innføringen |
Integrasjonsmønstre
1. Førstegangsimport av grunndata. Les artikler via Part API, og importer ressurser, ressursgrupper og kalendere én gang via INWB eller fileksport. Vurder nøye hvilken arbeidsstasjon i SkyPlanner hver Proalpha-ressurs skal kobles til. Alternative ressursgrupper blir til alternative arbeidsstasjoner.
2. Ordresynkronisering. En INWB-meldingsflyt eller n8n-arbeidsflyt sender åpne produksjonsordrer med operasjoner, normtider og ressurser. Lagerbeholdning hentes fra Material API per MRP-område, og åpne innkjøpsordrer via INWB. SkyPlanner regner bestilt materiale som tilgjengelig på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når ordren får statusen Delivered.
3. Tilbakeskriving av planen. For hver operasjon planleggingsmotoren har plassert eller flyttet, kaller integrasjonen setWorkOrderOperationDates med operasjonens guid, start og slutt. Hvis motoren har valgt en annen ressurs, følger et kall til changeWorkOrderOperationResource.
4. Tilbakemeldinger fra produksjonen. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer. Tidsregistreringene holder planen oppdatert og overføres til Proalpha via operationDataEntry. Hvis fabrikken allerede registrerer tilbakemeldinger på PDC-terminaler, bruk bare én kanal for å unngå dobbeltregistreringer.
5. Regler for dataeierskap og konflikter. Dokumenter dem før produksjonssetting:
| Data | Eier |
|---|---|
| Artikler, prosessmodeller, mengder, ordrestatus | Proalpha |
| Operasjonsrekkefølge, start- og sluttider, ressurstildeling | SkyPlanner |
| Omstillingstidsmatrise, verktøy, antall operatører | SkyPlanner |
| Skift og fravær | Ett system, valgt i avklaringen |
| Tilbakemeldinger og lagerposteringer | Proalpha, med data fra SkyPlanner-tidsregistreringer eller PDC |
Hvis Proalpha APS eller Feinplanung er aktivt, må dere bestemme hvilket system som eier operasjonsdatoene. Hvis to planleggingssystemer oppdaterer de samme datoene, overskriver de hverandres endringer. Med Autopilot planlegger SkyPlanner automatisk på nytt når produksjonen endrer seg.
Typiske prosjekttrinn
Implementeringen er normalt fullført i løpet av noen uker etter at innføringen starter. Før det prøver dere løsningen gratis i 30 dager med egne data. Eksporter åpne produksjonsordrer, operasjoner og ressurser fra Proalpha til CSV eller Excel, importer dem og kontroller planen.
- Arbeidsmøte om datakobling. Fastsett koblingstabellen, reglene for dataeierskap, synkroniseringsfrekvensene og kanalen for tilbakemeldinger sammen med Proalpha-partneren.
- Oppsett av grensesnitt. Aktiver REST API-ene og INWB-flytene, opprett den tekniske brukeren og åpne for nettverkstilgang. Først i testsystemet, deretter i produksjonssystemet.
- Førstegangsinnlasting. Artikler, ressurser, ressursgrupper og kalendere.
- Synkronisering av ordrer, lager og innkjøpsordrer. Produksjonsordrer sendes via INWB eller n8n, mens lagerbeholdning hentes med polling, med nye forsøk hvis overføringen feiler.
- Oppsett av begrensninger i SkyPlanner. Omstillingstidsmatrise, verktøy, antall operatører og alternative arbeidsstasjoner.
- Tilbakeskriving av planen. setWorkOrderOperationDates og changeWorkOrderOperationResource; operationDataEntry legges til i dette trinnet.
- Parallellkjøring. Sammenlign datoene i SkyPlanner med gjeldende plan, og korriger grunndata.
- Produksjonssetting. Aktiver tilbakeskriving når dataene stemmer overens.
Dette må dere ta høyde for i en Proalpha-integrasjon
- Ingen objekter for produksjonsruter. Proalpha planlegger ut fra produktenes prosessmodeller. Verktøy som kopieres fra SAP- eller Business Central-prosjekter, leter etter produksjonsruter og går glipp av data. Les operasjoner og BOM-linjer fra produksjonsordren.
- Intensitet i kalenderen. Kalenderblokker inneholder intensity og overloadIntensity. Koble dem til skift og effektivitetsgrader i SkyPlanner i stedet for å kopiere timetallene direkte.
- Måleenheter. Kontroller quantityUnitCode og om normert omstillingstid gjelder per ordre eller per stykk. Feil enheter gir feil i alle varigheter.
- Endepunkter hos kunden. REST-laget kjører på deres Proalpha-server. Brannmurer, porter og sertifikater avgjør når prosjektet kan starte, så få tilgangen på plass tidlig.
- Versjonsnivå. Avklar med partneren hvilke REST API-er Proalpha-versjonen deres tilbyr, før dere fastsetter datakoblingene.
- Dokumentasjon krever innlogging. Proalphas netthjelp ligger bak innlogging i Documentation Portal. Få feltnavnene bekreftet av partneren i stedet for å gjette.
Proalpha-integrasjonen: Hvem setter den opp og gir støtte?
- SkyPlanner-teamet setter opp integrasjonen under innføringen og gir støtte etter produksjonssetting. Hver Proalpha-installasjon er modellert forskjellig. Det er her denne fagkunnskapen kommer til nytte.
- Proalpha-partneren deres kan delta. Partneren kjenner prosessmodellene, INWB-flytene og versjonsnivået deres og kan sette opp API-tilgang. SkyPlanner stiller med REST API, Swagger/OpenAPI-dokumentasjon og webhooks.
- Egne utviklere kan bygge videre på integrasjonen via samme REST API med et API-token. SkyPlanner-teamet hjelper til ved behov. Produktdokumentasjonen er offentlig tilgjengelig i SkyPlanner-dokumentasjonen.
SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og månedlig fakturering. Dere får et pristilbud på integrasjonen tilpasset prosessene og behovene deres, sammen med abonnementet, slik at hele kostnaden er kjent før dere starter. Se hvordan Proalpha planlegger kapasitet i Har proALPHA produksjonsplanlegging som tar hensyn til faktisk kapasitet?, få oversikten på proALPHA-siden, og finn andre systemer i oversikten over ERP-integrasjoner.
Produsenters erfaringer med SkyPlanner
2 hspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-regneark til produksjonsoptimalisering i sanntid.»
Kalle Kalliomäki, forsyningskjedespesialist
UTU · Elektriske tavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 timers arbeidstid hver uke, og en ny arbeidskø når produksjonslinjen på sekunder.
+90%produksjonseffektivitet
«Effektiviteten i produksjonen har økt med 90%.»
Abdul Rucyinga, IT-sjef
Laboratory & Allied · Legemiddelproduksjon
Produksjonseffektiviteten har økt med 90%, og det tar under 30 minutter å lage en optimalisert plan for tre måneder på tvers av alle arbeidsstasjoner.
99,2%leveringspålitelighet
«SkyPlanner har gitt oss bedre oversikt, slik at vi kan identifisere flaskehalser, og gjort produksjonsstyringen tydeligere.»
Toni Tuori, produksjonssjef
Piristeel · Taksikring og regnvannssystemer
Leveringspåliteligheten nådde 99,2% i år, og produksjonsplanleggingen sparer opptil fire timers arbeidstid per dag.
Færrestopp på grunn av materialmangel
«Verdien SkyPlanner gir oss, er et verktøy som fungerer i det daglige, særlig når vi skal fastsette leveringsdatoer.»
Tommi Männistö, leder for produksjonsplanlegging
Eskomatic · Maskinering på oppdrag
Automatisk belastningsplanlegging gir mer nøyaktige leveringsdatoer, og produksjonsstans på grunn av materialmangel har gått kraftig ned.
Vanlige spørsmål
Hvilke Proalpha-grensesnitt bruker integrasjonen?
Proalphas REST API-er brukes til artikler, lagerbeholdning og tilbakeskriving av datoer, ressurser og tilbakemeldinger. INWB-meldingsflyter eller den n8n-baserte Integration Platform overfører produksjonsordrer med operasjonene deres. Fileksporter brukes i prøveperioden og ved masseinnlasting.
Hvor lagres planlagte datoer i Proalpha?
På produksjonsordrens operasjon, via setWorkOrderOperationDates med start- og sluttidspunkter. Hvis planleggingsmotoren har flyttet jobben til en annen maskin, oppdaterer changeWorkOrderOperationResource ressursen.
Støtter Proalpha webhooks?
Proalpha API Portal oppgir ikke noe API for abonnement på webhooks. Endringer overføres til SkyPlanner via INWB-meldingsflyter, n8n-arbeidsflyter eller polling. SkyPlanners egne webhooks gjør tilbakeskrivingen hendelsesstyrt.
Kan operatørenes tilbakemeldinger overføres til Proalpha?
Ja. Tidsregistreringer fra SkyPlanner Mobile Confirmations overføres via operationDataEntry med mengde, medarbeidertid og ressurstid. Bruk bare én tilbakemeldingskanal hvis dere også har PDC-terminaler i bruk.
Trenger vi Proalpha APS, og hva om vi allerede bruker det?
Dere trenger det ikke. SkyPlanner lager selv en produksjonsplan som tar hensyn til faktisk maskin- og bemanningskapasitet, basert på produksjonsordrer, operasjoner og ressurser. Autopilot holder planen oppdatert. Hvis Proalpha APS er aktivt, bestemmer dere i avklaringen hvilket system som eier operasjonsdatoene. SkyPlanner skriver da bare datoene det eier, slik at de to planene aldri overskriver hverandre.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner med en CSV- eller Excel-eksport av produksjonsordrene deres. Kredittkort er ikke nødvendig. Start prøveperioden, eller snakk med salg for å avklare integrasjonens omfang.
