Integrace / ERP / Acumatica Cloud ERP
Průvodce integrací Acumatica se SkyPlanner APS pro rozvrhování výroby
Tento průvodce ukazuje partnerům a IT týmům, jak propojit Acumatica Cloud ERP (Manufacturing Edition) se SkyPlanner APS. Integrace mezi SkyPlanner a Acumatica funguje obousměrně:
- Do SkyPlanner se přenášejí výrobní příkazy včetně operací, pracoviště, stroje, nástroje, směny, skladové položky a nákupní objednávky.
- K operacím výrobního příkazu se zapisují plánované termíny zahájení a dokončení a příkaz se zafixuje.
- Časové záznamy operátorů se přenášejí zpět jako záznamy práce a přesunů.
- Webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Tým SkyPlanner během zavádění nastaví integraci podle vaší konfigurace Acumatica a zajišťuje její podporu i po spuštění ostrého provozu. Průvodce je určen partnerům a vývojářům, kteří se chtějí zapojit nebo sami vyvíjet řešení nad zdokumentovaným REST API SkyPlanner (referenční dokumentace API).
Integrační rozhraní Acumatica
Integrace využívá rozhraní, která jsou již součástí Acumatica. Do instance se nic neinstaluje.
- REST API založené na kontraktech. Endpointy jsou verzované a odpovídají příslušnému vydání. Endpoint Manufacturing (například 26.200.001 pro 2026 R2) zpřístupňuje
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryaMaterialEntry. Endpoint Default zahrnujeStockItem,PurchaseOrderaSalesOrder. URL mají tvar{instance}/entity/{Endpoint}/{version}/{Entity}. - Akce na stejném endpointu.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryaReleaseMaterialEntryspouštějí stejnou logiku jako tlačítka na obrazovkách. - OData. Přes OData lze zpřístupnit libovolný dotaz Generic Inquiry (SM208000). Nejrychlejší hromadné načtení zajistí Generic Inquiry s otevřenými výrobními operacemi a jejich termíny.
- Push notifikace (SM302000). Vycházejí z Generic Inquiry nebo z vestavěného dotazu a odesílají vložené a odstraněné řádky na vámi nastavenou URL.
- Scénáře importu a exportu s poskytovateli dat pro CSV a Excel pro hromadné načítání.
Seznam entit a akcí najdete na obrazovce Web Service Endpoints (SM207000) a v repozitáři REST klienta Acumatica.
Autentizace a limity
Acumatica používá OAuth 2.0 a OpenID Connect prostřednictvím klientských aplikací registrovaných na obrazovce Connected Applications (SM303010). Dokumentace popisuje toky Authorization Code, Implicit, Resource Owner Password Credentials a Hybrid. Pro serverovou integraci zaregistrujte samostatného integračního uživatele s rolemi omezenými na nezbytná oprávnění. Použijte Authorization Code s obnovovacím tokenem nebo Resource Owner Password Credentials.
Limity určuje vaše licence. Povolený počet požadavků API za minutu a uživatelů API najdete na obrazovce License Monitoring Console (SM604000).
Na straně SkyPlanner používá REST API k autentizaci API token (SkyPlanner Settings > API). Dokumentace je dostupná ve Swagger/OpenAPI. Prvními voláními vás provede integrační tutoriál.
Mapování dat
| Objekt Acumatica (endpoint / formulář) | Objekt SkyPlanner | Směr | Četnost |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produkty a materiály | Acumatica → SkyPlanner | Úvodní načtení, poté jen změny |
BillOfMaterial (AM208000): materiály, operace | Struktura produktu, dílčí produkty, materiály pro jednotlivé produkty | Acumatica → SkyPlanner | Úvodní načtení, poté při změně |
| Operace kusovníku: Setup, Run, Machine, Queue, Finish, Move Time | Kroky procesu s dobou trvání a časy na přípravu a ukončení operace | Acumatica → SkyPlanner | Úvodní načtení, poté při změně |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Pracoviště, skupiny pracovišť, efektivita, alternativní pracoviště | Acumatica → SkyPlanner | Úvodní načtení, poté jen výjimečně |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Směny a personální kapacita | Acumatica → SkyPlanner | Denně, nebo správa směn ve SkyPlanner |
Tool (AM205500) | Nástroje jako výrobní zdroje s omezenou kapacitou | Acumatica → SkyPlanner | Úvodní načtení |
ProductionOrder s OrderOperationDetail (Planned, Released, In Process) | Zakázky a úlohy s termíny dokončení, prioritou zpracování a potřebou materiálu | Acumatica → SkyPlanner | Push notifikace nebo dotazování každých několik minut |
Řádky PurchaseOrder (Default) | Nákupní objednávky s očekávaným datem dodání | Acumatica → SkyPlanner | Dotazování každou hodinu nebo při spuštění rozvrhování |
| Množství položek na skladech | Stavy zásob | Acumatica → SkyPlanner | Dotazování každou hodinu nebo při spuštění rozvrhování |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Plánované zahájení, dokončení a pracoviště pro každou operaci | SkyPlanner → Acumatica | Při změně rozvrhu přes webhook SkyPlanner |
Akce FirmProductionOrder | Chrání zapsané termíny před změnami ze strany Acumatica APS | SkyPlanner → Acumatica | Po každém zpětném zápisu |
LaborEntry, MoveEntry s akcemi pro uvolnění | Časové záznamy, dokončená množství, potvrzení operátorů | SkyPlanner → Acumatica | Při každém potvrzení nebo za směnu |
| Není v Acumatica | Matice přípravných časů, konkrétní operátoři, úlohy pro více operátorů | Spravováno ve SkyPlanner | Nastavení během zavádění |
Integrační postupy
1. Úvodní načtení kmenových dat. Nejprve načtěte pracoviště, stroje, nástroje, směny a kalendáře. Poté načtěte skladové položky a kusovníky. Rozhodněte, jak namapujete pracoviště s několika stroji: jako jednu skupinu pracovišť, v níž je každý stroj samostatným pracovištěm, nebo jako jediné pracoviště. Nastavení Basis for Capacity v Acumatica napoví, jaký přístup závod používá.
2. Synchronizace příkazů. Výrobní příkazy i jejich operace načítejte z příkazu, nikoli z kusovníku. Operace se kopírují do příkazu a plánovači je upravují právě tam. Pro Generic Inquiry s otevřenými příkazy a operacemi nastavte push notifikace nebo se na něj pravidelně dotazujte. Načítejte také otevřené řádky nákupních objednávek. SkyPlanner považuje objednaný materiál za dostupný k datu dodání nákupní objednávky a aktualizuje stav zásob, jakmile je objednávka označena jako Delivered.
3. Zpětný zápis rozvrhu. U každé operace, kterou plánovací algoritmus zařadil nebo přesunul, zapíše SkyPlanner do OrderOperationDetail hodnoty StartDate a EndDate. Pokud se práce přesunula na alternativní pracoviště, zapíše i toto pracoviště. Poté zavolá FirmProductionOrder. Acumatica uvádí: „When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.“ (Při spuštění plánování výrobních příkazů se zohledněním skutečné kapacity systém nepřeplánuje zafixované výrobní příkazy.) (zdroj)
4. Potvrzování práce ve výrobním provozu. Operátoři zaznamenávají práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer. Z časových záznamů vznikají doklady LaborEntry (čas a dokončené množství za operaci) nebo MoveEntry (pouze množství), které se uvolňují příslušnou akcí. Pokud již výroba vykazuje práci v Acumatica přes Labor (AM301000) nebo Shop Floor Kiosk, údaje o průběhu výroby se přenášejí opačným směrem. Zvolte jeden kanál, nikdy ne oba.
5. Odpovědnost za data a pravidla pro řešení konfliktů. Před spuštěním ostrého provozu je písemně stanovte:
| Data | Odpovědný systém |
|---|---|
| Skladové položky, kusovníky, množství, stav příkazů, kalkulace nákladů | Acumatica |
| Pořadí operací, časy zahájení a dokončení, přiřazení pracovišť | SkyPlanner |
| Matice přípravných časů, nástroje, požadavky na operátory, alternativy | SkyPlanner |
| Směny a absence | Jeden systém zvolený při vymezení rozsahu |
| Transakce odvedené práce a přesunů | Acumatica; transakce se zapisují z časových záznamů SkyPlanner nebo se zadávají ve výrobním provozu |
Hlavním zdrojem konfliktů je vlastní APS systému Acumatica. Rough Cut Planning nebo APS Maintenance Process mohou přepočítat termíny příkazů, které rozvrhl SkyPlanner. Tomu zabráníte zafixováním každého zapsaného příkazu. Rozvržené příkazy také vylučte z běhů APS.
Typický postup projektu
Implementace je obvykle dokončena během několika týdnů od zahájení nasazování. Ještě předtím si můžete systém po dobu 30 dnů zdarma vyzkoušet na vlastních datech. Z Generic Inquiry exportujte do Excelu pracoviště a otevřené výrobní příkazy včetně operací, importujte je a ověřte rozvrh.
- Mapování. Stanovte mapovací tabulku, pravidla pro vlastnictví dat, frekvenci synchronizace a způsob zápisu odvedené práce.
- Přístup. Zaregistrujte připojenou aplikaci, vytvořte integračního uživatele a role a ověřte verzi koncového bodu na obrazovce Web Service Endpoints. Začněte v testovacím prostředí.
- Úvodní načtení. Pracoviště, stroje, nástroje, směny, skladové položky a kusovníky.
- Synchronizace příkazů a objednávek. Výrobní příkazy, operace a nákupní objednávky prostřednictvím push notifikací nebo pravidelného dotazování.
- Nastavení omezení ve SkyPlanner. Matice přípravných časů, konkrétní operátoři, úkoly pro více operátorů a alternativy.
- Zpětný zápis. Termíny operací, fixace příkazů a záznamy odvedené práce nebo přesunů.
- Souběžný provoz. Porovnejte termíny ze SkyPlanner se stávajícím plánem a opravte kmenová data.
- Spuštění ostrého provozu. Jakmile data souhlasí, zapněte zpětný zápis.
S čím počítat při integraci s Acumatica
- Ověřte, který modul APS je zapnutý. Classic a Optimized ukládají nastavení odděleně a zapnutý může být pouze jeden z nich. Před prvním zpětným zápisem zkontrolujte Enable/Disable Features (CS100000).
- Zafixujte verzi koncového bodu. Verze je součástí URL. Upgrade systému přidává novou verzi, proto při každém upgradu integraci znovu otestujte.
- Aktualizace operací. Některá pole operací jsou přes REST dostupná pouze pro čtení a záleží také na stavu příkazu. V testovacím prostředí ověřte posloupnost zpětného zápisu u příkazů ve stavech Released a In Process.
- Jednotky a časová pole. Výrobní čas se vztahuje k Run Units, strojní čas k Machine Units. Časy čekání a přesunu „affect the calculated schedule but do not occupy work center capacity.“ (ovlivňují vypočtený rozvrh, ale nezabírají kapacitu pracoviště). Při importu pečlivě ohlídejte převody.
- Vyhodnocení dostupnosti materiálu. Classic APS vyžaduje dostupnost veškerého materiálu v plném množství. SkyPlanner plánuje podle skladových zásob a očekávaných dodávek z nákupních objednávek s ohledem na jejich termíny. Dohodněte se, podle kterého výsledku se plánovači budou řídit.
- Limity API. Počet požadavků za minutu závisí na licenci. Používejte načítání změn a push notifikace, nikoli opakované načítání všech dat.
Kdo nastavuje integraci s Acumatica a zajišťuje podporu
- Tým SkyPlanner integraci nastaví během nasazování a po spuštění ostrého provozu zajišťuje podporu. Každý závod používá Acumatica jinak a právě při nastavení se tyto znalosti uplatní.
- Zapojit se může i váš partner pro Acumatica. Zná vaše úpravy, Generic Inquiries a role. SkyPlanner poskytuje REST API, dokumentaci Swagger/OpenAPI a webhooky.
- Integraci mohou vyvíjet i vaši vlastní vývojáři pomocí stejného REST API s tokenem API. Pro začátek stačí token API a tým SkyPlanner v případě potřeby pomůže. Touto cestou se při propojení se SAP Business One vydala společnost Laboratory & Allied: její interní IT tým vytvořil integraci převážně vlastními silami, s pomocí SkyPlanner.
Cena SkyPlanner začíná na 199 € měsíčně a zahrnuje 5 pracovišť s měsíční fakturací. Cenu integrace podle vašich procesů a potřeb dostanete předem společně s cenou tarifu, takže celkové náklady znáte ještě před zahájením. Srovnání s vlastním APS systému Acumatica najdete na stránce Plánování výroby v Acumatica s ohledem na skutečné kapacity, přehled na stránce Acumatica a další systémy v přehledu integrací s ERP.
Jak SkyPlanner hodnotí výrobní firmy
2 húspory každý týden
„Díky SkyPlanner jsme v plánování výroby přešli od excelových tabulek 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 úkolů se na linku dostane během několika sekund.
+90 %efektivity 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 a víceautomaticky rozvržený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 rozvrhují automaticky a celá firma má přehled o výrobě v reálném čase.
99,2 %včasnost dodávek
„SkyPlanner nám umožnil lépe 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í šetří až čtyři hodiny pracovní doby denně.
Časté dotazy
Zpřístupňuje API systému Acumatica výrobní příkazy?
Ano. Koncový bod Manufacturing v REST API založeném na kontraktech zpřístupňuje ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool a záznamy odvedené práce a přesunů, stejně jako akce typu FirmProductionOrder.
Kdo vytváří integraci s Acumatica?
Tým SkyPlanner během nasazování nastaví obousměrnou integraci podle vaší konfigurace Acumatica a po spuštění ostrého provozu zajišťuje podporu. Integraci může vyvíjet také váš partner pro Acumatica nebo vaši vlastní vývojáři pomocí zdokumentovaného REST API systému SkyPlanner. Pro začátek stačí token API.
Potřebujeme pro tuto integraci Acumatica APS?
Ne. Acumatica provádí vlastní plánování s ohledem na skutečné kapacity prostřednictvím formuláře Rough Cut Planning, zatímco Classic APS plánuje příkazy s dokončením za více než 120 dní s neomezenou kapacitou (zdroj). SkyPlanner sám sestavuje podrobný rozvrh respektující skutečné kapacity z výrobních příkazů, operací, pracovišť, strojů a nástrojů. Integrace tedy funguje bez ohledu na to, zda je zapnuté APS, které podle Acumatica „is subject to licensing“ (podléhá licenci). Autopilot udržuje rozvrh aktuální a operátoři zaznamenávají práci pomocí Mobile Confirmations.
Jak zabráníme tomu, aby Acumatica APS přepisoval termíny ze SkyPlanner?
SkyPlanner po zápisu termínů operací každý výrobní příkaz zafixuje. Plánování výroby s ohledem na skutečné kapacity v Acumatica zafixované příkazy nepřeplánovává.
Může Acumatica odesílat změny v reálném čase?
Ano. Push notifications (SM302000) nastavené pro Generic Inquiry odesílají změněné řádky na URL ihned při změně. Vlastní webhooky systému SkyPlanner odesílají změny rozvrhu opačným směrem.
Jaké ověřování má integrace používat?
OAuth 2.0 prostřednictvím klienta zaregistrovaného v Connected Applications (SM303010), s vyhrazeným integračním uživatelem a rolemi s minimálními potřebnými oprávněními. Konkrétní postup ověřování pro vaši instanci potvrdíme při vymezení rozsahu.
Můžeme SkyPlanner vyzkoušet ještě před vytvořením integrace?
Ano. Během 30denní bezplatné zkušební doby můžete využít až 20 pracovišť a importovat data z Acumatica Generic Inquiry ve formátu Excel nebo CSV. Platební kartu nepotřebujete. Vyzkoušejte zdarma nebo kontaktujte obchodní tým a vymezte rozsah integrace.
