Sdílet prostřednictvím

Příklad použití objednávek příchozích a odchozích dodávek

  • Článek

Poznámka

Azure Active Directory je nyní Microsoft Entra ID. Víc se uč

Tento článek obsahuje příklad scénáře, který ukazuje, jak vytvořit příchozí a odchozí objednávky dodávky pomocí zpracování zpráv. Používá standardní vzorová data, která jsou spojena se vzorovou právnickou osobou (společností) USMF.

Jak otestovat proces tvorby

Chcete-li vyzkoušet proces vytváření objednávek příchozích a odchozích dodávek prostřednictvím zpráv, nastavte možnosti Povolit ruční vytváření zprávy odchozí objednávky dodávky a Povolit ruční vytváření zprávy příchozí objednávky dodávky na Ano pro záznam Zdrojový systém. Poté můžete vytvářet zprávy objednávky dodávky přímo na stránkách Zprávy odchozí objednávky dodávky a Zprávy příchozí objednávky dodávky.

Dalším rychlým způsobem, jak zaúčtovat ukázkové zprávy, je použití požadavků Open Data Protocol (OData).

V obou příkladech zpracovatel zpráv zpracovává Microsoft Dynamics 365 Supply Chain Management zprávy a vytváří objednávky ve skladovém systému.

Tip

Chcete-li zcela přeskočit procesy vytváření objednávky dodávky prostřednictvím zpráv, můžete vytvořit příchozí objednávky dodávek a odchozí objednávky dodávek přímo na stránkách objednávek povolením možností Povolit ruční vytváření příchozí objednávky dodávky a Povolit ruční vytváření odchozí objednávky dodávky pro zdrojový systém.

Stejná logika struktury zpráv platí pro příchozí i odchozí zprávy objednávky dodávky:

  • Záhlaví objednávky

    • Řádek objednávky 1

    • Řádek objednávky 2

      …

    • Řádek objednávky n

  • Dokončeno

Tip

Další příklady požadavků HTTP pro vytváření zpráv a integraci hlavních dat zásob a produktů najdete v úložišti dynamics365scm-warehouse na GitHubu.

Předpoklady

Než budete moci projít tímto příkladem pomocí prostředí Supply Chain Management, musíte svůj systém připravit následujícím způsobem:

Nastavení ověřování pro tento příklad

Na stránce Aplikace Microsoft Entra ID přiřaďte uživatele Admin ke klientovi, který se používá pro autentizaci během interakce s prostředím Supply Chain Management z externího zdroje. Případně přiřaďte k integračním zprávám jiného uživatele, který má ověřovací přístup, jako je výchozí role Operátor integrace skladového systému. Pokud v rámci importu hlavních dat produktu použijete stejného uživatele, je třeba do role Operátor integrace skladového systému přidat další oprávnění související s entitami hlavních dat produktu.

Při odesílání entit přes OData musíte zajistit, aby výchozí společnost uživatele odpovídala společnosti, do které bude entita odeslána, nebo aby společnost (hodnota dataAreaId) byla zadána ve zprávách datové části požadavku. V obou případech lze zprávy o objednávce dodávky vyplnit pouze v případě, že je uvedena společnost (hodnota dataAreaId).

Vytvoření zpráv objednávky dodávky

Příklad jednoduché zprávy o objednávce příchozí dodávky

Pro zprávu záhlaví příchozí objednávky dodávky InboundShipmentOrderMessages musíte zadat minimálně následující údaje:

  • MessageId: M1
  • dataAreaId: USMF (volitelné, v závislosti na výchozí společnosti uživatele autorizace)
  • SourceSystemId: ERP
  • OrderNumber: IO1
  • ReceivingWarehouseId: 51

Když použijete proměnné , bude zpráva InboundShipmentOrderMessages vypadat jako v následujícím příkladu.

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

Zpráva InboundShipmentOrderLineMessages vypadá jako v následujícím příkladu.

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

Chcete-li zprávy potvrdit, odešlete úplnou zprávu pro záhlaví a řádky. Úplná zpráva vypadá nějak jako v následujícím příkladu.

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

Poznámka

Hodnota dataAreaId se používá jako součást klíče k porovnání s uvolněnou hlavičkou a řádkovými zprávami. Hodnota dataAreaId proto musí být zadána. Přípona ?cross-company=true je vyžadována pouze pro zprávy, kde se společnost liší od výchozí společnosti uživatele, která je nastavena na stránce Aplikace Microsoft Entra ID.

Příklad jednoduché zprávy o objednávce odchozí dodávky

Pro zprávu záhlaví odchozí objednávky dodávky OutboundShipmentOrderMessages musíte zadat minimálně následující údaje:

  • MessageId: M2
  • dataAreaId: USMF (volitelné, v závislosti na výchozí společnosti uživatele autorizace)
  • SourceSystemId: ERP
  • OrderNumber: OO1
  • ShipFromWarehouseId: 51
  • ConsigneeName nebo ReceiverName: Microsoft
  • ConsigneeCountryRegionId nebo ReceiverCountryRegionId: USA

Když použijete proměnné , bude zpráva OutboundShipmentOrderMessages vypadat jako v následujícím příkladu.

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

Zpráva OutboundShipmentOrderLineMessages vypadá jako v následujícím příkladu.

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

Chcete-li zprávy potvrdit, odešlete úplnou zprávu pro záhlaví. Úplná zpráva vypadá nějak jako v následujícím příkladu.

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

Poznámka

Hodnota dataAreaId se používá jako součást klíče k porovnání s uvolněnou hlavičkou a řádkovými zprávami. Hodnota dataAreaId proto musí být zadána. Přípona ?cross-company=true je vyžadována pouze pro zprávy, kde se společnost liší od výchozí společnosti uživatele, která je nastavena na stránce Aplikace Microsoft Entra ID.

Zprávy procesoru zpráv pro objednávky dodávky

Po importu dvou dokumentů do fronty zpráv, musíte použít procesor zpráv k jejich zpracování a vytvoření samotné příchozí a odchozí objednávky dodávky.