Integrácie / ERP / Senior ERP
Sprievodca integráciou Senior ERP so SkyPlanner APS na rozvrhovanie výroby
Tento sprievodca integráciou Senior ERP ukazuje partnerom a IT tímom, ako prepojiť Senior ERP od Senior Sistemas (Gestão Empresarial | ERP XT so Senior X) so SkyPlanner APS. SkyPlanner sa so Senior ERP integruje obojsmerne cez vlastné rozhrania systému Senior:
- Do SkyPlanner sa prenášajú výrobné príkazy (OP) s ich etapami, technologické postupy (roteiros), zdroje a strediská zdrojov, SKU, štruktúry výrobkov, zásoby a nákupné objednávky.
- Do OP sa spätne zapisuje plánovaný začiatok a koniec každej etapy aj zdroj, ktorý bol pre ňu vybraný.
- Ak si to zvolíte, časové záznamy operátorov sa spätne zapisujú ako apontamentos de produção.
- Senior X Events Hub informuje SkyPlanner o zmene stavu etapy OP a webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas úvodného nasadenia prispôsobí integráciu vášmu nastaveniu Senior ERP a po spustení ostrej prevádzky zabezpečuje jej podporu. Tento sprievodca je určený partnerom a vývojárom, ktorí sa chcú zapojiť alebo sami vyvíjať riešenia pomocou zdokumentovaného REST API SkyPlanner (referenčná dokumentácia API).
Integračné rozhrania Senior ERP
ERP XT je hybridný systém. Dokumentácia Senior uvádza, že Gestão Empresarial XT „becomes a hybrid system: an on-premises (local) system with integration of cloud solutions“ (stáva sa hybridným systémom: lokálnym systémom s integráciou cloudových riešení) (dokumentácia Senior, preložené). Rozvrhovací systém využíva tri rozhrania Senior:
- Webové služby G5 (SOAP). Služby na vašom serveri Senior pomenované podľa modulu (com.senior.g5.co.<module>…). Každá je publikovaná v troch variantoch WSDL: sapiens_Sync, sapiens_Async a sapiens_Scheduled. Medzi služby pre výrobu patrí com.senior.g5.co.mpr.pcp.ordemproducao, ktorá „calls the same production order generation routine“ (volá rovnakú rutinu na generovanie výrobných príkazov) ako obrazovka ERP (dokumentácia Senior, preložené), a služby pre produkty (com.senior.g5.co.ger.cad.produto) a odvádzanie výroby.
- Rozhrania REST API platformy Senior X Platform na api.senior.com.br pre oblasti ERP, ktoré Senior sprístupňuje v Senior X, napríklad produkty a predajné objednávky (dokumentácia Senior).
- Webhooky Events Hub. Vytvárajú sa v Senior X v časti Tecnologia > Customização > Events Hub > Webhooks. Modul Manufacturing publikuje udalosť erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus pri zmene stavu etapy OP (dokumentácia Senior).
Autentifikácia a prístup
- Senior X Platform. Integrácia sa prihlasuje požiadavkou POST na platform.senior.com.br cez /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login s používateľom vo formáte user@tenant. Odpoveď obsahuje prístupový token typu Bearer a obnovovací token. Pomocou aplikačných kľúčov sa možno prihlásiť cez loginWithKey (access key, secret, tenant). Volania REST obsahujú hlavičku authorization a hlavičku client_id, ktorá identifikuje pripájanú aplikáciu. Tá je zaregistrovaná na portáli Senior API a prepojená s rolou v ERP.
- Webové služby G5. Volania obsahujú parametre user, password a encryption. Pri použití tokenu Senior X tento token nahrádza heslo (dokumentácia Senior).
- Oprávnenia. V systéme Senior vytvorte samostatného používateľa pre integráciu s prístupom k dátam PCP, technickej prípravy výroby, skladov a nákupu, ktoré integrácia číta a zapisuje.
Na strane SkyPlanner sa REST API autentifikuje tokenom API v hlavičke Authorization-Token (SkyPlanner Settings > API). Dokumentácia je dostupná vo formáte Swagger/OpenAPI. Návod na integráciu vás prevedie prvými volaniami.
Udalosti a pravidelné načítavanie
Events Hub pokrýva dianie vo výrobe: pri zmene stavu etapy OP dorazí webhook do SkyPlanner a rozvrh sa aktualizuje. Ostatné dáta sa načítavajú pravidelnými dopytmi. Nová práca sa zachytáva načítaním dát filtrovaných na potvrdené a uvoľnené OP a nedávne zmeny. Frekvencia sa nastavuje pre každý závod samostatne: od niekoľkých minút pri OP až po hodinu pri zásobách.
SkyPlanner pri zmene stavu alebo rozvrhu odosiela webhooky, takže spätný zápis sa riadi udalosťami.
Mapovanie dát
| Objekt Senior ERP (rozhranie) | Objekt SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
| SKU: produto a derivação, merné jednotky (webové služby G5 alebo entity Senior X) | Výrobky a materiály | Senior → SkyPlanner | Úvodné načítanie, potom pravidelné načítavanie |
| Štruktúra výrobku (engenharia do SKU) | Štruktúra výrobku, čiastkové výrobky, materiály pre jednotlivé výrobky | Senior → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Roteiro s etapami (estágios): poradie, závislosť od predchádzajúcej etapy | Kroky procesu v danom poradí | Senior → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Pracoviská, trvanie, časy prípravy a ukončenia, efektívnosť | Senior → SkyPlanner | Úvodné načítanie, potom zriedkavo |
| Centro de recurso | Skupiny pracovísk | Senior → SkyPlanner | Úvodné načítanie, potom zriedkavo |
| Calendário: Feriados, výrobný kalendár podľa zmien | Pracovné zmeny a dni pracovného pokoja | Senior → SkyPlanner | Denne alebo vlastná správa pracovných zmien v SkyPlanner |
| Ordens de produção (Firme, Liberada) s etapami a materiálmi | Zákazky a operácie s termínmi dokončenia a materiálovými požiadavkami | Senior → SkyPlanner | Načítavanie každých niekoľko minút |
| Stav etapy OP (Events Hub orderProductionStageChangeStatus) | Priebeh operácie | Senior → SkyPlanner | V reálnom čase cez webhook |
| Estoque podľa SKU | Stavy zásob | Senior → SkyPlanner | Načítavanie každú hodinu alebo pri spustení rozvrhovania |
| Ordens de compra s termínmi dodania | Nákupné objednávky, očakávaný materiál podľa termínu dodania | Senior → SkyPlanner | Pravidelné dopyty každú hodinu alebo pri spustení rozvrhovania |
| Etapa OP: plánovaný začiatok a koniec, zdroj | Plánovaný začiatok a koniec každej operácie, priradené pracovisko | SkyPlanner → Senior | Pri zmene rozvrhu cez webhook SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, dátum a čas začiatku a konca | Časové záznamy a potvrdenia operátorov | SkyPlanner → Senior | Pri každom potvrdení alebo za každú zmenu, ak si to zvolíte |
| Nie je v Senior ERP | Matica časov prestavenia, nástroje ako zdroje s obmedzenou kapacitou, operácie s viacerými operátormi, alternatívne stroje a pracovníci | Spravuje sa v SkyPlanner | Nastavenie počas úvodného nasadenia |
Integračné postupy
1. Úvodné načítanie kmeňových dát. Načítajte SKU, štruktúry, roteiros, recursos, centros de recurso a výrobný kalendár. Dôkladne zvážte mapovanie stredísk zdrojov: z centro de recurso so štyrmi strojmi vznikne jedna skupina pracovísk alebo štyri pracoviská. Fator de carga preveďte buď na efektívnosť pracoviska v SkyPlanner, alebo na zmeny, nie na oboje.
2. Synchronizácia OP. Načítajte OP v stavoch Firme a Liberada s ich etapami a materiálmi, ako aj otvorené nákupné objednávky. MRP môže OP v stave Planejada stále zmeniť alebo odstrániť, preto ich rozvrhujte len vtedy, ak chcete výhľad do budúcnosti. SkyPlanner považuje objednaný materiál za dostupný v termíne dodania nákupnej objednávky a aktualizuje zásoby, keď je objednávka označená stavom Delivered.
3. Spätný zápis rozvrhu. Keď rozvrhovací mechanizmus zaradí alebo presunie etapu, webhook SkyPlanner spustí spätný zápis. Zapíše plánovaný začiatok a koniec každej etapy OP a vybraný zdroj do rovnakých polí, ktoré plánovač upravuje v Programação de produção. Konkrétnu webovú službu s vami a vaším partnerom Senior dohodne tím SkyPlanner počas definovania rozsahu.
4. Potvrdenia z výroby. Operátori zaznamenávajú prácu cez SkyPlanner Mobile Confirmations alebo Production Timer a časové záznamy udržiavajú rozvrh aktuálny. Vy rozhodnete, či sa skutočné časy budú spätne zapisovať do systému Senior. Ak áno, z každého potvrdenia vznikne apontamento de produção k etape OP s vyrobeným množstvom, nepodarkami a časom začiatku a konca. Senior prijíma hlásenia výroby len pre OP v stave Liberada alebo Andamento. Ak výrobu odvádzate cez Fábrica ao Vivo, SkyPlanner namiesto toho načítava priebeh cez Events Hub.
5. Zodpovednosť za dáta a pravidlá riešenia konfliktov. Spíšte ich pred spustením do prevádzky:
| Dáta | Zodpovedný systém |
|---|---|
| SKU, štruktúry, roteiros, množstvá a stav OP | Senior ERP |
| Poradie etáp, časy začiatku a konca, priradenie zdrojov | SkyPlanner |
| Matica časov prestavenia, požiadavky na nástroje a operátorov, alternatívne zdroje | SkyPlanner |
| Výrobný kalendár a zmeny | Jeden systém vybraný počas definovania rozsahu |
| Apontamentos, skladové pohyby, kalkulácia nákladov | Senior ERP, s priamym zadávaním alebo zápisom z časových záznamov SkyPlanner |
Na zápis termínov etáp určite len jeden systém. Ak plánovači naďalej určujú poradie rovnakých OP v Programação de produção alebo v Ganttovom diagrame, dohodnite sa, ktoré OP spravuje SkyPlanner.
Typický priebeh projektu
Implementácia sa bežne dokončí v priebehu niekoľkých týždňov od začiatku úvodného nasadenia. Ešte predtým si overte rozvrh počas 30-dňovej bezplatnej skúšobnej verzie so zdrojmi, roteiros a otvorenými OP exportovanými zo systému Senior vo formáte CSV alebo Excel.
- Mapovanie. Dohodnite tabuľku mapovania, pravidlá zodpovednosti za dáta, frekvencie synchronizácie a to, či sa apontamentos budú zapisovať späť.
- Prístup do systému Senior. Vytvorte používateľa pre integráciu, zaregistrujte aplikáciu na portáli Senior API a povoľte webové služby G5 a webhook Events Hub. Najprv otestujte integráciu v testovacej databáze.
- Úvodné načítanie. SKU, štruktúry, roteiros, recursos, centros de recurso, kalendár.
- Synchronizácia OP a nákupných objednávok. Pravidelné dopyty s filtrami a opakovaním pri zlyhaní spolu s webhookom pre stav etapy.
- Nastavenie obmedzení v SkyPlanner. Matica časov prestavenia, nástroje, počty operátorov na operáciu a alternatívne stroje alebo pracovníci.
- Spätný zápis rozvrhu. Termíny etáp a zdroje z webhookov SkyPlanner, prípadne aj apontamentos, ak si to zvolíte.
- Paralelné testovanie. Používajte SkyPlanner súbežne s aktuálnym plánom, porovnávajte termíny a opravte kmeňové dáta.
- Spustenie do prevádzky. Keď sa dáta zhodujú, zapnite spätný zápis.
S čím počítať pri integrácii Senior ERP
- Štyri druhy časov pri zdroji. Recurso obsahuje čas spracovania, čas prípravy, čas nakládky a vykládky a čas presunu. Čas nakládky a presunu môže predstavovať čas manipulácie, nie čas práce stroja. Pre každý zdroj určite, ako sa jednotlivé časy mapujú, inak budú všetky trvania nesprávne.
- Jeden čas prípravy na zdroj. Tempo setup v systéme Senior je jediná hodnota. Počas úvodného nasadenia vytvorte v SkyPlanner maticu časov prestavenia podľa skutočných prestavení vo vašej výrobe.
- Varianty. SKU v systéme Senior tvorí produkt spolu s derivação a roteiros sa môžu pre jednotlivé varianty líšiť. Kód variantu zahrňte do kľúčov produktov v SkyPlanner.
- Stavy OP. Hlásenia výroby možno zapisovať len k OP v stave Liberada alebo Andamento. Stavy naďalej meňte v systéme Senior a nechajte SkyPlanner sledovať tieto zmeny cez Events Hub.
- Hybridné nasadenie. Webové služby G5 bežia na vašom serveri Senior a Events Hub beží v Senior X. Naplánujte sieťový prístup k obom.
- Formát čísel. Webové služby Senior odmietajú čísla s oddeľovačmi tisícov a vyžadujú desatinnú čiarku. Čísla odosielajte v tomto formáte.
Kto nastavuje integráciu so Senior ERP a poskytuje jej podporu
- Tím SkyPlanner nastaví integráciu počas zavádzania a po spustení ostrej prevádzky poskytuje podporu pre dohodnuté webové služby, API Senior X a webhooky Events Hub. Každý závod používa Senior ERP inak a práve pri integrácii sa tieto skúsenosti uplatnia.
- Zapojiť sa môže aj váš partner pre Senior. Pozná vaše nastavenia, úpravy aj licencie a spolu s tímom SkyPlanner môže nastaviť integračného používateľa, registráciu na portáli API a webové služby.
- Vaši vývojári môžu integráciu ďalej rozvíjať cez REST API systému SkyPlanner s tokenom API. Na začiatok stačí token API a tím SkyPlanner v prípade potreby pomôže. Podrobnosti nájdete v dokumentácii k integrácii so SkyPlanner.
SkyPlanner je dostupný od 199 € mesačne s mesačnou fakturáciou a 5 pracoviskami v cene. Cenovú ponuku na integráciu pripravíme vopred podľa vašich procesov a potrieb spolu s ponukou predplatného. Pozrite si cenník, plánovanie výroby so Senior ERP s ohľadom na reálne kapacity strojov a pracovníkov, stránku Senior ERP a prehľad integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
2 hušetrené každý týždeň
„Vďaka SkyPlanner sme pri plánovaní výroby prešli od tabuliek v Exceli k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista dodávateľského reťazca
UTU · Elektrické rozvádzače a spínacie zariadenia
Plánovanie výroby ušetrí každý týždeň 2 hodiny pracovného času a nový zoznam operácií sa dostane na linku za pár sekúnd.
+90%efektívnosť výroby
„Efektívnosť výroby sa zvýšila o 90 %.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektívnosť výroby sa zvýšila o 90 % a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej než 30 minút.
1 000 a viacautomaticky rozvrhnutých výrobných príkazov
„Výrobu máme pod kontrolou úplne inak a náš prehľad o kapacitách je na celkom inej úrovni.“
Hannu Ryynänen, generálny riaditeľ
Mamec · Priemyselné miešadlá, čerpadlá a technologicky vyspelá zákazková výroba
Tisíce výrobných príkazov sa rozvrhujú automaticky a celá organizácia má prehľad o výrobe v reálnom čase.
Menejprestojov pre nedostatok materiálu
„Prínos SkyPlanner pre nás spočíva v tom, že je to nástroj, ktorý funguje pri každodennej práci, najmä pri stanovovaní termínov dodania.“
Tommi Männistö, manažér plánovania výroby
Eskomatic · Zákazkové obrábanie
Automatické rozvrhovanie zaťaženia umožňuje presnejšie určovať termíny dodania a počet výrobných prestojov spôsobených nedostatkom materiálu výrazne klesol.
Často kladené otázky
Má Senior ERP API pre výrobné príkazy?
Áno. Webová služba G5 com.senior.g5.co.mpr.pcp.ordemproducao vytvára výrobné príkazy OP rovnakým postupom ako pri ich vytváraní cez obrazovku ERP. Ďalšie služby G5 pokrývajú produkty a vykazovanie výroby. Senior X Platform navyše poskytuje REST API s prihlasovaním pomocou tokenu Bearer a webhooky Events Hub.
Podporuje Senior ERP webhooky?
Áno. Senior X Events Hub odosiela webhooky vrátane orderProductionStageChangeStatus pri zmene stavu etapy výrobného príkazu OP. SkyPlanner ho využíva na sledovanie priebehu výroby v reálnom čase a cez vlastné webhooky odosiela zmeny rozvrhu späť.
Ako sa plánované termíny zapisujú späť do Senior ERP?
SkyPlanner nastavuje plánovaný začiatok a koniec každej etapy výrobného príkazu OP aj zdroj, ktorý je pre ňu vybraný. Ide o tie isté polia, ktoré plánovač upravuje v Programação de produção. Pri každej zmene rozvrhu spustí webhook systému SkyPlanner spätný zápis cez prepojenie, ktoré tím SkyPlanner určí pre vašu inštaláciu Senior pri definovaní rozsahu počas zavádzania.
Funguje integrácia so Senior X a ERP XT?
Áno. ERP XT beží na vašom serveri a využíva cloudové služby na Senior X. Integrácia používa webové služby G5 na serveri a API Senior X a Events Hub v cloude.
Môžeme si SkyPlanner otestovať ešte pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk s importom dát zo Senior vo formáte CSV alebo Excel. Platobnú kartu nepotrebujete. Spustite skúšobnú verziu alebo kontaktujte obchodný tím a dohodnite si rozsah integrácie.