Business Central -integraatio-opas hienokuormitukseen SkyPlanner APS:llä

Integraatio käyttää kahta Business Centraliin valmiiksi kuuluvaa rajapintaa:

1. API v2.0 myynnin, ostojen ja varaston tietoihin. Sen kautta ovat käytettävissä items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers ja employees. Rajapinta ei sisällä valmistuksen entiteettejä, joten tuotantotiedot haetaan toisesta rajapinnasta.
2. OData v4 -verkkopalvelut valmistuksen tietoihin. Minkä tahansa Business Central -sivun voi julkaista OData v4 -verkkopalveluna Web Services -sivulla. Valitse objektityypiksi Page, anna sivun tunnus ja palvelun nimi ja valitse sitten Published. Päätepiste on tämän jälkeen käytettävissä ilman AL-koodia tai asennettavaa laajennusta. Integraatiossa julkaistaan vapautettujen tuotantotilausten, tuotantotilausten reititysrivien (Prod. Order Routing Lines), työpisteiden, konekeskusten ja reititysten vakiosivut. Ne ovat käytettävissä osoitteessa /ODataV4/Company('{name}')/{ServiceName}.

Julkaistujen sivujen kautta voi sekä lukea että kirjoittaa tietoja. Microsoftin mukaan: “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,” (Jos muokattava sivu julkaistaan verkkopalveluna, sen taustalla olevan taulun tietoja voi lukea ja muokata OData-kutsulla.) Päivityksiin käytetään PATCH-kutsua. Näin suunnitellut ajankohdat palautuvat Business Centraliin saman sivun ja samojen tarkistusten kautta kuin suunnittelijan tehdessä muutokset itse.

Älä käytä SOAPia. Microsoft on merkinnyt SOAP-verkkopalvelut vanhentuneiksi, ja Microsoftin käyttöliittymäsivujen julkaiseminen SOAP-palveluina poistuu vuoden 2026 julkaisuaallossa 2 (v29).

Business Central tukee webhook-tilauksia päätepisteen POST /api/v2.0/subscriptions kautta API v2.0:n entiteeteille, kuten items ja salesOrders. Seuraavat säännöt pätevät:

• Tilauksen luominen edellyttää kättelyä: päätepisteesi on palautettava validationToken ja tilakoodi 200 OK.
• Tilaukset vanhenevat kolmen päivän kuluttua. Uusi tilaus PATCH-kutsulla, jolloin kättely suoritetaan uudelleen.
• Ilmoitukset sisältävät resurssin polun, changeType-arvon ja antamasi clientState-arvon, eivät koko tietuetta. Tietue luetaan erikseen ilmoituksen jälkeen.
• Ilmoitukset tulevat viiveellä: Business Centralin verkkoversio odottaa 30 sekuntia ensimmäisen muutoksen jälkeen. Jos tänä aikana muuttuu yli 1 000 tietuetta, niistä saapuu yksi collection-ilmoitus.
• Verkkoversiossa voi olla enintään 200 webhook-tilausta ympäristöä kohti.

Tuotantotilausten, reititysrivien ja ostotilausten muutokset tarkistetaan muutaman minuutin välein julkaistuilta sivuilta ja purchaseOrders-entiteetistä. Kun haku rajataan avoimiin tilauksiin ja tulokset sivutetaan, pyyntömäärä pysyy selvästi Business Centralin rajojen sisällä.

SkyPlanner lähettää webhook-ilmoituksia tilan tai aikataulun muuttuessa, joten tietojen kirjoittaminen takaisin Business Centraliin on tapahtumapohjaista.

1. Perustietojen alkulataus. Hae Certified-tilassa olevat reititykset ja tuotannon tuoterakenteet sekä työpisteet ja kuormitusyksiköt julkaistuilta sivuilta. Hae nimikkeet ja mittayksiköt API v2.0 -rajapinnasta. Määritä harkiten, mitä SkyPlannerin työpistettä kukin Business Centralin työpiste tai kuormitusyksikkö vastaa: päätä, mallinnetaanko kolme kuormitusyksikköä sisältävä työpiste yhtenä työpisteryhmänä vai kolmena työpisteenä.

2. Tilausten synkronointi. Lue Released-tilassa olevat tuotantotilaukset reititysriveineen ja komponentteineen julkaistuilta sivuilta. Lue myös Firm Planned -tilaukset, jos aikataulutat niitä. Hae lisäksi avoimet ostotilausrivit API v2.0 -rajapinnasta. SkyPlanner käsittelee tilattua materiaalia saatavilla olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilaus merkitään Delivered-tilaan. Näin aikataulutuksessa tarkistetaan sekä varastosaldo että saapuvat ostot.

Älä koskaan aikatauluta Planned-tilassa olevia tuotantotilauksia. Microsoftin mukaan Business Central “deletes them the next time you run planning.” (poistaa ne, kun suunnittelu suoritetaan seuraavan kerran). Planning Worksheet ehdottaa edelleen täydennyksiä, ja SkyPlanner aikatauluttaa vahvistetut tilaukset todellisen kapasiteetin mukaan.

3. Aikataulun kirjoittaminen takaisin. Vakiosivu Prod. Order Routing julkaistaan OData v4 -verkkopalveluna. SkyPlanner lähettää jokaisesta laskentamoottorin aikatauluun sijoittamasta tai siirtämästä työvaiheesta PATCH-pyynnön kyseiselle reititysriville käyttäen If-Match-ETagia. Pyyntö asettaa Starting Date-Time – ja Ending Date-Time -kentät sekä Type- ja No.-kentät, jos työvaihe on siirtynyt vaihtoehtoiselle koneelle.

PATCH suorittaa sivun ja taulun liipaisimet, joten Business Central tarkistaa kentät omalla logiikallaan aivan kuten suunnittelijan muokatessa Prod. Order Routing -sivua. Tuotantotilausrivin Starting Date-Time- ja Ending Date-Time -kentät päivittyvät vastaavasti. Määrät, tilat ja kustannukset säilyvät Business Centralin hallinnassa.

4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations- tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Tuotoksen voi raportoida Business Centralissa entiseen tapaan Production Journal- tai Output Journal -päiväkirjasta.

Jos haluat kirjata tuotoksen ja kulutuksen täysin automaattisesti, tuotospäiväkirjan kirjausta varten lisätään Business Centralin vakio-API-sivu. SkyPlanner kirjaa silloin asetusajan, ajoajan ja tuotetun määrän työvaiheittain. Kirjaus päivittää Capacity Ledger Entries -tapahtumat, ja viimeisen reititysvaiheen tuotos lisää nimikkeen varastoon.

Valitse tuotoksen kirjaukseen yksi kanava. Jos kirjaukset tehdään sekä SkyPlannerista että Business Centralin Production Journal -päiväkirjasta, tapahtumat kirjautuvat kahteen kertaan.

5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäytön aloitusta:

Eniten ristiriitoja aiheuttavat tuotantotilausten Refresh– ja Replan-toiminnot. Microsoftin mukaan: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Jos lasket tuotantotilausrivit uudelleen Refresh-toiminnolla, Business Central poistaa nykyiset tuotantotilausrivit ja laskee uudet rivit.) Myös Replan voi muuttaa kapasiteettitarvetta, ja komponenttien uudelleenlaskenta “deletes previous changes in the components.” (poistaa komponentteihin aiemmin tehdyt muutokset).

Käsittele päivitettyä tilausta uutena versiona, synkronoi se uudelleen ja anna SkyPlannerin aikatauluttaa se uudestaan. Autopilotin avulla SkyPlanner aikatauluttaa työt automaattisesti uudelleen tuotannon muuttuessa.

• Reititysten yksiköt. Setup Time koskee koko tuotantotilausta, Run Time yhtä tuotettua nimikettä. Kummallakin on oma Unit of Measure Code. Wait Time ja Move Time eivät kuluta työpisteen kapasiteettia. Jos työpisteen yksikkö on Days, yksi päivä tarkoittaa 24 tuntia, ei kahdeksan tunnin työvuoroa. Muunna yksiköt tuonnin yhteydessä, muuten kaikki kestot ovat väärin.
• Vanhentuneet kalenterit. Kapasiteettia on vasta, kun Calculate Work Center Calendar on suoritettu suunnittelujaksolle. Tarkista Calendar Entries Available Until -kenttä ennen alkulatausta.
• Kuormitusyksikön kapasiteetti jää piiloon. Kun Consolidated Calendar ei ole käytössä, suunnittelussa huomioidaan vain työpisteen oma kapasiteetti: “The machine center capacity is excluded.” (Kuormitusyksikön kapasiteettia ei oteta mukaan.) Lue kuormitusyksiköiden kapasiteetti suoraan sen sijaan, että luottaisit työpisteiden yhteissummiin.
• Capacity ja Efficiency. Business Central laskee keston kaavalla Run Time / Efficiency / Capacity. Lasketut kalenteritapahtumat sisältävät jo molempien vaikutuksen. Kohdista Efficiency SkyPlannerin työpisteen tehokkuuteen vain kerran, ei kahdesti.
• Alternate Work Center on vain lisätieto. Microsoftin mukaan se “isn’t automatically included in planning processes.” (ei tule automaattisesti mukaan suunnitteluprosesseihin). Mallinna vaihtoehdot erikseen SkyPlannerin vaihtoehtoisina työpisteinä.
• Pyyntömäärien rajoitukset. Verkkoversion rajoitukset ovat käyttäjäkohtaisia, ja palveluidentiteetti lasketaan yhdeksi käyttäjäksi: 6 000 OData-pyyntöä liukuvan 5 minuutin aikaikkunan aikana ja 5 samanaikaista pyyntöä. Sivukoko on enintään 20 000 ja $batch-pyynnön koko enintään 100 operaatiota. Operaation aikakatkaisu on 8 minuuttia. Pyyntötiheyden ylitys palauttaa tilakoodin 429. Käytä eräpyyntöjä ja sivutusta ja kysele vain muutokset sen sijaan, että lataisit kaikki tiedot uudelleen.
• Lisensointi. Valmistustoiminnot ovat käytettävissä vain Premium-käyttökokemuksessa. Essentials-käyttäjät eivät voi kirjautua yritykseen, jonka käyttökokemukseksi on asetettu Premium.