Průvodce integrací Senior ERP pro plánování výroby se SkyPlanner APS
Tento průvodce integrací Senior ERP ukazuje partnerům a IT týmům, jak propojit Senior ERP od Senior Sistemas (Gestão Empresarial | ERP XT se Senior X) se SkyPlanner APS. SkyPlanner se se Senior ERP propojuje obousměrně prostřednictvím rozhraní společnosti Senior:
- Do SkyPlanner se načítají výrobní příkazy (OP) včetně fází, technologických postupů (roteiros), výrobních zdrojů a středisek zdrojů, dále SKU, struktury výrobků, skladové zásoby a nákupní objednávky.
- Zpět do OP se zapisuje plánovaný začátek a konec každé fáze i výrobní zdroj, který pro ni byl vybrán.
- Pokud se tak rozhodnete, časové záznamy operátorů se zapisují zpět jako hlášení výroby (apontamentos de produção).
- Senior X Events Hub informuje SkyPlanner o změně stavu fáze OP a webhooky SkyPlanner odesílají změny rozvrhu hned, jak nastanou.
Tým SkyPlanner během zavádění nastaví integraci podle vaší konfigurace Senior ERP a po spuštění ostrého provozu pro ni zajišťuje podporu. Tento průvodce je určen partnerům a vývojářům, kteří se chtějí zapojit nebo sami vytvořit řešení využívající zdokumentované REST API SkyPlanner (referenční dokumentace API).
Integrační rozhraní Senior ERP
ERP XT je hybridní systém. Dokumentace společnosti Senior uvádí, že Gestão Empresarial XT „becomes a hybrid system: an on-premises (local) system with integration of cloud solutions“ (stává se hybridním systémem: lokálním systémem s integrací cloudových řešení) (dokumentace Senior, v překladu). Systém pro rozvrhování využívá tři rozhraní Senior:
- Webové služby G5 (SOAP). Běží na vašem serveru Senior a jsou pojmenované podle modulu (com.senior.g5.co.<module>…). Každá je dostupná ve třech variantách WSDL: sapiens_Sync, sapiens_Async a sapiens_Scheduled. Mezi služby pro výrobu patří com.senior.g5.co.mpr.pcp.ordemproducao, která „calls the same production order generation routine“ (volá stejnou rutinu pro generování výrobních příkazů) jako obrazovka ERP (dokumentace Senior, v překladu), dále služby pro produkty (com.senior.g5.co.ger.cad.produto) a hlášení výroby.
- REST API Senior X Platform na adrese api.senior.com.br zpřístupňují oblasti ERP, které Senior nabízí v Senior X, například produkty a prodejní objednávky (dokumentace Senior).
- Webhooky Events Hub. Vytvářejí se v Senior X v nabídce Tecnologia > Customização > Events Hub > Webhooks. Při změně stavu fáze OP publikuje modul Manufacturing událost erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus (dokumentace Senior).
Ověřování a přístup
- Senior X Platform. Integrace se přihlašuje požadavkem POST na platform.senior.com.br přes cestu /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login s uživatelem ve formátu user@tenant. Odpověď obsahuje přístupový token Bearer a obnovovací token. Pro přihlášení pomocí aplikačních klíčů lze použít loginWithKey (přístupový klíč, tajný klíč, tenant). Volání REST obsahují hlavičku authorization a hlavičku client_id. Ta identifikuje připojující se aplikaci, která je registrovaná na portálu Senior API a propojená s rolí v ERP.
- Webové služby G5. Volání obsahují parametry pro uživatele, heslo a šifrování. Při použití tokenu Senior X nahrazuje token heslo (dokumentace Senior).
- Oprávnění. Vytvořte v Senior samostatného uživatele pro integraci s přístupem k datům PCP, technické přípravy výroby, skladu a nákupu, která integrace čte a zapisuje.
Na straně SkyPlanner se REST API ověřuje pomocí tokenu API v hlavičce Authorization-Token (SkyPlanner Settings > API). Dokumentace je ve formátu Swagger/OpenAPI. Prvními voláními vás provede návod k integraci.
Události a pravidelné dotazování
Events Hub zajišťuje události z výroby: při změně stavu fáze OP dorazí do SkyPlanner webhook a rozvrh se aktualizuje. Ostatní data se načítají pravidelnými dotazy. Nové výrobní úkoly se zjišťují dotazy filtrovanými podle stavů OP Firme a Liberada a podle posledních změn. Četnost se nastavuje pro každý závod zvlášť, od několika minut u OP po hodinový interval u zásob.
SkyPlanner při změně stavu nebo plánu odesílá webhooky, takže zpětný zápis se řídí událostmi.
Mapování dat
| Objekt Senior ERP (rozhraní) | Objekt SkyPlanner | Směr | Frekvence |
|---|---|---|---|
| SKU: produto a derivação, měrné jednotky (webové služby G5 nebo entity Senior X) | Výrobky a materiály | Senior → SkyPlanner | Úvodní načtení, poté pravidelné dotazování |
| Struktura výrobku (engenharia do SKU) | Struktura výrobku, dílčí výrobky, materiály pro každý výrobek | Senior → SkyPlanner | Úvodní načtení, poté při změně |
| Roteiro s fázemi (estágios): pořadí, závislost na předchozí fázi | Operace v daném pořadí | Senior → SkyPlanner | Úvodní načtení, poté při změně |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Pracoviště, doby trvání, časy přípravy a úklidu po operaci, efektivita | Senior → SkyPlanner | Úvodní načtení, poté jen zřídka |
| Centro de recurso | Skupiny pracovišť | Senior → SkyPlanner | Úvodní načtení, poté jen výjimečně |
| Calendário: Feriados, výrobní kalendář pro jednotlivé směny | Směny a nepracovní dny | Senior → SkyPlanner | Denně, nebo vlastní směny ve SkyPlanner |
| Ordens de produção (Firme, Liberada) včetně fází a materiálů | Zakázky a operace s termíny dokončení a požadavky na materiál | Senior → SkyPlanner | Dotazování každých několik minut |
| Stav fáze OP (Events Hub orderProductionStageChangeStatus) | Průběh operace | Senior → SkyPlanner | V reálném čase přes webhook |
| Estoque pro jednotlivé SKU | Stavy zásob | Senior → SkyPlanner | Dotazování každou hodinu nebo při spuštění plánování |
| Ordens de compra s termíny dodání | Nákupní objednávky, očekávaný materiál podle termínu dodání | Senior → SkyPlanner | Načítání dotazy každou hodinu nebo při spuštění rozvrhování |
| Fáze OP: plánovaný začátek a konec, výrobní zdroj | Plánovaný začátek a konec každé operace, přiřazené pracoviště | SkyPlanner → Senior | Při změně rozvrhu přes webhook SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, datum a čas začátku a konce | Časové záznamy a potvrzení operátorů | SkyPlanner → Senior | Při každém potvrzení nebo za směnu, pokud tuto možnost zvolíte |
| Není v Senior ERP | Matice seřizovacích časů, nástroje jako zdroje s omezenou kapacitou, operace s více operátory, alternativní stroje a pracovníci | Spravuje se ve SkyPlanner | Nastavení během zavádění |
Integrační scénáře
1. Úvodní načtení kmenových dat. Načtěte SKU, struktury, technologické postupy (roteiros), výrobní zdroje (recursos), střediska zdrojů (centros de recurso) a výrobní kalendář. Promyslete mapování středisek zdrojů: centro de recurso se čtyřmi stroji se převede na jednu skupinu pracovišť nebo na čtyři pracoviště. Fator de carga převeďte buď na efektivitu pracoviště ve SkyPlanner, nebo na směny, nikoli na obojí.
2. Synchronizace OP. Načtěte OP ve stavech Firme a Liberada včetně fází a materiálů a také otevřené nákupní objednávky. OP ve stavu Planejada může MRP stále měnit nebo mazat, proto je rozvrhujte jen tehdy, pokud chcete výhled do budoucna. SkyPlanner považuje objednaný materiál za dostupný v termínu dodání nákupní objednávky a po jejím označení stavem Delivered aktualizuje zásoby.
3. Zpětný zápis rozvrhu. Když plánovací jádro umístí nebo přesune fázi, webhook SkyPlanner spustí zpětný zápis. Zapíše plánovaný začátek a konec každé fáze OP a vybraný výrobní zdroj, tedy stejná pole, která plánovač upravuje v Programação de produção. Konkrétní webovou službu s vámi a vaším partnerem Senior dohodne tým SkyPlanner při vymezení rozsahu.
4. Potvrzování práce ve výrobě. Operátoři zaznamenávají práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer a jejich časové záznamy udržují rozvrh aktuální. Sami rozhodnete, zda se skutečné časy budou zapisovat zpět do Senior. Pokud ano, každé potvrzení se zapíše jako apontamento de produção k fázi OP, včetně vyrobeného množství, zmetků a času začátku a konce. Senior přijímá hlášení výroby pouze pro OP ve stavu Liberada nebo Andamento. Pokud výrobu hlásíte přes Fábrica ao Vivo, SkyPlanner místo toho načítá průběh přes Events Hub.
5. Odpovědnost za data a pravidla řešení konfliktů. Sepište je před spuštěním ostrého provozu:
| Data | Odpovědný systém |
|---|---|
| SKU, struktury, technologické postupy (roteiros), množství a stav OP | Senior ERP |
| Pořadí fází, časy začátku a konce, přiřazení výrobních zdrojů | SkyPlanner |
| Matice seřizovacích časů, požadavky na nástroje a operátory, alternativní výrobní zdroje | SkyPlanner |
| Výrobní kalendář a směny | Jeden systém zvolený při vymezení rozsahu |
| Hlášení výroby (apontamentos), skladové pohyby, kalkulace nákladů | Senior ERP; data se zadávají přímo v něm nebo se do něj zapisují z časových záznamů SkyPlanner |
Určete jediný systém, který bude zapisovat termíny fází. Pokud plánovači nadále řadí stejné OP v Programação de produção nebo v Ganttově diagramu, dohodněte se, které OP bude spravovat SkyPlanner.
Obvyklý postup projektu
Implementace bývá dokončena během několika týdnů od zahájení zavádění. Ještě předtím ověřte rozvrh v rámci 30denního bezplatného zkušebního období s výrobními zdroji, technologickými postupy (roteiros) a otevřenými OP exportovanými ze Senior do CSV nebo Excelu.
- Mapování. Stanovte mapovací tabulku, pravidla správy dat, četnost synchronizace a to, zda se budou hlášení výroby (apontamentos) zapisovat zpět.
- Přístup do Senior. Vytvořte uživatele pro integraci, zaregistrujte aplikaci na portálu Senior API a povolte webové služby G5 a webhook Events Hub. Nejprve vše otestujte v testovací databázi.
- Úvodní načtení. SKU, struktury, technologické postupy (roteiros), výrobní zdroje (recursos), střediska zdrojů (centros de recurso), kalendář.
- Synchronizace OP a nákupních objednávek. Pravidelné dotazy s filtry a opakováním při chybě, doplněné webhookem pro stav fáze.
- Nastavení omezení ve SkyPlanner. Matice seřizovacích časů, nástroje, počty pracovníků obsluhy na operaci a alternativní stroje nebo pracovníci.
- Zpětný zápis rozvrhu. Termíny fází a výrobní zdroje z webhooků SkyPlanner, případně i hlášení výroby (apontamentos), pokud tuto možnost zvolíte.
- Souběžné testování. Používejte SkyPlanner souběžně se stávajícím plánem, porovnávejte termíny a opravujte kmenová data.
- Spuštění ostrého provozu. Jakmile data souhlasí, zapněte zpětný zápis.
S čím počítat při integraci Senior ERP
- Čtyři druhy časů výrobního zdroje. Recurso obsahuje čas zpracování, seřízení, nakládky a vykládky a přesunu. Čas nakládky a přesunu může představovat manipulaci, nikoli strojní čas. Pro každý výrobní zdroj určete, jak se jednotlivé časy mapují, jinak budou všechny doby trvání chybné.
- Jeden seřizovací čas na výrobní zdroj. Tempo setup v Senior je jediná hodnota. Během zavádění vytvořte ve SkyPlanner matici seřizovacích časů podle skutečných přestaveb ve vaší výrobě.
- Varianty výrobků. SKU v Senior tvoří produkt a jeho varianta (derivação). Technologické postupy (roteiros) se mohou pro jednotlivé varianty lišit. Kód varianty přeneste do klíčů produktů ve SkyPlanner.
- Stavy OP. Hlášení výroby lze zapisovat pouze k OP ve stavech Liberada a Andamento. Stavy měňte v Senior a nechte SkyPlanner tyto změny přebírat přes Events Hub.
- Hybridní nasazení. Webové služby G5 běží na vašem serveru Senior a Events Hub běží v Senior X. Naplánujte síťový přístup k oběma.
- Formát čísel. Webové služby Senior odmítají čísla s oddělovači tisíců a vyžadují desetinnou čárku. Odesílejte čísla v tomto formátu.
Kdo nastavuje integraci se Senior ERP a zajišťuje její podporu
- Tým SkyPlanner integraci nastaví během zavádění a po spuštění ostrého provozu zajišťuje její podporu. To zahrnuje dohodnuté webové služby, API Senior X a webhooky Events Hub. Každý závod používá Senior ERP jinak a právě při nastavení integrace se tyto znalosti uplatní.
- Zapojit se může i váš partner pro Senior. Zná vaši konfiguraci, úpravy na míru i licence a může společně s týmem SkyPlanner nastavit integračního uživatele, registraci v portálu API a webové služby.
- Vaši vývojáři mohou integraci dále rozvíjet pomocí REST API SkyPlanner s API tokenem. Pro začátek stačí API token a tým SkyPlanner v případě potřeby pomůže. Dokumentaci najdete v dokumentaci integrace SkyPlanner.
Cena SkyPlanner začíná na 199 € měsíčně a zahrnuje 5 pracovišť. Fakturace probíhá měsíčně. Cenovou nabídku integrace dostanete předem spolu s nabídkou tarifu podle vašich procesů a potřeb. Podívejte se na ceník, kapacitní plánování se Senior ERP, stránku Senior ERP a přehled integrací s ERP.
Jak SkyPlanner hodnotí výrobní firmy
2 húspory každý týden
„Díky systému SkyPlanner jsme od plánování výroby v tabulkách Excelu přešli k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista na dodavatelský řetězec
UTU · Elektrické rozváděče a spínací zařízení
Při plánování výroby se každý týden ušetří 2 hodiny práce a nová fronta operací se na linku dostane během několika sekund.
+90%efektivita výroby
„Efektivita výroby vzrostla o 90 %.“
Abdul Rucyinga, vedoucí IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrostla o 90 % a vytvoření optimalizovaného plánu na tři měsíce pro všechna pracoviště trvá méně než 30 minut.
1 000+automaticky naplánovaných výrobních příkazů
„Výrobu máme pod kontrolou úplně jinak a náš přehled o kapacitách je na zcela jiné úrovni.“
Hannu Ryynänen, generální ředitel
Mamec · Průmyslová míchadla, čerpadla a technologicky náročná zakázková výroba
Tisíce výrobních příkazů se plánují automaticky a celá organizace má přehled o výrobě v reálném čase.
Méněprostojů kvůli nedostatku materiálu
„Přínos systému SkyPlanner pro nás spočívá v tom, že funguje v každodenní praxi, zejména při stanovování termínů dodání.“
Tommi Männistö, vedoucí plánování výroby
Eskomatic · Zakázkové obrábění
Automatické plánování vytížení umožňuje přesněji stanovit termíny dodání a výrazně ubylo prostojů ve výrobě způsobených nedostatkem materiálu.
Časté dotazy
Má Senior ERP API pro výrobní příkazy?
Ano. Webová služba G5 com.senior.g5.co.mpr.pcp.ordemproducao vytváří výrobní příkazy OP pomocí stejné rutiny, která se používá při jejich vytváření na obrazovce ERP. Další služby G5 pokrývají produkty a vykazování výroby. Senior X Platform navíc poskytuje REST API s přihlášením pomocí tokenu Bearer a webhooky Events Hub.
Podporuje Senior ERP webhooky?
Ano. Senior X Events Hub odesílá webhooky, včetně orderProductionStageChangeStatus při změně stavu fáze výrobního příkazu OP. SkyPlanner tak sleduje průběh výroby v reálném čase a vlastními webhooky předává změny plánu zpět.
Jak se plánované termíny zapisují zpět do Senior ERP?
SkyPlanner nastavuje plánovaný začátek a konec každé fáze výrobního příkazu OP a výrobní zdroj, který je pro ni vybrán. Jde o stejná pole, která plánovač upravuje v Programação de produção. Při každé změně plánu spustí webhook SkyPlanner zpětný zápis cestou, kterou tým SkyPlanner určí pro vaši instalaci Senior při vymezení rozsahu během zavádění.
Funguje integrace se Senior X a ERP XT?
Ano. ERP XT běží na vašem serveru a cloudové služby využívá na Senior X. Integrace používá webové služby G5 na serveru a API Senior X a Events Hub v cloudu.
Můžeme si SkyPlanner vyzkoušet před vytvořením integrace?
Ano. Během 30denní bezplatné zkušební verze můžete využít až 20 pracovišť a importovat data ze Senior ve formátu CSV nebo Excel. Platební karta není potřeba. Vyzkoušejte SkyPlanner nebo kontaktujte obchodní tým a vymezte s ním rozsah integrace.
