Integrationer / ERP / Senior ERP
Guide till integration med Senior ERP för produktionsplanering med SkyPlanner APS
Den här guiden visar hur partner och IT-team ansluter Senior ERP från Senior Sistemas (Gestão Empresarial | ERP XT med Senior X) till SkyPlanner APS. SkyPlanner integreras med Senior ERP i båda riktningarna via Seniors egna gränssnitt:
- Tillverkningsorder (OP) med tillhörande steg, operationsföljder (roteiros), resurser och resurscenter samt SKU:er, produktstrukturer, lagersaldon och inköpsorder läses in.
- Planerad start och sluttid för varje OP-steg samt den resurs som valts för steget förs tillbaka till tillverkningsordern.
- Operatörernas tidsregistreringar förs tillbaka som apontamentos de produção om du väljer det.
- Senior X Events Hub meddelar SkyPlanner när ett OP-steg byter status, och SkyPlanner skickar planändringar via webhooks så snart de sker.
SkyPlanner-teamet anpassar integrationen till din Senior ERP-miljö under införandet och ger support efter driftstarten. Guiden vänder sig till partner och utvecklare som vill delta eller själva bygga vidare på SkyPlanners dokumenterade REST API (API-referens).
Integrationsgränssnitt i Senior ERP
ERP XT är ett hybridsystem. I Seniors dokumentation står det att Gestão Empresarial XT ”becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (blir ett hybridsystem: ett lokalt installerat system med integrerade molnlösningar) (Seniors dokumentation, översatt). Ett planeringssystem använder tre gränssnitt från Senior:
- G5-webbtjänster (SOAP). Tjänster på din Senior-server, namngivna efter modul (com.senior.g5.co.<module>…). Varje tjänst publiceras i tre WSDL-varianter: sapiens_Sync, sapiens_Async och sapiens_Scheduled. Bland produktionstjänsterna finns com.senior.g5.co.mpr.pcp.ordemproducao, som ”calls the same production order generation routine” (anropar samma rutin för att skapa tillverkningsorder) som ERP-vyn (Seniors dokumentation, översatt), samt tjänster för produkter (com.senior.g5.co.ger.cad.produto) och produktionsrapportering.
- REST API:er för Senior X Platform på api.senior.com.br, för de ERP-domäner som Senior gör tillgängliga i Senior X, exempelvis produkter och kundorder (Seniors dokumentation).
- Webhooks i Events Hub. Skapas i Senior X under Tecnologia > Customização > Events Hub > Webhooks. Manufacturing publicerar händelsen erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus när ett OP-steg byter status (Seniors dokumentation).
Autentisering och åtkomst
- Senior X Platform. Integrationen loggar in med POST till platform.senior.com.br på /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, med användaren angiven som user@tenant. Svaret innehåller en Bearer-åtkomsttoken och en uppdateringstoken. Applikationsnycklar kan användas för inloggning med loginWithKey (access key, secret, tenant). REST-anrop skickar med headern authorization och en client_id-header som identifierar den anslutande applikationen. Applikationen registreras i Seniors API-portal och kopplas till en roll i ERP-systemet.
- G5-webbtjänster. Anropen skickar med parametrar för användare, lösenord och kryptering. Om en Senior X-token används ersätter den lösenordet (Seniors dokumentation).
- Behörigheter. Skapa en särskild Senior-användare för integrationen med åtkomst till de data inom PCP, produktberedning, lager och inköp som den läser och skriver.
På SkyPlanner-sidan autentiseras anrop till REST API med en API-token i headern Authorization-Token (SkyPlanner Settings > API). API:et är dokumenterat i Swagger/OpenAPI. Integrationsguiden går igenom de första anropen.
Händelser och pollning
Events Hub hanterar det som händer i produktionen: när ett OP-steg byter status når webhooken SkyPlanner och planen uppdateras. Övriga data hämtas genom pollning. Nya arbeten fångas upp genom läsningar som filtreras på fastställda och frisläppta tillverkningsorder samt de senaste ändringarna. Intervallet bestäms per fabrik: tillverkningsorder hämtas med några minuters mellanrum och lagersaldon en gång i timmen.
SkyPlanner skickar webhooks när status eller planeringen ändras. Återföringen är alltså händelsestyrd.
Datamappning
| Objekt i Senior ERP (gränssnitt) | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
| SKU: produto och derivação, måttenheter (G5-webbtjänster eller Senior X-entiteter) | Produkter och material | Senior → SkyPlanner | Första inläsning, därefter pollning |
| Produktstruktur (engenharia do SKU) | Produktstruktur, delprodukter, material per produkt | Senior → SkyPlanner | Första inläsning, därefter vid ändring |
| Roteiro med estágios: ordningsföljd, beroende av föregående steg | Processteg i ordningsföljd | Senior → SkyPlanner | Första inläsning, därefter vid ändring |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Produktionsgrupper, tidsåtgång, ställ- och avrustningstider, effektivitetsgrader | Senior → SkyPlanner | Första inläsning, därefter sällan |
| Centro de recurso | Grupper av produktionsgrupper | Senior → SkyPlanner | Första inläsning, därefter sällan |
| Calendário: Feriados, produktionskalender per skift | Skift och arbetsfria dagar | Senior → SkyPlanner | Dagligen, eller egna skift i SkyPlanner |
| Ordens de produção (Firme, Liberada) med steg och material | Order och operationer med färdigdatum och materialbehov | Senior → SkyPlanner | Pollning med några minuters mellanrum |
| Status för OP-steg (Events Hub orderProductionStageChangeStatus) | Operationens förlopp | Senior → SkyPlanner | I realtid via webhook |
| Estoque per SKU | Lagersaldon | Senior → SkyPlanner | Pollning varje timme eller vid planeringskörning |
| Ordens de compra med leveransdatum | Inköpsorder, inkommande material per leveransdatum | Senior → SkyPlanner | Pollning varje timme eller vid planeringskörning |
| OP-steg: planerad start och sluttid, resurs | Planerad start och sluttid per operation, tilldelad produktionsgrupp | SkyPlanner → Senior | Vid planändring, via SkyPlanner-webhook |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, start- och slutdatum med klockslag | Tidsregistreringar och operatörskvitteringar | SkyPlanner → Senior | Per kvittering eller skift, om det valts |
| Finns inte i Senior ERP | Ställtidsmatris, verktyg som resurser med begränsad kapacitet, operationer med flera operatörer, alternativa maskiner och personal | Underhålls i SkyPlanner | Konfigureras under införandet |
Integrationsmönster
1. Första inläsning av grunddata. Läs in SKU:er, strukturer, roteiros, recursos, centros de recurso och produktionskalendern. Gör ett medvetet val när du mappar resurscenter: ett centro de recurso med fyra maskiner blir en grupp av produktionsgrupper eller fyra produktionsgrupper. Omvandla Fator de carga till antingen produktionsgruppens effektivitetsgrad i SkyPlanner eller till skift, inte båda.
2. Synkronisering av tillverkningsorder. Läs in tillverkningsorder med status Firme och Liberada med tillhörande steg och material samt öppna inköpsorder. Tillverkningsorder med status Planejada kan fortfarande ändras eller tas bort av MRP, så planera in dem bara om du vill få en framåtblick. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagersaldot när inköpsordern markeras som Delivered.
3. Återföring av planen. När planeringsmotorn placerar eller flyttar ett steg utlöser en SkyPlanner-webhook återföringen. Den anger planerad start och sluttid för varje OP-steg samt vald resurs, alltså samma fält som planeraren redigerar i Programação de produção. Under kartläggningen kommer SkyPlanner-teamet överens med dig och din Senior-partner om exakt vilken webbtjänst som ska användas.
4. Kvitteringar från produktionen. Operatörerna registrerar sitt arbete med SkyPlanner Mobile Confirmations eller Production Timer, och tidsregistreringarna håller planen aktuell. Du väljer om faktiska tider ska föras tillbaka till Senior. Om du väljer det blir varje kvittering ett apontamento de produção på OP-steget, med producerad kvantitet, kassation samt start- och sluttider. Senior tar bara emot produktionsrapporter för tillverkningsorder med status Liberada eller Andamento. Om du rapporterar via Fábrica ao Vivo läser SkyPlanner i stället in förloppet via Events Hub.
5. Regler för dataägarskap och konflikter. Dokumentera dem före driftsättningen:
| Data | Ägare |
|---|---|
| SKU:er, strukturer, roteiros, orderkvantiteter och OP-status | Senior ERP |
| Stegens ordningsföljd, start- och sluttider, resurstilldelning | SkyPlanner |
| Ställtidsmatris, verktygs- och operatörsbehov, alternativa resurser | SkyPlanner |
| Produktionskalender och skift | Ett system, väljs under kartläggningen |
| Apontamentos, lagerrörelser, kostnadsberäkning | Senior ERP, registreras där eller förs över från tidsregistreringar i SkyPlanner |
Låt bara ett system skriva stegens datum. Om planerarna fortfarande bestämmer ordningsföljden för samma tillverkningsorder i Programação de produção eller Gantt-diagrammet behöver ni komma överens om vilka order SkyPlanner ansvarar för.
Vanliga projektsteg
Implementeringen är normalt klar inom några veckor efter att införandet har startat. Innan dess kan du validera planen under den kostnadsfria provperioden på 30 dagar med resurser, roteiros och öppna tillverkningsorder exporterade från Senior som CSV eller Excel.
- Mappning. Fastställ mappningstabellen, ansvarsreglerna, synkroniseringsintervallen och om apontamentos ska föras tillbaka.
- Åtkomst till Senior. Skapa integrationsanvändaren, registrera applikationen i Seniors API-portal och aktivera G5-webbtjänsterna och Events Hub-webhooken. Testa först i en testdatabas.
- Första inläsning. SKU:er, strukturer, roteiros, recursos, centros de recurso, kalender.
- Synkronisering av tillverknings- och inköpsorder. Pollning med filter och återförsök samt webhook för stegstatus.
- Konfigurera begränsningar i SkyPlanner. Ställtidsmatris, verktyg, antal operatörer per operation och alternativa maskiner eller personal.
- Återföring av planen. Stegdatum och resurser från SkyPlanner-webhooks samt apontamentos om det valts.
- Parallella tester. Kör SkyPlanner parallellt med den nuvarande planen, jämför datum och rätta grunddata.
- Driftsättning. Aktivera återföringen när uppgifterna stämmer överens.
Att ta höjd för vid integration med Senior ERP
- Fyra tider per resurs. Recurso innehåller processtid, ställtid, tid för lastning och lossning samt överföringstid. Lastnings- och överföringstid kan avse hantering, inte maskintid. Bestäm hur varje tid ska mappas för respektive resurs, annars blir all tidsåtgång fel.
- En ställtid per resurs. Seniors Tempo setup är ett enda värde. Bygg ställtidsmatrisen i SkyPlanner utifrån era faktiska omställningar under införandet.
- Varianter. En SKU i Senior består av en produkt och en derivação, och roteiros kan skilja sig mellan varianterna. Ta med variantkoden i produktnycklarna i SkyPlanner.
- OP-status. Bara tillverkningsorder med status Liberada eller Andamento kan ta emot produktionsrapporter. Gör statusändringarna i Senior och låt SkyPlanner följa dem via Events Hub.
- Hybriddrift. G5-webbtjänsterna körs på er Senior-server och Events Hub körs i Senior X. Planera nätverksåtkomsten för båda.
- Talformat. Seniors webbtjänster avvisar tal med tusentalsavgränsare och kräver decimalkomma. Skicka talen i det formatet.
Vem konfigurerar och ger support för integrationen med Senior ERP?
- SkyPlanner-teamet konfigurerar integrationen under införandet och ger support efter driftsättningen. Det omfattar de webbtjänster, Senior X-API:er och Events Hub-webhooks som ni har kommit överens om. Varje fabrik använder Senior ERP på sitt sätt, och den kunskapen tas till vara här.
- Er Senior-partner kan medverka. Partnern känner till er konfiguration, era anpassningar och licenser och kan tillsammans med SkyPlanner-teamet skapa integrationsanvändaren, registrera er i API-portalen och konfigurera webbtjänsterna.
- Era egna utvecklare kan bygga vidare på integrationen via SkyPlanners REST API med en API-token. En API-token räcker för att komma igång, och SkyPlanner-teamet hjälper till vid behov. Dokumentationen finns i SkyPlanners integrationsdokumentation.
SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Ni får en offert på integrationen i förväg, tillsammans med ert abonnemang, utifrån era processer och behov. Se priser, finplanering med Senior ERP, sidan om Senior ERP och översikten över ERP-integrationer.
Tillverkares omdömen om SkyPlanner
2 hsparade varje vecka
”Med SkyPlanner har vi gått från produktionsplanering i Excel till att optimera produktionen i realtid.”
Kalle Kalliomäki, specialist inom försörjningskedjan
UTU · Elcentraler och ställverk
Produktionsplaneringen sparar 2 timmars arbetstid varje vecka, och en ny arbetskö når produktionslinjen på några sekunder.
+90%effektivitet i produktionen
”Effektiviteten i produktionen har ökat med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Läkemedelstillverkning
Effektiviteten i produktionen har ökat med 90%, och det tar mindre än 30 minuter att ta fram en optimerad plan för tre månader som omfattar alla produktionsgrupper.
1 000-talstillverkningsorder planeras automatiskt
”Vi har kontroll över produktionen på ett helt annat sätt, och vår förståelse för kapaciteten är på en helt annan nivå.”
Hannu Ryynänen, vd
Mamec · Industriella blandare, pumpar och högteknologisk legotillverkning
Tusentals tillverkningsorder planeras automatiskt, och hela organisationen får en bild av produktionen i realtid.
Färrestopp på grund av materialbrist
”Värdet med SkyPlanner för oss är att det är ett verktyg som fungerar i vardagen, särskilt när vi ska fastställa leveransdatum.”
Tommi Männistö, produktionsplaneringschef
Eskomatic · Legobearbetning
Automatisk beläggningsplanering ger mer träffsäkra leveransdatum, och produktionsstoppen på grund av materialbrist har minskat kraftigt.
Vanliga frågor
Har Senior ERP ett API för tillverkningsorder?
Ja. G5-webbtjänsten com.senior.g5.co.mpr.pcp.ordemproducao skapar OP:er med samma rutin som i ERP-systemets gränssnitt. Andra G5-tjänster hanterar produkter och produktionsrapportering. Senior X Platform tillför REST API:er med inloggning via Bearer-token samt Events Hub-webhooks.
Har Senior ERP stöd för webhooks?
Ja. Senior X Events Hub skickar webhooks, bland annat orderProductionStageChangeStatus när ett OP-steg byter status. SkyPlanner använder detta för att följa arbetet i produktionen i realtid och skickar tillbaka ändringar i produktionsplanen via sina egna webhooks.
Hur skrivs planerade datum tillbaka till Senior ERP?
SkyPlanner anger planerad start och sluttid för varje OP-steg samt den valda resursen, i samma fält som planeraren redigerar i Programação de produção. En webhook från SkyPlanner utlöser återskrivningen varje gång produktionsplanen ändras. Återskrivningen sker via den anslutningsväg som SkyPlanner-teamet fastställer för er Senior-installation under kartläggningen vid införandet.
Fungerar integrationen med Senior X och ERP XT?
Ja. ERP XT körs på er server med molntjänster i Senior X. Integrationen använder G5-webbtjänster på servern samt Senior X-API:er och Events Hub i molnet.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan ni använda upp till 20 produktionsgrupper med CSV- eller Excel-import från Senior. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för att kartlägga integrationen.
