使用轻易云平台将旺店通调拨单转换并写入金蝶云星空API

  • 轻易云集成顾问-孙传友

案例分享：25 旺店通调拨单到金蝶云直接调拨单（WMS回传单据）

在现代企业的供应链管理中，数据集成与高效的信息流动是保持业务顺畅运行的关键。本文将详细介绍如何利用轻易云平台实现旺店通·旗舰奇门的数据无缝对接至金蝶云星空，具体案例为“25 旺店通调拨单到金蝶云直接调拨单（WMS回传单据）”。

作为系统集成顾问，我们常遇到的问题之一便是如何确保数据从源头到目标系统不发生任何遗漏，并且能够快速、高效地完成这一过程。在此案例中，我们重点解决了以下几个技术难题：

  1. 确保数据不漏单：通过调用旺店通·旗舰奇门接口wdt.wms.stocktransfer.manage.querywithdetail，我们设计了一套可靠的抓取机制来保证每一条数据都能被准确获取。
  2. 快速写入大量数据：对于大批量的数据信息，通过优化对接流程和采用并发处理机制，将这些数据高速写入金蝶云星空API batchSave。
  3. 定时抓取和分页限流问题：为了应对API请求次数限制及可能存在的大量分页结果，我们设置了合理的定时任务策略以及有效的限流控制措施，以保证抓取过程平稳有序。
  4. 实时监控与日志记录：整个过程中实时监控每一步骤，并记录详实日志，以便及时发现并纠正潜在问题。

配置元数据和处理格式差异也是另一个需要关注的重要方面。由于旺店通·旗舰奇门与金蝶云星空之间的数据结构有所不同，需通过映射转换来适配双方标准。这些工作不仅提高了整体效率，也大大降低了人工干预成本。

综上所述，此次项目不仅成功实现两大系统间的数据无缝连接，还提升了信息透明度和业务响应速度。后续文章将深入探讨具体实施步骤、技术细节及最佳实践经验分享，希望为相关从业者提供一些启示和借鉴。

企业微信与OA系统接口开发配置

调用旺店通·旗舰奇门接口wdt.wms.stocktransfer.manage.querywithdetail获取并加工数据

在数据集成的生命周期中，调用源系统接口是至关重要的一步。本文将深入探讨如何通过轻易云数据集成平台调用旺店通·旗舰奇门接口wdt.wms.stocktransfer.manage.querywithdetail，并对获取的数据进行初步加工。

接口调用配置

首先，我们需要配置接口调用的元数据。根据提供的元数据配置，可以看到该接口使用POST方法进行请求，主要参数包括分页参数和业务参数。

分页参数：

{
  "field": "pager",
  "label": "分页参数",
  "type": "object",
  "children": [
    {
      "field": "page_size",
      "label": "分页大小",
      "type": "string",
      "value": "50",
      "parent": "pager"
    },
    {
      "field": "page_no",
      "label": "页号",
      "type": "string",
      "value": "1",
      "parent": "pager"
    }
  ]
}

业务参数：

{
  "field": "params",
  "label": "业务参数",
  "type": "object",
  "children": [
    {
      "field": "start_time",
      "label": "开始时间",
      "type": "string",
      "describe":"仓库编号",
      "value":"{{LAST_SYNC_TIME|datetime}}",
      "parent":"params"
    },
    {
      "field":"end_time",
      {
        ...

这些配置确保了我们能够准确地分页获取数据，并且通过动态时间参数来确定数据范围。

数据请求与清洗

在实际操作中，首先需要通过API请求获取原始数据。以下是一个示例请求体：

{
  “pager”: {
    “page_size”: “50”,
    “page_no”: “1”
  },
  “params”: {
    “start_time”: “2023-01-01T00:00:00”,
    “end_time”: “2023-01-31T23:59:59”,
    “status”: “80,90”
  }
}

该请求体将会返回指定时间范围内状态为80或90的调拨单详细信息。接下来，我们需要对返回的数据进行清洗和初步加工，以便后续的数据转换与写入步骤。

数据转换与写入

在清洗过程中，我们可能需要过滤掉不必要的字段，仅保留关键字段，如transfer_no、transfer_id等。同时，根据条件过滤器，我们可以进一步筛选符合条件的数据。例如：

"condition":[
  [
    {"field":"transfer_no","logic":"like","value":"TF"},
    {"field":"remark","logic":"ieqv2","value":"wms库存异动调拨生成"}
  ]
]

这些条件确保了我们仅处理特定类型的调拨单，避免无关数据干扰。

实际案例应用

假设我们从旺店通获取到以下原始数据：

[
  {
    “transfer_no”: “TF12345”,
    “transfer_id”: “67890”,
    “remark”: “wms库存异动调拨生成”,
    ...
  },
  ...
]

经过清洗和条件过滤后，我们得到如下精简数据：

[
  {
    “transfer_no”: “TF12345”,
    “transfer_id”: “67890”
  }
]

这些精简后的数据将被进一步处理，并最终写入目标系统（如金蝶云）中，实现不同系统间的数据无缝对接。

小结

通过上述步骤，我们成功地调用了旺店通·旗舰奇门接口wdt.wms.stocktransfer.manage.querywithdetail，并对获取的数据进行了有效的清洗和初步加工。这一步骤为后续的数据转换与写入奠定了坚实基础。在实际操作中，灵活运用元数据配置和条件过滤器，可以极大提升数据集成的效率和准确性。 钉钉与ERP系统接口开发配置

使用轻易云数据集成平台将旺店通调拨单转换并写入金蝶云星空API接口

在数据集成过程中，ETL（Extract, Transform, Load）是关键步骤之一。本文将详细探讨如何使用轻易云数据集成平台，将旺店通的调拨单数据转换为金蝶云星空API接口所能接收的格式，并最终写入目标平台。

元数据配置解析

在进行数据转换和写入之前，我们需要理解元数据配置。以下是关键字段及其配置解析：

  1. API和请求方法

    {"api":"batchSave","method":"POST"}

    这里指定了调用金蝶云星空的batchSave API，使用HTTP POST方法。

  2. 基础字段映射

    • FBillTypeID: 单据类型，固定值ZJDB01_SYS
    • FBillNo: 单据编号，对应源数据中的transfer_no
    • FDate: 日期，使用模板语言转换格式
    • FStockOrgId: 调入库存组织，固定值106
    • FOwnerTypeIdHead: 货主类型，固定值BD_OwnerOrg
    • FOwnerIdHead: 货主，固定值106

  3. 动态字段映射

    • FBillEntry: 明细信息，是一个数组字段，每个子项包含物料编码、实收数量、调入仓库等信息。 
      {
"field":"FMATERIALID",
"label":"物料编码",
"type":"string",
"describe":"基础资料",
"parser":{"name":"ConvertObjectParser","params":"FNumber"},
"value":"{{details_list.spec_no}}"
}

      这里的物料编码通过ConvertObjectParser解析器，将源数据中的物料编码（spec_no）转换为金蝶云所需格式。

  4. 其他重要字段

    • FormId: 业务对象表单Id，固定值STK_TransferDirect
    • IsAutoSubmitAndAudit: 提交并审核，布尔值设为true

数据转换与写入过程

  1. 提取源数据 从旺店通系统中提取调拨单数据，包括调拨单号、日期、库存组织、货主、明细列表等信息。

  2. 数据清洗与转换 使用轻易云平台的元数据配置，将提取的数据进行清洗和转换。具体操作如下：

    • 将调拨单号（如：transfer_no）直接映射到目标字段FBillNo
    • 日期字段使用模板语言进行格式化处理 
      {"field":"FDate","value":"{{created_date|dateTime}}"}
    • 对于复杂的明细信息，通过循环处理每一条明细记录，并根据元数据配置进行字段映射和格式转换。例如： 
      {
"field":"FMATERIALID",
"value":"{{details_list.spec_no}}"
}

  3. 构建请求体 根据元数据配置和转换后的数据，构建符合金蝶云API要求的请求体。示例如下：

    {
 "FormId": "STK_TransferDirect",
 "IsVerifyBaseDataField": false,
 "Operation": "Save",
 "IsAutoSubmitAndAudit": true,
 "InterationFlags": "STK_InvCheckResult",
 "Model": {
   "FBillTypeID": {"FNumber": "ZJDB01_SYS"},
   "FBillNo": "{transfer_no}",
   ...
   "FBillEntry": [
     {
       "FMATERIALID": {"FNumber": "{{details_list.spec_no}}"},
       ...
     }
   ]
 }
}

  4. 发送请求并处理响应 使用HTTP POST方法，将构建好的请求体发送到金蝶云星空API接口，并处理返回的响应结果。如果成功，则表示调拨单已成功写入目标平台；否则，需要根据错误信息进行排查和修正。

技术要点总结

  • 使用轻易云平台提供的全异步、多种异构系统支持，实现了不同系统间的数据无缝对接。
  • 通过灵活的元数据配置，可以方便地将源系统的数据转换为目标系统所需的格式。
  • 在ETL过程中，通过解析器和模板语言实现了复杂的数据清洗和格式转换。
  • 最终通过标准化的API接口调用，实现了高效的数据写入和同步。

以上技术案例展示了如何利用轻易云数据集成平台高效地完成旺店通到金蝶云星空的数据集成任务，为企业提供了可靠的数据流转解决方案。 金蝶与MES系统接口开发配置

版权声明

该文章《使用轻易云平台将旺店通调拨单转换并写入金蝶云星空API》为原创内容，版权归 广东轻亿云软件科技有限公司 所有。 未经本公司书面授权，严禁转载、引用、复制或建立镜像等行为。 若需转载或引用本文内容，请联系本公司获取授权，并在显著位置注明作者姓名、文章出处（包括原文链接）等信息。

金蝶云星辰与吉客云对接
更多系统对接方案