इसके माध्यम से साझा किया गया

API के माध्यम से Intelligent Order Management पूर्ति ऑप्टिमाइज़ेशन इंजिन (DOM) को कॉल करें

अप्रैल 2023 रिलीज़ के भाग के रूप में, आप एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस (API) के माध्यम से बिक्री ऑर्डर ऑर्केस्ट्रेशन के बाहर से पूर्ति अनुकूलन इंजन (DOM) को कॉल कर सकते हैं। Microsoft Dynamics 365 Intelligent Order Management कोई भी प्लेटफॉर्म, जैसे कि ई-कॉमर्स, मार्केटप्लेस, या एंटरप्राइज रिसोर्स प्लानिंग (ईआरपी) प्लेटफॉर्म, इष्टतम पूर्ति स्रोत प्राप्त करने के लिए इंटेलिजेंट ऑर्डर मैनेजमेंट को एपीआई अनुरोध कर सकता है, साथ ही शिपिंग विकल्प जैसे कि वाहक शिपिंग दरें और अनुमानित डिलीवरी तिथि की जानकारी भी प्राप्त कर सकता है। यदि आप केवल पूर्ति योजना चाहते हैं, तो API अनुरोध में कम से कम शिपिंग पता, उत्पाद और मात्रा शामिल होनी चाहिए। यदि आप पूर्ति योजना के अतिरिक्त वाहक की शिपिंग दरें और अनुमानित डिलीवरी तिथियां भी जानना चाहते हैं, तो आपको वाहक को जानकारी देनी होगी। वर्तमान में, शिपिंग दरें प्राप्त करने के लिए FedEx दर API को कॉल करने के लिए API का निर्माण किया गया है। हालाँकि, पेलोड प्रतिक्रिया किसी भी वाहक के लिए सामान्य है।

आवश्यक शर्तें

API के माध्यम से इंटेलिजेंट ऑर्डर मैनेजमेंट फ़ुलफ़िलमेंट ऑप्टिमाइज़ेशन इंजन (DOM) का उपयोग करने से पहले निम्नलिखित पूर्वापेक्षाएँ पूरी होनी चाहिए:

  • इंटेलिजेंट ऑर्डर मैनेजमेंट का नवीनतम संस्करण (संस्करण 1.0.0.6035) स्थापित करें।
  • पूर्ति सेटिंग्स सेट करें, जैसे कि रणनीतियाँ, स्रोत सूचियाँ और बाधाएँ. अधिक जानकारी के लिए, पूर्ति और रिटर्न अनुकूलन प्रदाता अवलोकन देखें।
  • एक इन्वेंट्री दृश्यता प्रदाता स्थापित करें. अधिक जानकारी के लिए, इन्वेंट्री दृश्यता देखें.
  • सुनिश्चित करें कि वेयरहाउस आईडी को पूर्ति स्रोत सेटिंग में प्रत्येक पूर्ति स्रोत से मैप किया गया है.

यदि आप FedEx वाहक से शिपिंग विकल्प वाले परिणामों की अपेक्षा कर रहे हैं, तो आपको यह सुनिश्चित करना होगा कि निम्नलिखित सेटअप पूरा हो गया है।

  1. एक FedEx प्रदाता स्थापित करें. अधिक जानकारी के लिए, देखें FedEx प्रदाता सेट अप करें.
  2. सेटिंग्स>पूर्ति सेटिंग्स>छुट्टियों का कैलेंडर पर जाकर छुट्टियों का कैलेंडर सेट करें.
  3. सेटिंग>पूर्ति सेटिंग>शिपिंग वाहक पर वाहक पिकअप शेड्यूल सेट करें। वाहक का चयन करें, पिकअप शेड्यूल पर जाएं, और नया पिकअप शेड्यूल जोड़ें।
  4. सुनिश्चित करें कि कम से कम एक कैलेंडर और पिकअप शेड्यूल पूर्ति स्रोत सेटिंग को असाइन किया गया है।
  5. सुनिश्चित करें कि वजन और आयाम उत्पाद की साझा उत्पाद तालिका में हैं।
  6. सुनिश्चित करें कि वाहक की शिपिंग दर कारक तालिका शिपिंग दर कारक और फ़ॉलबैक दर जानकारी के साथ अद्यतन की गई है। शिपिंग दर कारक तालिकाओं तक पहुंचने के लिए, सेटिंग >पूर्ति सेटिंग >शिपिंग वाहक >शिपिंग दर कारक पर जाएं।

कार्यक्षमता विवरण

जब API अनुरोध किया जाता है, तो पूर्व-कॉन्फ़िगर की गई पूर्ति अनुकूलन रणनीतियों और बाधाओं के आधार पर, प्रत्येक पंक्ति के लिए सर्वोत्तम पूर्ति स्रोत को वापस करने के लिए इंटेलिजेंट ऑर्डर मैनेजमेंट पूर्ति अनुकूलन इंजन (DOM) को आमंत्रित किया जाता है। यदि अनुरोध में FedEx जैसा कोई वाहक शामिल है, तो वाहक पिकअप शेड्यूल को पूर्ति स्रोत के कार्य कैलेंडर के साथ देखा जाता है, और अगला उपलब्ध पिकअप समय वाहक API को भेजा जाता है। DOM API की प्रतिक्रिया पूर्ति योजना और वाहक आउटपुट दोनों को जोड़ती है, और उन्हें कॉलिंग एप्लिकेशन को वापस प्रस्तुत करती है।

नमूना API अनुरोध

अपने परिवेश में परीक्षण करने के लिए एक प्रवाह-से-अनबाउंड क्रिया बनाएँ। Power Automate Dataverse 

{{Dataverse URL}}/api/data/v9.2/msdyn_IomDomAPI  
**apiVersion**: 1.0 
{ 
    "fnoCompanyId": "USMF", 
    "orderId": "b16bd573-ad9a-4188-bc08-e5ac5eca776e", 
    "strategyId": null, 
    "carrier": "fedex", 
    "salesOrderOrigin": null, 
    "customerInformation": { 
        "name": "Whole sales", 
        "customerNumber": "US-001", 
        "customerGroup": "10", 
        "customerEmail": "test@microsoft.com" 
    }, 
    "orderDestinationAddress": { 
        "addressType": "Residence", 
        "address1": "537 N St. Francis", 
        "address2": null, 
        "address3": null, 
        "city": "Wichita", 
        "stateOrProvince": "KS", 
        "postalCode": "67214", 
        "phoneNumber": null, 
        "country": "US" 
    }, 
    "lineItems": [ 
        { 
            "lineId": "d5670621-910d-486b-90ca-61d739e9a92e", 
            "itemId": "1000", 
            "quantity": 2, 
            "freeShipping": "No" 
        }, 
        { 
            "lineId": "5c8b423b-c9fe-4ff1-a16e-a75a35d7c424", 
            "itemId": "T0001", 
            "quantity": 2, 
            "freeShipping": "Yes", 
            "dimensions": { 
                "sizeId": "10" 
            } 
        }, 
        { 
            "lineId": "a359a0ec-cded-4eda-b7b0-d7478dff48b9", 
            "itemId": "T0004", 
            "quantity": 2, 
            "freeShipping": "Yes", 
            "dimensions": { 
                "colorId": "black" 
            } 
        } 
    ] 
}

नमूना प्रतिक्रिया

Fulfillment Successful 
{ 
    "fulfillmentPlan": { 
        "executionId": "616d8797-0654-4ca7-bae2-c4771521e5f4", 
        "planLines": [ 
            { 
                "orderId": "47c1c1c6-5cc7-4691-a0ae-b50b83b2bba1", 
                "lineId": "34d8209b-3a4b-4c54-a666-76fef99bef63", 
                "quantityToFulfill": 1.0, 
                "orderedQuantity": 1.0, 
                "fulfillmentCenter": "127", 
                "itemId": "1000" 
            } 
        ], 
        "notFulfilledLines": [] 
    } 
}

एपीआई संदर्भ गाइड

यह अनुभाग API अनुरोध में डेटा प्रकार और हेडर फ़ील्ड का वर्णन करता है।

नाम डेटा प्रकार वर्णन
fnoकंपनीआईडी स्ट्रिंग, वैकल्पिक सिस्टम में कंपनी के लिए पहचानकर्ता. यह फ़ील्ड आवश्यक है यदि Dataverse वित्त और संचालन ऐप्स से जुड़ा हुआ है।
बिक्रीऑर्डरमूल स्ट्रिंग, वैकल्पिक सिस्टम में ऑर्डर मूल के लिए पहचानकर्ता. यह फ़ील्ड आवश्यक है यदि इन्वेंट्री को ऑर्डर मूल के आधार पर आवंटित से उपभोग करना है।
आदेश कामतत्व Guid स्ट्रिंग, आवश्यक उपयोगकर्ता द्वारा निर्धारित ऑर्डर संख्या जिसका उपयोग मूल सिस्टम में ऑर्डर या कार्ट आईडी की पहचान करने के लिए किया जाता है।
रणनीतिआईडी Guid स्ट्रिंग, वैकल्पिक बुद्धिमान ऑर्डर प्रबंधन में पूर्ति रणनीति के लिए पहचानकर्ता. यदि यह पहचानकर्ता प्रदान नहीं किया गया है, तो प्रक्रिया सिस्टम में परिभाषित डिफ़ॉल्ट रणनीति का उपयोग करती है।
वाहक स्ट्रिंग, वैकल्पिक शिपिंग दरें और पूर्वानुमानित डिलीवरी अनुमान प्राप्त करने के लिए यह फ़ील्ड आवश्यक है। समर्थित मान FedEx है.
आर्डरगंतव्यपता पता, आवश्यक प्राप्तकर्ता का शिपिंग पता. पता मॉडल का उपयोग करें.
ग्राहक सूचना ग्राहक जानकारी, वैकल्पिक ऑर्डर के लिए ग्राहक जानकारी. ग्राहक सूचना मॉडल का उपयोग करें.
लाइन आइटम ऑर्डर विवरण, आवश्यक ऑर्डर विवरण ऑब्जेक्ट्स की एक सरणी. ऑर्डर विवरण मॉडल की एक सरणी का उपयोग करें.

नमूना

यह अनुभाग उन फ़ील्ड का वर्णन करता है जो API अनुरोध में डेटा मॉडल का उपयोग करते हैं.

पता

यह अनुभाग API अनुरोध में पता ऑब्जेक्ट में फ़ील्ड का वर्णन करता है।

नाम डेटा प्रकार वर्णन
पता मुद्रलेख स्ट्रिंग, वैकल्पिक, मान: व्यवसाय, निवास, कोई भी वह मान जो यह बताता है कि निर्दिष्ट पता आवासीय है या नहीं।
नाम स्ट्रिंग, वैकल्पिक व्यक्ति का नाम.
पता 1 स्ट्रिंग, वैकल्पिक पते की पहली पंक्ति.
पता द्वितीय स्ट्रिंग, वैकल्पिक पते की दूसरी पंक्ति.
पता3 स्ट्रिंग, वैकल्पिक पते की तीसरी पंक्ति.
शहर स्ट्रिंग, आवश्यक शहर।
राज्य या प्रांत स्ट्रिंग, आवश्यक राज्य या प्रान्त। दो-अक्षर का ISO मूल राज्य कोड आवश्यक है।
डाक कोड स्ट्रिंग, आवश्यक डाक कोड.
देश स्ट्रिंग, आवश्यक देश या क्षेत्र कोड. दो-अक्षर का ISO मूल देश कोड आवश्यक है।
फ़ोन नंबर स्ट्रिंग, वैकल्पिक टेलीफोन नंबर।

ऑर्डर विवरण

यह अनुभाग API अनुरोध के ऑर्डर विवरण अनुभाग में फ़ील्ड का वर्णन करता है।

नाम डेटा प्रकार वर्णन
लाइन आईडी Guid स्ट्रिंग, आवश्यक मूल सिस्टम में ऑर्डर लाइन के लिए पहचानकर्ता.
सामान आईडी स्ट्रिंग, आवश्यक इस लाइन आइटम से संबद्ध उत्पाद का नाम. मान शून्य नहीं हो सकता.
मात्रा संख्या, आवश्यक ऑर्डर किये गये उत्पादों की मात्रा.
मुफ़्त शिपिंग स्ट्रिंग, वैकल्पिक, मान: हाँ, नहीं का मान हाँ इसका अर्थ यह है कि दर अनुरोध किए जाने पर उत्पाद का वजन शामिल नहीं किया जाता है।
DIMENSIONS उत्पाद आयाम, वैकल्पिक उत्पाद आयाम वे विशेषताएं हैं जो किसी उत्पाद संस्करण की पहचान कराती हैं। वे उत्पाद आयाम मॉडल का उपयोग करते हैं। यह फ़ील्ड आवश्यक है यदि Dataverse वित्त और संचालन ऐप्स से जुड़ा हुआ है। उत्पाद प्रकार की पहचान करने के लिए उत्पाद आयाम का चयन करें.

उत्पाद के आयाम

यह अनुभाग उत्पाद आयाम तालिका में फ़ील्ड का वर्णन करता है।

नाम डेटा प्रकार वर्णन
रंगआईडी स्ट्रिंग, वैकल्पिक आइटम के रंग का मान. यह फ़ील्ड आवश्यक है यदि Dataverse वित्त और संचालन ऐप्स से जुड़ा हुआ है। उस उत्पाद संस्करण की पहचान करने के लिए उत्पाद आयाम चुनें जिसके साथ आप काम करना चाहते हैं.
आकारआईडी स्ट्रिंग, वैकल्पिक आइटम आकार का मान. यह फ़ील्ड आवश्यक है यदि Dataverse वित्त और संचालन ऐप्स से जुड़ा हुआ है। उस उत्पाद संस्करण की पहचान करने के लिए उत्पाद आयाम चुनें जिसके साथ आप काम करना चाहते हैं.
स्टाइलआईडी स्ट्रिंग, वैकल्पिक आइटम शैली का मान. यह फ़ील्ड आवश्यक है यदि Dataverse वित्त और संचालन ऐप्स से जुड़ा हुआ है। उस उत्पाद संस्करण की पहचान करने के लिए उत्पाद आयाम चुनें जिसके साथ आप काम करना चाहते हैं.
कॉन्फ़िगरेशनआईडी स्ट्रिंग, वैकल्पिक आइटम कॉन्फ़िगरेशन का मान. यह फ़ील्ड आवश्यक है यदि Dataverse वित्त और संचालन ऐप्स से जुड़ा हुआ है। उस उत्पाद संस्करण की पहचान करने के लिए उत्पाद आयाम चुनें जिसके साथ आप काम करना चाहते हैं.