Integraatiot / ERP / Senior ERP
Senior ERP -integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Senior ERP -integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten Senior Sistemas -yhtiön Senior ERP (Gestão Empresarial | ERP XT yhdessä Senior X:n kanssa) yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Senior ERP:n välinen integraatio toimii molempiin suuntiin Seniorin omien rajapintojen kautta:
- SkyPlanneriin tuodaan tuotantotilaukset (OP) vaiheineen, työvaiheketjut (roteiros), resurssit ja resurssikeskukset, SKU-nimikkeet, tuoterakenteet, varastotiedot ja ostotilaukset.
- OP:lle palautetaan kunkin vaiheen suunniteltu alku- ja loppuaika sekä vaiheelle valittu resurssi.
- Halutessasi työntekijöiden aikakirjaukset palautetaan tuotantokirjauksina (apontamentos de produção).
- Senior X Events Hub ilmoittaa SkyPlannerille OP:n vaiheen tilan muutoksista, ja SkyPlannerin webhookit välittävät aikataulumuutokset sitä mukaa kuin niitä tapahtuu.
SkyPlannerin tiimi määrittää integraation Senior ERP -ympäristöösi sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on tarkoitettu kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai kehittää itse ratkaisuja SkyPlannerin dokumentoidun REST API:n avulla (API-dokumentaatio).
Senior ERP:n integraatiorajapinnat
ERP XT on hybridiratkaisu. Seniorin dokumentaation mukaan Gestão Empresarial XT “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (muuttuu hybridijärjestelmäksi, jossa paikalliseen järjestelmään on integroitu pilviratkaisuja) (Seniorin dokumentaatio, käännetty). Tuotannonsuunnitteluohjelmisto käyttää kolmea Seniorin rajapintaa:
- G5-verkkopalvelut (SOAP). Senior-palvelimellasi toimivat palvelut on nimetty moduulin mukaan (com.senior.g5.co.<module>…). Jokaisesta julkaistaan kolme WSDL-versiota: sapiens_Sync, sapiens_Async ja sapiens_Scheduled. Tuotannon palveluihin kuuluu com.senior.g5.co.mpr.pcp.ordemproducao, joka “calls the same production order generation routine” (kutsuu samaa tuotantotilauksen luontirutiinia) kuin ERP:n käyttöliittymä (Seniorin dokumentaatio, käännetty). Lisäksi tarjolla on palveluja tuotteille (com.senior.g5.co.ger.cad.produto) ja tuotantoraportointiin.
- Senior X Platform REST API:t osoitteessa api.senior.com.br kattavat ne ERP:n osa-alueet, jotka Senior tarjoaa Senior X:n kautta, kuten tuotteet ja myyntitilaukset (Seniorin dokumentaatio).
- Events Hub -webhookit. Ne luodaan Senior X:ssä kohdassa Tecnologia > Customização > Events Hub > Webhooks. Manufacturing julkaisee tapahtuman erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus, kun OP:n vaiheen tila muuttuu (Seniorin dokumentaatio).
Tunnistautuminen ja käyttöoikeudet
- Senior X Platform. Integraatio kirjautuu POST-pyynnöllä osoitteeseen platform.senior.com.br polussa /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login. Käyttäjätunnus annetaan muodossa user@tenant. Vastaus sisältää Bearer-käyttöoikeustunnisteen ja päivitystunnisteen. Sovellusavaimilla voi kirjautua loginWithKey-toiminnolla (access key, secret, tenant). REST-kutsuissa lähetetään authorization-otsake ja client_id-otsake, joka yksilöi yhteyden muodostavan sovelluksen. Sovellus rekisteröidään Seniorin API-portaaliin ja liitetään ERP:n rooliin.
- G5-verkkopalvelut. Kutsuissa välitetään user-, password- ja encryption-parametrit. Senior X -tunnistetta käytettäessä tunniste korvaa salasanan (Seniorin dokumentaatio).
- Käyttöoikeudet. Luo integraatiolle oma Senior-käyttäjä, jolla on luku- ja kirjoitusoikeudet integraation käyttämiin PCP-, tuotesuunnittelu-, varasto- ja ostotietoihin.
SkyPlannerin REST API käyttää tunnistautumiseen API-tunnistetta Authorization-Token-otsakkeessa (SkyPlanner Settings > API). Rajapinta on dokumentoitu Swagger/OpenAPI-muodossa. Integraatio-opas käy läpi ensimmäiset kutsut.
Tapahtumat ja toistuvat kyselyt
Events Hub kattaa tuotannon tapahtumat: kun OP:n vaiheen tila muuttuu, webhook välittää tiedon SkyPlannerille ja aikataulu päivittyy. Muut tiedot haetaan säännöllisillä kyselyillä. Uudet työt poimitaan hauilla, jotka on rajattu vahvistettuihin ja vapautettuihin OP:ihin sekä viimeaikaisiin muutoksiin. Hakutiheys määritetään tehdaskohtaisesti: OP:t voidaan hakea muutaman minuutin välein ja varastotiedot tunnin välein.
SkyPlanner lähettää webhook-ilmoituksia tilan tai tuotantosuunnitelman muuttuessa, joten tietojen palautus toimii tapahtumapohjaisesti.
Tietojen vastaavuudet
| Senior ERP:n objekti (rajapinta) | SkyPlanner-objekti | Suunta | Päivitystiheys |
|---|---|---|---|
| SKU: produto ja derivação, mittayksiköt (G5-verkkopalvelut tai Senior X:n entiteetit) | Tuotteet ja materiaalit | Senior → SkyPlanner | Alkulataus, sitten toistuvat kyselyt |
| Tuoterakenne (engenharia do SKU) | Tuoterakenne, alituotteet, tuotekohtaiset materiaalit | Senior → SkyPlanner | Alkulataus, sitten muutosten yhteydessä |
| Roteiro ja sen estágios-vaiheet: järjestys ja riippuvuus edellisestä vaiheesta | Työvaiheet järjestyksessä | Senior → SkyPlanner | Alkulataus, sitten muutosten yhteydessä |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Työpisteet, kestot, asetus- ja purkuajat, tehokkuudet | Senior → SkyPlanner | Alkulataus, sen jälkeen harvoin |
| Centro de recurso | Työpisteryhmät | Senior → SkyPlanner | Alkusiirto, sen jälkeen harvoin |
| Calendário: Feriados, vuorokohtainen tuotantokalenteri | Työvuorot ja vapaapäivät | Senior → SkyPlanner | Päivittäin tai erilliset työvuorot SkyPlannerissa |
| Ordens de produção (Firme, Liberada) vaiheineen ja materiaaleineen | Tilaukset ja työt määräaikoineen ja materiaalitarpeineen | Senior → SkyPlanner | Kysely muutaman minuutin välein |
| OP:n vaiheen tila (Events Hub orderProductionStageChangeStatus) | Työn eteneminen | Senior → SkyPlanner | Reaaliaikaisesti webhookilla |
| SKU-kohtainen Estoque | Varastosaldot | Senior → SkyPlanner | Kysely tunnin välein tai suunnitteluajon yhteydessä |
| Ordens de compra toimituspäivineen | Ostotilaukset, saapuvat materiaalit toimituspäivän mukaan | Senior → SkyPlanner | Haku tunnin välein tai suunnitteluajon yhteydessä |
| OP:n vaihe: suunniteltu alku ja loppu, resurssi | Työkohtaiset suunnitellut alku- ja loppuajat, valittu työpiste | SkyPlanner → Senior | Aikataulun muuttuessa SkyPlannerin webhookilla |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, alku- ja loppupäivä sekä kellonajat | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → Senior | Kuittaus- tai vuorokohtaisesti, jos toiminto valitaan |
| Ei Senior ERP:ssä | Asetusaikamatriisi, työkalut rajallisina resursseina, usean työntekijän työt, vaihtoehtoiset koneet ja työntekijät | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutustavat
1. Perustietojen alkusiirto. Lue SKU-nimikkeet, tuoterakenteet, roteiros, recursos, centros de recurso ja tuotantokalenteri. Määritä resurssikeskusten vastaavuudet harkiten: neljä konetta sisältävä centro de recurso vastaa yhtä työpisteryhmää tai neljää työpistettä. Muunna Fator de carga joko SkyPlannerin työpisteen tehokkuudeksi tai työvuoroiksi, älä molemmiksi.
2. OP-synkronointi. Lue Firme- ja Liberada-tilassa olevat OP:t vaiheineen ja materiaaleineen sekä avoimet ostotilaukset. MRP voi edelleen muuttaa tai poistaa Planejada-tilassa olevia OP:itä, joten ota ne suunnitteluun vain, jos haluat näkymän pidemmälle tulevaisuuteen. SkyPlanner käsittelee tilattua materiaalia saatavilla olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilaus merkitään Delivered-tilaan.
3. Aikataulun palautuskirjaus. Kun suunnittelumoottori sijoittaa vaiheen aikatauluun tai siirtää sitä aikataulussa, SkyPlannerin webhook käynnistää palautuskirjauksen. Se asettaa kunkin OP-vaiheen suunnitellun alku- ja loppuajan sekä vaiheelle valitun resurssin samoihin kenttiin, joita suunnittelija muokkaa Programação de produção -toiminnossa. SkyPlannerin tiimi sopii käytettävästä verkkopalvelusta kanssasi ja Senior-kumppanisi kanssa määrittelyn aikana.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations – tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Päätät itse, palautetaanko toteutuneet ajat Senioriin. Jos palautetaan, jokaisesta kuittauksesta muodostuu OP:n vaiheelle apontamento de produção, joka sisältää valmistuneen määrän, hylkymäärän sekä alku- ja loppuajat. Senior hyväksyy tuotantokirjaukset vain Liberada- tai Andamento-tilassa oleville OP:ille. Jos raportoit Fábrica ao Vivon kautta, SkyPlanner lukee etenemistiedot sen sijaan Events Hubin kautta.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjatkaa säännöt ennen tuotantokäytön aloittamista:
| Tiedot | Omistaja |
|---|---|
| SKU-nimikkeet, tuoterakenteet, roteiros, OP-määrät ja -tilat | Senior ERP |
| Vaiheiden järjestys, alku- ja loppuajat, resurssien valinta | SkyPlanner |
| Asetusaikamatriisi, työkalu- ja työntekijävaatimukset, vaihtoehtoiset resurssit | SkyPlanner |
| Tuotantokalenteri ja työvuorot | Yksi järjestelmä, joka valitaan määrittelyssä |
| Apontamentos, varastotapahtumat, kustannuslaskenta | Senior ERP; tiedot syötetään siellä tai siirretään SkyPlannerin aikakirjauksista |
Valitse yksi järjestelmä, joka kirjoittaa vaiheiden päivämäärät. Jos suunnittelijat järjestävät samoja OP:itä edelleen Programação de produção -toiminnossa tai Gantt-kaaviossa, sopikaa, mitkä OP:t ovat SkyPlannerin hallinnassa.
Projektin tyypilliset vaiheet
Toteutus valmistuu tavallisesti viikoissa käyttöönoton aloittamisesta. Varmista sitä ennen aikataulun toimivuus 30 päivän maksuttomassa kokeilussa. Käytä Seniorista CSV- tai Excel-muodossa vietyjä resursseja, roteiros-työvaiheketjuja ja avoimia OP:itä.
- Tietojen vastaavuudet. Lyö lukkoon vastaavuustaulukko, tietojen omistajuussäännöt ja synkronointitiheydet sekä se, palautetaanko apontamentos-kirjaukset.
- Seniorin käyttöoikeudet. Luo integraatiokäyttäjä, rekisteröi sovellus Seniorin API-portaaliin ja ota G5-verkkopalvelut sekä Events Hub -webhook käyttöön. Testaa ensin hyväksymistestauskannassa.
- Alkusiirto. SKU-nimikkeet, tuoterakenteet, roteiros, recursos, centros de recurso ja kalenteri.
- OP:iden ja ostotilausten synkronointi. Säännölliset haut suodatuksineen ja uudelleenyrityksineen sekä vaiheen tilasta ilmoittava webhook.
- Rajoitteiden määritys SkyPlannerissa. Asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai henkilöt.
- Aikataulun palautuskirjaus. Vaiheiden päivämäärät ja resurssit SkyPlannerin webhookeista sekä haluttaessa apontamentos-kirjaukset.
- Rinnakkaistestaus. Käyttäkää SkyPlanneria nykyisen suunnitelman rinnalla, verratkaa ajankohtia ja korjatkaa perustiedot.
- Tuotantokäytön aloitus. Ottakaa takaisinkirjoitus käyttöön, kun tiedot täsmäävät.
Mitä Senior ERP -integraatiossa on huomioitava
- Resurssin neljä aikatietoa. Recurso sisältää prosessiajan, asetusajan, lastaus- ja purkuajan sekä siirtoajan. Lastaus- ja siirtoaika voivat olla käsittelyaikaa, eivät koneaikaa. Määritä kunkin ajan vastaavuus resurssikohtaisesti, muuten kaikki kestot ovat väärin.
- Yksi asetusaika resurssia kohti. Seniorin Tempo setup on yksittäinen arvo. Rakenna SkyPlannerin asetusaikamatriisi käyttöönoton aikana todellisten tuotevaihtojen pohjalta.
- Tuotevariantit. Seniorin SKU muodostuu tuotteesta ja derivação-variantista, ja roteiros-työvaiheketjut voivat vaihdella varianteittain. Sisällytä variantin koodi SkyPlannerin tuoteavaimiin.
- OP:iden tilat. Tuotantokirjauksia hyväksytään vain Liberada- ja Andamento-tilassa oleville OP:ille. Tee tilamuutokset Seniorissa ja anna SkyPlannerin seurata niitä Events Hubin kautta.
- Hybriditoteutus. G5-verkkopalvelut toimivat Senior-palvelimellanne ja Events Hub Senior X:ssä. Suunnitelkaa verkkoyhteydet molempiin.
- Lukumuoto. Seniorin verkkopalvelut eivät hyväksy lukuja, joissa on tuhaterotin, ja vaativat desimaalipilkun. Lähettäkää luvut tässä muodossa.
Kuka määrittää Senior ERP -integraation asetukset ja vastaa tuesta?
- SkyPlanner-tiimi määrittää integraation asetukset käyttöönoton aikana ja vastaa tuesta tuotantokäytön alettua. Tämä kattaa sovitut verkkopalvelut, Senior X -rajapinnat ja Events Hub -webhookit. Jokainen tehdas käyttää Senior ERP:tä omalla tavallaan, ja tämä osaaminen otetaan huomioon toteutuksessa.
- Senior-kumppaninne voi osallistua toteutukseen. Kumppani tuntee ympäristönne, räätälöintinne ja lisenssinne. Se voi luoda integraatiokäyttäjän, hoitaa rekisteröinnin API-portaaliin ja määrittää verkkopalvelut yhdessä SkyPlanner-tiimin kanssa.
- Omat kehittäjänne voivat laajentaa integraatiota SkyPlannerin REST API -rajapinnan kautta API-tunnisteella. Alkuun pääsee pelkällä API-tunnisteella, ja SkyPlanner-tiimi auttaa tarvittaessa. Ohjeet löytyvät SkyPlannerin integraatiodokumentaatiosta.
SkyPlannerin hinta on alkaen 199 € kuukaudessa, ja siihen sisältyy 5 työpistettä. Laskutus on kuukausittain. Integraatiosta annetaan etukäteen prosessinne ja tarpeidenne mukainen tarjous yhdessä valitsemanne tilauksen kanssa. Tutustukaa hinnastoon, Senior ERP:n hienokuormitukseen, Senior ERP -sivuun ja ERP-integraatioiden koontisivuun.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästöä joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kojeistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono saadaan tuotantolinjalle sekunneissa.
+90%tuotannon tehokkuuteen
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkkeiden valmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikkien työpisteiden optimoitu suunnitelma kolmeksi kuukaudeksi syntyy alle 30 minuutissa.
1 000:iaautomaattisesti suunniteltuja työtilauksia
”Tuotanto on aivan eri tavalla hallinnassa, ja ymmärryksemme kapasiteetista on täysin eri tasolla.”
Hannu Ryynänen, toimitusjohtaja
Mamec · Teollisuussekoittimet, pumput ja korkean teknologian sopimusvalmistus
Tuhansien työtilausten suunnittelu hoituu automaattisesti, ja koko organisaatiolla on reaaliaikainen näkymä tuotantoon.
Vähemmänmateriaalipuutteista johtuvia seisokkeja
”SkyPlannerin arvo meille on siinä, että se toimii arjen työkaluna, erityisesti toimituspäivien määrittämisessä.”
Tommi Männistö, tuotannonsuunnittelupäällikkö
Eskomatic · Sopimuskoneistus
Automaattinen kuormitussuunnittelu tarkentaa toimituspäiviä, ja materiaalipuutteista johtuvat tuotantoseisokit ovat vähentyneet merkittävästi.
Usein kysytyt kysymykset
Onko Senior ERP:ssä rajapinta tuotantotilauksille?
Kyllä. G5-verkkopalvelu com.senior.g5.co.mpr.pcp.ordemproducao luo tuotantotilaukset (OP) samalla toiminnolla kuin ERP:n käyttöliittymä. Muut G5-palvelut kattavat tuotteet ja tuotantoraportoinnin. Senior X Platform tarjoaa lisäksi REST API -rajapinnat, joihin kirjaudutaan Bearer-tunnisteella, sekä Events Hub -webhookit.
Tukeeko Senior ERP webhookeja?
Kyllä. Senior X Events Hub lähettää webhookeja, kuten orderProductionStageChangeStatus-tapahtuman, kun tuotantotilauksen (OP) vaiheen tila muuttuu. SkyPlanner seuraa sen avulla tuotannon etenemistä reaaliajassa ja välittää suunnitelman muutokset takaisin omilla webhookeillaan.
Miten suunnitellut päivämäärät kirjoitetaan takaisin Senior ERP:hen?
SkyPlanner asettaa kunkin tuotantotilauksen (OP) vaiheen suunnitellun alun ja lopun sekä sille valitun resurssin. Nämä ovat samat kentät, joita suunnittelija muokkaa Programação de produção -näkymässä. SkyPlannerin webhook käynnistää takaisinkirjoituksen aina suunnitelman muuttuessa. Tiedot siirretään reittiä, jonka SkyPlanner-tiimi määrittää Senior-ympäristöänne varten käyttöönoton määrittelyvaiheessa.
Toimiiko integraatio Senior X:n ja ERP XT:n kanssa?
Kyllä. ERP XT toimii palvelimellanne, ja sen pilvipalvelut toimivat Senior X:ssä. Integraatio käyttää palvelimella G5-verkkopalveluja ja pilvessä Senior X -rajapintoja sekä Events Hubia.
Voimmeko kokeilla SkyPlanneria ennen integraation rakentamista?
Kyllä. Ilmaisessa 30 päivän kokeilussa voitte käyttää enintään 20 työpistettä ja tuoda tiedot Seniorista CSV- tai Excel-tiedostoina. Luottokorttia ei tarvita. Aloittakaa kokeilu tai ottakaa yhteyttä myyntiin integraation määrittelyä varten.
