Integratiegids voor Business Central voor productieschema’s met SkyPlanner APS

De integratie gebruikt twee interfaces die standaard met Business Central worden meegeleverd:

1. API v2.0 voor commerciële gegevens en voorraadgegevens. Deze API biedt toegang tot items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers en employees. De API bevat geen productie-entiteiten. Productiegegevens worden daarom via de tweede interface uitgewisseld.
2. OData v4-webservices voor productie. Elke Business Central-pagina kan op de pagina Web Services als OData v4-webservice worden gepubliceerd. Kies het objecttype Page, de pagina-ID en een servicenaam en selecteer vervolgens Published. Het endpoint is dan beschikbaar, zonder AL-code en zonder dat u een extensie hoeft te implementeren. De integratie publiceert de standaardpagina’s voor vrijgegeven productieorders, Prod. Order Routing Lines, werkcentra, machinecentra en bewerkingsvolgorden. Deze zijn beschikbaar via /ODataV4/Company('{name}')/{ServiceName}.

Gepubliceerde pagina’s ondersteunen lezen en schrijven. Microsoft: “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,” (Als een bewerkbare pagina als webservice wordt aangeboden, kunnen de gegevens in de onderliggende tabel via een OData-aanroep worden geraadpleegd en gewijzigd.) Updates verlopen via PATCH. Zo gaan geplande datums terug naar Business Central, via dezelfde pagina en met dezelfde validatie die een planner gebruikt.

Gebruik geen SOAP. Microsoft heeft SOAP-webservices als verouderd aangemerkt. Vanaf 2026 release wave 2 (v29) vervalt de mogelijkheid om Microsoft UI-pagina’s als SOAP te publiceren.

Business Central ondersteunt webhookabonnementen via POST /api/v2.0/subscriptions voor API v2.0-entiteiten zoals items en salesOrders. Daarbij gelden de volgende regels:

• Voor het aanmaken van een abonnement is een handshake vereist: uw endpoint moet het validationToken teruggeven met 200 OK.
• Abonnementen verlopen na drie dagen. Vernieuw ze met PATCH; de handshake wordt dan opnieuw uitgevoerd.
• Meldingen bevatten het resourcepad, changeType en uw clientState, niet het volledige record. Dat haalt u daarna op.
• Meldingen worden met vertraging verstuurd: Business Central online wacht 30 seconden na de eerste wijziging. Als binnen dat tijdsvenster meer dan 1.000 records zijn gewijzigd, worden die als één collection-melding verstuurd.
• Online geldt een maximum van 200 webhookabonnementen per omgeving.

Productieorders, bewerkingsregels en inkooporders worden om de paar minuten opgehaald via de gepubliceerde pagina’s en purchaseOrders. Door op openstaande orders te filteren en paginering te gebruiken, blijft het aantal aanvragen ruim binnen de limieten van Business Central.

SkyPlanner verstuurt webhooks zodra de status of het productieschema verandert. Het terugschrijven gebeurt dus op basis van events.

1. Stamgegevens voor het eerst inladen. Haal bewerkingsvolgorden en productiestuklijsten met de status Certified, werkcentra en machinecentra op via de gepubliceerde pagina’s, en artikelen en maateenheden via API v2.0. Bepaal bewust hoe u elk werk- of machinecentrum aan een werkcentrum in SkyPlanner koppelt: wordt een werkcentrum met drie machinecentra één groep werkcentra of drie afzonderlijke werkcentra?

2. Ordersynchronisatie. Lees productieorders met de status Released (en Firm Planned, als u die inplant) met hun bewerkingsregels en componenten uit de gepubliceerde pagina’s, en openstaande inkooporderregels via API v2.0. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra die order de status Delivered krijgt. Het productieschema houdt dus rekening met zowel de voorraad als de verwachte inkopen.

Plan nooit productieorders met de status Planned in: volgens Microsoft geldt dat Business Central “deletes them the next time you run planning.” (ze verwijdert wanneer u de planning de volgende keer uitvoert.) De Planning Worksheet blijft bevoorradingsvoorstellen doen, terwijl SkyPlanner de vaste orders inplant op basis van de werkelijke capaciteit.

3. Het productieschema terugschrijven. De standaardpagina Prod. Order Routing wordt gepubliceerd als OData v4-webservice. Voor elke bewerking die de planningsengine heeft ingepland of verplaatst, stuurt SkyPlanner een PATCH naar de betreffende bewerkingsregel met de If-Match-ETag. Daarmee worden Starting Date-Time en Ending Date-Time ingesteld, plus Type en No. wanneer de bewerking naar een alternatieve machine is verplaatst.

De PATCH voert de pagina- en tabeltriggers uit. Business Central valideert de velden dus met zijn eigen logica, precies zoals wanneer een planner de pagina Prod. Order Routing bewerkt. De velden Starting en Ending Date-Time van de productieorderregel worden vervolgens bijgewerkt. Hoeveelheden, status en kosten blijven in beheer bij Business Central.

4. Terugmeldingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Die tijdregistraties houden het productieschema actueel. De productieoutput kan zoals voorheen in Business Central worden gerapporteerd via de Production Journal of Output Journal.

Als u productieoutput en verbruik volledig automatisch wilt boeken, wordt een standaard API-pagina van Business Central toegevoegd voor boekingen in het outputdagboek. SkyPlanner boekt dan per bewerking de insteltijd, bewerkingstijd en geproduceerde hoeveelheid. De boeking werkt de Capacity Ledger Entries bij, en output op de laatste bewerking van de bewerkingsvolgorde voegt het artikel toe aan de voorraad.

Kies één kanaal voor het boeken van productieoutput. Boeken vanuit zowel SkyPlanner als de Business Central Production Journal leidt tot dubbele boekingen.

5. Afspraken over gegevensbeheer en conflicten. Leg deze vóór de livegang vast:

De belangrijkste oorzaak van conflicten zijn de acties Refresh en Replan op productieorders. Microsoft: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Als u met de actie Refresh productieorderregels opnieuw berekent, verwijdert Business Central de bestaande regels en berekent het nieuwe.) Replan kan ook de capaciteitsbehoefte wijzigen, en het opnieuw berekenen van componenten “deletes previous changes in the components.” (verwijdert eerdere wijzigingen in de componenten.)

Behandel een vernieuwde order als een nieuwe versie, synchroniseer deze opnieuw en laat SkyPlanner opnieuw plannen. Met Autopilot plant SkyPlanner automatisch opnieuw wanneer de productie verandert.

• Eenheden in bewerkingsvolgorden. Setup Time geldt per productieorder, Run Time per geproduceerd artikel. Beide hebben een eigen Unit of Measure Code. Wait Time en Move Time verbruiken geen capaciteit van het werkcentrum. Als de eenheid van het werkcentrum Days is, staat één dag voor 24 uur, niet voor een dienst van acht uur. Reken de waarden bij het importeren om, anders klopt geen enkele tijdsduur.
• Verouderde kalenders. Capaciteit is pas beschikbaar nadat Calculate Work Center Calendar voor de planningshorizon is uitgevoerd. Controleer het veld Calendar Entries Available Until voordat u de gegevens voor het eerst inlaadt.
• Verborgen capaciteit van machinecentra. Als Consolidated Calendar uitstaat, wordt alleen de eigen capaciteit van het werkcentrum ingepland: “The machine center capacity is excluded.” (De capaciteit van het machinecentrum wordt uitgesloten.) Lees de capaciteit van machinecentra rechtstreeks uit in plaats van op de totalen van het werkcentrum te vertrouwen.
• Capacity en Efficiency. Business Central berekent de tijdsduur als Run Time / Efficiency / Capacity. In de berekende kalenderposten zijn beide factoren al verwerkt. Pas Efficiency één keer toe op de efficiëntie van het SkyPlanner-werkcentrum, niet twee keer.
• Alternate Work Center is alleen ter informatie. Volgens Microsoft geldt: “isn’t automatically included in planning processes.” (wordt niet automatisch meegenomen in planningsprocessen.) Leg alternatieven expliciet vast als alternatieve werkcentra in SkyPlanner.
• Aanvraaglimieten. Online gelden de limieten per gebruiker, waarbij een service-principal als één gebruiker telt: 6.000 OData-aanvragen binnen een voortschrijdend tijdsvenster van 5 minuten en 5 gelijktijdige aanvragen. De paginagrootte is beperkt tot 20.000 records, een $batch tot 100 bewerkingen en een bewerking krijgt na 8 minuten een time-out. Bij overschrijding van de aanvraaglimiet wordt 429 geretourneerd. Gebruik batches en paginering en haal via polling alleen wijzigingen op, in plaats van alle gegevens opnieuw te laden.
• Licenties. Productiefunctionaliteit is alleen beschikbaar in de Premium-ervaring. Gebruikers met Essentials kunnen zich niet aanmelden bij een bedrijf dat op Premium is ingesteld.