Integrasjoner / ERP / Senior ERP
Veiledning til integrasjon med Senior ERP for produksjonsplanlegging med SkyPlanner APS
Denne veiledningen viser partnere og IT-team hvordan de kobler Senior ERP fra Senior Sistemas (Gestão Empresarial | ERP XT med Senior X) til SkyPlanner APS. SkyPlanner utveksler data med Senior ERP i begge retninger via Seniors egne grensesnitt:
- Produksjonsordrer (OP-er) med trinn, operasjonsruter (roteiros), ressurser og ressurssentre, SKU-er, produktstrukturer, lagerbeholdning og innkjøpsordrer hentes inn.
- Planlagt start og slutt for hvert OP-trinn, sammen med ressursen som er valgt for trinnet, skrives tilbake til OP-en.
- Operatørenes tidsregistreringer skrives tilbake som apontamentos de produção hvis dere ønsker det.
- Senior X Events Hub varsler SkyPlanner når et OP-trinn endrer status, og SkyPlanner sender planendringer via webhooks så snart de skjer.
SkyPlanner-teamet tilpasser integrasjonen til oppsettet deres i Senior ERP under oppstarten og gir støtte etter produksjonssetting. Denne veiledningen er for partnere og utviklere som vil delta i arbeidet eller bygge videre på SkyPlanners dokumenterte REST API (API-referanse) selv.
Integrasjonsgrensesnitt i Senior ERP
ERP XT er et hybridsystem. Seniors dokumentasjon sier at Gestão Empresarial XT «becomes a hybrid system: an on-premises (local) system with integration of cloud solutions» (blir et hybridsystem: et lokalt installert system med integrerte skyløsninger) (Seniors dokumentasjon, oversatt). Et planleggingssystem bruker tre grensesnitt fra Senior:
- G5-nettjenester (SOAP). Tjenester på Senior-serveren deres, navngitt etter modul (com.senior.g5.co.<module>…). Hver tjeneste publiseres i tre WSDL-varianter: sapiens_Sync, sapiens_Async og sapiens_Scheduled. Produksjonstjenestene omfatter com.senior.g5.co.mpr.pcp.ordemproducao, som «calls the same production order generation routine» (kaller den samme rutinen for opprettelse av produksjonsordrer) som ERP-skjermbildet (Seniors dokumentasjon, oversatt), samt tjenester for produkter (com.senior.g5.co.ger.cad.produto) og produksjonsrapportering.
- Senior X Platform REST API-er på api.senior.com.br, for ERP-områdene Senior gjør tilgjengelige i Senior X, som produkter og salgsordrer (Seniors dokumentasjon).
- Events Hub-webhooks. Opprettes i Senior X under Tecnologia > Customização > Events Hub > Webhooks. Manufacturing publiserer hendelsen erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus når et OP-trinn endrer status (Seniors dokumentasjon).
Autentisering og tilgang
- Senior X Platform. Integrasjonen logger inn med POST til platform.senior.com.br på /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, med brukeren angitt som user@tenant. Svaret inneholder et Bearer-tilgangstoken og et oppdateringstoken. Applikasjonsnøkler kan brukes til innlogging med loginWithKey (access key, secret, tenant). REST-kall har en authorization-header og en client_id-header som identifiserer applikasjonen som kobler seg til. Applikasjonen registreres i Senior API-portalen og knyttes til en rolle i ERP-systemet.
- G5-nettjenester. Kallene inneholder parametere for bruker, passord og kryptering. Ved bruk av et Senior X-token erstatter tokenet passordet (Seniors dokumentasjon).
- Tilgangsrettigheter. Opprett en egen Senior-bruker for integrasjonen, med tilgang til dataene innen PCP, konstruksjon, lager og innkjøp som den leser og skriver.
Hos SkyPlanner autentiseres REST API-et med et API-token i Authorization-Token-headeren (SkyPlanner Settings > API), og det er dokumentert i Swagger/OpenAPI. Integrasjonsveiledningen viser hvordan dere utfører de første kallene.
Hendelser og polling
Events Hub dekker det som skjer i produksjonen: Når et OP-trinn endrer status, mottar SkyPlanner en webhook og oppdaterer planen. Andre data hentes ved polling. Nye oppgaver fanges opp ved å filtrere på faste og frigitte OP-er og nylige endringer. Hyppigheten fastsettes per fabrikk: OP-er hentes med noen minutters mellomrom, mens lagerbeholdning hentes hver time.
SkyPlanner sender webhooks når status eller planen endres. Tilbakeskrivingen er dermed hendelsesstyrt.
Datakobling
| Objekt i Senior ERP (grensesnitt) | SkyPlanner-objekt | Retning | Frekvens |
|---|---|---|---|
| SKU: produto og derivação, måleenheter (G5-nettjenester eller Senior X-entiteter) | Produkter og materialer | Senior → SkyPlanner | Førstegangsinnlasting, deretter polling |
| Produktstruktur (engenharia do SKU) | Produktstruktur, delprodukter, materialer per produkt | Senior → SkyPlanner | Førstegangsinnlasting, deretter ved endringer |
| Roteiro med estágios: rekkefølge, avhengighet av forrige trinn | Prosesstrinn i rekkefølge | Senior → SkyPlanner | Førstegangsinnlasting, deretter ved endringer |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Arbeidsstasjoner, varigheter, klargjørings- og nedriggingstider, effektivitetsverdier | Senior → SkyPlanner | Førstegangsinnlasting, deretter sjelden |
| Centro de recurso | Arbeidsstasjonsgrupper | Senior → SkyPlanner | Førstegangsinnlasting, sjelden deretter |
| Calendário: Feriados, produksjonskalender per skift | Skift og fridager | Senior → SkyPlanner | Daglig, eller egne skift i SkyPlanner |
| Ordens de produção (Firme, Liberada) med trinn og materialer | Ordrer og jobber med leveringsfrister og materialbehov | Senior → SkyPlanner | Polling med få minutters mellomrom |
| Status for OP-trinn (Events Hub orderProductionStageChangeStatus) | Fremdrift for jobber | Senior → SkyPlanner | Sanntid via webhook |
| Estoque per SKU | Lagerbeholdninger | Senior → SkyPlanner | Polling hver time eller ved planleggingskjøring |
| Ordens de compra med leveringsdatoer | Innkjøpsordrer, inngående materialer etter leveringsdato | Senior → SkyPlanner | Polling hver time eller ved kjøring av planleggingen |
| OP-trinn: planlagt start og slutt, ressurs | Planlagt start og slutt per jobb, tildelt arbeidsstasjon | SkyPlanner → Senior | Ved planendring, via SkyPlanner-webhook |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, dato og klokkeslett for start og slutt | Tidsregistreringer og operatørbekreftelser | SkyPlanner → Senior | Per bekreftelse eller per skift, hvis valgt |
| Finnes ikke i Senior ERP | Matrise for omstillingstider, verktøy som ressurser med begrenset kapasitet, jobber med flere operatører, alternative maskiner og personell | Vedlikeholdes i SkyPlanner | Settes opp under oppstarten |
Integrasjonsmønstre
1. Førstegangsinnlasting av grunndata. Hent SKU-er, strukturer, roteiros, recursos, centros de recurso og produksjonskalenderen. Bestem nøye hvordan ressurssentrene skal kobles: Et centro de recurso med fire maskiner blir én arbeidsstasjonsgruppe eller fire arbeidsstasjoner. Konverter Fator de carga til enten arbeidsstasjonseffektivitet i SkyPlanner eller skift, ikke begge deler.
2. Synkronisering av OP-er. Hent OP-er med status Firme og Liberada, med tilhørende trinn og materialer, samt åpne innkjøpsordrer. OP-er med status Planejada kan fortsatt endres eller slettes av MRP. Ta dem derfor bare med i planen hvis dere ønsker oversikt fremover. SkyPlanner regner bestilt materiale som tilgjengelig på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered.
3. Tilbakeskriving av planen. Når planleggingsmotoren plasserer eller flytter et trinn, utløser en SkyPlanner-webhook tilbakeskrivingen. Den angir planlagt start og slutt for hvert OP-trinn og ressursen som er valgt for det. Dette er de samme feltene planleggeren redigerer i Programação de produção. Under avklaringen avtaler SkyPlanner-teamet med dere og Senior-partneren deres nøyaktig hvilken nettjeneste som skal brukes.
4. Bekreftelser fra produksjonen. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringene holder planen oppdatert. Dere velger om faktiske tider skal skrives tilbake til Senior. Hvis dere velger dette, blir hver bekreftelse et apontamento de produção på OP-trinnet, med produsert mengde, vrak og start- og sluttider. Senior godtar bare produksjonsrapportering på OP-er med status Liberada eller Andamento. Hvis dere rapporterer via Fábrica ao Vivo, henter SkyPlanner i stedet fremdriften gjennom Events Hub.
5. Regler for dataeierskap og konflikter. Dokumenter dem før produksjonssetting:
| Data | Eier |
|---|---|
| SKU-er, strukturer, roteiros, OP-mengder og -status | Senior ERP |
| Trinnrekkefølge, start- og sluttider, ressurstildeling | SkyPlanner |
| Matrise for omstillingstider, krav til verktøy og operatører, alternative ressurser | SkyPlanner |
| Produksjonskalender og skift | Ett system, valgt under avklaringen |
| Apontamentos, lagerbevegelser, kostnadsberegning | Senior ERP, registrert der eller overført fra tidsregistreringer i SkyPlanner |
La bare ett system skrive datoene for trinnene. Hvis planleggerne fortsatt bestemmer rekkefølgen for de samme OP-ene i Programação de produção eller Gantt-diagrammet, må dere avtale hvilke OP-er SkyPlanner har ansvaret for.
Typiske prosjekttrinn
Implementeringen er normalt ferdig i løpet av noen uker etter at oppstartsarbeidet begynner. Før dette validerer dere planen i den gratis prøveperioden på 30 dager, med ressurser, roteiros og åpne OP-er eksportert fra Senior som CSV eller Excel.
- Datakobling. Fastsett koblingstabellen, reglene for dataansvar, synkroniseringshyppigheten og om apontamentos skal skrives tilbake.
- Tilgang til Senior. Opprett integrasjonsbrukeren, registrer applikasjonen i Senior API-portalen, og aktiver G5-nettjenestene og Events Hub-webhooken. Test først i en testdatabase.
- Førstegangsinnlasting. SKU-er, strukturer, roteiros, recursos, centros de recurso, kalender.
- Synkronisering av OP-er og innkjøpsordrer. Polling med filtre og nye forsøk ved feil, samt webhook for trinnstatus.
- Oppsett av begrensninger i SkyPlanner. Matrise for omstillingstider, verktøy, antall operatører per jobb og alternative maskiner eller medarbeidere.
- Tilbakeskriving av planen. Datoer og ressurser for trinn fra SkyPlanner-webhooks, samt apontamentos hvis dette er valgt.
- Parallelltesting. Kjør SkyPlanner parallelt med den gjeldende planleggingen, sammenlign datoer og korriger grunndata.
- Produksjonssetting. Slå på tilbakeskriving når dataene stemmer overens.
Hva dere må ta høyde for ved integrasjon med Senior ERP
- Fire tidsverdier per ressurs. Recurso inneholder prosesstid, klargjøringstid, tid for lasting og lossing samt overføringstid. Laste- og overføringstid kan være håndteringstid, ikke maskintid. Bestem hvordan hver tidsverdi skal kobles for hver ressurs, ellers blir alle varigheter feil.
- Én klargjøringstid per ressurs. Seniors Tempo setup er én enkelt verdi. Bygg matrisen for omstillingstider i SkyPlanner ut fra de faktiske omstillingene deres under oppstarten.
- Varianter. En SKU i Senior består av et produkt og en derivação, og roteiros kan variere mellom variantene. Ta variantkoden med i produktnøklene i SkyPlanner.
- OP-statuser. Bare OP-er med status Liberada og Andamento godtar produksjonsrapportering. Gjør statusendringene i Senior, og la SkyPlanner følge dem gjennom Events Hub.
- Hybrid drift. G5-nettjenestene kjører på Senior-serveren din, mens Events Hub kjører i Senior X. Planlegg nettverkstilgang til begge.
- Tallformat. Nettjenestene i Senior avviser tall med tusenskilletegn og krever desimalkomma. Send tallene i dette formatet.
Hvem setter opp og gir støtte for integrasjonen med Senior ERP?
- SkyPlanner-teamet setter opp integrasjonen under innføringen og gir støtte etter driftsstart. Dette omfatter de avtalte nettjenestene, API-ene i Senior X og webhookene i Events Hub. Hver fabrikk bruker Senior ERP på sin egen måte, og denne kunnskapen tas med i arbeidet.
- Senior-partneren din kan delta. Partneren kjenner oppsettet, tilpasningene og lisensene dine, og kan sette opp integrasjonsbrukeren, registreringen i API-portalen og nettjenestene sammen med SkyPlanner-teamet.
- Dine egne utviklere kan bygge videre på integrasjonen via SkyPlanners REST API med et API-token. Et API-token er nok for å komme i gang, og SkyPlanner-teamet hjelper til ved behov. Du finner dokumentasjonen under SkyPlanners integrasjonsdokumentasjon.
SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og faktureres månedlig. Du får et pristilbud på integrasjonen på forhånd, tilpasset prosessene og behovene dine, sammen med abonnementet. Se priser, produksjonsplanlegging med Senior ERP innenfor faktisk maskin- og bemanningskapasitet, siden om Senior ERP og oversikten over ERP-integrasjoner.
Produsentenes erfaringer med SkyPlanner
2 hspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-regneark til produksjonsoptimalisering i sanntid.»
Kalle Kalliomäki, spesialist på forsyningskjeder
UTU · Elektrotavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 timers arbeid hver uke, og en ny jobbkø er ute på produksjonslinjen i løpet av 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.
Flere 1 000arbeidsordrer 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 blandere, pumper og høyteknologisk kontraktsproduksjon
Tusenvis av arbeidsordrer planlegges automatisk, og hele organisasjonen har oversikt over produksjonen i sanntid.
Færrestans på grunn av materialmangel
«Verdien av SkyPlanner for oss er at det er et verktøy som fungerer i hverdagen, særlig når vi skal fastsette leveringsdatoer.»
Tommi Männistö, leder for produksjonsplanlegging
Eskomatic · Maskinering på oppdrag
Automatisk planlegging av produksjonsbelastningen gir mer presise leveringsdatoer, og antallet produksjonsstans på grunn av materialmangel har gått kraftig ned.
Ofte stilte spørsmål
Har Senior ERP et API for produksjonsordrer?
Ja. G5-nettjenesten com.senior.g5.co.mpr.pcp.ordemproducao oppretter OP-er med samme rutine som i ERP-skjermbildet, og andre G5-tjenester dekker produkter og produksjonsrapportering. Senior X Platform tilbyr i tillegg REST API-er med pålogging via Bearer-token og webhooks fra Events Hub.
Støtter Senior ERP webhooks?
Ja. Senior X Events Hub sender webhooks, blant annet orderProductionStageChangeStatus når et OP-trinn endrer status. SkyPlanner bruker dette til å følge fremdriften i produksjonen i sanntid, og sender planendringer tilbake via sine egne webhooks.
Hvordan skrives planlagte datoer tilbake til Senior ERP?
SkyPlanner angir planlagt start og slutt for hvert OP-trinn og ressursen som er valgt for det. Dette er de samme feltene som planleggeren redigerer i Programação de produção. Hver gang planen endres, utløser en webhook fra SkyPlanner tilbakeskriving via forbindelsen som SkyPlanner-teamet fastsetter for Senior-installasjonen din som en del av avklaringen under innføringen.
Fungerer integrasjonen med Senior X og ERP XT?
Ja. ERP XT kjører på serveren din med skytjenester i Senior X. Integrasjonen bruker G5-nettjenester på serveren. I skyen bruker den API-ene i Senior X og Events Hub.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner med import fra Senior via CSV eller Excel. Du trenger ikke kredittkort. Start prøveperioden, eller snakk med salgsteamet for å avklare omfanget av integrasjonen.
