แชร์ผ่าน

ตัวอย่างของการใช้ใบสั่งการจัดส่งขาเข้าและขาออก

  • บทความ

หมายเหตุ

Azure Active Directory ตอนนี้เป็น Microsoft Entra ID เรียนรู้เพิ่มเติม

บทความนี้แสดงตัวอย่างสถานการณ์ที่แสดงวิธีการสร้างใบสั่งการจัดส่งขาเข้าและขาออกผ่านทางการประมวลผลข้อความ โดยใช้ข้อมูลตัวอย่างมาตรฐานที่เกี่ยวข้องกับตัวอย่างนิติบุคคล (บริษัท) USMF

วิธีการทดสอบกระบวนการสร้าง

หากต้องการลองใช้กระบวนการสร้างสำหรับใบสั่งการจัดส่งขาเข้าและขาออกผ่านทางข้อความ ให้ตั้งค่าตัวเลือก เปิดใช้งานการสร้างข้อความใบสั่งการจัดส่งขาออกด้วยตนเอง และ เปิดใช้งานการสร้างข้อความใบสั่งการจัดส่งขาเข้าด้วยตนเอง เป็น ใช่ สำหรับเรกคอร์ดของ ระบบต้นทาง จากนั้น คุณสามารถสร้างข้อความใบสั่งการจัดส่งโดยตรงบนข้อความใบสั่ง จัดส่งขาออก และ หน้าข้อความของใบสั่งจัดส่ง ขาเข้าได้

วิธีด่วนอีกวิธีในการโพสต์ข้อความตัวอย่างคือ การใช้คำขอ Open Data Protocol (OData)

ในทั้งสองตัวอย่าง ตัวประมวลผลข้อความ ใน Microsoft Dynamics 365 Supply Chain Management จะประมวลผลข้อความ และใบสั่งในระบบคลังสินค้า

คำแนะนำ

หากต้องการข้ามกระบวนการสร้างใบสั่งการจัดส่งผ่านทางข้อความทั้งหมด คุณสามารถสร้างใบสั่งการจัดส่งขาเข้าและใบสั่งการจัดส่งขาออกได้โดยตรงบนหน้าใบสั่งโดยอนุญาตการตั้งค่า เปิดใช้งานการสร้างใบสั่งการจัดส่งขาเข้าด้วยตนเอง และ เปิดใช้งานการสร้างใบสั่งการจัดส่งขาออกด้วยตนเอง สำหรับระบบต้นทาง

ตรรกะโครงสร้างข้อความเดียวกันนี้ใช้กับข้อความใบสั่งการจัดส่งทั้งขาเข้าและขาออก:

  • ส่วนหัวของใบสั่ง

    • รายการใบสั่ง 1

    • รายการใบสั่ง 2

      …

    • รายการใบสั่ง n

  • เสร็จสมบูรณ์

คำแนะนำ

หากต้องการตัวอย่างเพิ่มเติมเกี่ยวกับการร้องขอ HTTP ในการสร้างข้อความและการรวมข้อมูลสินค้าคงคลังและผลิตภัณฑ์หลัก ให้ไปที่ที่เก็บในคลังสินค้า dynamics365scm บน GitHub

ข้อกำหนดเบื้องต้น

ก่อนที่คุณจะสามารถทำงานได้ตามตัวอย่างนี้โดยใช้สภาพแวดล้อม Supply Chain Management คุณต้องเตรียมระบบของคุณในลักษณะต่อไปนี้:

ตั้งค่าการรับรองความถูกต้องสำหรับตัวอย่าง

ในหน้า แอปพลิเคชัน Microsoft Entra ID ให้กำหนดผู้ใช้ที่เป็นผู้ดูแลระบบให้กับไคลเอ็นต์ที่ใช้สำหรับการตรวจสอบสิทธิ์ระหว่างการโต้ตอบกับสภาพแวดล้อม Supply Chain Management แหล่งภายนอก หรือกำหนดผู้ใช้รายอื่นที่มีสิทธิ์เข้าถึงข้อความการรวม เช่น บทบาทผู้ดำเนินการรวมระบบคลังสินค้าเริ่มต้น หากคุณใช้ผู้ใช้รายเดียวกันเป็นส่วนหนึ่งของการนำเข้าข้อมูลหลักของผลิตภัณฑ์ จะต้องเพิ่มสิทธิ์การใช้งานเพิ่มเติมที่เกี่ยวข้องกับเอนทิตีข้อมูลหลักของผลิตภัณฑ์ให้กับบทบาท ผู้ดำเนินงานการรวมระบบคลังสินค้า

เมื่อคุณลงรายการเอนทิตีผ่าน OData คุณต้องตรวจสอบให้แน่ใจว่าบริษัทเริ่มต้นของผู้ใช้ตรงกับบริษัทที่เอนทิตีจะถูกลงรายการไป หรือบริษัท (ค่า dataAreaId) ถูกระบุไว้ในข้อความเพย์โหลดของคำขอ ไม่ว่าจะด้วยวิธีใด ข้อความใบสั่งการจัดส่งจะเสร็จสมบูรณ์ได้ก็ต่อเมื่อมีการระบุบริษัท (ค่า dataAreaId)

สร้างข้อความใบสั่งการจัดส่ง

ตัวอย่างข้อความใบสั่งการจัดส่งขาเข้าแบบง่าย

สำหรับข้อความส่วนหัวของใบสั่งการจัดส่งขาเข้า InboundShipmentOrderMessages คุณต้องระบุข้อมูลต่อไปนี้เป็นอย่างน้อย:

  • MessageId: M1
  • dataAreaId: USMF (เป็นทางเลือก ขึ้นอยู่กับบริษัทผู้ใช้การอนุญาตเริ่มต้น)
  • SourceSystemId: ERP
  • OrderNumber: IO1
  • ReceivingWarehouseId: 51

เมื่อคุณใช้ตัวแปร ข้อความ InboundShipmentOrderMessages จะมีลักษณะเหมือนตัวอย่างต่อไปนี้

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

ข้อความ InboundShipmentOrderLineMessages มีลักษณะเหมือนตัวอย่างต่อไปนี้

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

หากต้องการส่งข้อความ ให้โพสต์ข้อความ สมบูรณ์ สำหรับส่วนหัวและบรรทัด ข้อความเสร็จสมบูรณ์มีลักษณะเหมือนตัวอย่างต่อไปนี้

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

หมายเหตุ

ค่า dataAreaId ถูกใช้เป็นส่วนหนึ่งของคีย์เพื่อจับคู่กับส่วนหัวและข้อความบรรทัดที่เผยแพร่ ดังนั้น ต้องระบุค่า dataAreaId ต้องมีคำต่อท้าย ?cross-company=true สำหรับข้อความที่บริษัทแตกต่างจากบริษัทเริ่มต้นของผู้ใช้ที่ตั้งค่าไว้ในหน้า แอปพลิเคชัน Microsoft Entra ID

ตัวอย่างข้อความใบสั่งการจัดส่งขาออกแบบง่าย

สำหรับข้อความส่วนหัวของใบสั่งการจัดส่งขาออก OutboundShipmentOrderMessages คุณต้องระบุข้อมูลต่อไปนี้เป็นอย่างน้อย:

  • MessageId: M2
  • dataAreaId: USMF (เป็นทางเลือก ขึ้นอยู่กับบริษัทผู้ใช้การอนุญาตเริ่มต้น)
  • SourceSystemId: ERP
  • OrderNumber: OO1
  • ShipFromWarehouseId: 51
  • ConsigneeName หรือ ReceiverName: Microsoft
  • ConsigneeCountryRegionId หรือ ReceiverCountryRegionId: USA

เมื่อคุณใช้ตัวแปร ข้อความ OutboundShipmentOrderMessages จะมีลักษณะเหมือนตัวอย่างต่อไปนี้

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

ข้อความ OutboundShipmentOrderLineMessages มีลักษณะเหมือนตัวอย่างต่อไปนี้

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

หากต้องการส่งข้อความ ให้โพสต์ข้อความ สมบูรณ์ สำหรับส่วนหัว ข้อความเสร็จสมบูรณ์มีลักษณะเหมือนตัวอย่างต่อไปนี้

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

หมายเหตุ

ค่า dataAreaId ถูกใช้เป็นส่วนหนึ่งของคีย์เพื่อจับคู่กับส่วนหัวและข้อความบรรทัดที่เผยแพร่ ดังนั้น ต้องระบุค่า dataAreaId ต้องมีคำต่อท้าย ?cross-company=true สำหรับข้อความที่บริษัทแตกต่างจากบริษัทเริ่มต้นของผู้ใช้ที่ตั้งค่าไว้ในหน้า แอปพลิเคชัน Microsoft Entra ID

ข้อความตัวประมวลผลข้อความสำหรับใบสั่งการจัดส่ง

หลังจากที่เอกสารทั้ง 2 ฉบับได้นำเข้าเข้ามาในคิวข้อความแล้ว คุณต้องใช้ตัวประมวลผลข้อความ เพื่อประมวลผลและสร้างใบสั่งการจัดส่งขาเข้าและขาออกตามจริง