Esimerkki saapuvien ja lähtevien lähetystilausten käyttämisestä

Muistiinpano

Azure Active Directory on nyt Microsoft Entra ID. Lisätietoja

Tämän artikkelin esimerkkiskenaariossa kuvataan, miten luoda tulevia ja lähteviä lähetystilauksia luodaan sanomien käsittelyn kautta. Se käyttää tavallisia näytetietoja, jotka on liitetty USMF-esimerkkioikeushenkilöön (yritykseen).

Luontiprosessin testaaminen

Voit kokeilla saapuvien ja lähtevien lähetystilausten luomisprosessia sanomien avulla määrittämällä asetusten Ota käyttöön manuaalinen lähtevän lähetystilauksen sanoman luonti ja Ota käyttöön manuaalinen saapuvan lähetystilauksen sanoman luonti arvoksi KylläLähdejärjestelmä-tietueen osalta. Tämän jälkeen voit luoda lähetystilaussanomia suoraan lähtevän lähetyksen tilaussanomat ja saapuvatlähetystilaussanomat -sivuilla .

Toinen nopea tapa kirjata esimerkkisanomia on käyttää Open Data Protocol (OData) -pyyntöjä.

Molemmissa esimerkeissä sanomienkäsittelyohjelma Microsoft Dynamics 365 Supply Chain Managementissa käsittelee sanomat ja luo tilaukset varastojärjestelmään.

Vihje

Jos haluat ohittaa lähetystilauksen luontiprosessit sanomien avulla kokonaan, voit luoda saapuvat lähetystilaukset ja lähtevät lähetystilaukset suoraan tilaussivuilla sallimalla asetukset Ota käyttöön manuaalinen saapuvan lähetystilauksen luonti ja Ota käyttöön manuaalinen lähtevän lähetystilauksen luonti lähdejärjestelmän osalta.

Sama viestirakenteen logiikka koskee sekä saapuvia että lähteviä lähetystilausviestejä:

• Tilauksen otsikko

  • Tilausrivi 1

  • Tilausrivi 2

    …

  • Tilausrivi n

• Päätetty

Tässä artikkelissa annetut esimerkkitiedot käyttävät prosessia, joka ei riipu oletusyrityksestä käyttäjien valtuutuksessa. Siksi viesteissä on oltava dataAreaId-arvo.

Edellytykset

Ennen kuin voit käsitellä tätä esimerkkiä käyttämällä Supply Chain Management -ympäristöä, sinun on valmisteltava järjestelmäsi seuraavalla tavalla:

• Tarkista versiovaatimukset ja ota ominaisuus käyttöön kohdassa Ota käyttöön ja määritä vain varastonhallintatilassa kuvatulla tavalla.
• Kirjaudu järjestelmään, johon vakiomuotoiset esittelytiedot on asennettu ja valitse USMF-yritys.
• Määritä vähintään yksi tietue Lähdejärjestelmät-sivulle. Tässä esimerkkiskenaariossa oletetaan, että olet määrittänyt lähdejärjestelmän, jossa Lähdejärjestelmä-kentän arvoksi on asetettu ERP. Lisätietoja kohdasta Määritä lähdejärjestelmäsi.
• Määritä tarvittavat numerosarjat kohdassa Numerosekvenssien määrittäminen kuvatulla tavalla.

Määritä esimerkin todentaminen

Määritä Microsoft Entra ID -sovellukset -sivulla Järjestelmänvalvoja-käyttäjä asiakkaalle, jota käytetään todentamiseen vuorovaikutuksessa tarjonnan kanssa Supply Chain Management -ympäristössä ulkoisesta lähteestä. Vaihtoehtoisesti voit määrittää toisen käyttäjän, jolla on todennusoikeudet, integrointisanomiin, kuten oletusarvoinen Warehouse System Integration Operator -rooli. Jos käytät samaa käyttäjää osana tuotteen perustietojen tuontia, Warehouse System Integration Operator -rooliin on lisättävä enemmän oikeuksia, jotka liittyvät tuotteen perustietokokonaisuuksiin.

Kun lähetät kokonaisuuksia OData-protokollan kautta, sinun on varmistettava, että käyttäjän oletusyritys vastaa yritystä, jolle entiteetti lähetetään, tai että yrityksen (dataAreaId-arvo) on määritetty pyyntöhyötykuormissa. Joka tapauksessa lähetystilausviestit voidaan täyttää vain, jos yrityksen (dataAreaId-arvo) on määritetty.

Luo lähetystilauksen sanomia

Esimerkki yksinkertaisesta saapuvan lähetyksen tilausviestistä

InboundShipmentOrderMessages saapuvan lähetystilauksen otsikkoviestissä sinun on annettava vähintään seuraavat tiedot:

• MessageId: M1
• dataAreaId: USMF (Valinnainen, riippuen valtuutuksen oletuskäyttäjäyrityksestä)
• SourceSystemId: ERP
• OrderNumber: IO1
• ReceivingWarehouseId: 51

-muuttujia käytettäessä InboundShipmentOrderMessages-viesti on seuraavan esimerkin kaltainen.

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

InboundShipmentOrderLineMessages -viesti näyttää seuraavalta esimerkiltä.

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

Jos haluat sitoa viestit, lähetä valmis-viesti otsikolle ja riveille. Valmis viesti näyttää suurin piirtein seuraavalta esimerkiltä.

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

Huomautus

dataAreaId-arvoa käytetään osana avainta vastaamaan vapautettuja otsikko- ja riviviestejä. Siksi dataAreaId-arvo on määritettävä. Suffiksi ?cross-company=true vaaditaan vain viesteissä, joissa yritys eroaa käyttäjän oletusyrityksestä, joka on määritetty Microsoft Entra ID -sovellukset -sivulla.

Esimerkki yksinkertaisesta lähtevän lähetyksen tilausviestistä

OutboundShipmentOrderMessages lähtevän lähetystilauksen otsikkoviestissä sinun on annettava vähintään seuraavat tiedot:

• MessageId: M2
• dataAreaId: USMF (Valinnainen, riippuen valtuutuksen oletuskäyttäjäyrityksestä)
• SourceSystemId: ERP
• OrderNumber: OO1
• ShipFromWarehouseId: 51
• ConsigneeName tai ReceiverName: Microsoft
• ConsigneeCountryRegionId tai ReceiverCountryRegionId: USA

-muuttujia käytettäessä OutboundShipmentOrderMessages-viesti on seuraavan esimerkin kaltainen.

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

OutboundShipmentOrderLineMessages -viesti näyttää seuraavalta esimerkiltä.

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

Jos haluat sitoa viestit, lähetä valmis-viesti otsikolle. Valmis viesti näyttää suurin piirtein seuraavalta esimerkiltä.

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

Huomautus

dataAreaId-arvoa käytetään osana avainta vastaamaan vapautettuja otsikko- ja riviviestejä. Siksi dataAreaId-arvo on määritettävä. Suffiksi ?cross-company=true vaaditaan vain viesteissä, joissa yritys eroaa käyttäjän oletusyrityksestä, joka on määritetty Microsoft Entra ID -sovellukset -sivulla.

Viestikäsittelijän viestit lähetystilauksille

Kun nämä kaksi asiakirjaa on tuotu viestijonoon, sinun on käsiteltävä viestinkäsittelyohjelma ja luotava ne todelliset saapuvat ja lähtevät lähetystilaukset.