Integrasjoner / ERP / Sage X3
Integrasjonsguide for Sage X3 og produksjonsplanlegging med SkyPlanner APS
Denne guiden viser Sage-partnere og IT-team hvordan de kobler Sage X3 til SkyPlanner APS. Den beskriver hvilke X3-grensesnitt dere skal bruke, hvilke objekter dataene ligger i, og hvor prosjekter går galt. SkyPlanner integreres med Sage X3 i begge retninger, både i skyen og lokalt:
- Produksjonsordrer, operasjoner, produksjonsruter, arbeidssentre, kalendere, lagerbeholdning og åpne innkjøpsordrer hentes inn.
- Planlagte operasjonsdatoer og arbeidssentre skrives tilbake til produksjonsordrene (GESMFG).
- Operatørenes tidsregistreringer bokføres som produksjonsoppfølging (GESMTK).
- SkyPlanners webhooks sender planendringer fortløpende.
SkyPlanner-teamet tilpasser integrasjonen til deres X3-oppsett under innføringen og gir støtte etter produksjonssetting.
Hvis dere fortsatt vurderer om X3 i det hele tatt trenger et verktøy for produksjonsplanlegging som tar hensyn til faktisk maskin- og bemanningskapasitet, bør dere først lese Har Sage X3 produksjonsplanlegging? Se SkyPlanner APS for Sage X3 for en produktoversikt, og oversikten over ERP-integrasjoner for andre ERP-systemer.
SkyPlanners rolle i et X3-miljø
Standardplanleggingen i Sage X3 (FUNMAUTJ) setter operasjonene i rekkefølge ut fra data i produksjonsruten, men planlegger hver produksjonsordre uavhengig av de andre. En brukerstøtteveiledning fra Sage UK sier det rett ut: «does not delay or stagger work orders based on overall resource load.» (utsetter eller forskyver ikke produksjonsordrer ut fra den samlede ressursbelastningen). Produksjonsplanlegging som tar hensyn til tilgjengelig ressurskapasitet, ligger i et eget lag, og Sage tilbyr to alternativer:
- Production Scheduler (aktivitetskode POPS), kun for lokale installasjoner.
- Det generiske grensesnittet Finite scheduler (aktivitetskode GFS), som kobler X3 i skyen eller lokalt til Sage X3 Web Scheduling eller et planleggingsverktøy fra en uavhengig programvareleverandør.
SkyPlanner fyller denne rollen som et eksternt, skybasert planleggingsverktøy via standard-API-ene i X3. Derfor fungerer det likt med X3 i skyen og lokalt. MRP (FUNMRP) oppretter fortsatt forslag til produksjonsordrer og innkjøpsordrer. SkyPlanner setter faste og planlagte produksjonsordrer i rekkefølge ut fra faktisk kapasitet.
Integrasjonsmuligheter i Sage X3
Driftsmodellen avgjør fremgangsmåten. Sage X3 i skyen gir ikke tredjepartsapplikasjoner tilgang til verken applikasjonens filsystem eller databasen. Integrasjonen går derfor via API-er eller en driftet filoverføringstjeneste. Med lokal installasjon kan dere også bruke direkte filimport og mellomlagringstabeller i X3-databasen.
| Alternativ | Beskrivelse | Autentisering | Bruksområde |
|---|---|---|---|
| GraphQL API (Sage X3 Web API) | Sages «technology of choice» (foretrukne teknologi) for X3-API-er; videreutvikles uten versjoner | JWT (HS256) signert med Secret fra en Connected application, Client ID som iss, URL som aud, egen Syracuse-bruker | Produkter, anlegg, innkjøp og lager; produksjonsnoder der de er tilgjengelige |
| REST api1 | REST basert på representasjoner: .../api1/x3/$$prod/<FOLDER>.<ENTITY>?representation=<REP>.$query | Syracuse-autentisering | Entiteter som ikke er tilgjengelige via GraphQL |
| SOAP-nettjenester for objekter | Objekter publisert i Web services (GESAWE); feltene er objektets skjermfelt; lesing, lagring og endring | OAuth2 på tilkoblingspooler i Syracuse | Tilbakeskriving til Work order (GESMFG) og Production tracking (GESMTK) |
| SOAP Template Services | Import-/eksportmaler over SOAP via AOWSIMPORT og AOWSEXPORT | OAuth2; X3 tillater ikke Basic-autentisering for SOAP | Maler som kjøres fra mellomvare |
| Import-/eksportmaler | Malbaserte filer for satsvis behandling | Filsystem (lokal installasjon) eller driftet filoverføring (sky) | Førstegangsinnlasting og nattlig massesynkronisering |
| Sync API (Cloud BI) | Kun i skyen: inkrementelt uttrekk med kun lesetilgang samt NDJSON-strøm; tilgjengelig på forespørsel via Sage ISV-representanten din | Bearer-token samt X-API-KEY per tenant | Lesing av store mengder endringer i skyen |
For GraphQL i en lokal installasjon må "bearer" legges til i session.auth-arrayet i nodelocal.js. I Sage X3 SaaS er autentisering for tilkoblede apper aktivert som standard. I Sage X3 Cloud kan den tilkoblede appen ikke bruke admin-brukeren: Opprett i stedet en Syracuse-bruker med Standard-autentisering.
Hvilket grensesnitt brukes til hvilken dataflyt?
- Produkter, lokasjoner, innkjøp og lagerbeholdning: GraphQL, som i Sages offisielle eksempler.
- Produksjonsordrer, operasjoner, produksjonsruter og arbeidssentre: REST api1-representasjoner eller eksportmaler som kjøres via AOWSEXPORT. I versjoner der GraphQL-skjemaet eksponerer produksjonsdomenet (
xtremX3Manufacturing), leser integrasjonen de samme dataene derfra. - Operasjonsdatoer og arbeidssentre tilbake til X3: SOAP-webtjenesten Work order (GESMFG), med operasjonen modify. Alternativ løsning: importmal via AOWSIMPORT.
- Produksjonsoppfølging: SOAP-webtjenesten Production tracking (GESMTK), med operasjonen save.
Det samme oppsettet fungerer med X3 både i skyen og lokalt, siden ingen av delene krever direkte tilgang til filsystemet eller databasen. Ingenting installeres i X3: Integrasjonen bruker en tilkoblet applikasjon, en Syracuse-bruker og webtjenester publisert i GESAWE.
Hendelser: legg opp til polling
Sages offentlige utviklerdokumentasjon for X3 beskriver ingen funksjon for utgående webhooks eller forretningshendelser. Innstillingen «Callback URL», som ble lagt til i 2024 R1, brukes av Mobile Automation og Web Scheduling når de kaller SOAP-webtjenester. Den er ikke et generelt hendelsessystem. Oppdag endringer med planlagte avlesninger: GraphQL-spørringer, tidsstempelmarkøren i Sync API i skyen eller periodiske eksporter med maler.
Datakobling: fra Sage X3 til SkyPlanner
| Sage X3-objekt (tabell, funksjon) | SkyPlanner-objekt | Retning | Hyppighet |
|---|---|---|---|
| Produkt, ITMMASTER | Produkt | X3 → SkyPlanner | Ved oppstart, deretter etter tidsplan |
| Produksjonsstykkliste (GESBODP) | Produktstruktur med flere nivåer, materialer | X3 → SkyPlanner | Ved oppstart, deretter ved endringer |
| Produksjonsrute (GESROU): OPENUM, arbeidssenter WST, SETTIM, OPETIM, tidsenhet TIMUOMCOD | Prosesstrinn med omstillings- og kjøretider | X3 → SkyPlanner | Ved oppstart, deretter ved endringer |
| Arbeidssenter (GESMWS, WORKSTATIO): WST, WSTTYP, WSTNBR, EFF, SHR, erstatninger med prioritet | Arbeidsstasjon, effektivitet, alternativer | X3 → SkyPlanner | Ved oppstart, sjelden deretter |
| Arbeidssentergruppe (WCR) | Arbeidsstasjonsgrupper | X3 → SkyPlanner | Ved oppstart |
| Ukestruktur (TWD), arbeidstidstabeller, tabell for kapasitetsvariasjoner, DEFDIH | Skift, overtidsskift, fravær | X3 → SkyPlanner | Ved oppstart, deretter ved endringer |
| Produksjonsordrer: MFGHEAD, MFGOPE, med produkter og materialer | Ordre, materialer, prosesstrinn | X3 → SkyPlanner | Polling med 5 til 15 minutters intervall |
| Lagerbeholdning per lokasjon | Lagersaldoer | X3 → SkyPlanner | Polling |
| Innkjøpsordrer (POH): åpne linjer, forventet mottaksdato | Innkommende materialer med forventet leveringsdato | X3 → SkyPlanner | Polling med 5 til 15 minutters intervall |
| Operations-fanen i GESMFG: Start OPESTR, End OPEEND, arbeidssenter | Planlagt start, slutt og valgt arbeidsstasjon | SkyPlanner → X3 | Ved endringer i planen (webhook) |
| Produksjonsoppfølging (GESMTK): operasjonstider, mengder, materialoppfølging, produksjonsrapportering | Tidsregistreringer, mengder, materialforbruk | SkyPlanner → X3 | Ved hver bekreftelse (webhook) |
Hent alltid faste produksjonsordrer. Hent også planlagte ordrer hvis planleggerne vil se dem som foreløpig belastning i Gantt-diagrammet. Forslag blir liggende i MRP til de konverteres til produksjonsordrer.
Integrasjonsmønstre
1. Første innlasting av grunndata. Last inn arbeidssentre og kalendere først, deretter produkter, stykklister og produksjonsruter, siden produksjonsrutene refererer til arbeidssentre.
2. Ordresynkronisering. Bruk polling av MFGHEAD og MFGOPE for å hente nye og endrede produksjonsordrer. Koble hver MFGOPE-linje til et prosesstrinn i SkyPlanner på arbeidsstasjonen som er angitt av WST-koden. Synkroniser åpne innkjøpsordrer i samme syklus. SkyPlanner regner bestilte materialer som tilgjengelige på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren får status Delivered. Materialkontrollene dekker da både lagerbeholdning og innkommende leveranser.
3. Tilbakeskriving av planen. SkyPlanners webhook utløses når planen endres. Integrasjonen kaller modify-operasjonen på Work order-objektet (GESMFG), som er publisert som en SOAP-webtjeneste i GESAWE. Den oppdaterer Start (OPESTR), End (OPEEND) og arbeidssenteret for hver endret operasjon. Ved satsvise oppdateringer overføres de samme feltene via en importmal for produksjonsordrer i AOWSIMPORT. Skriv bare datoer og arbeidssentre, aldri mengder, stykklistelinjer eller produksjonsruter.
4. Maskinvalget tilbake til X3. Når arbeidssentrene er koblet én til én, skrives motorens valg blant alternative maskiner tilbake som operasjonens arbeidssenter. Dermed registrerer X3 maskinen som faktisk kjører jobben. Når et arbeidssenter i X3 representerer en gruppe maskiner, vises den enkelte maskinen i operatørens kø. X3 mottar gruppens arbeidssenter sammen med de planlagte datoene.
5. Bekreftelser fra produksjonsgulvet. Operatørene registrerer arbeid med Mobile Confirmations eller Production Timer. Integrasjonen bokfører hver bekreftelse med save-operasjonen på Production tracking-objektet (GESMTK): operasjonstid og mengde i operasjonsoppfølgingen, samt materialforbruk hvis dere registrerer det der. X3 godtar bare registreringer på produksjonsordrer med status Firm, og komponentene må være tilgjengelige med mindre Release if shortage (MFGSHTCOD) er valgt for kombinasjonen av produkt og lokasjon.
6. Pålitelig synkronisering. Bruk ID-en til SkyPlanner-tidsregistreringen som nøkkel for hver bokføring, og lagre oppfølgingsnummeret som ble opprettet i X3. Da vil en gjentatt webhook aldri føre til dobbel bokføring. Fjern produksjonsordrer som er lukket eller kansellert i X3 fra planen ved neste polling. Loggfør avviste kall med feilmeldingen fra X3 i stedet for å prøve på nytt i blinde. Legg endringer i kø mens X3 er utilgjengelig, slik at de bokføres i riktig rekkefølge når systemet er tilgjengelig igjen.
7. Regler for dataansvar. X3 styrer hva som lages: produkt, mengde, stykkliste, produksjonsrute og lokasjon. SkyPlanner styrer når og hvor: rekkefølge, arbeidsstasjon og start- og sluttider. Avtal at planleggerne slutter å omplanlegge i Planning workbench og å kjøre FUNMAUTJ på ordrer som styres av SkyPlanner. Ellers overskrives endringene deres ved neste tilbakeskriving.
Typiske prosjekttrinn
Implementeringen er normalt fullført i løpet av noen uker etter at innføringen starter. Et Sage X3-prosjekt omfatter:
- Utprøving med egne data. Eksporter arbeidssentre, produksjonsruter og et øyeblikksbilde av åpne produksjonsordrer med X3-eksportmaler eller Excel, og importer dem som CSV. Juster skift, effektivitet og prioriteringer til Gantt-diagrammet gjenspeiler virkeligheten.
- Kobling av grunndata. Koble GESMWS-arbeidssentre til arbeidsstasjoner, GESROU-operasjoner til prosesstrinn, og tidsenheter og ukestrukturer til skift. Rett samtidig opp operasjoner i produksjonsrutene som mangler arbeidssenter, dager uten arbeidstidstabeller og feil tidsenheter.
- Førstegangsinnlasting. Produkter, produksjonsstykklister, produksjonsruter og arbeidssentre, deretter kalendere.
- Synkronisering av ordrer og innkjøpsordrer. Tilkoblet applikasjon, Syracuse-bruker, GraphQL-spørringer eller malbasert eksport, og en jobb som regelmessig henter produksjonsordrer, lagerbeholdning og åpne innkjøpsordrer.
- Tilbakeskriving av planen. SOAP-webtjenesten Work order publisert i GESAWE, med feilhåndtering og logging.
- Tilbakemeldinger fra produksjonsgulvet. Registreringer fra Mobile Confirmations sendes til X3 gjennom nettjenesten Production tracking (GESMTK).
- Testing parallelt med gjeldende plan. Planleggerne sammenligner begge planene før overgangen.
- Produksjonssetting. Slå av manuell omplanlegging i X3 for ordrer som styres av SkyPlanner.
Fallgruver i Sage X3
- Forslag er ikke produksjonsordrer. MRP-forslag har ingen MFGOPE-operasjonslinjer før de konverteres til planlagte eller fastlagte produksjonsordrer. Planlegg derfor de konverterte ordrene, ikke forslagene.
- Hull i kalenderen. En arbeidsdag uten arbeidstidsplan bruker standardskjemaet DEFDIH. En tom dag uten standard gir feil datoer og belastning. Gi hver arbeidsdag i hver ukestruktur en arbeidstidsplan før du eksporterer kalenderne.
- Utdaterte belastningsperioder. Når kapasitet eller kalendere endres, oppdateres ikke eksisterende belastningsperioder i X3 før du planlegger på nytt og kjører Recalculate loads (FUNMIWL). Ikke valider SkyPlanner mot en utdatert Loads inquiry (CONSMWK).
- No. of resources angir bemanningen. WSTNBR er antallet ressurser en operasjon trenger ved arbeidssenteret, for eksempel tre personer ved et arbeidskraftbasert arbeidssenter. Koble dette til antallet operatører på arbeidsstasjonen i SkyPlanner, som planlegger flere personer på samme jobb samtidig. Anlegg som har brukt GFS-grensesnittet for avansert planlegging, har verdien satt til 1, slik Sage krever. Kontroller derfor hvor den faktiske bemanningen er angitt.
- Operasjoner i produksjonsruten som mangler arbeidssenter kan ikke plasseres på en arbeidsstasjon. Disse blir flagget når datakoblingene settes opp.
- Tidsenheter og alternative arbeidssentre. Tidene i produksjonsruten har sin egen tidsenhet (TIMUOMCOD), og alternative arbeidssentre har en prioritet. Koble begge eksplisitt, og kontroller datakoblingene på nytt etter hver X3-oppgradering.
- Låste ordrer. Hvis anlegget også har brukt Production Scheduler, har ordrer som er sendt dit, statusen Being optimized. De kan ikke endres før de fjernes fra planleggingen (PSOPTFREE). Frigi dem før overgangen.
Hvem setter opp integrasjonen med Sage X3?
Arbeidet omfatter å koble deres mapper, konvensjoner for produksjonsruter, arbeidssenterstrukturer og spesialutviklede løsninger til SkyPlanner. Det omfatter også begrensninger som X3 ikke lagrer som planleggingsdata: omstillingstidsmatrise, verktøy, antall operatører og alternative ressurser.
- SkyPlanner-teamet setter opp integrasjonen under oppstarten og følger den opp etter produksjonssetting. Hvert anlegg bruker X3 på sin måte, og denne kunnskapen tas inn i oppsettet. Teamet kobler til X3-endepunktet deres, enten det ligger i skyen eller lokalt, validerer grunndata når datakoblingene settes opp, og logger avvisninger fra X3 for oppfølging. Integrasjonen har en tydelig ansvarlig fra første dag, og dere trenger ingen egen integrasjonsutvikler.
- Sage-partneren deres kan delta. Partneren kjenner mappene, aktivitetskodene og de spesialutviklede løsningene deres, og kan gjennomgå den tilkoblede applikasjonen, Syracuse-brukeren og publiseringene i GESAWE sammen med teamet.
- Egne utviklere kan bygge videre på integrasjonen. SkyPlanners REST API leser og skriver ordrer, produkter, materialer, prosesstrinn og tidsregistreringer, med JWT-autentisering og Swagger/OpenAPI-dokumentasjon (API-referanse). En API-nøkkel er nok for å komme i gang, og integrasjonsveiledningen tar dere gjennom de første kallene. SkyPlanner-teamet bistår ved behov. SkyPlanner-dokumentasjonen dekker produkter og materialer og innkjøpsordrer. Hos Laboratory & Allied koblet det interne IT-teamet SkyPlanner til SAP Business One i stor grad på egen hånd, med hjelp fra SkyPlanner.
Derfor velger X3-team SkyPlanner til produksjonsplanleggingen
Velg SkyPlanner når dere vil være i drift i løpet av uker, ikke etter et APS-prosjekt som varer i flere måneder.
Velg SkyPlanner når dere vil ha planleggingen i gang før integrasjonen er ferdig.
Planleggerne bruker CSV-data til å planlegge i prøveperioden mens lesing fra og tilbakeskriving til X3 settes opp. Når integrasjonen er i drift, erstatter den filimporten.
Velg SkyPlanner når dere vil holde integrasjonsoppsettet enkelt.
Webhooks sender plan- og statusendringer i sanntid, så mellomvaren trenger bare å hente oppdateringer regelmessig fra X3. Arcturus AI-motoren lager planen på sekunder, og Autopilot omplanlegger automatisk når produksjonen endrer seg.
Velg SkyPlanner når X3-dataene skal danne grunnlaget for en modell av de faktiske begrensningene.
Bemanningstall blir til flere operatører på samme arbeidsstasjon, og alternative arbeidssentre blir til alternative maskiner. Omstillingstidsmatrisen legger inn omstillinger mellom produkter ut fra rekkefølgen. Verktøy behandles som begrensede ressurser, slik at en fikstur som er i bruk på én maskin, aldri blir reservert på en annen samtidig.
Velg SkyPlanner når produksjonsoppfølgingen skal starte på produksjonsgulvet.
Operatørene registrerer arbeid på telefon eller nettbrett med Mobile Confirmations, Production Timer og Quick Log Mode. De samme tidsregistreringene sendes til X3 som produksjonsregistreringer.
Prisen starter på 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 dere ser hele kostnaden før dere starter. Se priser og funksjoner, eller start en gratis prøveperiode på 30 dager med opptil 20 arbeidsstasjoner, uten kredittkort.
Produksjonsbedrifters 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 arbeidstimer hver uke, og en ny jobbkø 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 som dekker alle arbeidsstasjonene.
98%leveringspålitelighet, opp fra omtrent 50%
«SkyPlanner spiller en avgjørende rolle i å opprettholde leveringspåliteligheten vår.»
Hannu Lahtinen, daglig leder
KJH-Comp · Platemekanikk og kontraktsproduksjon
Leveringspåliteligheten steg fra rundt 50% til hele 98%, og planleggingen krever nå én arbeidsleder i stedet for to.
99,2%leveringspålitelighet
«SkyPlanner har gjort det lettere å se flaskehalsene og gitt oss tydeligere produksjonsstyring.»
Toni Tuori, produksjonssjef
Piristeel · Taksikring og regnvannssystemer
Leveringspåliteligheten nådde 99,2% i år, og planleggingen sparer opptil fire arbeidstimer per dag.
Ofte stilte spørsmål
Hvordan integreres SkyPlanner APS med Sage X3?
I begge retninger, via GraphQL, REST api1, SOAP-nettjenester og maler. Produksjonsordrer, produksjonsruter og arbeidssentre hentes inn. Planlagte operasjonsdatoer og registrerte timer sendes tilbake via webhooks når planen endres. SkyPlanner-teamet setter opp integrasjonen under oppstarten, eller Sage X3-partneren eller utviklerne deres bygger den med SkyPlanners REST API.
Hvordan skrives operasjonsdatoer tilbake til Sage X3?
Gjennom objektet Work order (GESMFG), publisert som en SOAP-nettjeneste i funksjonen Web services (GESAWE). Operasjonen modify oppdaterer Start (OPESTR), End (OPEEND) og arbeidssenteret for hver operasjon. Ved satsvise oppdateringer kjøres en importmal for produksjonsordrer gjennom AOWSIMPORT. Timer og mengder sendes gjennom objektet Production tracking (GESMTK).
Bør vi bruke GraphQL eller SOAP-nettjenester?
Begge, der hver av dem er best egnet. GraphQL er API-et Sage anbefaler, og leser produkter, anlegg, innkjøp og lagerbeholdning både i skyen og lokalt. SOAP-nettjenester for objekter skriver planen og produksjonsregistreringene, mens SOAP Template Services kjører import- og eksportmaler for masseinnlasting.
Hvordan unngår vi doble registreringer eller tapte endringer?
Bruk ID-en til tidsregistreringen i SkyPlanner som nøkkel for hver registrering i Production tracking, og lagre registreringsnummeret som X3 returnerer. Da blir gjentatte webhooks gjenkjent og hoppet over. Legg endringer i kø mens X3 er utilgjengelig, og send dem i rekkefølge når forbindelsen er tilbake. Logg avvisninger sammen med feilmeldingen fra X3, for eksempel registreringer på en produksjonsordre som ikke har status Firm.
Trenger vi aktivitetskodene POPS eller GFS for SkyPlanner?
Nei. De aktiverer Sages egen Production Scheduler og det generiske grensesnittet mot Web Scheduling. SkyPlanner leser produksjonsordrer gjennom GraphQL, REST api1 eller maler, og skriver tilbake gjennom SOAP-nettjenestene Work order og Production tracking.
Hvordan henter SkyPlanner nye produksjonsordrer fra Sage X3?
Integrasjonen henter data fra X3 med korte intervaller via GraphQL, REST api1 eller malbaserte eksporter, eller via Sync API i skyen. I motsatt retning sender SkyPlanner endringer i planen via webhooks så snart de skjer.
Kan vi teste med data fra Sage X3 før vi bygger noe?
Ja. Importer CSV-eksporter av arbeidssentre, produksjonsruter og åpne produksjonsordrer i løpet av prøveperioden på 30 dager. Kontakt salg for å avklare omfanget av selve X3-integrasjonen.
