Ghid de integrare Business Central pentru programarea producției cu SkyPlanner APS

Integrarea folosește două interfețe deja incluse în Business Central:

1. API v2.0 pentru date comerciale și de stoc. Expune items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers și employees. Nu include entități de producție, așa că datele de producție sunt preluate prin a doua interfață.
2. Servicii web OData v4 pentru producție. Orice pagină Business Central poate fi publicată ca serviciu web OData v4 din pagina Web Services. Alegeți tipul de obiect Page, ID-ul paginii și un nume de serviciu, apoi bifați Published. Endpointul devine activ, fără cod AL și fără să fie nevoie să implementați o extensie. Integrarea publică paginile standard pentru comenzile de producție lansate, Prod. Order Routing Lines, centrele de lucru, centrele de utilaje și fluxurile tehnologice, accesibile la /ODataV4/Company('{name}')/{ServiceName}.

Paginile publicate permit atât citirea, cât și scrierea datelor. Microsoft precizează: “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,” (Dacă o pagină editabilă este expusă ca serviciu web, datele din tabelul aferent pot fi accesate și modificate printr-un apel OData), cu PATCH pentru actualizări. Astfel sunt trimise înapoi datele planificate în Business Central, prin aceeași pagină și cu aceleași validări pe care le folosește un planificator.

Nu folosiți SOAP. Microsoft a declarat serviciile web SOAP învechite, iar publicarea paginilor de interfață Microsoft prin SOAP este eliminată în valul de lansare 2 din 2026 (v29).

Business Central permite abonamente webhook prin POST /api/v2.0/subscriptions pentru entități API v2.0 precum items și salesOrders. Se aplică următoarele reguli:

• Crearea unui abonament necesită un schimb de validare: endpointul dumneavoastră trebuie să returneze validationToken cu răspunsul 200 OK.
• Abonamentele expiră după trei zile. Reînnoiți-le cu PATCH, iar procedura de confirmare a conexiunii se va relua.
• Notificările conțin calea resursei, changeType și valoarea clientState furnizată de dumneavoastră, nu înregistrarea completă. Înregistrarea se citește ulterior.
• Notificările sunt trimise cu întârziere: Business Central online așteaptă 30 de secunde după prima modificare, iar dacă în acest interval sunt modificate peste 1.000 de înregistrări, acestea sunt semnalate printr-o singură notificare collection.
• Maximum 200 de abonamente webhook pentru fiecare mediu online.

Comenzile de producție, liniile fluxurilor tehnologice și comenzile de achiziție sunt preluate prin interogări la fiecare câteva minute, din paginile publicate și din purchaseOrders. Filtrarea doar a comenzilor deschise și paginarea mențin numărul de cereri mult sub limitele Business Central.

SkyPlanner trimite webhookuri când se schimbă starea sau programul de producție, astfel încât scrierea datelor înapoi este declanșată de evenimente.

1. Încărcarea inițială a nomenclatoarelor. Preluați fluxurile tehnologice și BOM-urile de producție cu starea Certified, precum și centrele de lucru și centrele de mașini, din paginile publicate, iar articolele și unitățile de măsură din API v2.0. Stabiliți cu atenție corespondența fiecărui centru de lucru sau centru de mașini cu un centru de lucru SkyPlanner: decideți dacă un centru de lucru cu trei centre de mașini devine un singur grup de centre de lucru sau trei centre de lucru.

2. Sincronizarea ordinelor. Citiți din paginile publicate ordinele de producție cu starea Released (și Firm Planned, dacă le programați), împreună cu liniile de flux tehnologic și componentele acestora, iar din API v2.0 liniile deschise ale comenzilor de achiziție. SkyPlanner consideră materialele comandate disponibile la data de livrare a comenzii de achiziție și actualizează stocul când comanda este marcată Delivered. Astfel, programarea ține cont atât de stoc, cât și de achizițiile care urmează să sosească.

Nu programați niciodată ordinele de producție cu starea Planned: Microsoft precizează că Business Central “deletes them the next time you run planning.” (le șterge la următoarea rulare a planificării). Planning Worksheet continuă să propună aprovizionarea, iar SkyPlanner programează ordinele ferme în funcție de capacitatea reală.

3. Scrierea programului de producție înapoi în Business Central. Pagina standard Prod. Order Routing este publicată ca serviciu web OData v4. Pentru fiecare operație pe care motorul a programat-o sau a mutat-o, SkyPlanner trimite o cerere PATCH către linia respectivă a fluxului tehnologic, cu ETag-ul If-Match. Setează Starting Date-Time și Ending Date-Time, precum și Type și No. dacă operația a fost mutată pe un utilaj alternativ.

PATCH execută declanșatoarele paginii și ale tabelului, astfel încât Business Central validează câmpurile după propria logică, exact ca atunci când un planificator modifică pagina Prod. Order Routing. Câmpurile Starting și Ending Date-Time de pe linia ordinului de producție sunt actualizate în consecință. Business Central păstrează controlul asupra cantităților, stării și costurilor.

4. Confirmări din producție. Operatorii își înregistrează activitatea cu SkyPlanner Mobile Confirmations sau Production Timer, iar înregistrările de timp mențin programul de producție la zi. Producția realizată poate fi raportată în Business Central ca și până acum, din Production Journal sau Output Journal.

Dacă doriți înregistrarea complet automată a producției realizate și a consumurilor, se adaugă o pagină API standard Business Central pentru înregistrarea producției prin jurnal. SkyPlanner înregistrează apoi timpul de reglaj, timpul de execuție și cantitatea produsă pentru fiecare operație. Înregistrarea actualizează Capacity Ledger Entries, iar raportarea producției la ultima operație din fluxul tehnologic adaugă articolul în stoc.

Alegeți un singur canal pentru înregistrarea producției realizate. Înregistrarea atât din SkyPlanner, cât și din Production Journal în Business Central dublează înregistrările.

5. Responsabilitatea asupra datelor și regulile de gestionare a conflictelor. Documentați-le înainte de punerea în funcțiune:

Principala sursă de conflicte o reprezintă acțiunile Refresh și Replan aplicate ordinelor de producție. Microsoft precizează: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Dacă folosiți acțiunea Refresh pentru a recalcula liniile ordinului de producție, Business Central șterge liniile existente și calculează linii noi.) Replan poate modifica și necesarul de capacitate, iar recalcularea componentelor “deletes previous changes in the components.” (șterge modificările anterioare ale componentelor).

Tratați ordinul actualizat ca pe o versiune nouă, sincronizați-l din nou și lăsați SkyPlanner să refacă programarea. Cu Autopilot, SkyPlanner reface automat programarea când apar schimbări în producție.

• Unitățile din fluxurile tehnologice. Setup Time se aplică pe ordin de producție, iar Run Time pe articol produs; fiecare are propriul Unit of Measure Code. Wait Time și Move Time nu consumă capacitatea centrului de lucru. Dacă unitatea centrului de lucru este Days, o zi înseamnă 24 de ore, nu un schimb de opt ore. Faceți conversia la import; altfel, toate duratele vor fi greșite.
• Calendare neactualizate. Capacitatea există numai după rularea acțiunii Calculate Work Center Calendar pentru orizontul de planificare. Verificați câmpul Calendar Entries Available Until înainte de încărcarea inițială.
• Capacitatea centrelor de mașini nu este inclusă. Dacă Consolidated Calendar este dezactivat, se planifică doar capacitatea proprie a centrului de lucru: “The machine center capacity is excluded.” (Capacitatea centrului de mașini este exclusă.) Citiți direct capacitatea centrelor de mașini, în loc să vă bazați pe totalurile centrelor de lucru.
• Capacity și Efficiency. Business Central calculează durata ca Run Time / Efficiency / Capacity, iar înregistrările de calendar calculate includ deja ambii factori. Mapați Efficiency la eficiența centrului de lucru SkyPlanner o singură dată, nu de două ori.
• Alternate Work Center are rol informativ. Microsoft precizează: “isn’t automatically included in planning processes.” (nu este inclus automat în procesele de planificare). Modelați explicit alternativele ca centre de lucru alternative în SkyPlanner.
• Limitarea cererilor. În mediul online, limitele se aplică per utilizator, iar un principal de serviciu este considerat un utilizator: 6.000 de cereri OData într-o fereastră glisantă de 5 minute și 5 cereri simultane. Dimensiunea unei pagini este limitată la 20.000 de înregistrări, un $batch la 100 de operații, iar o operație expiră după 8 minute. Depășirea limitei de cereri returnează codul 429. Grupați cererile în loturi, folosiți paginarea și interogați doar modificările, în loc să reîncărcați toate datele.
• Licențiere. Funcționalitățile de producție sunt disponibile numai în experiența Premium. Utilizatorii cu Essentials nu se pot conecta la o companie configurată pentru Premium.