Integrationer / ERP / Senior ERP
Guide til Senior ERP integration med SkyPlanner APS til produktionsplanlægning
Denne guide til Senior ERP integration viser partnere og IT-teams, hvordan de forbinder Senior ERP fra Senior Sistemas (Gestão Empresarial | ERP XT med Senior X) med SkyPlanner APS. SkyPlanner integreres med Senior ERP i begge retninger via Seniors egne grænseflader:
- Produktionsordrer (OP’er) indlæses med deres trin, ruter (roteiros), ressourcer og ressourcecentre samt SKU’er, produktstrukturer, lagerbeholdninger og indkøbsordrer.
- Planlagt start og slut for hvert OP-trin samt den valgte ressource skrives tilbage til produktionsordren.
- Operatørernes tidsregistreringer skrives tilbage som apontamentos de produção, hvis I vælger det.
- Senior X Events Hub giver SkyPlanner besked, når et OP-trin skifter status, og SkyPlanner sender planændringer via webhooks, så snart de sker.
SkyPlanner-teamet tilpasser integrationen til jeres Senior ERP-opsætning under opstarten og yder support efter idriftsættelsen. Denne guide er til partnere og udviklere, der vil deltage eller selv bygge videre på SkyPlanners dokumenterede REST API (API-reference).
Integrationsgrænseflader i Senior ERP
ERP XT er en hybrid. Seniors dokumentation beskriver Gestão Empresarial XT sådan: “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (bliver et hybridsystem: et lokalt installeret system med integration af cloudløsninger) (Seniors dokumentation, oversat). Et planlægningssystem bruger tre grænseflader fra Senior:
- G5-webservices (SOAP). Tjenester på jeres Senior-server, navngivet efter modul (com.senior.g5.co.<module>…). Hver tjeneste udstilles i tre WSDL-varianter: sapiens_Sync, sapiens_Async og sapiens_Scheduled. Produktionstjenesterne omfatter com.senior.g5.co.mpr.pcp.ordemproducao, som “calls the same production order generation routine” (kalder den samme rutine til oprettelse af produktionsordrer) som ERP-skærmbilledet (Seniors dokumentation, oversat), samt tjenester til produkter (com.senior.g5.co.ger.cad.produto) og produktionsindberetning.
- Senior X Platform REST API’er på api.senior.com.br til de ERP-domæner, som Senior udstiller på Senior X, f.eks. produkter og salgsordrer (Seniors dokumentation).
- Events Hub-webhooks. Oprettes i Senior X under Tecnologia > Customização > Events Hub > Webhooks. Manufacturing udsender hændelsen erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus, når et OP-trin skifter status (Seniors dokumentation).
Godkendelse og adgang
- Senior X Platform. Integrationen logger ind med POST til platform.senior.com.br på /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login med brugeren angivet som user@tenant. Svaret indeholder et Bearer-adgangstoken og et opdateringstoken. Applikationsnøgler kan bruges til at logge ind med loginWithKey (access key, secret, tenant). REST-kald medsender headeren authorization og en client_id-header, som identificerer den tilsluttede applikation. Applikationen registreres i Seniors API-portal og knyttes til en rolle i ERP-systemet.
- G5-webservices. Kald medsender parametrene user, password og encryption. Ved brug af et Senior X-token erstatter tokenet adgangskoden (Seniors dokumentation).
- Rettigheder. Opret en særskilt Senior-bruger til integrationen med adgang til de data om PCP, konstruktion, lager og indkøb, som den læser og skriver.
Hos SkyPlanner bruger REST API’et et API-token i headeren Authorization-Token til godkendelse (SkyPlanner Settings > API). API’et er dokumenteret i Swagger/OpenAPI. Integrationsvejledningen gennemgår de første kald.
Hændelser og polling
Events Hub dækker hændelser fra produktionen: Når et OP-trin skifter status, modtager SkyPlanner webhooken og opdaterer planen. Øvrige data hentes via polling. Nye opgaver findes ved at hente data filtreret efter fastlagte og frigivne OP’er samt seneste ændringer. Hyppigheden fastsættes pr. fabrik og spænder fra med få minutters mellemrum for OP’er til hver time for lagerbeholdninger.
SkyPlanner sender webhooks, når status eller planen ændres, så tilbageskrivningen er hændelsesstyret.
Datamapping
| Objekt i Senior ERP (grænseflade) | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
| SKU: produto og derivação, måleenheder (G5-webservices eller Senior X-entiteter) | Produkter og materialer | Senior → SkyPlanner | Første indlæsning, derefter polling |
| Produktstruktur (engenharia do SKU) | Produktstruktur, delprodukter, materialer pr. produkt | Senior → SkyPlanner | Første indlæsning, derefter ved ændringer |
| Roteiro med estágios: rækkefølge og afhængighed af det foregående trin | Procestrin i rækkefølge | Senior → SkyPlanner | Første indlæsning, derefter ved ændringer |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Arbejdsstationer, varigheder, opstillings- og nedtagningstider, effektivitetsgrader | Senior → SkyPlanner | Første indlæsning, derefter sjældent |
| Centro de recurso | Arbejdsstationsgrupper | Senior → SkyPlanner | Første indlæsning, derefter sjældent |
| Calendário: Feriados, produktionskalender pr. skift | Skift og arbejdsfri dage | Senior → SkyPlanner | Dagligt eller egne skift i SkyPlanner |
| Ordens de produção (Firme, Liberada) med trin og materialer | Ordrer og opgaver med leveringsfrister og materialebehov | Senior → SkyPlanner | Polling med få minutters mellemrum |
| Status for OP-trin (Events Hub orderProductionStageChangeStatus) | Opgavens fremdrift | Senior → SkyPlanner | I realtid via webhook |
| Estoque pr. SKU | Lagerbeholdninger | Senior → SkyPlanner | Polling hver time eller ved planlægningskørsel |
| Ordens de compra med leveringsdatoer | Indkøbsordrer, indgående materialer efter leveringsdato | Senior → SkyPlanner | Polling hver time eller ved planlægningskørsel |
| OP-trin: planlagt start og slut, ressource | Planlagt start og slut pr. opgave, tildelt arbejdsstation | SkyPlanner → Senior | Ved planændring via SkyPlanner-webhook |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, start- og slutdato samt klokkeslæt | Tidsregistreringer og operatørtilbagemeldinger | SkyPlanner → Senior | Pr. tilbagemelding eller pr. skift, hvis det vælges |
| Findes ikke i Senior ERP | Omstillingsmatrix, værktøjer som ressourcer med begrænset kapacitet, opgaver med flere operatører, alternative maskiner og medarbejdere | Vedligeholdes i SkyPlanner | Konfigureres under opstarten |
Integrationsmønstre
1. Første indlæsning af stamdata. Indlæs SKU’er, strukturer, roteiros, recursos, centros de recurso og produktionskalenderen. Tag aktivt stilling til mappingen af ressourcecentre: Et centro de recurso med fire maskiner bliver til én arbejdsstationsgruppe eller fire arbejdsstationer. Omsæt Fator de carga til enten arbejdsstationens effektivitet i SkyPlanner eller skift, ikke begge dele.
2. Synkronisering af OP’er. Indlæs OP’er med status Firme og Liberada med deres trin og materialer samt åbne indkøbsordrer. MRP kan stadig ændre eller slette OP’er med status Planejada, så medtag dem kun i planen, hvis I ønsker et fremadrettet overblik. SkyPlanner betragter bestilte materialer som tilgængelige på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered.
3. Tilbageskrivning af planen. Når planlægningsmotoren placerer eller flytter et trin, udløser en SkyPlanner-webhook tilbageskrivningen. Den angiver planlagt start og slut for hvert OP-trin samt den valgte ressource. Det er de samme felter, som planlæggeren redigerer i Programação de produção. Under afklaringen aftaler SkyPlanner-teamet med jer og jeres Senior-partner, præcis hvilken webservice der skal bruges.
4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringerne holder planen ajour. I vælger, om faktiske tider skal skrives tilbage til Senior. Hvis I vælger det, bliver hver tilbagemelding til et apontamento de produção på OP-trinnet med produceret mængde, kassation samt start- og sluttidspunkt. Senior accepterer kun produktionsindberetninger på OP’er med status Liberada eller Andamento. Hvis I indberetter via Fábrica ao Vivo, læser SkyPlanner i stedet fremdriften via Events Hub.
5. Dataejerskab og konfliktregler. Skriv reglerne ned inden idriftsættelsen:
| Data | Ejer |
|---|---|
| SKU’er, strukturer, roteiros, OP-mængder og status | Senior ERP |
| Trinnenes rækkefølge, start- og sluttidspunkter, ressourcetildeling | SkyPlanner |
| Omstillingsmatrix, krav til værktøjer og operatører, alternative ressourcer | SkyPlanner |
| Produktionskalender og skift | Ét system, valgt under afklaringen |
| Apontamentos, lagerbevægelser, omkostningsberegning | Senior ERP, registreret dér eller overført fra SkyPlanners tidsregistreringer |
Lad kun ét system skrive datoerne for trinnene. Hvis planlæggerne stadig fastlægger rækkefølgen for de samme OP’er i Programação de produção eller Gantt-diagrammet, skal I aftale, hvilke OP’er SkyPlanner styrer.
Typiske trin i projektet
Implementeringen er normalt afsluttet inden for nogle uger efter opstart. Inden da kan I validere planen i den gratis prøveperiode på 30 dage med ressourcer, roteiros og åbne OP’er eksporteret fra Senior som CSV eller Excel.
- Mapping. Fastlæg mappingtabellen, reglerne for dataansvar, synkroniseringshyppigheden og om apontamentos skal skrives tilbage.
- Adgang til Senior. Opret integrationsbrugeren, registrer applikationen i Seniors API-portal, og aktivér G5-webservices og Events Hub-webhooken. Test først i en testdatabase.
- Første indlæsning. SKU’er, strukturer, roteiros, recursos, centros de recurso og kalender.
- Synkronisering af OP’er og indkøbsordrer. Polling med filtre og genforsøg samt webhook til trinstatus.
- Opsætning af begrænsninger i SkyPlanner. Omstillingsmatrix, værktøjer, antal operatører pr. opgave og alternative maskiner eller medarbejdere.
- Tilbageskrivning af planen. Datoer og ressourcer for trinnene fra SkyPlanner-webhooks samt apontamentos, hvis det vælges.
- Parallel test. Kør SkyPlanner parallelt med den nuværende plan, sammenlign datoer, og ret stamdata.
- Idriftsættelse. Aktivér tilbageskrivning, når data stemmer overens.
Det skal I tage højde for i en Senior ERP integration
- Fire tider pr. ressource. Recurso indeholder procestid, opstillingstid, tid til ilægning og udtagning samt transporttid. Ilægning og transport kan være håndteringstid frem for maskintid. Beslut for hver ressource, hvordan tiderne mappes, ellers bliver alle varigheder forkerte.
- Én opstillingstid pr. ressource. Seniors Tempo setup er en enkelt værdi. Opbyg omstillingsmatricen i SkyPlanner ud fra jeres faktiske omstillinger under opstarten.
- Varianter. En SKU i Senior består af et produkt og en derivação, og roteiros kan variere fra variant til variant. Medtag variantkoden i produktnøglerne i SkyPlanner.
- OP-statusser. Kun OP’er med status Liberada og Andamento accepterer produktionsindberetninger. Foretag statusændringer i Senior, og lad SkyPlanner følge dem via Events Hub.
- Hybrid drift. G5-webtjenester kører på din Senior-server, mens Events Hub kører i Senior X. Planlæg netværksadgang til begge.
- Talformat. Seniors webtjenester afviser tal med tusindtalsseparatorer og kræver decimalkomma. Send tallene i det format.
Hvem opsætter og supporterer integrationen med Senior ERP?
- SkyPlanner-teamet opsætter integrationen under opstarten og yder support efter idriftsættelsen. Det omfatter de aftalte webtjenester, Senior X-API’er og Events Hub-webhooks. Hver fabrik bruger Senior ERP på sin egen måde, og den viden indgår i arbejdet.
- Din Senior-partner kan deltage. Partneren kender din opsætning, dine tilpasninger og dine licensforhold og kan sammen med SkyPlanner-teamet oprette integrationsbrugeren, registrere integrationen i API-portalen og opsætte webtjenesterne.
- Dine egne udviklere kan bygge videre på integrationen via SkyPlanners REST API med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper efter behov. Du finder dokumentationen i SkyPlanners integrationsdokumentation.
SkyPlanner koster fra 199 € om måneden med 5 arbejdsstationer inkluderet og månedlig fakturering. Du får på forhånd et tilbud på integrationen sammen med dit abonnement, tilpasset dine processer og behov. Se priser, produktionsplanlægning med Senior ERP, der tager højde for den faktiske maskin- og personalekapacitet, siden om Senior ERP og oversigten over ERP-integrationer.
Produktionsvirksomheders erfaringer med SkyPlanner
2 timersparet hver uge
“Med SkyPlanner er vi gået fra produktionsplanlægning i Excel-regneark til produktionsoptimering i realtid.”
Kalle Kalliomäki, specialist i forsyningskæder
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 timers arbejde hver uge, og en ny opgavekø når ud til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
1.000-vis afproduktionsordrer planlægges automatisk
“Vi har styr på produktionen på en helt anden måde, og vores forståelse af kapaciteten er på et helt andet niveau.”
Hannu Ryynänen, administrerende direktør
Mamec · Industrielle blandere, pumper og højteknologisk kontraktproduktion
Tusindvis af produktionsordrer planlægges automatisk, og hele organisationen har overblik over produktionen i realtid.
Færrestop på grund af materialemangel
“Værdien af SkyPlanner for os er, at det er et værktøj, der fungerer i hverdagen, især når vi skal fastlægge leveringsdatoer.”
Tommi Männistö, chef for produktionsplanlægning
Eskomatic · Maskinbearbejdning som underleverandør
Automatisk planlægning af belastningen giver mere præcise leveringsdatoer, og antallet af produktionsstop på grund af materialemangel er faldet markant.
Ofte stillede spørgsmål
Har Senior ERP et API til produktionsordrer?
Ja. G5-webtjenesten com.senior.g5.co.mpr.pcp.ordemproducao opretter OP’er med samme rutine som ERP-skærmbilledet, og andre G5-tjenester dækker produkter og produktionsrapportering. Senior X Platform supplerer med REST API’er med login via Bearer-token og Events Hub-webhooks.
Understøtter Senior ERP webhooks?
Ja. Senior X Events Hub sender webhooks, herunder orderProductionStageChangeStatus, når et OP-trin skifter status. SkyPlanner bruger det til at følge fremdriften i produktionen i realtid og sender ændringer i planen tilbage via sine egne webhooks.
Hvordan skrives planlagte datoer tilbage til Senior ERP?
SkyPlanner angiver den planlagte start og afslutning for hvert OP-trin samt den valgte ressource. Det er de samme felter, som planlæggeren redigerer i Programação de produção. Hver gang planen ændres, udløser en SkyPlanner-webhook tilbageskrivningen via den integrationsvej, som SkyPlanner-teamet fastlægger for din Senior-installation under afklaringen ved opstart.
Fungerer integrationen med Senior X og ERP XT?
Ja. ERP XT kører på din server med cloudtjenester på Senior X. Integrationen bruger G5-webtjenester på serveren samt Senior X-API’er og Events Hub i skyen.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med CSV- eller Excel-import fra Senior. Der kræves intet kreditkort. Start prøveperioden, eller tal med salg for at afklare integrationens omfang.
