Průvodce integrací Business Central pro rozvrhování výroby ve SkyPlanner APS

Integrace využívá dvě rozhraní, která jsou již součástí Business Central:

1. API v2.0 pro obchodní a skladová data. Zpřístupňuje items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers a employees. Neobsahuje výrobní entity, proto se výrobní data přenášejí přes druhé rozhraní.
2. Webové služby OData v4 pro výrobu. Libovolnou stránku Business Central lze na stránce Web Services publikovat jako webovou službu OData v4. Zvolte typ objektu Page, ID stránky a název služby a poté zaškrtněte Published. Koncový bod je tím dostupný, bez kódu AL a bez nasazování rozšíření. Integrace publikuje standardní stránky pro vydané výrobní zakázky, Prod. Order Routing Lines, pracoviště, strojní centra a technologické postupy. Jsou dostupné na adrese /ODataV4/Company('{name}')/{ServiceName}.

Publikované stránky umožňují čtení i zápis. Microsoft uvádí: „If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,“ (Pokud je upravitelná stránka zpřístupněna jako webová služba, lze k datům v podkladové tabulce přistupovat a upravovat je voláním OData.) Pro aktualizace se používá PATCH. Takto se plánované termíny zapisují zpět do Business Central, přes stejnou stránku a se stejným ověřováním, jaké používá plánovač.

SOAP nepoužívejte. Microsoft označil webové služby SOAP za zastaralé a v 2026 release wave 2 (v29) odstraňuje možnost publikovat stránky uživatelského rozhraní Microsoft jako SOAP.

Business Central podporuje odběry webhooků přes POST /api/v2.0/subscriptions pro entity API v2.0, jako jsou items a salesOrders. Platí tato pravidla:

• Vytvoření odběru vyžaduje ověřovací handshake: váš koncový bod musí vrátit validationToken se stavem 200 OK.
• Platnost odběrů vyprší po třech dnech. Obnovte je pomocí PATCH; znovu přitom proběhne handshake.
• Oznámení obsahují cestu k prostředku, changeType a váš clientState, nikoli celý záznam. Ten načtete následně.
• Oznámení se odesílají se zpožděním: Business Central online čeká 30 sekund od první změny. Pokud se v tomto intervalu změní více než 1 000 záznamů, přijde jediné oznámení typu collection.
• V online prostředí je povoleno nejvýše 200 odběrů webhooků na prostředí.

Výrobní zakázky, řádky technologických postupů a nákupní objednávky se načítají dotazováním každých několik minut z publikovaných stránek a z purchaseOrders. Filtrování pouze na otevřené zakázky a objednávky spolu se stránkováním udržuje počet požadavků bezpečně pod limity Business Central.

SkyPlanner odesílá webhooky při změně stavu nebo rozvrhu, takže zpětný zápis je řízen událostmi.

1. Prvotní načtení kmenových dat. Z publikovaných stránek načtěte technologické postupy a výrobní kusovníky ve stavu Certified, pracovní a strojní centra. Z API v2.0 načtěte položky a měrné jednotky. Mapování každého pracovního nebo strojního centra na pracoviště ve SkyPlanner si promyslete: rozhodněte, zda z pracovního centra se třemi strojními centry vznikne jedna skupina pracovišť, nebo tři pracoviště.

2. Synchronizace zakázek. Z publikovaných stránek načítejte výrobní zakázky ve stavu Released (a také Firm Planned, pokud je rozvrhujete) včetně řádků technologického postupu a komponent. Z API v2.0 načítejte 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 zásoby, jakmile je objednávka označena jako Delivered. Rozvrh tak zohledňuje jak skladové zásoby, tak očekávané nákupy.

Výrobní zakázky ve stavu Planned nikdy nerozvrhujte. Microsoft o nich uvádí, že je Business Central odstraní: „deletes them the next time you run planning.“ (odstraní je při příštím spuštění plánování.) Planning Worksheet nadále navrhuje doplnění zásob a SkyPlanner rozvrhuje potvrzené zakázky podle skutečné kapacity.

3. Zpětný zápis rozvrhu. Standardní stránka Prod. Order Routing se publikuje jako webová služba OData v4. Pro každou operaci, kterou plánovací jádro zařadilo nebo přesunulo, odešle SkyPlanner požadavek PATCH na příslušný řádek technologického postupu s ETag v hlavičce If-Match. Nastaví pole Starting Date-Time a Ending Date-Time, a pokud byla operace přesunuta na alternativní stroj, také Type a No.

PATCH spouští triggery stránky a tabulky, takže Business Central ověřuje pole vlastní logikou, přesně jako při úpravách plánovačem na stránce Prod. Order Routing. Následně se aktualizují pole Starting Date-Time a Ending Date-Time na řádku výrobní zakázky. Množství, stav a náklady zůstávají v Business Central.

4. Odvádění výroby. Obsluha zaznamenává práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer. Tyto časové záznamy udržují rozvrh aktuální. Výrobu lze v Business Central vykazovat stejně jako dosud prostřednictvím Production Journal nebo Output Journal.

Pokud chcete výrobu a spotřebu účtovat plně automaticky, přidá se standardní stránka API Business Central pro účtování deníku výroby. SkyPlanner pak pro každou operaci účtuje čas seřízení, čas zpracování a vyrobené množství. Účtování aktualizuje Capacity Ledger Entries a odvedení výroby na poslední operaci technologického postupu přidá položku do zásob.

Pro účtování výroby zvolte jediný kanál. Účtování ze SkyPlanner i z Production Journal v Business Central vede k duplicitním záznamům.

5. Odpovědnost za data a pravidla řešení konfliktů. Před spuštěním ostrého provozu je písemně stanovte:

Hlavním zdrojem konfliktů jsou akce Refresh a Replan u výrobních zakázek. Microsoft uvádí: „If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.“ (Pokud použijete akci Refresh k přepočtu řádků výrobní zakázky, Business Central odstraní stávající řádky a vypočítá nové.) Replan může změnit i potřebu kapacity a přepočet komponent „deletes previous changes in the components.“ (odstraní předchozí změny v komponentách.)

Se zakázkou po akci Refresh zacházejte jako s novou verzí, znovu ji synchronizujte a nechte SkyPlanner přepočítat rozvrh. S funkcí Autopilot SkyPlanner při změnách ve výrobě přepočítává rozvrh automaticky.

• Jednotky v technologických postupech. Setup Time se vztahuje na výrobní zakázku, Run Time na vyrobený kus a každý z těchto časů má vlastní Unit of Measure Code. Wait Time a Move Time nespotřebovávají kapacitu pracoviště. Pokud je jednotkou pracoviště Days, jeden den znamená 24 hodin, nikoli osmihodinovou směnu. Při importu proveďte převod, jinak budou všechny doby trvání chybné.
• Neaktuální kalendáře. Kapacita je k dispozici až po spuštění Calculate Work Center Calendar pro daný horizont. Před prvotním načtením zkontrolujte pole Calendar Entries Available Until.
• Skrytá kapacita strojních center. Pokud je Consolidated Calendar vypnutý, plánuje se pouze vlastní kapacita pracovního centra: „The machine center capacity is excluded.“ (Kapacita strojního centra není zahrnuta.) Načítejte kapacitu strojních center přímo, místo abyste spoléhali na součty za pracovní centra.
• Capacity a Efficiency. Business Central počítá dobu trvání jako Run Time / Efficiency / Capacity a vypočtené položky kalendáře již oba parametry zohledňují. Při mapování Efficiency na efektivitu pracoviště ve SkyPlanner ji započítejte jednou, nikoli dvakrát.
• Alternate Work Center má pouze informativní význam. Microsoft k němu uvádí: „isn’t automatically included in planning processes.“ (není automaticky zahrnuto do plánovacích procesů.) Alternativy výslovně nastavte jako alternativní pracoviště ve SkyPlanner.
• Omezování požadavků. Limity v online prostředí platí pro každého uživatele zvlášť a instanční objekt se počítá jako jeden uživatel: 6 000 požadavků OData v klouzavém intervalu 5 minut a 5 souběžných požadavků. Velikost stránky je omezena na 20 000 záznamů, $batch na 100 operací a časový limit operace je 8 minut. Při překročení limitu počtu požadavků se vrací stav 429. Místo opakovaného úplného načítání používejte dávky, stránkování a dotazování pouze na změny.
• Licence. Výrobní funkce jsou k dispozici pouze v režimu Premium. Uživatelé s licencí Essentials se nemohou přihlásit do společnosti nastavené na Premium.