實現旺店通旗艦奇門與金蝶雲星空資料整合的技術方法

standxy發表於2024-10-25

旺店通·旗艦奇門資料整合到金蝶雲星空的技術實現

在企業資訊化管理中，資料的高效流動和準確對接是關鍵。本文將分享一個實際案例：如何透過輕易雲資料整合平臺，將旺店通·旗艦奇門的銷售出庫單快遞單資料整合到金蝶雲星空預置基礎資料【2B】中。

為了實現這一目標，我們利用了輕易雲平臺的多項特性，包括高吞吐量的資料寫入能力、實時監控與告警系統、自定義資料轉換邏輯以及視覺化的資料流設計工具。這些特性確保了我們能夠快速、可靠地完成大量資料的整合，並且在整個過程中保持對資料質量和處理狀態的實時監控。

首先，我們需要從旺店通·旗艦奇門獲取銷售出庫單快遞單的資料。為此，我們呼叫了其提供的API介面wdt.wms.stockout.sales.querywithdetail，該介面支援定時抓取並處理分頁和限流問題，確保不漏單。在獲取到這些原始資料後，透過自定義的資料轉換邏輯，將其轉化為符合金蝶雲星空要求的資料格式。

接下來，我們使用金蝶雲星空提供的batchSave API介面，將轉換後的資料批次寫入到目標系統中。輕易雲平臺強大的高吞吐量寫入能力，使得這一過程能夠快速完成，即使面對海量資料也能保證時效性。同時，透過集中監控和告警系統，我們可以實時跟蹤每個整合任務的狀態和效能，一旦出現異常情況，系統會立即發出告警並啟動錯誤重試機制，以確保資料傳輸的可靠性。

此外，為了適應企業特定業務需求，我們還進行了定製化的資料對映對接，並在整個過程中實施了嚴格的資料質量監控和異常檢測機制。這不僅提高了資料處理效率，也大大降低了潛在風險。

透過上述技術手段，我們成功實現了旺店通·旗艦奇門與金蝶雲星空之間的資料無縫對接，為企業的資訊化管理提供了堅實保障。
如何開發用友BIP介面

如何對接釘釘API介面

呼叫旺店通·旗艦奇門介面wdt.wms.stockout.sales.querywithdetail獲取並加工資料

在輕易雲資料整合平臺的生命週期中，呼叫源系統介面是至關重要的一步。本文將詳細探討如何透過呼叫旺店通·旗艦奇門介面wdt.wms.stockout.sales.querywithdetail來獲取銷售出庫單快遞單的資料，並進行初步加工處理。

介面呼叫配置

首先，我們需要配置好介面的請求引數和後設資料。以下是關鍵的後設資料配置：

{
  "api": "wdt.wms.stockout.sales.querywithdetail",
  "method": "POST",
  "number": "order_no",
  "id": "stockout_id",
  "idCheck": true,
  "request": [
    {
      "field": "pager",
      "label": "分頁引數",
      ...
    },
    {
      ...
    }
  ],
  ...
}

分頁與限流處理

為了確保資料完整性和避免漏單問題，我們採用分頁機制來逐步獲取資料。每次請求設定分頁大小為50條記錄，透過調整頁號來遍歷所有資料。

{
  "field": "pager",
  ...
  {
    "field": "page_size",
    ...
    "value": 50
  },
  {
    ...
    "field": "page_no",
    ...
    // 初始值為1，後續根據返回結果遞增
    ...
}

時間視窗與狀態過濾

為了提高查詢效率和準確性，我們可以使用時間視窗和狀態過濾條件。這裡我們設定了開始時間為當前時間前40分鐘，結束時間為當前時間，並且只查詢特定狀態的出庫單。

{
  ...
  {
    ...
    {"field":"start_time","value":"{{MINUTE_AGO_40|datetime}}"},
    {"field":"end_time","value":"{{CURRENT_TIME|datetime}}"},
    {"field":"status_type","value":"3"},
    {"field":"status","value":"53,54,60,61,..."}
   }
}

資料清洗與轉換

在獲取到原始資料後，需要對其進行清洗和轉換，以適應目標系統金蝶雲星空的資料結構。例如，可以透過自定義邏輯將不同欄位對映到目標系統所需格式：

  • 欄位對映：將stockout_no對映為金蝶雲星空中的訂單編號。
  • 日期格式轉換：將日期欄位統一轉換為ISO標準格式。
  • 狀態碼翻譯：將旺店通中的狀態碼翻譯成金蝶雲星空可識別的狀態描述。

實時監控與異常處理

輕易雲平臺提供了實時監控和告警功能，可以隨時跟蹤API呼叫的成功率、響應時間等關鍵指標。一旦發現異常，如網路超時或返回錯誤碼，可以立即觸發重試機制或傳送告警通知。

{
   // 示例監控配置（簡化）
   ... 
   {"monitoring_enabled": true},
   {"alert_thresholds":{"timeout_ms":5000,"error_rate_percent":5}}
}

確保高吞吐量與可靠性

為了確保大量資料能夠快速寫入到金蝶雲星空系統中，我們可以利用輕易雲平臺的高吞吐量能力。同時，透過批次操作減少API呼叫次數，提高整體效率。在實際操作中，還需注意處理分頁、限流等問題，以避免因請求過多導致源系統壓力過大。

綜上所述，透過合理配置請求引數、實現分頁機制、進行必要的資料清洗與轉換，以及利用實時監控與異常處理功能，可以有效地從旺店通·旗艦奇門介面獲取並加工銷售出庫單快遞單的資料，為後續整合到金蝶雲星空打下堅實基礎。
如何開發用友BIP介面

如何開發金蝶雲星空API介面

將旺店通銷售出庫單快遞單資料整合到金蝶雲星空

在資料整合過程中，ETL（提取、轉換、載入）是至關重要的一步。本文將深入探討如何使用輕易雲資料整合平臺，將旺店通的銷售出庫單快遞單資料轉換為金蝶雲星空API介面所能接收的格式，並最終寫入目標平臺。

1. 資料提取與清洗

首先，從旺店通系統中獲取銷售出庫單快遞單的資料。透過呼叫旺店通的API介面wdt.wms.stockout.sales.querywithdetail，可以獲取相關訂單的詳細資訊。這一步需要注意介面的分頁和限流問題，以確保資料完整性和請求的成功率。

2. 資料轉換

在輕易雲資料整合平臺中，配置ETL轉換規則，將提取到的原始資料轉換為金蝶雲星空所需的格式。以下是具體步驟：

2.1 資料對映

根據金蝶雲星空API介面的要求，對提取到的資料進行欄位對映。例如，旺店通中的訂單編號、快遞單號等資訊需要對映到金蝶雲星空對應的欄位。後設資料配置如下：

{
    "api": "batchSave",
    "method": "POST",
    "idCheck": true,
    "operation": {
        "rowsKey": "array",
        "rows": 10,
        "method": "batchArraySave"
    },
    "request": [
        {"field":"FNumber","label":"編碼","type":"string","describe":"單據型別","value":"{bfn_num}"},
        {"field":"FName","label":"名稱","type":"string","describe":"單據編號","value":"{trade_no}"},
        {"field":"FCreateOrgId","label":"建立組織","type":"string","describe":"組織","value":"100.01","parser":{"name":"ConvertObjectParser","params":"FNumber"}},
        {"field":"FUseOrgId","label":"使用組織","type":"string","describe":"基礎資料","value":"100.01","parser":{"name":"ConvertObjectParser","params":"FNumber"}},
        {"field":"F_PAUF_Text_YSDD","label":"原始訂單","type":"string","describe":"組織","value":"{src_trade_no}"},
        {"field":"F_PAUF_Text_DDBH","label":"訂單編號","type":"string","value":"{trade_no}"},
        {"field":"F_PAUF_Text_KDDH","label":"快遞單號","type":"string","describe":"文字","value":"{logistics_no}"},
        {"field":"F_PAUF_Text_CKDH","label":"出庫單號","type":"string","describe":"文字","value":"{order_no}"},
        {"field":"F_PAUF_Text_wlbm", "label": "物料編碼", "type": "string", "value": "{details_list_goods_no}"}
    ],
    "otherRequest": [
        {"field": "FormId", "label": "業務物件表單Id", "type": "string", "describe": "必須填寫金蝶的表單ID如:PUR_PurchaseOrder", "value": "BAS_PreBaseDataTwo"},
        {"field": "Operation", "label": "執行的操作", "type": "string", "value": "Save"},
        {"field": "IsAutoSubmitAndAudit", "label": "提交併稽核", "type": 
![釘釘與MES系統介面開發配置](https://pic.qeasy.cloud/T1.png)


![金蝶與外部系統打通介面](https://pic.qeasy.cloud/QEASY/A65.png)

相關文章