Business Central integravimo vadovas: gamybos tvarkaraščių sudarymas su SkyPlanner APS

Integracija veikia per dvi sąsajas, kurios jau yra Business Central:

1. API v2.0 skirta komerciniams ir atsargų duomenims. Per ją pasiekiami items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers ir employees. Gamybos esybių joje nėra, todėl gamybos duomenys perduodami per antrąją sąsają.
2. OData v4 žiniatinklio tarnybos skirtos gamybai. Bet kurį Business Central puslapį galima paskelbti kaip OData v4 žiniatinklio tarnybą puslapyje Web Services. Pasirinkite objekto tipą Page, puslapio ID ir tarnybos pavadinimą, tada pažymėkite Published. Galinis taškas pradeda veikti – nereikia nei AL kodo, nei diegti plėtinio. Integracijai skelbiami standartiniai išleistų gamybos užsakymų, Prod. Order Routing Lines, darbo centrų, įrenginių centrų ir technologinių maršrutų puslapiai, pasiekiami adresu /ODataV4/Company('{name}')/{ServiceName}.

Per paskelbtus puslapius duomenis galima ir skaityti, ir rašyti. Microsoft nurodo: „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,” (jei redaguojamas puslapis paskelbtas kaip žiniatinklio paslauga, jo lentelės duomenis galima pasiekti ir keisti OData užklausa). Atnaujinimams naudojamas PATCH. Taip suplanuotos datos grąžinamos į Business Central per tą patį puslapį ir tikrinamos taip pat, kaip planuotojui dirbant su tuo puslapiu.

Nenaudokite SOAP. Microsoft SOAP žiniatinklio paslaugas paskelbė pasenusiomis, o galimybė skelbti Microsoft naudotojo sąsajos puslapius kaip SOAP pašalinama su 2026 metų 2-ąja leidimų banga (v29).

Business Central leidžia per POST /api/v2.0/subscriptions prenumeruoti webhook pranešimus apie API v2.0 esybes, pvz., items ir salesOrders. Taikomos šios taisyklės:

• Kuriant prenumeratą būtinas ryšio patvirtinimas: jūsų galinis taškas turi grąžinti validationToken su atsakymo kodu 200 OK.
• Prenumeratos nustoja galioti po trijų dienų. Atnaujinkite jas naudodami PATCH – tada vėl atliekama ryšio patvirtinimo procedūra.
• Pranešimuose pateikiamas ištekliaus kelias, changeType ir jūsų clientState, o ne visas įrašas. Patį įrašą nuskaitote vėliau.
• Pranešimai siunčiami su delsa: po pirmojo pakeitimo Business Central internetinė versija laukia 30 sekundžių. Jei per šį laiką pasikeičia daugiau nei 1 000 įrašų, apie juos atsiunčiamas vienas collection pranešimas.
• Internetinėje versijoje vienoje aplinkoje leidžiama ne daugiau kaip 200 įvykių pranešimų prenumeratų.

Gamybos užsakymai, technologinių maršrutų eilutės ir pirkimo užsakymai nuskaitomi kas kelias minutes, siunčiant užklausas į paskelbtus puslapius ir purchaseOrders. Atrenkant tik atvirus užsakymus ir duomenis skaidant puslapiais, užklausų skaičius lieka gerokai mažesnis už Business Central ribas.

Pasikeitus būsenai arba tvarkaraščiui, SkyPlanner siunčia įvykių pranešimus, todėl duomenų įrašymą atgal inicijuoja įvykiai.

1. Pradinis pagrindinių duomenų įkėlimas. Iš paskelbtų puslapių nuskaitykite technologinius maršrutus ir gamybos BOM, kurių būsena Certified, taip pat darbo ir įrenginių centrus, o per API v2.0 – prekes ir matavimo vienetus. Apgalvotai susiekite kiekvieną darbo ar įrenginių centrą su SkyPlanner darbo centru: nuspręskite, ar darbo centras su trimis įrenginių centrais taps viena darbo centrų grupe, ar trimis darbo centrais.

2. Užsakymų sinchronizavimas. Iš paskelbtų puslapių nuskaitykite gamybos užsakymus, kurių būsena Released (taip pat Firm Planned, jei sudarote jų tvarkaraščius), kartu su jų technologinių maršrutų eilutėmis ir komponentais, o per API v2.0 – atvirų pirkimo užsakymų eilutes. SkyPlanner laiko užsakytas medžiagas prieinamomis pirkimo užsakymo pristatymo dieną ir atnaujina atsargas, kai pirkimo užsakymas pažymimas Delivered. Todėl sudarant tvarkaraštį tikrinamos ir turimos atsargos, ir laukiami pristatymai pagal pirkimo užsakymus.

Niekada nesudarykite gamybos užsakymų, kurių būsena Planned, tvarkaraščių: Microsoft nurodo, kad Business Central „deletes them the next time you run planning.” (juos pašalina kitą kartą paleidus planavimą). Planning Worksheet toliau siūlo aprūpinimo variantus, o SkyPlanner sudaro patvirtintų užsakymų tvarkaraščius pagal realius pajėgumus.

3. Tvarkaraščio įrašymas atgal. Standartinis Prod. Order Routing puslapis paskelbiamas kaip OData v4 žiniatinklio tarnyba. Kiekvienai operacijai, kurią planavimo variklis įtraukė į tvarkaraštį arba perkėlė, SkyPlanner siunčia PATCH užklausą į atitinkamą technologinio maršruto eilutę su If-Match ETag. Nustatomi Starting Date-Time ir Ending Date-Time laukai, o perkėlus operaciją į alternatyvų įrenginį – ir Type bei No.

PATCH paleidžia puslapio ir lentelės trigerius, todėl Business Central tikrina laukus pagal savo logiką – lygiai taip pat, kaip planuotojui redaguojant puslapį Prod. Order Routing. Atitinkamai atnaujinami gamybos užsakymo eilutės Starting Date-Time ir Ending Date-Time laukai. Kiekiai, būsena ir sąnaudos lieka Business Central žinioje.

4. Darbų patvirtinimai ceche. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations arba Production Timer, o pagal darbo laiko įrašus tvarkaraštis nuolat atnaujinamas. Produkciją Business Central galima apskaityti kaip ir anksčiau – per Production Journal arba Output Journal.

Jei norite visiškai automatiškai registruoti produkciją ir sunaudojimą, pridedamas standartinis Business Central API puslapis produkcijos žurnalo įrašams registruoti. Tada SkyPlanner kiekvienai operacijai registruoja paruošimo laiką, vykdymo laiką ir pagamintą kiekį. Registruojant atnaujinami Capacity Ledger Entries įrašai, o užregistravus paskutinės technologinio maršruto operacijos produkciją, prekė įtraukiama į atsargas.

Pasirinkite vieną produkcijos registravimo kanalą. Registruojant ir iš SkyPlanner, ir iš Business Central Production Journal, įrašai dubliuojami.

5. Atsakomybė už duomenis ir konfliktų sprendimo taisyklės. Užfiksuokite jas prieš pradėdami naudoti integraciją:

Pagrindinis konfliktų šaltinis – gamybos užsakymų veiksmai Refresh ir Replan. Microsoft nurodo: „If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (naudojant veiksmą Refresh gamybos užsakymo eilutėms perskaičiuoti, Business Central pašalina esamas eilutes ir apskaičiuoja naujas). Replan taip pat gali pakeisti pajėgumų poreikį, o komponentų perskaičiavimas „deletes previous changes in the components.” (pašalina ankstesnius komponentų pakeitimus).

Atnaujintą užsakymą laikykite nauja versija, sinchronizuokite jį iš naujo ir leiskite SkyPlanner perskaičiuoti tvarkaraštį. Naudojant Autopilot, SkyPlanner automatiškai perskaičiuoja tvarkaraštį pasikeitus gamybai.

• Vienetai technologiniuose maršrutuose. Setup Time taikomas visam gamybos užsakymui, Run Time – vienai pagamintai prekei, ir kiekvienas turi atskirą Unit of Measure Code. Wait Time ir Move Time nenaudoja darbo centro pajėgumų. Jei darbo centro matavimo vienetas yra Days, viena diena reiškia 24 valandas, o ne aštuonių valandų pamainą. Konvertuokite importuodami, antraip visos trukmės bus neteisingos.
• Pasenę kalendoriai. Pajėgumai atsiranda tik atlikus Calculate Work Center Calendar veiksmą planuojamam laikotarpiui. Prieš pradinį įkėlimą patikrinkite lauką Calendar Entries Available Until.
• Neįtraukti įrenginių centro pajėgumai. Kai Consolidated Calendar išjungtas, planuojami tik paties darbo centro pajėgumai: „The machine center capacity is excluded.” (įrenginių centro pajėgumai neįtraukiami). Nuskaitykite įrenginių centro pajėgumus tiesiogiai, o ne pasikliaukite bendrais darbo centro pajėgumais.
• Capacity ir Efficiency. Business Central trukmę skaičiuoja pagal formulę Run Time / Efficiency / Capacity, o apskaičiuotuose kalendoriaus įrašuose jau atsižvelgta į abu rodiklius. Susiedami Efficiency su SkyPlanner darbo centro efektyvumu, pritaikykite jį vieną, o ne du kartus.
• Alternate Work Center skirtas tik informacijai. Microsoft nurodo: „isn’t automatically included in planning processes.” (nėra automatiškai įtraukiamas į planavimo procesus). Alternatyvas aiškiai apibrėžkite kaip alternatyvius SkyPlanner darbo centrus.
• Užklausų ribojimas. Internetinės versijos ribos taikomos kiekvienam naudotojui, o tarnybos identitetas laikomas vienu naudotoju: 6 000 OData užklausų per slenkantį 5 minučių laikotarpį ir 5 vienu metu vykdomos užklausos. Puslapyje gali būti ne daugiau kaip 20 000 įrašų, $batch užklausoje – 100 operacijų, o operacijos vykdymo laikas ribojamas iki 8 minučių. Viršijus užklausų dažnio ribą grąžinamas kodas 429. Užuot kaskart iš naujo įkėlę visus duomenis, grupuokite užklausas, skaidykite duomenis puslapiais ir periodiškai nuskaitykite tik pakeitimus.
• Licencijavimas. Gamybos funkcijos prieinamos tik Premium režimu. Essentials naudotojai negali prisijungti prie įmonės, kuriai nustatytas Premium režimas.