Průvodce integrací Sage 100 pro plánování výroby se SkyPlanner APS
Tento průvodce integrací Sage 100 ukazuje partnerům Sage a IT týmům, jak propojit Sage 100 se SkyPlanner APS. Věnuje se oběma produktům tohoto názvu: Sage 100 v USA a Kanadě s modulem Production Management a Sage 100 v Německu a Rakousku s modulem Sage 100 Produktion. Integrace SkyPlanner se Sage 100 funguje obousměrně:
- Do SkyPlanner se načítají výrobní příkazy (Work tickets nebo Fertigungsaufträge) včetně operací (steps nebo Arbeitsgänge), dále pracoviště, položky, skladové zásoby a nákupní objednávky.
- Plánované termíny se zapisují zpět ke každé operaci (step nebo Arbeitsgang).
- Časové záznamy obsluhy se zapisují zpět jako výkazy práce (US) nebo Rückmeldungen (DE).
Tým SkyPlanner při zavádění nastaví integraci podle vaší instalace Sage 100 a po spuštění ostrého provozu zajišťuje její podporu. Tento průvodce je určen partnerům a vývojářům, kteří se chtějí do integrace zapojit nebo sami využít zdokumentované REST API SkyPlanner (referenční dokumentace API).
Americký Sage 100: integrační rozhraní
Americký Sage 100 běží v místní infrastruktuře v edicích Standard, Advanced nebo Premium. Jeho integrační rozhraní jsou umístěna na serveru Sage 100.
Business Object Interface (BOI).
„The Business Objects Interface allows third-party developers with the necessary skills to access Sage 100 programs and applications using Component Object Model (COM).“ (Rozhraní Business Objects Interface umožňuje vývojářům třetích stran s potřebnými znalostmi přistupovat k programům a aplikacím tohoto systému pomocí Component Object Model (COM).) (Nápověda Sage 100) Vývojářský portál Sage jej popisuje jako „Sage 100’s internal API layer, giving you access to the same logic used by the application itself.“ (Interní vrstva API systému, která zpřístupňuje stejnou logiku, jakou používá samotná aplikace.) (developer.sage.com) BOI slouží k zápisu: každé vytvoření nebo aktualizace záznamu prochází stejnými kontrolami jako při práci uživatele v Sage 100.
ODBC.
Ovladač ProvideX ODBC čte tabulky Sage 100 pro účely reportingu a hromadného načítání dat. Pro edici Advanced je k dispozici ovladač ODBC typu klient/server. Integrace používá ODBC k hromadnému načítání výrobních příkazů, položek a nákupních objednávek, zatímco k zápisu používá BOI.
Visual Integrator (VI).
Importní a exportní úlohy VI přenášejí data mezi Sage 100 a soubory nebo zdroji ODBC. Sage uvádí: „One of the most powerful features of the Visual Integrator module is its ability to directly import data from and export data to an ODBC data source.“ (Jednou z nejvýkonnějších funkcí modulu Visual Integrator je možnost přímo importovat data ze zdroje ODBC a exportovat je do něj.) (zdroj) VI je součástí balíčku Essentials a hodí se pro výměnu dat prostřednictvím souborů.
eBusiness Web Services používá SOAP a pokrývá „the Sage 100 sales order, customer, and customer contact entities.“ (Entity prodejních objednávek, zákazníků a zákaznických kontaktů v tomto systému.) (zdroj) Může přenášet prodejní objednávky, zatímco výrobní data se přenášejí přes BOI a ODBC.
Integrace běží spolu se Sage 100 pod uživatelským účtem Sage 100 s oprávněními k úlohám, které využívá v modulech Production Management, Inventory a Purchase Order. Odchozí komunikace směřuje na REST API SkyPlanner přes HTTPS.
Německý Sage 100: integrační rozhraní
Německý Sage 100 běží na Microsoft SQL Server v místní instalaci nebo v cloudové variantě. Sage uvádí, že jej lze „doplnit o partnerská řešení prostřednictvím rozhraní API“ (Sage 100). Doplňky pro výrobu uvedené v nabídce Sage staví na Sage AppDesigner a business objektech Sage 100.
Integrace využívá stejný postup jako partnerská řešení Sage: z databáze Sage 100 na SQL Server načítá Fertigungsaufträge, Arbeitsgänge, Arbeitsplätze, Ressourcenlisten, Artikel a Bestellungen. Termíny Arbeitsgang a hlášení Rückmeldungen se zapisují zpět způsobem, který váš partner Sage a tým SkyPlanner dohodnou při vymezení rozsahu, aby zápisy respektovaly vlastní logiku Sage 100. Váš partner Sage potvrdí verzi (například 9.0) a nastavení přístupu.
Ověřování a přístup
| Strana integrace | Způsob ověřování |
|---|---|
| Americký Sage 100, BOI | Uživatelská relace Sage 100 na serveru Sage 100 s oprávněními role ke každé využívané úloze |
| Americký Sage 100, ODBC | DSN v instalaci Sage 100, přístup pro čtení |
| Německý Sage 100 | Uživatelský účet Sage 100 pro zpětný zápis a přístup pro čtení z databáze na SQL Server podle dohody s vaším partnerem Sage |
| SkyPlanner | API token v hlavičce Authorization-Token, vytvořený ve SkyPlanner v nabídce Nastavení > API |
REST API SkyPlanner je zdokumentováno ve Swagger/OpenAPI. Prvními voláními vás provede návod k integraci.
Zjišťování změn
Změny v Sage 100 se zjišťují pravidelným načítáním dat. Otevřené výrobní příkazy (Work tickets nebo Fertigungsaufträge) načítejte v krátkých intervalech, skladové zásoby a nákupní objednávky každou hodinu. Filtrujte podle stavu a data změny, aby se při každém načtení přenášely pouze změněné záznamy.
SkyPlanner při změně plánu odesílá webhooky, takže zpětný zápis do Sage 100 se spouští na základě událostí.
Mapování dat
| Sage 100 (US) | Sage 100 (DE) | Objekt ve SkyPlanner | Směr | Četnost |
|---|---|---|---|---|
| Item | Artikel | Výrobky a materiály | Sage 100 → SkyPlanner | Úvodní načtení, poté denně |
| Bill of Materials, materiály šablony | Stückliste v Ressourcenliste | Struktura výrobku, dílčí výrobky, materiály pro jednotlivé výrobky | Sage 100 → SkyPlanner | Při změně |
| Work center: pracovníci nebo stroje, pracovní doba podle dnů v týdnu, odstávky | Arbeitsplatz, Ressource (Mitarbeiter, Maschine) | Pracoviště, skupiny pracovišť, pracovníci, směny | Sage 100 → SkyPlanner | Úvodní načtení |
| Operace šablony výrobního příkazu, kódy činností | Arbeitsplan, Arbeitsgänge s časy seřízení a časy na kus (Rüst- a Stückzeiten) | Operace s časy seřízení a zpracování | Sage 100 → SkyPlanner | Při změně |
| Výrobní příkaz s operacemi a termínem dokončení | Fertigungsauftrag s Arbeitsgänge, Liefertermin | Zakázky a operace s termíny dokončení | Sage 100 → SkyPlanner | Načítání v krátkých intervalech |
| Množství zásob podle skladů | Lagerbestand | Skladové zůstatky | Sage 100 → SkyPlanner | Každou hodinu |
| Řádky nákupních objednávek, požadované termíny | Bestellungen, Liefertermine | Nákupní objednávky s očekávaným datem dodání | Sage 100 → SkyPlanner | Každou hodinu |
| Řádky prodejních objednávek, přislíbené termíny | Kundenaufträge | Termíny dodání zákazníkům, priorita zákazníka | Sage 100 → SkyPlanner | Načítání v krátkých intervalech |
| Termíny operací výrobního příkazu (BOI) | Arbeitsgang-Termine | Plánovaný začátek, konec a pracoviště pro každou operaci | SkyPlanner → Sage 100 | Při změně, přes webhook |
| Labor Entry, dokončení výrobního příkazu (BOI) | Rückmeldung: časy, množství | Časové záznamy a potvrzení obsluhy | SkyPlanner → Sage 100 | Při každém potvrzení nebo za směnu |
| Neeviduje se v Sage 100 | Neeviduje se v Sage 100 | Matice časů seřízení, nástroje jako kapacitně omezené zdroje, obsluha jednotlivých operací, alternativní pracoviště | Spravuje se ve SkyPlanner | Při zavádění |
Integrační postupy
1. Úvodní načtení kmenových dat. Nejprve načtěte položky a pracoviště, poté šablony nebo Arbeitspläne s jejich operacemi. Z amerického Work center se třemi stroji a dvěma pracovníky obsluhy vzniknou ve SkyPlanner tři pracoviště, skupina pracovišť a dva pracovníci. Každý zdroj pak dostane vlastní časovou osu.
2. Synchronizace zakázek. Načítejte otevřené výrobní příkazy (Work tickets nebo Fertigungsaufträge) s jejich operacemi, skladové zásoby a otevřené nákupní objednávky. Než SkyPlanner zařadí operaci do plánu, zkontroluje zásoby i očekávané dodávky. Sage 100 nadále navrhuje výrobní příkazy a SkyPlanner plánuje zakázky, které uvolníte.
3. Zpětný zápis plánu. U každé operace, kterou plánovací algoritmus zařadil nebo přesunul, odesílá SkyPlanner plánovaný začátek, konec a pracoviště. V americkém Sage 100 integrace aktualizuje termíny operací výrobního příkazu přes BOI. V německém Sage 100 aktualizuje termíny Arbeitsgang způsobem dohodnutým při vymezení rozsahu. Množství, alokace a kalkulace nákladů zůstávají v Sage 100.
4. Odvádění výroby. Obsluha vykazuje práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer a záznamy času udržují plán aktuální. V americkém Sage 100 se vykázaný čas zapisuje jako Labor Entry k operaci výrobního příkazu a závěrečné potvrzení příkaz dokončí. V německém Sage 100 vzniká Rückmeldung s časy a množstvími. Pokud už váš závod vykazuje čas v Betriebsdatenerfassung nebo v aplikaci pro čárové kódy, zvolte jeden způsob vykazování.
5. Pravidla pro správu dat a řešení konfliktů. Sepište je před spuštěním ostrého provozu:
| Data | Spravuje |
|---|---|
| Položky, kusovníky, šablony, množství zakázek, náklady | Sage 100 |
| Pořadí operací, časy zahájení a ukončení, přiřazení pracoviště | SkyPlanner |
| Matice seřizovacích časů, nástroje, obsluha pro jednotlivé operace, alternativní zdroje | SkyPlanner |
| Vykázaná práce a Rückmeldungen | Sage 100 na základě záznamů času ze SkyPlanner |
Hlavním zdrojem konfliktů je souběžné používání druhého plánovacího nástroje. Pokud plánovači dál spouštějí Enhanced Scheduling v americkém Sage 100 nebo přesouvají úlohy na Plantafel v německém Sage 100, spravují termíny dva systémy. Nechte termíny operací spravovat SkyPlanner. S funkcí Autopilot SkyPlanner při změnách ve výrobě automaticky přeplánuje výrobu.
Typický průběh projektu
Implementace bývá dokončena během několika týdnů od zahájení zavádění. Ještě předtím si ověřte plán v bezplatné 30denní zkušební verzi pomocí exportu otevřených výrobních příkazů nebo Fertigungsaufträge do CSV či Excelu. Projekt pak probíhá takto:
- Vymezení rozsahu. Potvrďte produkt (americký nebo německý Sage 100), verzi a instalaci, způsob čtení a zápisu, frekvenci synchronizace a způsob vykazování času.
- Přístupy. Váš partner Sage nastaví uživatele v Sage 100, jeho oprávnění a přístup k databázi.
- Počáteční načtení dat. Položky, pracoviště, šablony nebo Arbeitspläne, kusovníky a směny.
- Synchronizace zakázek. Pravidelné načítání výrobních příkazů nebo Fertigungsaufträge, nákupních objednávek a skladových zásob.
- Nastavení omezení ve SkyPlanner. Matice seřizovacích časů, nástroje, počty pracovníků obsluhy pro jednotlivé operace a alternativní stroje nebo pracovníci.
- Zpětný zápis plánu. Zápis plánovaných termínů operací do Sage 100, následně vykázané práce a Rückmeldungen.
- Souběžné testování a spuštění ostrého provozu. Porovnejte termíny se stávajícím plánem, opravte kmenová data a poté zapněte zpětný zápis.
S čím počítat při integraci se Sage 100
- Ujasněte si, který Sage 100 používáte. Americký a německý Sage 100 mají odlišné datové modely i rozhraní. Produkt a verzi uveďte už při prvním hovoru k vymezení rozsahu.
- Pracoviště zahrnující více strojů. V americké verzi představuje pracoviště jednu kapacitní jednotku tvořenou „one or more persons or machines“ (jednou či více osobami nebo stroji). U každého pracoviště rozhodněte, zda se ve SkyPlanner převede na jedno pracoviště, několik pracovišť nebo skupinu.
- Seřizovací a výrobní časy. Šablony a Arbeitspläne obsahují časy, se kterými SkyPlanner plánuje. Před spuštěním ostrého provozu je porovnejte se skutečnými časy ve výrobě.
- Kalendáře. Pracoviště v americké verzi obsahují pracovní dobu pro jednotlivé dny v týdnu a odstávky. Načtěte je jako směny do SkyPlanner a poté ve SkyPlanner doplňte směny a absence jednotlivých pracovníků obsluhy.
- Měrné jednotky. Operace mohou být definovány na kus, dávku nebo hodinu. Namapujte jednotku u každé operace.
- Oprávnění BOI. BOI respektuje zabezpečení podle rolí v Sage 100. Chybějící oprávnění k úloze zabrání zápisu. Otestujte každý zápis pod integračním uživatelem.
- Termíny spravuje jen jeden systém. Jakmile termíny převezme SkyPlanner, vypněte souběžné plánování a přestaňte přesouvat úlohy na Plantafel.
Integrace se Sage 100: kdo ji nastavuje a zajišťuje podporu
- Tým SkyPlanner integraci nastaví během zavádění a po spuštění ostrého provozu zajišťuje podporu.
- Zapojit se může i váš partner Sage. Zná vaši verzi Sage 100, nastaví uživatele a oprávnění a ověří přístup k databázi.
- Integraci mohou dále rozvíjet i vaši vývojáři pomocí zdokumentovaného REST API SkyPlanner. Pro začátek stačí token API a tým SkyPlanner v případě potřeby pomůže.
Po propojení plánovací jádro Arcturus vytváří plán z aktuálních zakázek v Sage 100 a plánované termíny se zapisují ke každé operaci. SkyPlanner stojí od 199 € měsíčně včetně 5 pracovišť, s měsíční fakturací. Cenu integrace stanovíme předem podle vašich procesů a potřeb společně s cenou tarifu, takže celkové náklady znáte ještě před zahájením. Podívejte se na ceník, funkce a srovnání s vlastním plánováním Sage 100 v článku Kapacitní plánování v Sage 100. Přehled najdete na stránce Sage 100. Samostatné průvodce pro Sage 200 a Sage X3 najdete na stránkách Sage 200 a Sage X3, další systémy ERP pak v přehledu integrací s ERP.
Jak SkyPlanner hodnotí výrobní firmy
6 měsícůdopředu vidí obchodní tým volnou kapacitu
„SkyPlanner poskytuje spolehlivý základ pro veškeré plánování výroby.“
Anu Järvinen, vedoucí výroby
Fredman Operations · Balicí papíry pro styk s potravinami
Obchodní tým vidí volnou kapacitu šest měsíců dopředu. Na požadavky na změnu plánu, jejichž vyřízení dříve trvalo hodinu i déle, nyní odpovídají během sekund.
100%včasnost dodávek od roku 2021
„SkyPlanner nám dává přehled o kapacitách a umožňuje předvídatelné plánování.“
Dan Berglund, COO/CFO
Opes Corporation · Chemická a potravinářská výroba
Po celou dobu používání SkyPlanner, tedy od roku 2021, dosahuje včasnost dodávek 100 %.
Časté dotazy
Má Sage 100 REST API pro výrobní příkazy?
Americký Sage 100 zpřístupňuje svou obchodní logiku přes Business Object Interface, pro čtení používá ODBC a pro souborové úlohy Visual Integrator. SkyPlanner načítá výrobní příkazy přes ODBC a BOI a přes BOI zapisuje termíny operací a vykázanou práci. Data z německého Sage 100 se čtou z jeho databáze SQL Server. Způsob zpětného zápisu se stanoví s vaším partnerem Sage při vymezení rozsahu.
Kdo vytvoří integraci se Sage 100?
Tým SkyPlanner během zavádění nastaví obousměrnou integraci podle vaší konfigurace Sage 100 a po spuštění ostrého provozu zajišťuje podporu. Váš partner Sage nastaví uživatele, oprávnění a přístup k databázi a může se do projektu zapojit. Na zdokumentovaném REST API SkyPlanner mohou stavět i vaši vývojáři. Pro začátek stačí token API.
Jak se plánované termíny zapisují zpět do Sage 100?
V americkém Sage 100 integrace přes BOI aktualizuje plánované termíny každé operace výrobního příkazu a na základě časových záznamů obsluhy zaúčtovává Labor Entry. V německém Sage 100 aktualizuje termíny Arbeitsgang u každého Fertigungsauftrag a zapisuje Rückmeldungen způsobem, který váš partner Sage a tým SkyPlanner stanoví při vymezení rozsahu.
Může Sage 100 odesílat změny v reálném čase?
SkyPlanner načítá změny ze Sage 100 v pravidelných intervalech: otevřené zakázky v krátkém cyklu, skladové zásoby a nákupní objednávky každou hodinu. Opačným směrem odesílají webhooky SkyPlanner změny plánu ihned, jakmile nastanou.
Můžeme SkyPlanner otestovat ještě před vytvořením integrace?
Ano. Bezplatná 30denní zkušební verze podporuje až 20 pracovišť a import výrobních příkazů nebo Fertigungsaufträge z CSV či Excelu. Platební karta není potřeba. Vyzkoušejte SkyPlanner nebo kontaktujte obchodní tým a vymezte rozsah integrace.
