企业数据集成最佳实践：旺店通与金蝶云星空对接案例

金蝶与旺店通数据无缝对接技术详解

2022-04-21 19:15:42
轻易云集成顾问-曹润

旺店通·企业奇门数据集成到金蝶云星空案例分享

在系统对接中，如何确保数据的完整性和快速处理是两大核心挑战。在本篇技术案例中，我们将探讨一个具体的解决方案，即将旺店通·企业奇门的数据集成到金蝶云星空，实现【类型:纠错入库】旺店通-入库单管理==>金蝶-其他入库单。

系统对接概述

为了确保整个集成过程高效、准确地执行，我们采用了以下几步关键策略：

定时可靠的抓取机制：通过调用wdt.stockin.order.query接口，我们能够按设定间隔可靠地从旺店通·企业奇门获取最新的入库单数据。同时设计了分页抓取与限流逻辑，以应对大量数据并发查询，并保证系统稳定运行。
批量数据写入：借助金蝶云星空提供的batchSave API接口，将获取的数据批量、高效地写入目标系统。此方法不仅提升了传输效率，还降低了网络延迟和服务器压力。
实时监控与日志记录：在轻易云平台强大的可视化操作界面支持下，对每个环节的数据处理状态进行实时监控，并详细记录日志。任何异常状况都能及时被捕捉和分析，这为后续错误重试机制提供了坚实基础。
格式差异处理与自定义映射：由于源系统（旺店通·企业奇门）和目标系统（金蝶云星空）之间的数据格式存在差异，我们利用自定义映射工具，对各字段进行一一对应转换，确保数据无缝流动。另外，通过参数化配置实现灵活调整，使得维护更加便捷。
异常处理及重试机制：针对可能出现的数据对接异常情况，设计了一套完善的错误捕获与重试机制。例如，当API请求失败或超时时，系统会自动记录失败原因并依照预设规则重新尝试，以最大程度减少人工介入力度，提升整体运维水平。

上述关键步骤为我们解决实际问题提供了一整套行之有效的方法，为数据精准、迅速、安全传输奠定了良好基础。下面我们将深入剖析具体实现细节及其相应代码示例。数据集成平台可视化配置API接口

调用旺店通·企业奇门接口wdt.stockin.order.query获取并加工数据

在数据集成生命周期的第一步，我们需要从源系统获取数据并进行初步加工。本文将详细探讨如何使用轻易云数据集成平台调用旺店通·企业奇门接口wdt.stockin.order.query来获取入库单数据，并对其进行必要的清洗和转换。

接口调用配置

首先，我们需要配置接口调用的元数据。根据提供的元数据配置，我们可以看到该接口是通过POST方法进行调用，主要用于查询入库单信息。以下是关键字段的配置：

api: wdt.stockin.order.query
method: POST
number: order_no
id: stockin_id
name: order_no
idCheck: true

请求参数

请求参数包括时间范围、单据类别、状态等，具体如下：

start_time 和 end_time：用于按最后修改时间增量获取数据，格式为yyyy-MM-dd HH:mm:ss。我们可以使用模板变量{{DAYS_AGO_1|datetime}}和{{CURRENT_TIME|datetime}}来动态生成这两个时间参数。
order_type：指定单据类别，这里我们选择“8”代表纠错入库。
status：指定入库单状态，这里选择“80”代表已完成。
其他可选字段如仓库编号、上层单据编号、入库单号等，可以根据实际需求进行传递。

分页参数也需要配置，以确保能够处理大批量的数据：

page_size：每页返回的数据条数，默认值为40。
page_no：页号，默认从0页开始。

以下是完整的请求参数示例：

{
  "start_time": "{{DAYS_AGO_1|datetime}}",
  "end_time": "{{CURRENT_TIME|datetime}}",
  "order_type": "8",
  "status": "80",
  "page_size": "{PAGINATION_PAGE_SIZE}",
  "page_no": "{PAGINATION_START_PAGE}"
}

数据清洗与转换

在获取到原始数据后，需要对其进行清洗和转换，以便后续写入目标系统。在这个过程中，我们主要关注以下几个方面：

字段映射：将源系统中的字段映射到目标系统所需的字段。例如，将order_no映射为目标系统中的订单编号。
数据格式转换：确保日期、数值等字段符合目标系统的格式要求。例如，将日期格式从yyyy-MM-dd HH:mm:ss转换为目标系统所需的格式。
异常处理：对于缺失或异常的数据进行处理，例如填充默认值或记录日志以便后续排查。

实际案例

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

{
  "stockin_id": "12345",
  "order_no": "IN20231001001",
  "warehouse_no": "WH001",
  "status": "80",
  "last_modified": "2023-10-01 12:00:00"
}

我们需要将其转换为目标系统所需的格式，例如金蝶ERP中的其他入库单。具体步骤如下：

将stockin_id映射为金蝶中的唯一标识符。
将order_no映射为金蝶中的订单编号。
确保日期格式符合金蝶系统要求。

转换后的数据示例如下：

{
  "unique_id": "12345",
  "order_number": "IN20231001001",
  "warehouse_code": "WH001",
  "status_code": "80",
  "modified_date": "2023/10/01"
}

通过以上步骤，我们实现了从旺店通·企业奇门接口获取并加工入库单数据，为后续的数据写入和进一步处理奠定了基础。这一过程不仅提高了数据处理的效率，也确保了数据的一致性和准确性。如何开发钉钉API接口

使用轻易云数据集成平台进行ETL转换并写入金蝶云星空API接口

在数据集成的生命周期中，ETL（Extract, Transform, Load）转换是关键步骤之一。本文将详细介绍如何使用轻易云数据集成平台，将源平台的数据进行ETL转换，并最终通过API接口写入到金蝶云星空。

数据请求与清洗

首先，我们从源平台（如旺店通）获取入库单管理相关的数据。这些数据通常包括订单编号、库存组织、日期、部门、供应商等信息，以及具体的明细信息如物料编码、收货仓库、实收数量等。在这个阶段，我们需要对原始数据进行清洗，确保其完整性和准确性。

数据转换与写入

接下来是数据转换和写入目标平台（金蝶云星空）的过程。我们需要将清洗后的数据按照金蝶云星空API接口所需的格式进行转换，并通过API接口写入到金蝶云星空系统中。

以下是一个详细的元数据配置示例，用于将源平台的数据转换为金蝶云星空API所需的格式：


{
  "api": "batchSave",
  "effect": "EXECUTE",
  "method": "POST",
  "idCheck": true,
  "request": [
    {"field":"FBillNo","label":"单据编号","type":"string","describe":"单据编号","value":"{order_no}"},
    {"field":"FBillTypeID","label":"单据类型","type":"string","describe":"单据类型","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"QTRKD04_SYS"},
    {"field":"FStockOrgId","label":"库存组织","type":"string","describe":"组织","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"100"},
    {"field":"FStockDirect","label":"库存方向","type":"string","describe":"下拉列表"},
    {"field":"FDate","label":"日期","type":"string","describe":"日期","value":"{stockin_time}"},
    {"field":"FDEPTID","label":"部门","type":"string","describe":"基础资料","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"BM000003"},
    {"field":"FOwnerTypeIdHead","label":"货主类型","type":"string","describe":"多类别基础资料列表","value":"BD_OwnerOrg"},
    {"field":"FOwnerIdHead","label":"货主","type":"string","describe":"多类别基础资料","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"100"},
    {"field": "FNOTE", "label": "备注", "type": "string", "describe": "多行文本", "value": "{remark}"},
    {"field": "FSUPPLIERID", "label": "供应商", "type": "string", "value": "SP001", "parser": {"name": "ConvertObjectParser", "params": "FNumber"}},
    {
      "field": "FEntity",
      "label": "明细信息",
      "type": "array",
      "describe": "明细信息",
      "value": "details_list",
      "children":[
        {"field": "FMATERIALID", "label": "物料编码", 
![金蝶与MES系统接口开发配置](https://pic.qeasy.cloud/T19.png~tplv-syqr462i7n-qeasy.image)

版权声明

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