Productie-API

Microsoft Dynamics 365 Business Central heeft geen standaard-API die productieorders schrijft. De MCP Guard-extensie voegt de schrijfkant toe, zodat een AI-assistent een planbord kan bedienen: productieorders lezen, maken, wijzigen en verwijderen, vernieuwen en vrijgeven, en bewerkingen herplannen. De pagina's werken op de versies 28 en 29 van Business Central.

Het eindpunt

https://api.businesscentral.dynamics.com/v2.0/{environment}/api/vangelderSolutions/production/v1.0/companies({companyId})/…

Alleen een productieorder kan worden verwijderd. Regels en bewerkingen kunnen niet afzonderlijk worden verwijderd.

Wat er nodig is om ze te gebruiken

1. Wijs de machtigingenset MCP GUARD - USER toe. Sinds versie 1.13.0.0 bevat ze de pagina's voor productie, de query en hun codeunit, en niets op bedrijfsgegevens. De aparte set MCP GUARD - PROD bestaat niet meer. Zie Machtigingensets.
2. Geef de gebruiker de eigen machtigingen van Business Central op productieorders. Productie vereist ook de Premium-ervaring en -licentie.
3. Wijs een MCP Guard-licentie toe. Zonder licentie weigeren de pagina's de aanroep, ook in een sandboxomgeving.
4. Stel Toegang productie in op de regel van de gebruiker. Wijzigen laat wijzigingen toe. Maken en acties laat ook toe orders te maken en te verwijderen en de acties uit te voeren. Zie Toegangsniveaus per module.
5. Voeg de pagina's en de query toe aan de MCP-configuratie met de bewerkingen die u wilt (Read, Create, Modify, Delete, Actions), en schakel Unblock Edit Tools in. Zie MCP-configuraties.

Een productieorder maken

Stuur eerst status, sourceType en sourceNumber, daarna quantity en dueDate. De order wordt bewaard zodra de bron bekend is. De velden die volgen, worden gevalideerd op de bewaarde order, zoals op de pagina Productieorder. Een productieorder kan niet als voltooid worden aangemaakt, en ook niet zonder bronnummer.

Een productieorder vernieuwen

refresh en refreshForward maken de regels van de order opnieuw aan met hun bewerkingsplannen en componenten, zoals de functie Productieorder vernieuwen met elke optie aan. refresh plant achterwaarts vanaf de vervaldatum. refreshForward plant voorwaarts vanaf de begindatum. Business Central weigert het vernieuwen voor regels die al output of verbruik hebben. Een voltooide order kan niet worden vernieuwd.

De regels van een order worden gemaakt door het vernieuwen, niet via prodOrderLines.

Een productieorder vrijgeven

release wijzigt een gesimuleerde, geplande of vast geplande order in vrijgegeven. De status maakt deel uit van de sleutel van een productieorder, dus de vrijgegeven order is een ander record. Ze krijgt haar nummer uit de nummerreeks voor vrijgegeven orders, en dat kan verschillen van het nummer dat ze had. De header Location van het antwoord verwijst naar de vrijgegeven order.

Een status die in een wijziging wordt meegestuurd, wordt geweigerd. Gebruik in plaats daarvan de actie release.

Een productieorder verwijderen

Verwijder de order via productionOrders. Daarvoor moeten drie dingen kloppen:

• De regel van de gebruiker geeft Maken en acties voor Toegang productie.
• De MCP-configuratie heeft de bewerking Delete ingeschakeld voor de pagina MCP Guard Prod. Orders API, en Unblock Edit Tools ingeschakeld.
• De order kan in Business Central worden verwijderd.

De regels, de componenten en het bewerkingsplan gaan mee met de order. Regels en bewerkingsregels kunnen niet afzonderlijk worden verwijderd.

Business Central bepaalt welke orders verwijderd kunnen worden:

• Een voltooide order blijft. De extensie weigert ze te verwijderen.
• Een vrijgegeven order waarop output, verbruik of capaciteit geboekt is, wordt door Business Central geweigerd. Maak die boekingen ongedaan en voltooi de order in plaats daarvan.

Een bewerking herplannen

Wijzig de begin- of einddatum-tijd van een bewerking in prodOrderRoutingLines, of geef ze een andere bewerkingsplaats of machine met soort en nummer. De wijziging gaat door de eigen validatie van Business Central, dus Business Central verschuift de bewerkingen die volgen.

Filter op status en prodOrderNumber om de regels of de bewerkingen van één order op te halen.

Verwante informatie

• Planning- en assemblage-API
• Toegangsniveaus per module
• Machtigingensets
• Problemen met de API-pagina's oplossen