API de production

Microsoft Dynamics 365 Business Central n'a pas d'API standard qui écrit des ordres de fabrication. L'extension MCP Guard ajoute le volet écriture, de sorte qu'un assistant IA peut gérer un tableau de planification : lire des ordres de fabrication, les créer, les modifier et les supprimer, les actualiser et les lancer, et replanifier des opérations. Les pages fonctionnent sur les versions 28 et 29 de Business Central.

Le point de terminaison

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

Seul un ordre de fabrication peut être supprimé. Les lignes et les opérations ne peuvent pas être supprimées séparément.

Ce qu'il faut pour les utiliser

1. Attribuez l'ensemble d'autorisations MCP GUARD - USER. Depuis la version 1.13.0.0, il contient les pages de production, la requête et leur codeunit, et rien sur les données métier. L'ensemble distinct MCP GUARD - PROD n'existe plus. Voir Ensembles d'autorisations.
2. Donnez à l'utilisateur les autorisations propres à Business Central sur les ordres de fabrication. La production exige aussi l'expérience et la licence Premium.
3. Attribuez une licence MCP Guard. Sans licence, les pages refusent l'appel, dans un environnement bac à sable aussi.
4. Définissez Accès production sur la règle de l'utilisateur. Modifier autorise les modifications. Créer et actions autorise aussi la création et la suppression d'ordres et les actions. Voir Niveaux d'accès par module.
5. Ajoutez les pages et la requête à la configuration MCP avec les opérations souhaitées (Read, Create, Modify, Delete, Actions), et activez Unblock Edit Tools. Voir Configurations MCP.

Créer un ordre de fabrication

Envoyez d'abord status, sourceType et sourceNumber, puis quantity et dueDate. L'ordre est enregistré dès que son origine est connue. Les champs qui suivent sont validés sur l'ordre enregistré, comme sur la page Ordre de fabrication. Un ordre de fabrication ne peut pas être créé comme terminé, ni sans numéro d'origine.

Actualiser un ordre de fabrication

refresh et refreshForward recréent les lignes de l'ordre avec leurs gammes et leurs composants, comme la fonction d'actualisation de l'ordre de fabrication avec toutes les options activées. refresh planifie en arrière à partir de la date d'échéance. refreshForward planifie en avant à partir de la date de début. Business Central refuse l'actualisation pour les lignes qui ont déjà une production ou une consommation. Un ordre terminé ne peut pas être actualisé.

Les lignes d'un ordre sont créées par l'actualisation, et non via prodOrderLines.

Lancer un ordre de fabrication

release fait passer un ordre simulé, planifié ou planifié ferme à l'état lancé. Le statut fait partie de la clé d'un ordre de fabrication : l'ordre lancé est donc un autre enregistrement. Il prend son numéro dans la souche de numéros des ordres lancés, qui peut différer du numéro qu'il avait. L'en-tête Location de la réponse pointe vers l'ordre lancé.

Un statut envoyé dans une modification est refusé. Utilisez plutôt l'action release.

Supprimer un ordre de fabrication

Supprimez l'ordre via productionOrders. Trois conditions doivent être remplies :

• La règle de l'utilisateur accorde Créer et actions pour Accès production.
• La configuration MCP a l'opération Delete activée pour la page MCP Guard Prod. Orders API, et Unblock Edit Tools activé.
• L'ordre peut être supprimé dans Business Central.

Les lignes, les composants et la gamme sont supprimés avec l'ordre. Les lignes et les lignes gamme ne peuvent pas être supprimées séparément.

Business Central décide quels ordres peuvent être supprimés :

• Un ordre terminé est conservé. L'extension refuse de le supprimer.
• Un ordre lancé sur lequel une production, une consommation ou une capacité a été validée est refusé par Business Central. Contrepassez ces validations et terminez plutôt l'ordre.

Replanifier une opération

Modifiez la date-heure de début ou de fin d'une opération dans prodOrderRoutingLines, ou donnez-lui un autre centre ou poste de charge avec le type et le numéro. La modification passe par la validation propre à Business Central : Business Central déplace donc les opérations qui suivent.

Pour obtenir les lignes ou les opérations d'un seul ordre, filtrez sur status et prodOrderNumber.

Informations associées

• API de planification et d'assemblage
• Niveaux d'accès par module
• Ensembles d'autorisations
• Résoudre les problèmes des pages API