金蝶云数据集成到旺店通的技术实施方案

企业数据对接：金蝶云与旺店通系统无缝整合

2021-04-22 12:06:22
轻易云集成顾问-何语琴

金蝶云星空数据集成到旺店通·旗舰版的技术案例分享

在企业信息化和业务管理过程中，不同系统之间的数据对接是实现高效运营的重要环节。本文将介绍一个成功的系统对接集成案例：如何通过轻易云数据集成平台，将金蝶云星空的数据无缝整合到旺店通·旗舰版中，具体方案名称为"标准-金蝶-其他入库单——>旺店通-委外仓入(入库业务)"。

为了确保从金蝶云星空获取的数据不漏单，我们利用其API接口executeBillQuery进行定时可靠的抓取。同时，为了应对大量数据写入需求，我们使用了旺店通·旗舰版提供的wms.stockother.In.push API，实现批量、快速地将处理好的数据写入目标系统。在这一过程中，还要特别关注以下几点：

分页与限流问题：由于金蝶云星空API有每次调用返回结果数量和频率限制，因此我们设计了分页机制，并实施限流策略，以防止接口请求过多被临时封禁。
异常处理与错误重试机制：对于执行过程中可能遇到的数据传输失败或网络中断等异常情况，建立了一套完善的错误检测与重试机制，确保每条记录最终能够正确传输至目标系统。
实时监控与日志记录：通过轻易云的平台功能，对整个数据处理过程中的关键节点进行实时监控和日志记录，以便及时发现并解决潜在的问题，提高业务透明度和运维效率。
数据格式差异处理：由于源端（如金蝶云星空）与目标端（如旺店通·旗舰版）的数据结构不同，我们开发了定制化映射规则以转换不同字段类型及内容格式，确保两者间的数据顺利兼容。

本文开篇即把焦点放在核心技术操作上，通过实际案例展示一系列应对大规模、多源头复杂场景下，实现稳定、高效、安全数据交互的方法。后续内容将详细探讨这些技术点如何具体实施，以及项目上线后的效果反馈。数据集成平台API接口配置

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

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

接口配置与调用

首先，我们需要配置元数据，以便正确调用金蝶云星空的executeBillQuery接口。以下是关键的元数据配置：

{
  "api": "executeBillQuery",
  "effect": "QUERY",
  "method": "POST",
  "number": "FBillNo",
  "id": "FEntity_FEntryID",
  "name": "FBillNo",
  "idCheck": true,
  ...
}

该配置指定了API名称、请求方法以及主要字段标识符等信息。具体字段配置如下：

FBillNo: 单据编号
FEntity_FEntryID: 分录ID
FID: 实体主键
FDocumentStatus: 单据状态
FStockOrgId_FNumber: 库存组织编号
FDate: 日期
FBillTypeID_FNumber: 单据类型编号
FSUPPLIERID_FNumber: 供应商编号
FNOTE: 备注

这些字段将用于构建请求和解析响应。

请求参数构建

为了有效地查询数据，我们需要构建合适的请求参数。以下是一个示例请求参数：

{
  "FormId": "STK_MISCELLANEOUS",
  "FieldKeys": [
    "FBillNo", 
    "FEntity_FEntryID", 
    ...
  ],
  "FilterString": "FApproveDate>='{{LAST_SYNC_TIME|datetime}}' and FStockOrgId.FNumber='101' and FSTOCKID.F_TBIK_Assistant_qtr = '委外仓' and FBillTypeID.FNUMBER in ('QTRKD01_SYS') and FDate>='2024-08-05 17:30:00'",
  ...
}

在这个请求中，FormId指定了业务对象表单ID为STK_MISCELLANEOUS，FieldKeys列出了需要查询的字段集合，而FilterString则定义了过滤条件，用于筛选特定的数据记录。

数据清洗与转换

获取到原始数据后，需要进行清洗和转换，以便后续处理。以下是一个简单的数据清洗示例：

def clean_data(raw_data):
    cleaned_data = []
    for record in raw_data:
        cleaned_record = {
            '单据编号': record['FBillNo'],
            '分录ID': record['FEntity_FEntryID'],
            '实体主键': record['FID'],
            '单据状态': record['FDocumentStatus'],
            '库存组织': record['FStockOrgId_FNumber'],
            '日期': record['FDate'],
            '单据类型': record['FBillTypeID_FNumber'],
            '供应商': record['FSUPPLIERID_FNumber'],
            '备注': record.get('FNOTE', ''),
            ...
        }
        cleaned_data.append(cleaned_record)
    return cleaned_data

在这个函数中，我们对原始记录进行了字段映射和必要的数据清理，如处理缺失值等。

数据写入目标系统

最后，将清洗后的数据写入目标系统。在轻易云平台上，可以通过配置相应的目标系统接口实现这一过程。例如，将数据写入旺店通的委外仓入库业务中。

{
  "api": "insertWarehouseEntry",
  ...
}

通过这种方式，可以实现从金蝶云星空到旺店通系统的数据无缝对接，确保业务流程的顺畅运行。

总结来说，通过合理配置元数据、构建请求参数、进行数据清洗与转换，并最终写入目标系统，可以高效地实现跨系统的数据集成。这一过程不仅提高了业务透明度和效率，还确保了数据的一致性和准确性。金蝶与外部系统打通接口

使用轻易云数据集成平台实现金蝶入库单数据ETL转换并写入旺店通·旗舰版API接口

在数据集成过程中，ETL（提取、转换、加载）是关键步骤之一。本文将详细探讨如何使用轻易云数据集成平台，将金蝶系统的入库单数据转换为旺店通·旗舰版API接口所能接收的格式，并最终写入目标平台。

数据请求与清洗

首先，从源系统（金蝶）提取原始数据。假设我们已经完成了这一阶段，接下来我们需要对这些数据进行转换，以符合目标系统（旺店通·旗舰版）的要求。

数据转换与写入

根据元数据配置，我们需要将金蝶系统的字段映射到旺店通·旗舰版API接口所需的字段。以下是具体的元数据配置：

{
  "api": "wms.stockother.In.push",
  "effect": "EXECUTE",
  "method": "POST",
  "idCheck": true,
  "request": [
    {
      "field": "order",
      "label": "单据头",
      "type": "object",
      "children": [
        {"field": "outer_no", "label": "外部单号", "type": "string", "value": "{FBillNo}"},
        {"field": "warehouse_no", "label": "仓库编号", "type": "string", "value": "{FSTOCKID}"},
        {"field": "reason", "label": "入库原因", "type": "string", "value": "{F_TBIK_RKLX}"},
        {"field": "is_check", "label": "是否审核", "type": "string", "value":"true"},
        {"field":"remark","label":"备注","type":"string","value":"{FNOTE}"}
      ]
    },
    {
      "field":"order_details",
      "label":"单据明细",
      "type":"array",
      "value":"list",
      ...
    }
  ],
  ...
}

配置解析与应用

单据头配置：
- outer_no 映射到 {FBillNo}，表示外部单号。
- warehouse_no 映射到 {FSTOCKID}，表示仓库编号。
- reason 映射到 {F_TBIK_RKLX}，表示入库原因。
- is_check 固定值 "true"，表示是否审核。
- remark 映射到 {FNOTE}，表示备注。
单据明细配置：
- spec_no 映射到 {FMATERIALID_FNumber}，表示商家编码。
- num 映射到 {FQty}，表示数量。
- price 映射到 {FMATERIALID_FRefCost}，表示入库价。
- remark 映射到 {FEntryNote}，表示明细备注。

数据组装与发送

在完成字段映射后，我们需要组装数据并通过HTTP POST方法发送至旺店通·旗舰版API接口。以下是一个示例请求体：

{
  "order":{
    ...
  },
  ...
}

通过轻易云平台的可视化界面，可以方便地配置和调试上述请求体。在实际操作中，还可以利用平台提供的实时监控功能，确保每个环节的数据处理状态透明可见。

小结

本文详细介绍了如何使用轻易云数据集成平台，将金蝶系统的入库单数据进行ETL转换，并成功写入旺店通·旗舰版API接口。通过元数据配置，我们能够高效地完成不同系统间的数据无缝对接，实现业务流程的自动化和优化。如何开发钉钉API接口

版权声明

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