Sprievodca integráciou Business Central na rozvrhovanie výroby so SkyPlanner APS

Integrácia využíva dve rozhrania, ktoré sú už súčasťou Business Central:

1. API v2.0 pre obchodné a skladové údaje. Sprístupňuje items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers a employees. Neobsahuje entity pre výrobu, preto sa výrobné údaje prenášajú cez druhé rozhranie.
2. Webové služby OData v4 pre výrobu. Ľubovoľnú stránku v Business Central možno publikovať ako webovú službu OData v4 na stránke Web Services. Vyberte typ objektu Page, ID stránky a názov služby a potom označte Published. Koncový bod je tým sprístupnený bez kódu AL a bez nasadzovania rozšírenia. Integrácia publikuje štandardné stránky pre uvoľnené výrobné zákazky, Prod. Order Routing Lines, pracoviská, strojové centrá a technologické postupy. Sú dostupné na adrese /ODataV4/Company('{name}')/{ServiceName}.

Publikované stránky umožňujú čítanie aj zápis. Microsoft uvádza: „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,“ (Ak je upraviteľná stránka sprístupnená ako webová služba, dáta v príslušnej tabuľke možno čítať a meniť volaním OData.) Na aktualizácie sa používa PATCH. Takto sa plánované termíny zapisujú späť do Business Central, cez tú istú stránku a s rovnakým overovaním, aké využíva plánovač.

SOAP nepoužívajte. Microsoft označil webové služby SOAP za zastarané a v 2026 release wave 2 (v29) odstraňuje možnosť publikovať stránky používateľského rozhrania Microsoft ako SOAP.

Business Central podporuje odbery webhookov cez POST /api/v2.0/subscriptions pre entity API v2.0, napríklad items a salesOrders. Platia tieto pravidlá:

• Vytvorenie odberu vyžaduje overovací handshake: váš koncový bod musí vrátiť validationToken so stavom 200 OK.
• Platnosť odberov uplynie po troch dňoch. Obnovte ich pomocou PATCH; overenie spojenia sa pritom zopakuje.
• Oznámenia obsahujú cestu k zdroju, changeType a váš clientState, nie celý záznam. Samotný záznam načítate následne.
• Oznámenia prichádzajú s oneskorením: Business Central online čaká 30 sekúnd od prvej zmeny. Ak sa v tomto intervale zmení viac než 1 000 záznamov, príde jedno oznámenie typu collection.
• V online verzii je povolených najviac 200 odberov webhookov na prostredie.

Výrobné zákazky, riadky technologických postupov a nákupné objednávky sa načítavajú každých niekoľko minút z publikovaných stránok a z purchaseOrders. Filtrovanie na otvorené zákazky a objednávky spolu so stránkovaním udržiava počet požiadaviek bezpečne pod limitmi Business Central.

SkyPlanner odosiela webhooky pri zmene stavu alebo rozvrhu, takže spätný zápis je riadený udalosťami.

1. Úvodné načítanie kmeňových dát. Z publikovaných stránok načítajte technologické postupy a výrobné kusovníky v stave Certified, pracoviská a strojové centrá. Položky a merné jednotky načítajte cez API v2.0. Pri mapovaní každého pracoviska alebo strojového centra na pracovisko v SkyPlanner zvoľte vhodnú štruktúru: rozhodnite, či pracovisko s tromi strojovými centrami vytvorí jednu skupinu pracovísk alebo tri pracoviská.

2. Synchronizácia zákaziek. Z publikovaných stránok načítajte výrobné zákazky v stave Released (a tiež Firm Planned, ak ich rozvrhujete) spolu s riadkami technologických postupov a komponentmi. Cez API v2.0 načítajte aj otvorené riadky nákupných objednávok. SkyPlanner považuje objednaný materiál za dostupný v termíne dodania nákupnej objednávky a aktualizuje skladové zásoby po jej označení ako Delivered. Pri rozvrhovaní sa tak kontrolujú skladové zásoby aj očakávané dodávky z nákupu.

Nikdy nerozvrhujte výrobné zákazky v stave Planned. Microsoft uvádza, že Business Central „deletes them the next time you run planning.“ (pri ďalšom spustení plánovania ich odstráni). Planning Worksheet naďalej navrhuje zásobovanie a SkyPlanner rozvrhuje pevne plánované zákazky podľa reálnej kapacity.

3. Spätný zápis rozvrhu. Štandardná stránka Prod. Order Routing sa publikuje ako webová služba OData v4. Pre každú operáciu, ktorú plánovací algoritmus zaradil alebo presunul, odošle SkyPlanner požiadavku PATCH na príslušný riadok technologického postupu s ETag v hlavičke If-Match. Nastaví polia Starting Date-Time a Ending Date-Time. Ak sa operácia presunula na alternatívny stroj, nastaví aj Type a No.

PATCH spúšťa triggery stránky aj tabuľky, takže Business Central overuje polia vlastnou logikou, presne ako pri úprave stránky Prod. Order Routing plánovačom. Následne sa upravia aj polia Starting Date-Time a Ending Date-Time na riadku výrobnej zákazky. Množstvá, stav a náklady zostávajú v správe Business Central.

4. Potvrdzovanie práce vo výrobe. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations alebo Production Timer a ich časové záznamy udržiavajú rozvrh aktuálny. Výrobný výstup možno v Business Central vykazovať tak ako doteraz, cez Production Journal alebo Output Journal.

Ak chcete výrobný výstup a spotrebu účtovať úplne automaticky, pridá sa štandardná stránka API Business Central na účtovanie denníka výstupu. SkyPlanner potom za každú operáciu zaúčtuje čas nastavenia, čas výroby a vyrobené množstvo. Účtovanie aktualizuje Capacity Ledger Entries a výstup poslednej operácie technologického postupu pridá položku do skladových zásob.

Na účtovanie výrobného výstupu si zvoľte jeden kanál. Ak ho budete účtovať zo SkyPlanner aj cez Production Journal v Business Central, vzniknú duplicitné záznamy.

5. Pravidlá správy dát a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:

Hlavným zdrojom konfliktov sú akcie Refresh a Replan na výrobných zákazkách. Microsoft uvádza: „If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.“ (Ak akciou Refresh prepočítate riadky výrobnej zákazky, Business Central odstráni existujúce riadky a vypočíta nové.) Replan môže zmeniť aj potrebu kapacity a prepočet komponentov „deletes previous changes in the components.“ (odstráni predchádzajúce zmeny v komponentoch).

Zákazku po akcii Refresh považujte za novú verziu, znova ju synchronizujte a nechajte SkyPlanner prepočítať rozvrh. S funkciou Autopilot SkyPlanner pri zmenách vo výrobe prepočíta rozvrh automaticky.

• Jednotky v technologických postupoch. Setup Time sa vzťahuje na výrobnú zákazku, Run Time na vyrobenú položku a každý z nich má vlastný Unit of Measure Code. Wait Time a Move Time nečerpajú kapacitu pracoviska. Ak je jednotkou pracoviska Days, jeden deň predstavuje 24 hodín, nie osemhodinovú zmenu. Pri importe jednotky prepočítajte, inak budú všetky trvania nesprávne.
• Neaktuálne kalendáre. Kapacita existuje až po spustení Calculate Work Center Calendar pre príslušný plánovací horizont. Pred úvodným načítaním skontrolujte pole Calendar Entries Available Until.
• Skrytá kapacita strojových centier. Ak je Consolidated Calendar vypnutý, plánuje sa iba vlastná kapacita pracoviska: „The machine center capacity is excluded.“ (Kapacita strojového centra sa nezahŕňa.) Kapacitu strojových centier načítavajte priamo, nespoliehajte sa na súčty za pracoviská.
• Capacity a Efficiency. Business Central počíta trvanie ako Run Time / Efficiency / Capacity a vypočítané položky kalendára už zohľadňujú obe hodnoty. Efficiency premietnite do efektívnosti pracoviska v SkyPlanner iba raz, nie dvakrát.
• Alternate Work Center má iba informačný charakter. Microsoft uvádza, že „isn’t automatically included in planning processes.“ (sa automaticky nezahŕňa do plánovacích procesov). Alternatívy preto výslovne nastavte ako alternatívne pracoviská v SkyPlanner.
• Obmedzovanie požiadaviek. V online prostredí platia limity na používateľa a objekt service principal sa počíta ako jeden používateľ: 6 000 požiadaviek OData v kĺzavom 5-minútovom intervale a 5 súbežných požiadaviek. Veľkosť stránky je obmedzená na 20 000 záznamov, $batch na 100 operácií a časový limit operácie je 8 minút. Pri prekročení frekvencie požiadaviek sa vráti stav 429. Namiesto opakovaného úplného načítavania používajte dávky, stránkovanie a pravidelné načítavanie iba zmien.
• Licencovanie. Výroba je dostupná iba v režime Premium. Používatelia s licenciou Essentials sa nemôžu prihlásiť do spoločnosti nastavenej na Premium.