Integrace / ERP / Oracle NetSuite
Průvodce integrací NetSuite se SkyPlanner APS pro rozvrhování výroby
Tento průvodce ukazuje partnerům NetSuite, správcům a technickým specialistům, kteří vybírají řešení, jak propojit SkyPlanner APS s Oracle NetSuite pro plánování výroby, které respektuje skutečné kapacity strojů a pracovníků. SkyPlanner se s NetSuite propojuje obousměrně přes webové služby REST a SuiteQL:
- Do SkyPlanner přicházejí výrobní příkazy, technologické postupy, pracoviště, položky a nákupní objednávky.
- Plánované časy zahájení a ukončení se zapisují k úkolům výrobních operací.
- Vykázané hodiny a vyrobená množství se zapisují zpět jako Work Order Completions nebo Assembly Builds.
- Webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
NetSuite spravuje položky, kusovníky, technologické postupy, výrobní příkazy, zásoby a kalkulace nákladů. SkyPlanner pomocí enginu Arcturus plánuje výrobu s ohledem na skutečné kapacity strojů a pracovníků. Tým SkyPlanner při zavádění nastaví integraci pro váš účet a po spuštění ostrého provozu zajišťuje její podporu. Integrace pracuje se standardními záznamy NetSuite a není závislá na Advanced Manufacturing SuiteApp.
SkyPlanner již funguje propojený s NetSuite ve společnosti UTU, která vyrábí rozvaděče a spínací zařízení ve finském městě Ulvila. UTU spustila ostrý provoz v září 2025 s propojením SkyPlanner na Oracle NetSuite a svůj mzdový systém. Pokud chcete posoudit obchodní přínosy, začněte na stránce o rozvrhování výroby s NetSuite a u článku Umí NetSuite plánovat výrobu s ohledem na kapacity?.
Rozhodnutí, které určí podobu projektu: REST a OAuth 2.0
Oracle určil směr. Od verze 2026.1 by nové integrace měly využívat webové služby SuiteTalk REST s OAuth 2.0. Od verze 2027.1 již nelze vytvářet nové integrace se SOAP ani Token-Based Authentication (TBA). Ve verzi 2028.2 budou endpointy SOAP vypnuty. Každá dnes zahajovaná integrace pro rozvrhování má stavět na REST.
| Možnost v NetSuite | Popis | Úloha při integraci s APS |
|---|---|---|
| SuiteTalk REST record API | /services/rest/record/v1/<recordType>, verzování podle vydání NetSuite; !transform pro odvádění výroby, výdej materiálu a výrobu sestav | Zápis: termíny operací a výrobních příkazů (PATCH), odvedená výroba, výdej materiálu a výroba sestav (transform) |
| SuiteQL přes REST | POST /services/rest/query/v1/suiteql s Prefer: transient, až 100 000 výsledků na dotaz, stránkování pomocí limit/offset | Hromadné čtení: položky, technologické postupy, pracoviště, otevřené výrobní příkazy, zásoby |
| SuiteScript 2.1 RESTlets | Vlastní endpointy get/post/put/delete | Funkce, které REST nepokrývá, a sdružená data, například výrobní příkaz se všemi operacemi |
| SuiteScript User Event / Map-Reduce | Skripty běžící na serveru v NetSuite | Odesílání oznámení o změnách |
| CSV Import Assistant | Uložená mapování pro import | Jednorázové načtení dat; není určeno pro průběžnou synchronizaci |
| SuiteTalk SOAP | Starší rozhraní, pouze TBA | Nové integrace na něm nestavte |
Autentizace
Pro rozvrhovací systém komunikující mezi servery použijte OAuth 2.0 Client Credentials (machine-to-machine). V administraci přejděte touto cestou: Setup > Integration > Manage Authentication > OAuth 2.0 Client Credentials (M2M) Setup. Nahrajete veřejný certifikát a přiřadíte jej k entitě, roli a záznamu integrace. Každý záznam integrace může obsahovat nejvýše pět aktivních certifikátů.
Vytvořte samostatnou integrační roli s oprávněním prohlížet položky, revize kusovníků, technologické postupy a pracoviště a upravovat výrobní příkazy, odvody výroby a výdeje materiálu. REST API SkyPlanner (referenční dokumentace API) používá JWT, takže middleware uchovává přihlašovací údaje pro oba systémy.
Události: standardní webhook není k dispozici
Dokumentace Oracle nepopisuje žádný nativní odchozí webhook. Osvědčeným řešením je skript SuiteScript User Event nad záznamem Work Order (afterSubmit), který zařadí odchozí volání do fronty prostřednictvím N/task nebo skriptu Map/Reduce. Samotné volání pak probíhá přes N/https. V afterSubmit nikdy neprovádějte synchronní odchozí volání: probíhá totiž během ukládání záznamu uživatelem, takže pomalý endpoint ukládání zpomalí nebo způsobí jeho selhání.
Události User Event nepokrývají všechny způsoby změny dat. Hromadné aktualizace a importy CSV je mohou obejít. Skript proto doplňte pravidelnou kontrolou změn pomocí dotazů SuiteQL nad lastmodifieddate, aby žádná změna neunikla. V opačném směru spouštějí zpětný zápis vlastní webhooky systému SkyPlanner, takže NetSuite dostává nové termíny ihned po změně plánu.
Mapování dat z NetSuite do SkyPlanner
| Záznam v NetSuite (REST id) | Objekt v SkyPlanner | Směr | Četnost |
|---|---|---|---|
Assembly Item (assemblyItem), Inventory Item (inventoryItem) | Výrobek / materiál | NetSuite → SkyPlanner | Úvodní načtení, poté denně nebo při změně |
BOM Revision (bomRevision), komponenty kusovníku | Víceúrovňová struktura výrobku, materiálové požadavky | NetSuite → SkyPlanner | Při změně |
Manufacturing Routing (manufacturingRouting, podseznamy routingStep, routingComponent) | Operace technologického postupu: pořadí, pracoviště, čas seřízení, čas zpracování | NetSuite → SkyPlanner | Při změně |
| Manufacturing Work Center (Group označená jako pracoviště): Machine Resources, Labor Resources, Work Calendar | Pracoviště, skupiny pracovišť, směny | NetSuite → SkyPlanner, následná správa v SkyPlanner | Úvodní načtení |
Work Order (workOrder): položka, množství, lokalita, Production Start/End Date, stav; termín dodání z navázaného záznamu Sales Order | Zakázka / operace s termínem a prioritou | NetSuite → SkyPlanner | Téměř v reálném čase přes User Event, doplněno pravidelnou kontrolou změn |
Manufacturing Operation Task (manufacturingOperationTask) | Rozvržená operace | NetSuite → SkyPlanner, termíny SkyPlanner → NetSuite | Téměř v reálném čase |
Skladové zásoby podle lokalit (SuiteQL), Item Receipts (itemReceipt) | Stavy zásob pro rozvrhování podle dostupnosti materiálu | NetSuite → SkyPlanner | Každých 15 až 60 minut nebo při příjmu |
Řádky Purchase Order (purchaseOrder): položka, množství, očekávané datum příjmu, stav | Nákupní objednávky / očekávaný materiál (předpokládané datum dodání). Materiál se považuje za dostupný k datu dodání; stav zásob se aktualizuje po označení nákupní objednávky stavem Delivered | NetSuite → SkyPlanner | Každých 15 až 60 minut nebo při změně |
| Plánovaný začátek a konec každé operace | PATCH manufacturingOperationTask/{id} (startDate, endDate) a PATCH workOrder/{id} (Production Start/End Date) | SkyPlanner → NetSuite | Při změně rozvrhu přes webhook systému SkyPlanner |
| Mobile Confirmations, časové záznamy, Production Timer | POST workOrder/{id}/!transform/workOrderCompletion: rozsah startOperation/endOperation, dokončené množství, odpracovaný čas na řádcích operation, ID časového záznamu ze SkyPlanner jako externí ID | SkyPlanner → NetSuite | Při každém potvrzení nebo dávkově |
| Spotřeba materiálu | POST workOrder/{id}/!transform/workOrderIssue nebo isBackflush při odvedení výroby | SkyPlanner → NetSuite | Při každém potvrzení |
| Dokončená zakázka (účty bez WIP) | POST workOrder/{id}/!transform/assemblyBuild | SkyPlanner → NetSuite | Při dokončení zakázky |
| Uzavřená zakázka | Work Order Close (workOrderClose) | V NetSuite provádí finanční oddělení | Ve výchozím nastavení bez automatizace |
Integrační postupy
1. Úvodní načtení kmenových dat. Pomocí SuiteQL načtěte nejprve pracoviště, poté položky, revize kusovníků a technologické postupy. Technologické postupy odkazují na pracoviště, proto na pořadí záleží. Ve zkušební verzi exportujte stejná data do CSV a importujte je do SkyPlanner. Rozvrh tak ověříte ještě před napsáním jakéhokoli kódu.
2. Synchronizace příkazů a objednávek. Načítejte výrobní příkazy ve stavech Released a In Process. Včas rozhodněte, zda zahrnete i příkazy ve stavu Planned. Pokud ano, považujte je za předběžnou poptávku. Ve stejném cyklu synchronizujte otevřené nákupní objednávky, aby rozvrh u každé operace ověřoval nejen skladové zásoby, ale i očekávané dodávky materiálu.
3. Zpětný zápis rozvrhu. Při změně rozvrhu odešle webhook systému SkyPlanner nové termíny operací do middlewaru. Middleware pro každou změněnou operaci odešle PATCH /services/rest/record/v1/manufacturingOperationTask/{id} (referenční dokumentace záznamu Oracle) s poli startDate a endDate. Další PATCH v hlavičce workOrder nastaví pole Production Start a End Date. Zapisujte pouze termíny a případně vlastní pole pro pořadí, pokud ho používáte. Množství ani data kusovníku nikdy nezapisujte zpět. Pro aktualizaci více operací v jedné transakci poslouží jednoduchý RESTlet, který uloží celý seznam operací jediným voláním. Výchozí volbou zůstává record API.
4. Odvádění výroby v provozu. Obsluha zaznamenává práci v SkyPlanner Mobile Confirmations. Middleware odešle každé potvrzení prostřednictvím transformací záznamu Work Order voláním POST /services/rest/record/v1/workOrder/{id}/!transform/workOrderCompletion. Předá přitom startOperation, endOperation, dokončené množství a vykázaný čas na řádcích operací. Výrobní příkazy bez WIP se místo toho uzavírají pomocí !transform/assemblyBuild. Work Order Completion přes REST vyžaduje funkci Manufacturing Work In Process. Účtování zásob a nákladů zůstává v NetSuite.
5. Idempotence a opakování požadavků. Každý odvod výroby nese ID časového záznamu ze SkyPlanner jako externí ID v NetSuite. Externí ID jsou jedinečná v rámci typu záznamu. Opakovaně doručený webhook je proto odmítnut jako duplicita, místo aby znovu zaúčtoval množství a náklady. Zápisy procházejí frontou. Neúspěšné volání (limit souběžných požadavků, uzamčený záznam, prošlý certifikát) se zopakuje a zaznamená do protokolu. Všechny požadavky, které selžou i poté, vidí tým SkyPlanner zajišťující podporu integrace.
6. Pravidla odpovědnosti za data. NetSuite určuje, co se vyrábí: položku, množství, kusovník, technologický postup a lokalitu. SkyPlanner určuje, kdy a kde: pořadí operací, pracoviště, zahájení a ukončení. Termíny upravené v NetSuite se při příštím zpětném zápisu přepíší. Pole Production Start/End Date proto uzamkněte úpravou formuláře nebo pomocí workflow.
Typické kroky projektu
Implementace bývá hotová během několika týdnů od zahájení zavádění, a to i ve velkých firmách. Projekt pro NetSuite zahrnuje:
- Zkouška na vlastních datech: export pracovišť, technologických postupů a otevřených výrobních příkazů z uložených vyhledávání do CSV a jejich import do SkyPlanner během 30denní zkušební doby.
- Mapování kmenových dat: přiřazení záznamů NetSuite k objektům SkyPlanner, mapování vlastních polí a jednotek a určení modelu s WIP nebo bez WIP pro každou položku.
- Úvodní načtení: položky, revize kusovníků, technologické postupy a pracoviště přes SuiteQL, poté nastavení směn, obsluhy a alternativních pracovišť ve SkyPlanner.
- Synchronizace výrobních příkazů a nákupních objednávek: výrobní příkazy ve stavech Released a In Process a otevřené nákupní objednávky s očekávanými daty příjmu. Synchronizaci řídí skripty User Event a pravidelné dotazování pro kontrolu shody dat.
- Zpětný zápis rozvrhu: zápis plánovaných termínů operací do výrobních příkazů a úkolů operací, s nastavením OAuth 2.0 M2M v sandboxu i v produkčním prostředí.
- Odvádění výroby z provozu: Work Order Completions, výdeje materiálu nebo Assembly Builds na základě Mobile Confirmations a časových záznamů.
- Souběžné testování se stávajícím plánem: používejte rozvrh SkyPlanner souběžně se současným postupem uvolňování do výroby a porovnejte výsledky.
- Spuštění ostrého provozu: převeďte plánování do SkyPlanner a uzamkněte pole s termíny v NetSuite.
Pokud jsou technologické postupy správně vedené a projekt zahrnuje jen jednu dceřinou společnost, jeho rozsah zůstává malý. Více dceřiných společností, zpětné odvádění s WIP a vlastní formuláře znamenají více práce při mapování.
Úskalí NetSuite
- Výrobní příkazy bez technologického postupu. Výrobní příkaz bez Manufacturing Routing nemá žádné operace, které by bylo možné rozvrhnout. Oracle uvádí totéž i u vlastního nástroje pro plánování výroby s ohledem na kapacity: „Work orders not associated with a NetSuite routing should not be scheduled.“ (Výrobní příkazy, které nejsou přiřazeny k technologickému postupu v NetSuite, by se neměly rozvrhovat.) Vyhledejte je pomocí SuiteQL před spuštěním ostrého provozu.
- Pracoviště mají jen základní údaje. Pracoviště v NetSuite je záznam Group se dvěma počty, Machine Resources a Labor Resources (oba mají výchozí hodnotu 0), a jedním Work Calendar, obvykle „Default Work Calendar“. Pracoviště načtěte jednorázově. Jednotlivá pracoviště, směny jednotlivých pracovníků, nástroje, matici přípravných časů a alternativní pracoviště pak spravujte ve SkyPlanner.
- Kvalita údajů v polích Setup Time a Run Rate. NetSuite tato pole používá při rozvrhování bez omezení kapacit. Protože ale kapacitu nezohledňuje, chybné hodnoty zůstávají bez povšimnutí. Plánování výroby, které respektuje skutečné kapacity, je odhalí hned první den.
- S WIP, nebo bez WIP. S Manufacturing WIP se výroba účtuje prostřednictvím Work Order Issue, Work Order Completion a Work Order Close. Bez WIP se používá Assembly Build. Integrace pro položky s WIP zapisuje Work Order Completions a pro ostatní Assembly Builds. Určení modelu pro každou položku je proto součástí mapování.
- Advanced Manufacturing ve stejném účtu. Pokud účet používá také Advanced Manufacturing SuiteApp, jeho záznamy Manufacturing Work Bench musí přesně odpovídat technologickému postupu: pořadím operací, názvem operace i pracovištěm. Rozhodněte, který systém určuje termíny operací. Dva rozvrhovací systémy nad stejnými výrobními příkazy znamenají dva konkurenční plány.
- Limity souběžných požadavků. Webové služby a volání RESTlet sdílejí jeden limit souběžných požadavků pro účet. Ten vychází z úrovně služby a zvyšuje se o 10 za každou licenci SuiteCloud Plus. Souběžné dotazování na jednotlivé záznamy jej rychle vyčerpá. Pro čtení používejte SuiteQL se stránkováním a zápisy řaďte do fronty.
- Obnovení sandboxu smaže nastavení M2M. Při obnovení sandboxu se vymažou mapování OAuth 2.0 Client Credentials a mezi účty se nekopírují. Prošlý nebo zneplatněný certifikát zastaví synchronizaci, dokud nevytvoříte nové mapování. Nastavte upozornění na chyby autentizace.
Integrace s NetSuite: kdo ji nastavuje a podporuje
Práce zahrnuje mapování vašich záznamů, technologických postupů a pracovišť i omezení, která NetSuite neuchovává jako data použitelná pro rozvrhování: matici přípravných časů, nástroje, počty pracovníků obsluhy a alternativní zdroje. Webhooky SkyPlanner odesílají změny rozvrhu zpět ihned, jakmile nastanou, včetně změn provedených funkcí Autopilot.
- Tým SkyPlanner integraci nastaví při zavádění a po spuštění ostrého provozu zajišťuje její podporu. Každý závod používá NetSuite jinak: s WIP nebo bez WIP, s vlastními formuláři, skripty a pravidly pro technologické postupy. Tým namapuje vaše záznamy a propojí REST API a webhooky SkyPlanner s NetSuite REST, SuiteQL a RESTlets. Podpora zahrnuje skript User Event i middleware a reaguje na změny vašeho nastavení NetSuite.
- Zapojit se může i váš partner pro NetSuite. Partneři znají vaše vlastní formuláře, skripty a role. Pracují s REST API SkyPlanner, které pokrývá zakázky, produkty, materiály, nákupní objednávky, kroky technologického postupu a časové záznamy. K dispozici je dokumentace Swagger/OpenAPI a autentizace JWT. Veřejná dokumentace: dokumentace SkyPlanner.
- Na řešení mohou navázat vaši vlastní vývojáři. Běžné rozdělení je skript User Event uvnitř NetSuite a malá služba middlewaru mimo něj. Pro začátek stačí klíč API (návod k integraci) a tým SkyPlanner podle potřeby pomůže.
Nejprve ověřte rozvrh v 30denní zkušební verzi zdarma na datech z CSV až pro 20 pracovišť, bez platební karty. Integrace pak vychází z rozvrhu, který už odpovídá potřebám závodu.
Po propojení engine Arcturus rozvrhuje výrobu podle aktuálních výrobních příkazů v NetSuite a ověřuje dostupnost materiálu ze zásob i očekávaných nákupních objednávek. Obsluha vykazuje práci pomocí Mobile Confirmations, Production Timer a Quick Log Mode a NetSuite odráží dění ve výrobním provozu bez ručního zadávání. SkyPlanner stojí od 199 € měsíčně s 5 pracovišti v ceně, s měsíční fakturací a možností předplatné kdykoli zrušit. Cenu integrace podle vašich procesů a potřeb dostanete předem spolu s cenou tarifu, takže celkové náklady znáte ještě před zahájením. Kontaktujte obchodní tým a vymezte rozsah integrace s NetSuite, nebo si prohlédněte funkce a zákazníky.
Jak SkyPlanner hodnotí výrobní firmy
2 hušetřené každý týden
„Díky SkyPlanner jsme v plánování výroby přešli od tabulek v Excelu k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista dodavatelského řetězce
UTU · Elektrické rozváděče a spínací zařízení
Plánování výroby šetří každý týden 2 hodiny pracovní doby 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 pro všechna pracoviště na tři měsíce zabere méně než 30 minut.
99,2 %včasnost dodávek
„SkyPlanner nám pomohl odhalovat úzká místa a zpřehlednil řízení výroby.“
Toni Tuori, vedoucí výroby
Piristeel · Střešní bezpečnostní prvky a okapové systémy
Včasnost dodávek letos dosáhla 99,2 % a rozvrhování výroby šetří až čtyři hodiny pracovní doby denně.
6 měsícůdopředu vidí obchodníci volnou kapacitu
„SkyPlanner je spolehlivým základem pro veškeré plánování výroby.“
Anu Järvinen, vedoucí výroby
Fredman Operations · Balicí papíry pro styk s potravinami
Obchodníci vidí volnou kapacitu na šest měsíců dopředu. Požadavky na změnu rozvrhu, na jejichž zodpovězení dříve potřebovali hodinu i více, nyní vyřídí během několika sekund.
Časté dotazy
Jak se SkyPlanner APS propojuje s NetSuite?
Obousměrně prostřednictvím NetSuite REST record API, SuiteQL a podle potřeby RESTlets. Termíny operací se zapisují pomocí PATCH do manufacturingOperationTask. Odpracovaný čas a vyrobené množství se přenášejí prostřednictvím transformace workOrderCompletion nebo assemblyBuild. Tým SkyPlanner integraci nastaví během zavádění a zajišťuje její podporu i po spuštění do ostrého provozu. Váš partner pro NetSuite nebo vlastní vývojáři ji mohou dále rozvíjet s využitím zdokumentovaného REST API.
Potřebujeme k používání SkyPlanner aplikaci Advanced Manufacturing SuiteApp?
Ne. SkyPlanner sám plánuje výrobu s ohledem na skutečné kapacity strojů a pracovníků na základě standardních záznamů Work Orders, Manufacturing Routings a Work Centers. Pokud v účtu používáte také Advanced Manufacturing, při vymezení rozsahu se určí, který systém bude nastavovat termíny operací.
Jak se zabrání duplicitnímu zaúčtování, pokud se událost odešle dvakrát?
Každý záznam Work Order Completion má jako externí ID identifikátor časového záznamu ze SkyPlanner. NetSuite zajišťuje jedinečnost externích ID v rámci každého typu záznamu, takže opakovanou událost odmítne, místo aby znovu zaúčtoval množství a náklady. Neúspěšné zápisy se zařadí do fronty, opakují a zaznamenávají do protokolu.
Můžeme místo REST a OAuth 2.0 použít TBA nebo SOAP?
U nových integrací počítejte s REST a OAuth 2.0. Oracle od verze 2027.1 neumožní vytvářet nové integrace TBA a SOAP a ve verzi 2028.2 deaktivuje všechny endpointy SOAP. Integrace SkyPlanner postavená na REST a OAuth 2.0 bude fungovat i po obou těchto změnách.
Jak se SkyPlanner dozví o nových výrobních příkazech v NetSuite?
NetSuite nemá zdokumentovaný standardní odchozí webhook. Skript User Event pro Work Order při uložení zařadí oznámení do fronty. Pravidelné dotazování přes SuiteQL zachytí změny, které skript nezaznamená, například importy CSV a hromadné aktualizace.
Můžeme SkyPlanner otestovat s daty z NetSuite ještě před vytvořením integrace?
Ano. Exportujte pracoviště, technologické postupy a otevřené výrobní příkazy do CSV, během 30denní zkušební doby je importujte do SkyPlanner a porovnejte výsledný plán výroby, který respektuje skutečné kapacity strojů a pracovníků, se svým současným plánem. Vyzkoušejte zdarma nebo si rezervujte ukázku.
Jak dlouho trvá integrace s NetSuite?
Implementace bývá dokončena během několika týdnů od zahájení zavádění, a to i ve velkých firmách. Už během zkušební doby lze rozvrhovat výrobu na základě dat z CSV. Společnost UTU dnes SkyPlanner s NetSuite používá (zkušenosti UTU).
