Esimerkki saapuvien ja lähtevien lähetystilausten käyttämisestä
Muistiinpano
Azure Active Directory on nyt Microsoft Entra ID. Opi lisää
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 saapuvat lähetystilaussanomat -sivuilla .
Toinen nopea tapa kirjata esimerkkisanomia on käyttää Open Data Protocol (OData) -pyyntöjä.
Molemmissa tapauksissa sanoman käsittelijä käsittelee Microsoft Dynamics 365 Supply Chain Management 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
Viimeistele
Vihje
Lisätietoja sanomien luomista ja varaston ja tuotteen perustietojen integroimista varten on dynamics365scm-varastotietovaraston Eri Kenttä -sivulla.
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
: M1dataAreaId
: US SEN MUKAAN , mikä on oletuslupakäyttäjän yritys)SourceSystemId
: ERPOrderNumber
: IO1ReceivingWarehouseId
hinta: 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
: M2dataAreaId
: US SEN MUKAAN , mikä on oletuslupakäyttäjän yritys)SourceSystemId
: ERPOrderNumber
: SEN VOI MYÖS TEHDÄ: SEN VOI MYÖS TEHDÄ.ShipFromWarehouseId
hinta: 51ConsigneeName
taiReceiverName
: MicrosoftConsigneeCountryRegionId
taiReceiverCountryRegionId
: 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.