Koppelingen / ERP / Senior ERP
Handleiding voor de Senior ERP-koppeling voor productieplanning met SkyPlanner APS
Deze handleiding laat partners en IT-teams zien hoe ze Senior ERP van Senior Sistemas (Gestão Empresarial | ERP XT met Senior X) aan SkyPlanner APS koppelen. SkyPlanner wisselt in beide richtingen gegevens uit met Senior ERP via de eigen interfaces van Senior:
- Productieorders (OP’s) met hun fasen, bewerkingsroutes (roteiros), productiemiddelen en productiemiddelgroepen worden ingelezen, evenals SKU’s, productstructuren, voorraad en inkooporders.
- De geplande start en het geplande einde per OP-fase en het gekozen productiemiddel voor elke fase worden teruggeschreven naar de OP.
- Als u daarvoor kiest, worden tijdregistraties van operators als apontamentos de produção teruggeschreven.
- Senior X Events Hub meldt aan SkyPlanner wanneer de status van een OP-fase verandert. SkyPlanner-webhooks geven planningswijzigingen direct door.
Het SkyPlanner-team stemt de koppeling tijdens de onboarding af op uw Senior ERP-inrichting en biedt ook na de ingebruikname ondersteuning. Deze handleiding is bedoeld voor partners en ontwikkelaars die daaraan willen meewerken of zelf een koppeling willen bouwen met de gedocumenteerde REST API van SkyPlanner (API-documentatie).
Interfaces voor koppelingen met Senior ERP
ERP XT is een hybride systeem. Volgens de documentatie van Senior geldt voor Gestão Empresarial XT: “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (wordt een hybride systeem: een lokaal systeem met geïntegreerde cloudoplossingen) (Senior-documentatie, vertaald). Voor de planning worden drie Senior-interfaces gebruikt:
- G5-webservices (SOAP). Services op uw Senior-server, met namen per module (com.senior.g5.co.<module>…). Elke service is beschikbaar in drie WSDL-varianten: sapiens_Sync, sapiens_Async en sapiens_Scheduled. Tot de productieservices behoort com.senior.g5.co.mpr.pcp.ordemproducao. Deze service “calls the same production order generation routine” (roept dezelfde routine voor het genereren van productieorders aan) als het ERP-scherm (Senior-documentatie, vertaald). Daarnaast zijn er services voor producten (com.senior.g5.co.ger.cad.produto) en productieterugmeldingen.
- Senior X Platform REST API’s op api.senior.com.br, voor de ERP-domeinen die Senior via Senior X beschikbaar stelt, zoals producten en verkooporders (Senior-documentatie).
- Events Hub-webhooks. Deze maakt u in Senior X aan onder Tecnologia > Customização > Events Hub > Webhooks. Manufacturing publiceert het event erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus wanneer de status van een OP-fase verandert (Senior-documentatie).
Authenticatie en toegang
- Senior X Platform. De koppeling meldt zich via POST aan bij platform.senior.com.br op /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, met de gebruiker als user@tenant. Het antwoord bevat een Bearer-toegangstoken en een vernieuwingstoken. Aanmelden met applicatiesleutels kan via loginWithKey (access key, secret, tenant). REST-aanroepen bevatten de authorization-header en een client_id-header die de gekoppelde applicatie identificeert. Die applicatie is geregistreerd in het Senior API-portaal en gekoppeld aan een rol in het ERP.
- G5-webservices. Aanroepen bevatten parameters voor gebruiker, wachtwoord en versleuteling. Bij gebruik van een Senior X-token vervangt het token het wachtwoord (Senior-documentatie).
- Rechten. Maak een aparte Senior-gebruiker aan voor de koppeling, met toegang tot de gegevens voor PCP, engineering, voorraad en inkoop die de koppeling leest en schrijft.
Aan de kant van SkyPlanner gebruikt de REST API een API-token in de Authorization-Token-header voor authenticatie (SkyPlanner Settings > API). De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding leidt u door de eerste aanroepen.
Events en polling
Events Hub verzorgt de terugkoppeling vanaf de werkvloer: zodra de status van een OP-fase verandert, ontvangt SkyPlanner de webhook en wordt de planning bijgewerkt. Overige gegevens worden via polling opgehaald. Door bij het uitlezen te filteren op definitieve en vrijgegeven OP’s en recente wijzigingen, wordt nieuw werk opgehaald. De frequentie wordt per fabriek ingesteld: van om de paar minuten voor OP’s tot elk uur voor voorraad.
SkyPlanner verstuurt webhooks wanneer de status of de planning verandert. Het terugschrijven gebeurt dus op basis van events.
Datamapping
| Senior ERP-object (interface) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
| SKU: produto en derivação, maateenheden (G5-webservices of Senior X-entiteiten) | Producten en materialen | Senior → SkyPlanner | Eerste import, daarna polling |
| Productstructuur (engenharia do SKU) | Productstructuur, deelproducten, materialen per product | Senior → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Roteiro met estágios: volgorde, afhankelijkheid van de vorige fase | Processtappen op volgorde | Senior → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Werkcentra, bewerkingsduren, instel- en afbouwtijden, efficiënties | Senior → SkyPlanner | Eerste import, daarna zelden |
| Centro de recurso | Werkcentrumgroepen | Senior → SkyPlanner | Eerste import, daarna zelden |
| Calendário: Feriados, productiekalender per ploegendienst | Ploegendiensten en niet-werkdagen | Senior → SkyPlanner | Dagelijks, of eigen ploegendiensten in SkyPlanner |
| Ordens de produção (Firme, Liberada) met fasen en materialen | Orders en taken met uiterste datums en materiaalbehoeften | Senior → SkyPlanner | Polling om de paar minuten |
| Status van OP-fase (Events Hub orderProductionStageChangeStatus) | Voortgang van taken | Senior → SkyPlanner | Realtime via webhook |
| Estoque per SKU | Voorraadsaldi | Senior → SkyPlanner | Polling, elk uur of bij een planningsrun |
| Ordens de compra met leverdatums | Inkooporders, binnenkomend materiaal per leverdatum | Senior → SkyPlanner | Polling, elk uur of bij het uitvoeren van de planning |
| OP-fase: geplande start- en eindtijd, productiemiddel | Geplande start- en eindtijd per taak, toegewezen werkcentrum | SkyPlanner → Senior | Bij planningswijzigingen, via een SkyPlanner-webhook |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, start- en einddatum en -tijd | Tijdregistraties en terugmeldingen van operators | SkyPlanner → Senior | Per terugmelding of per ploegendienst, indien gewenst |
| Niet in Senior ERP | Omsteltijdenmatrix, gereedschappen met beperkte beschikbaarheid, taken met meerdere operators, alternatieve machines en medewerkers | Beheerd in SkyPlanner | Ingericht tijdens de onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Lees SKU’s, structuren, roteiros, recursos, centros de recurso en de productiekalender in. Kies bewust hoe u productiemiddelgroepen koppelt: een centro de recurso met vier machines wordt één werkcentrumgroep of vier werkcentra. Vertaal Fator de carga naar de efficiëntie van het werkcentrum in SkyPlanner óf naar ploegendiensten, niet naar beide.
2. OP-synchronisatie. Lees OP’s met de status Firme en Liberada in, inclusief fasen en materialen, samen met openstaande inkooporders. MRP kan OP’s met de status Planejada nog wijzigen of verwijderen. Plan deze dus alleen in als u een vooruitblik wilt. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt.
3. Planning terugschrijven. Wanneer de planningsengine een fase inplant of verplaatst, activeert een SkyPlanner-webhook het terugschrijven. Daarbij worden de geplande start en het geplande einde van elke OP-fase en het gekozen productiemiddel vastgelegd. Dit zijn dezelfde velden die de planner bewerkt in Programação de produção. Tijdens de scopebepaling spreekt het SkyPlanner-team met u en uw Senior-partner af welke webservice hiervoor wordt gebruikt.
4. Terugmeldingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Die tijdregistraties houden de planning actueel. U kiest of de werkelijke tijden naar Senior worden teruggeschreven. Zo ja, dan wordt elke terugmelding een apontamento de produção op de OP-fase, met de geproduceerde hoeveelheid, uitval en start- en eindtijden. Senior accepteert productieterugmeldingen alleen voor OP’s met de status Liberada of Andamento. Als u via Fábrica ao Vivo terugmeldt, leest SkyPlanner de voortgang in plaats daarvan via Events Hub.
5. Gegevenseigenaarschap en conflictregels. Leg deze vóór de ingebruikname vast:
| Gegevens | Eigenaar |
|---|---|
| SKU’s, structuren, roteiros, OP-hoeveelheden en -status | Senior ERP |
| Fasevolgorde, start- en eindtijden, toewijzing van productiemiddelen | SkyPlanner |
| Omsteltijdenmatrix, benodigde gereedschappen en operators, alternatieve productiemiddelen | SkyPlanner |
| Productiekalender en ploegendiensten | Eén systeem, gekozen tijdens de scopebepaling |
| Apontamentos, voorraadmutaties, kostencalculatie | Senior ERP, daar ingevoerd of overgenomen uit SkyPlanner-tijdregistraties |
Laat slechts één systeem de fasedatums schrijven. Als planners dezelfde OP’s ook nog in Programação de produção of het Gantt-diagram op volgorde zetten, spreek dan af welke OP’s door SkyPlanner worden beheerd.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Valideer de planning vooraf tijdens de gratis proefperiode van 30 dagen met productiemiddelen, roteiros en openstaande OP’s die u als CSV of Excel uit Senior exporteert.
- Mapping. Leg de mappingtabel, de regels voor gegevenseigenaarschap, de synchronisatiefrequenties en het al dan niet terugschrijven van apontamentos vast.
- Toegang tot Senior. Maak de integratiegebruiker aan, registreer de applicatie in het Senior API-portaal en schakel de G5-webservices en de Events Hub-webhook in. Test eerst in een acceptatieomgeving.
- Eerste import. SKU’s, structuren, roteiros, recursos, centros de recurso, kalender.
- Synchronisatie van OP’s en inkooporders. Polling met filters en herhaalpogingen, plus de webhook voor de fasestatus.
- Planningsbeperkingen instellen in SkyPlanner. Omsteltijdmatrix, gereedschappen, aantallen operators per taak en alternatieve machines of medewerkers.
- Planning terugschrijven. Fasedatums en productiemiddelen via SkyPlanner-webhooks, plus apontamentos als u daarvoor kiest.
- Parallel testen. Laat SkyPlanner naast de huidige planning draaien, vergelijk de datums en corrigeer de stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten voor een Senior ERP-koppeling
- Vier tijden per productiemiddel. Recurso bevat de procestijd, insteltijd, laad- en lostijd en verplaatstijd. Laad- en verplaatstijd kunnen handelingstijd zijn in plaats van machinetijd. Bepaal per productiemiddel hoe elke tijd wordt vertaald, anders klopt geen enkele bewerkingsduur.
- Eén insteltijd per productiemiddel. Tempo setup in Senior bevat één waarde. Bouw tijdens de onboarding de omsteltijdenmatrix in SkyPlanner op basis van uw werkelijke omstellingen.
- Varianten. Een SKU in Senior bestaat uit een product plus een derivação. De roteiros kunnen per variant verschillen. Neem de variantcode op in de productsleutels van SkyPlanner.
- OP-statussen. Alleen OP’s met de status Liberada of Andamento accepteren productieterugmeldingen. Beheer statuswijzigingen in Senior en laat SkyPlanner deze via Events Hub volgen.
- Hybride implementatie. De G5-webservices draaien op uw Senior-server en Events Hub draait in Senior X. Zorg voor netwerktoegang tot beide.
- Getalnotatie. De webservices van Senior accepteren geen getallen met scheidingstekens voor duizendtallen en vereisen een decimale komma. Verstuur getallen in die notatie.
Wie configureert en ondersteunt de Senior ERP-koppeling?
- Het SkyPlanner-team configureert de koppeling tijdens de onboarding en biedt ondersteuning na ingebruikname. Dit geldt voor de afgesproken webservices, Senior X-API’s en Events Hub-webhooks. Elke fabriek gebruikt Senior ERP anders. Die praktijkkennis wordt hierbij ingezet.
- Uw Senior-partner kan meewerken. De partner kent uw inrichting, maatwerk en licenties en kan samen met het SkyPlanner-team de integratiegebruiker, de registratie in het API-portaal en de webservices instellen.
- Uw eigen ontwikkelaars kunnen de koppeling verder uitbouwen via de REST API van SkyPlanner met een API-token. Een API-token volstaat om te beginnen. Het SkyPlanner-team helpt waar nodig. U vindt de documentatie in de integratiedocumentatie van SkyPlanner.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturering. U ontvangt vooraf een offerte voor de koppeling, afgestemd op uw proces en behoeften, samen met uw abonnement. Bekijk de prijzen, capaciteitsplanning met Senior ERP, de Senior ERP-pagina en het overzicht van ERP-koppelingen.
Ervaringen van fabrikanten met SkyPlanner
2 hbespaard per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd en een nieuwe werklijst is binnen enkele seconden beschikbaar aan de lijn.
+90%productie-efficiëntie
“De efficiëntie in de productie is met 90% gestegen.”
Abdul Rucyinga, hoofd IT
Laboratory & Allied · Farmaceutische productie
De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerde planning voor drie maanden voor alle werkcentra is in minder dan 30 minuten klaar.
1.000’enwerkorders automatisch ingepland
“We hebben de productie op een andere manier onder controle en ons inzicht in de capaciteit ligt op een heel ander niveau.”
Hannu Ryynänen, CEO
Mamec · Industriële mengers, pompen en hightech productie in opdracht
Duizenden werkorders worden automatisch ingepland en de hele organisatie heeft realtime inzicht in de productie.
Minderstilstand door materiaaltekorten
“De waarde van SkyPlanner voor ons is dat het in de dagelijkse praktijk werkt, vooral bij het vaststellen van leverdatums.”
Tommi Männistö, manager productieplanning
Eskomatic · Verspaning in opdracht
Door de belasting automatisch in te plannen worden leverdatums nauwkeuriger bepaald. Ook is de productiestilstand door materiaaltekorten sterk afgenomen.
Veelgestelde vragen
Heeft Senior ERP een API voor productieorders?
Ja. De G5-webservice com.senior.g5.co.mpr.pcp.ordemproducao genereert OP’s met dezelfde routine als het ERP-scherm. Andere G5-services ondersteunen producten en productieterugmeldingen. Senior X Platform voegt REST API’s met aanmelding via een Bearer-token en Events Hub-webhooks toe.
Ondersteunt Senior ERP webhooks?
Ja. Senior X Events Hub verstuurt webhooks, waaronder orderProductionStageChangeStatus wanneer de status van een OP-fase verandert. SkyPlanner gebruikt deze om de voortgang op de werkvloer in realtime te volgen. De eigen webhooks van SkyPlanner sturen wijzigingen in de planning terug.
Hoe worden geplande datums teruggeschreven naar Senior ERP?
SkyPlanner stelt het geplande begin en einde van elke OP-fase in, samen met het daarvoor gekozen productiemiddel. Dit zijn dezelfde velden die de planner bewerkt in Programação de produção. Bij elke wijziging in de planning activeert een SkyPlanner-webhook het terugschrijven. Dat gebeurt via de route die het SkyPlanner-team voor uw Senior-installatie vastlegt tijdens de scopebepaling bij de onboarding.
Werkt de koppeling met Senior X en ERP XT?
Ja. ERP XT draait op uw server, met cloudservices op Senior X. De koppeling gebruikt G5-webservices op de server en Senior X-API’s en Events Hub in de cloud.
Kunnen we SkyPlanner testen voordat we de koppeling bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en gegevens uit Senior importeren via CSV of Excel. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales om de scope van de koppeling te bepalen.
