Beispiel für die Verwendung von eingehenden und ausgehenden Sendungsaufträgen

Hinweis

Azure Active Directory ist jetzt Microsoft Entra ID. Mehr erfahren

Dieser Artikel enthält ein Beispielszenario, das zeigt, wie Sie eingehende und ausgehende Lieferaufträge über die Nachrichtenverarbeitung erstellen. Es werden die Standardbeispieldaten verwendet, die mit der USMF-Beispiel für eine juristische Person (Unternehmen) verknüpft sind.

Den Erstellungsprozess testen

Um den Prozess der Erstellung eingehender und ausgehender Lieferaufträge über Nachrichten auszuprobieren, stellen Sie die Optionen Erstellung manueller Nachrichten zu ausgehenden Lieferaufträgen aktivieren und Erstellung manueller Nachrichten zu eingehenden Lieferungsaufträgen aktivieren auf Ja für einen Quellsystem-Datensatz. Sie können dann Lieferauftragsnachrichten direkt auf den Seiten Nachrichten für ausgehenden Lieferungsauftrag und Nachrichten für eingehenden Lieferungsauftrag erstellen.

Eine weitere schnelle Möglichkeit, Beispielnachrichten zu veröffentlichen, ist die Verwendung von Open Data Protocol (OData)-Anfragen.

In beiden Beispielfällen verarbeitet der Nachrichtenprozessor in Microsoft Dynamics 365 Supply Chain Management die Nachrichten und erstellt die Aufträge im Lagersystem.

Tipp

Um die Prozesse zur Erstellung von Lieferaufträgen über Nachrichten vollständig zu überspringen, können Sie die eingehenden und ausgehenden Lieferaufträge direkt auf den Auftragsseiten erstellen, indem Sie die Option Manuelle Erstellung von eingehenden Lieferungsaufträgen aktivieren und die Einstellungen Manuelle Erstellung von ausgehenden Lieferungsaufträgen aktivieren für ein Quellsystem aktivieren.

Die gleiche Nachrichtenstrukturlogik gilt sowohl für die eingehenden als auch für die ausgehenden Nachrichten zu Lieferaufträgen:

• Auftragskopf

  • Auftragsposition 1

  • Auftragsposition 2

    …

  • Auftragsposition n

• Vollständig

Tipp

Weitere Beispiele für HTTP-Anfragen zum Erstellen von Nachrichten und Integrieren von Bestands- und Produktstammdaten finden Sie im dynamics365scm-warehouse-Repository auf GitHub.

Erforderliche Komponenten

Bevor Sie dieses Beispiel mithilfe einer Supply Chain Management-Umgebung durcharbeiten können, müssen Sie Ihr System folgendermaßen vorbereiten:

• Überprüfen Sie die Versionsanforderungen und aktivieren Sie das Feature wie unter Modus „Nur Lagerortverwaltung“ aktivieren und konfigurieren beschrieben.
• Arbeiten Sie in einem System an, in dem die Standarddemodaten installiert sind, und wählen Sie die juristische Person USMF aus.
• Richten Sie mindestens einen Datensatz auf der Seite Quellsysteme ein. In diesem Beispielszenario wird davon ausgegangen, dass Sie ein Quellsystem eingerichtet haben, in dem das Feld Quellsystem auf ERP gesetzt ist. Weitere Informationen finden Sie unter Ihr Quellsystem konfigurieren.
• Richten Sie die erforderlichen Nummernkreise ein, wie unter Nummernkreise einrichten beschrieben.

Authentifizierung für das Beispiel einrichten

Weisen Sie auf der Seite Microsoft Entra ID-Anwendungen den Administrierendenbenutzenden dem Client zu, der für die Authentifizierung während der Interaktion mit der Supply Chain Management-Umgebung von einer externen Quelle verwendet wird. Alternativ können Sie einen anderen Benutzenden zuweisen, der über Authentifizierungszugriff auf die Integrationsnachrichten verfügt, z. B. die Standardrolle Integrationsoperator des Lagerortsystems. Wenn Sie denselben Benutzenden im Rahmen des Produktmasterdatenimports verwenden, müssen der Rolle Integrationsoperator des Lagerortsystems weitere Berechtigungen hinzugefügt werden, die sich auf Produktmasterdatenentitäten beziehen.

Wenn Sie Entitäten über OData veröffentlichen, müssen Sie sicherstellen, dass entweder das Standardunternehmen des Benutzenden mit dem Unternehmen übereinstimmt, an das die Entität gesendet wird, oder dass das Unternehmen (dataAreaId-Wert) in den Anforderungsnutzdatennachrichten angegeben ist. In beiden Fällen können Nachrichten zu Lieferaufträgen nur abgeschlossen werden, wenn das Unternehmen (dataAreaId-Wert) angegeben ist.

Nachrichten zu Lieferaufträgen erstellen

Beispiel für eine einfache Nachricht zu einem eingehenden Lieferauftrag

Für die InboundShipmentOrderMessages-Kopfzeilennachricht des eingehenden Lieferauftrags müssen Sie mindestens die folgenden Daten angeben:

• MessageId: M1
• dataAreaId: USMF (Optional, abhängig vom Unternehmen des Standardautorisierungsbenutzers)
• SourceSystemId: ERP
• OrderNumber: IO1
• ReceivingWarehouseId: 51

Wenn Sie Variablen verwenden, sieht die InboundShipmentOrderMessages-Nachricht wie im folgenden Beispiel aus.

POST {{resource}}/data/InboundShipmentOrderMessages
{
"MessageId": "{{MessageId}}",
"dataAreaId": "{{dataAreaId}}",
"SourceSystemId": "{{SourceSystem}}",
"OrderNumber": "{{OrderNumber}}",
"ReceivingWarehouseId": "{{Warehouse}}"
}

Die InboundShipmentOrderLineMessages-Nachricht sieht wie im folgenden Beispiel aus.

POST {{resource}}/data/InboundShipmentOrderLineMessages
{
"MessageId": "{{MessageId}}",
"dataAreaId": "{{dataAreaId}}",
"SourceSystemId": "{{SourceSystem}}",
"OrderNumber": "{{OrderNumber}}",
"OrderLineNumber": 1,
"ItemNumber": "A0001",
"ExpectedQuantity": 10,
"ExpectedUnitSymbol": "Pcs"
}

Um die Nachrichten festzuschreiben, stellen Sie eine vollständige Nachricht für die Kopfzeile und die Positionen bereit. Die vollständige Nachricht sieht in etwa wie im folgenden Beispiel aus.

POST {{resource}}/data/InboundShipmentOrderMessages(MessageId='{{MessageId}}', dataAreaId='{{dataAreaId}}',SourceSystemId='{{SourceSystem}}', OrderNumber='{{OrderNumber}}')/Microsoft.Dynamics.DataEntities.Complete?cross-company=true

Schein

Der dataAreaId-Wert wird als Teil des Schlüssels zum Abgleich mit den freigegebenen Kopfzeilen- und Positionsnachrichten verwendet. Deshalb muss der dataAreaId-Wert muss angegeben werden. Das Suffix ?cross-company=true ist nur für Nachrichten erforderlich, bei denen sich das Unternehmen von dem Standardunternehmen des Benutzenden unterscheidet, das auf der Seite Microsoft Entra ID-Anwendungen eingerichtet ist.

Beispiel für eine einfache Nachricht zu einem ausgehenden Lieferauftrag

Für die OutboundShipmentOrderMessages-Kopfzeilennachricht des ausgehenden Lieferauftrags müssen Sie mindestens die folgenden Daten angeben:

• MessageId: M2
• dataAreaId: USMF (Optional, abhängig vom Unternehmen des Standardautorisierungsbenutzers)
• SourceSystemId: ERP
• OrderNumber: OO1
• ShipFromWarehouseId: 51
• ConsigneeName oder ReceiverName: Microsoft
• ConsigneeCountryRegionId oder ReceiverCountryRegionId: USA

Wenn Sie Variablen verwenden, sieht die OutboundShipmentOrderMessages-Nachricht wie im folgenden Beispiel aus.

POST {{resource}}/data/OutboundShipmentOrderMessages
{
"MessageId": "{{MessageId}}",
"dataAreaId": "{{dataAreaId}}",
"SourceSystemId": "{{SourceSystem}}",
"OrderNumber": "{{OrderNumber}}",
"ShipFromWarehouseId": "{{Warehouse}}",
"ConsigneeName": "{{ConsigneeName}}",
"ConsigneeCountryRegionId": "{{ConsigneeCountryRegionId}}"
}

Die OutboundShipmentOrderLineMessages-Nachricht sieht wie im folgenden Beispiel aus.

POST {{resource}}/data/OutboundShipmentOrderLineMessages
{
"MessageId": "{{MessageId}}",
"dataAreaId": "{{dataAreaId}}",
"SourceSystemId": "{{SourceSystem}}",
"OrderNumber": "{{OrderNumber}}",
"OrderLineNumber": 1,
"ItemNumber": "A0001",
"OrderedQuantity": 10,
"OrderedUnitSymbol": "Pcs"
}

Um die Nachrichten festzuschreiben, stellen Sie eine vollständige Nachricht für die Kopfzeile bereit. Die vollständige Nachricht sieht in etwa wie im folgenden Beispiel aus.

POST {{resource}}/data/OutboundShipmentOrderMessages(MessageId='{{MessageId}}', dataAreaId='{{dataAreaId}}',SourceSystemId='{{SourceSystem}}', OrderNumber='{{OrderNumber}}')/Microsoft.Dynamics.DataEntities.Complete?cross-company=true

Schein

Der dataAreaId-Wert wird als Teil des Schlüssels zum Abgleich mit den freigegebenen Kopfzeilen- und Positionsnachrichten verwendet. Deshalb muss der dataAreaId-Wert muss angegeben werden. Das Suffix ?cross-company=true ist nur für Nachrichten erforderlich, bei denen sich das Unternehmen von dem Standardunternehmen des Benutzenden unterscheidet, das auf der Seite Microsoft Entra ID-Anwendungen eingerichtet ist.

Nachrichten der Nachrichtenverarbeitung für Lieferaufträge

Nachdem die beiden Dokumente in die Nachrichtenwarteschlange importiert wurden, müssen Sie die Nachrichtenverarbeitung verwenden, um sie zu bearbeiten und die eigentlichen eingehenden und ausgehenden Lieferaufträge erstellen.