Eksempel på bruk av innkommende og utgående forsendelsesordrer

Artikkel
07/19/2024

Notat

Azure Active Directory er nå Microsoft Entra ID. Få mer informasjon

Denne artikkelen inneholder et eksempelscenario som viser hvordan du oppretter innkommende og utgående forsendelsesordrer via meldingsbehandling. Den bruker standard eksempeldata som er knyttet til USMF-eksempelet på juridisk enhet (selskap).

Slik tester du opprettelsesprosessen

Hvis du vil prøve å opprette innkommende og utgående forsendelsesordrer via meldinger, angir du alternativet Aktiver manuell oppretting av melding for utgående forsendelsesordre og Aktiver manuell oppretting av melding for innkommende forsendelsesordre til Ja for en Kildesystem-post. Du kan deretter opprette forsendelsesordremeldinger direkte på sidene Bestillingsmeldinger for utgående forsendelse og Innkommende forsendelsesordremeldinger .

En annen rask måte å postere eksempelmeldinger på, er å bruke Åpen dataprotokoll (OData)-forespørsler.

I begge eksempeltilfeller behandler meldingsbehandleren meldingene Microsoft Dynamics 365 Supply Chain Management og oppretter ordrene i lagersystemet.

Tips

Hvis du vil hoppe over forsendelsesordreopprettingsprosessene via meldinger helt, kan du opprette de innkommende forsendelsesordrene og utgående forsendelsesordrer direkte på ordresidene ved å tillate Aktiver manuell oppretting av innkommende forsendelsesordre og Aktiver oppretting av manuell forsendelsesordre-innstillingen for et kildesystem.

Den samme meldingsstrukturlogikken gjelder for både innkommende og utgående forsendelsesordremeldinger:

Ordrehode
- Ordrelinje 1
- Ordrelinje 2
  
  …
- Ordrelinje n
Fullfør

Tips

Hvis du vil ha flere eksempler på HTTP-forespørsler for å opprette meldinger og integrere lager- og produktstandarddata, kan du gå til lagerrepositoriet for dynamics365scm på GitHub.

Nødvendig programvare

Før du kan gå gjennom dette eksemplet ved å bruke et Supply Chain Management-miljø, må du forberede systemet på følgende måte:

Sjekk versjonskravene, og aktiver funksjonen som beskrevet i Aktiver og konfigurer bare lagerstyringsmodus.
Arbeid i et system der standard demodata er installert, og velg den juridiske enheten USMF.
Sett opp minst én post på siden Kildesystemer. Dette eksempelscenarioet forutsetter at du har satt opp et kildesystem der Kildesystem-feltet er satt til ERP. Hvis du vil ha mer informasjon, se Konfigurere kildesystemer.
Sett opp de nødvendige nummersekvensene som beskrevet i Sett opp nummersekvenser.

Konfigurere godkjenning for eksemplet

På Microsoft Entra ID-aååer-siden tilordne Admin-bruker til klienten som brukes til autentisering under interaksjon med Supply Chain Management-miljøet fra en ekstern kilde. Alternativt kan du tilordne en annen bruker som har autentiseringstilgang til integreringsmeldingene, for eksempel standard Integreringsoperatør for lagersystem-rolle. Hvis du bruker samme bruker som en del av importen av produkthoveddata, må flere privilegier som er relatert til produkthoveddataenheter legges til Integreringsoperatør for lagersystem-rollen.

Når du legger ut enheter via OData, må du enten sørge for at brukerens standardselskap samsvarer med selskapet som enheten skal postes til, eller at selskapet (dataAreaId-verdi) er spesifisert i forespørselsnyttelastmeldingene. Uansett kan meldinger om forsendelsesordre bare fylles ut hvis selskapet (dataAreaId-verdi) er spesifisert.

Opprette forsendelsesordremeldinger

Eksempel på en enkel ordremelding for inngående forsendelse

For den InboundShipmentOrderMessages-meldingen for innkommende forsendelsesordre må du minimum oppgi følgende data:

MessageId: M1
dataAreaId: USMF (valgfritt, avhengig av standard autorisasjonsbrukerfirma)
SourceSystemId: ERP
OrderNumber: IO1
ReceivingWarehouseId: 51

Når du bruker variabler, ser InboundShipmentOrderMessages-meldingen ut som i følgende eksempel.

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

InboundShipmentOrderLineMessages-meldingen ser ut som følgende eksempel.

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

For å overføre meldingene, legg inn en fullstendig melding for overskriften og linjene. Den fullstendige meldingen ser omtrent ut som følgende eksempel.

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

Merknad

dataAreaId-verdien brukes som en del av nøkkelen for å matche mot den frigitte overskriften og linjemeldingene. Derfor må dataAreaId-verdien angis. Suffikset ?cross-company=true er bare påkrevd for meldinger der selskapet skiller seg fra brukerens standardselskap som er satt opp på Microsoft Entra ID-applikasjoner-siden.

Eksempel på en enkel ordremelding for utgående forsendelse

For OutboundShipmentOrderMessages-meldingen for utgående forsendelsesordre må du minimum oppgi følgende data:

MessageId: M2
dataAreaId: USMF (valgfritt, avhengig av standard autorisasjonsbrukerfirma)
SourceSystemId: ERP
OrderNumber: OO1
ShipFromWarehouseId: 51
ConsigneeName eller ReceiverName: Microsoft
ConsigneeCountryRegionId eller ReceiverCountryRegionId: USA

Når du bruker variabler, ser OutboundShipmentOrderMessages-meldingen ut som i følgende eksempel.

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

OutboundShipmentOrderLineMessages-meldingen ser ut som følgende eksempel.

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

For å overføre meldingene, legg inn en fullstendig melding for overskriften. Den fullstendige meldingen ser omtrent ut som følgende eksempel.

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

Merknad

Meldingsbehandlermeldinger for forsendelsesordrer

Etter at de to dokumentene er importert til meldingskøen, må du bruke meldingsprosessoren for å behandle dem og opprette de faktiske innkommende og utgående forsendelsesordrene.

Del via