实现金蝶分步式调入单对接旺店通的完整方案

  • 轻易云集成顾问-潘裕

金蝶分步式调入单对接旺店通其他入库单：技术实施案例分享

在系统集成领域，确保不同平台间的数据无缝对接是一项至关重要的任务。本案例聚焦于如何通过轻易云数据集成平台，将金蝶云星空中的调入单高效、安全地集成到旺店通·企业奇门的其他入库单。本次方案利用了金蝶云星空API接口executeBillQuery进行数据获取，并使用旺店通API接口wdt.stockin.order.push实现数据写入。

首先，我们需要解决的是确保从金蝶云星空获取的数据不漏单。为此，通过定时可靠的抓取机制，设定固定时间间隔调用executeBillQuery接口，从而保证所有新增或变更的数据都能被及时捕获。同时，为防止大规模数据处理过程中出现超时或限流的问题，我们采用分页处理策略，以批量方式逐步读取和传输数据，有效规避性能瓶颈。

其次，当大量数据需要快速写入到旺店通·企业奇门时，高效的数据传输显得尤为关键。在这一步骤中，针对不同类型和数量级的数据，通过并行处理方式，实现批次化上传，不仅提升了效率，还有效降低了网络请求带来的延迟风险。此外，对于两者之间存在的数据格式差异问题，我们采用实时转换与映射规则，使得每一条记录在发送前已经被精准地调整到符合目标系统要求的格式。

为了确保整个过程中的稳健性及可追溯性，我们构建了一套完整的异常处理与错误重试机制。当调用过程遇到失败情况时，可自动触发重试逻辑，并详细记录日志以便后续排查分析。这不仅提高了整体操作成功率，也为维护人员提供了宝贵的信息支持。

最后，在实际项目运行中，为保障透明度和操作可视化管理，对全流程每个环节，包括从抓取、转换、上传至监控等，都进行了细致全面的配置，使业务方能够随时洞察系统状态，以及可能存在的问题点，从而极大提升了运维效率与业务连续性。 用友与WMS系统接口开发配置

调用金蝶云星空接口executeBillQuery获取并加工数据

在数据集成的生命周期中，调用源系统接口获取数据是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用金蝶云星空的executeBillQuery接口，以获取并加工调入单数据。

接口配置与请求参数

首先，我们需要配置接口的元数据。以下是executeBillQuery接口的元数据配置：

{
  "api": "executeBillQuery",
  "method": "POST",
  "number": "FBillNo",
  "id": "FSTKTRSINENTRY_FEntryID",
  "pagination": {
    "pageSize": 500
  },
  "idCheck": true,
  "request": [
    {"field":"FSTKTRSINENTRY_FEntryID","label":"FEntryID","type":"string","value":"FSTKTRSINENTRY_FEntryID"},
    {"field":"FID","label":"实体主键","type":"string","value":"FID"},
    {"field":"FBillNo","label":"单据编号","type":"string","value":"FBillNo"},
    {"field":"FDocumentStatus","label":"单据状态","type":"string","value":"FDocumentStatus"},
    {"field":"FStockOrgID_FNumber","label":"调入库存组织","type":"string","value":"FStockOrgID.FNumber"},
    {"field":"FDate","label":"日期","type":"string","value":"FDate"},
    {"field":"FBillTypeID","label":"单据类型","type":"string","value":"FBillTypeID"},
    {"field":"FTransferDirect","label":"调拨方向","type":"string","value":"FTransferDirect"},
    {"field":"FNOTE","label":"备注","type":"string","value":"FNOTE"},
    {"field":"FCreateDate","label":"创建日期","type":"string","value":"FCreateDate"},
    {"field":"FApproveDate","label":"审核日期","type":"string","value":"FApproveDate"},
    {"field":"FTransferMode","label":"调拨方式","type":"string","value":"FTransferMode"},
    {"field": "FilterString", "label": "过滤条件", "type": "string", "describe": "示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=", "value": "FApproveDate>='{{LAST_SYNC_TIME|dateTime}}' and F_PRSH_Base_yrr.Fgroup = '电商库'"}
  ],
  "otherRequest":[
    {"field": "Limit", "label": "最大行数", "type": "string", "describe": "金蝶的查询分页参数", "value": "{PAGINATION_PAGE_SIZE}"},
    {"field": "StartRow", "label": "开始行索引", "type": "string", "describe": "金蝶的查询分页参数", "value": "{PAGINATION_START_ROW}"},
    {"field": "TopRowCount", "label": "返回总行数", "type": "int", 
![轻易云数据集成平台金蝶集成接口配置](https://pic.qeasy.cloud/S14.png~tplv-syqr462i7n-qeasy.image)
### 使用轻易云数据集成平台实现金蝶分步式调入单对接旺店通其他入库单

在数据集成生命周期的第二步，我们需要将已经从源平台（金蝶）获取的数据进行ETL转换，转为目标平台（旺店通·企业奇门API接口）所能够接收的格式，并最终写入目标平台。本文将详细介绍这一过程中的关键技术细节和元数据配置。

#### 数据转换与写入

在本案例中，我们的目标是将金蝶分步式调入单的数据转换并推送到旺店通的其他入库单接口。以下是具体的元数据配置及其解析：

```json
{
  "api": "wdt.stockin.order.push",
  "effect": "EXECUTE",
  "method": "POST",
  "idCheck": true,
  "operation": {
    "method": "merge",
    "field": "FBillNo",
    "bodyName": "details",
    "bodySum": ["FQty"],
    "header": ["FBillNo", "F_PRSH_Base_yrr_Fnumber", "FNOTE"],
    "body": ["FMaterialID_FNumber", "FQty", "FProduceDate", "FEntryNote"]
  },
  "request": [
    {
      "field": "outer_no",
      "label": "外部单号",
      "type": "string",
      "describe": "外部单号",
      "value": "{FBillNo}"
    },
    {
      "field": "warehouse_no",
      "label": "仓库编码",
      "type": "string",
      "describe": "",
      "_mongoQuery 1cc929c8-7ec5-3f42-ade6-c1f49506d34c findField=content.FNumber where={\"content.F_PBLH_KINGDEESTOCK\":{\"$eq\":\"{F_PRSH_Base_yrr_Fnumber}\"},\"content.F_PBLH_MAPPINGTYPE\":{\"$regex\":\"D\"}}"
    },
    {
      ...

元数据配置解析

  1. API接口与请求方式

    • api字段指定了目标API接口为wdt.stockin.order.push。
    • method字段表示使用HTTP POST方法提交请求。

  2. 操作类型

    • operation部分定义了如何处理数据，包括合并操作(merge)和字段映射。此处指定了主键字段FBillNo，以及需要合并的明细表字段details和汇总字段FQty。

  3. 请求参数映射

    • outer_no: 外部单号，对应金蝶系统中的FBillNo。
    • warehouse_no: 仓库编码，通过MongoDB查询获取对应的仓库编码。
    • remark: 固定备注信息，标识此次操作为“金蝶分步式调入单对接入库”。
    • is_check: 是否审核，固定值为“1”，表示自动审核。

  4. 货品明细节点

    • goods_list: 定义了货品明细节点，其中包括商家编码、入库数量、生产日期、备注等信息。这些字段分别映射到金蝶系统中的相应字段，如商家编码对应details.FMaterialID_FNumber，入库数量对应details.FQty等。

实际应用

在实际应用中，我们首先需要通过轻易云平台从金蝶系统中提取所需数据，然后根据上述元数据配置进行ETL转换。具体步骤如下：

  1. 提取数据：从金蝶系统中提取调入单数据，包括主表和明细表信息。
  2. 转换数据：根据元数据配置，将提取的数据进行格式转换。例如，将金蝶系统中的物料编码、数量、生产日期等字段映射到旺店通API所需的格式。
  3. 写入目标平台：通过HTTP POST请求，将转换后的数据推送到旺店通·企业奇门API接口，实现其他入库单的创建。

技术要点

  • 异构系统集成：轻易云平台支持多种异构系统的数据集成，通过灵活的元数据配置，可以实现不同系统间的数据无缝对接。
  • 实时监控与透明化：在整个ETL过程中，轻易云平台提供实时监控功能，确保每个环节都清晰可见，提高业务透明度和效率。
  • 自动化处理：通过预定义的元数据配置，可以实现自动化的数据转换与写入，大大减少手动操作，提高工作效率。

以上就是使用轻易云数据集成平台实现金蝶分步式调入单对接旺店通其他入库单的详细技术方案及其元数据配置解析。在实际应用中，通过合理配置元数据，可以高效地完成复杂的数据集成任务。 轻易云数据集成平台金蝶集成接口配置

版权声明

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

金蝶云星空与旺店通打通
更多系统对接方案