提升业务连续性与数据一致性：采购入库同步金蝶云星空方案解析

2022-04-23 07:46:20
轻易云集成顾问-蔡威

案例分享：采购入库旺店通同步金蝶-114

在现代企业运营中，数据集成的高效性和准确性对于业务流程至关重要。本文将详细解析一个实际运作方案——“采购入库旺店通同步金蝶-114”，该方案旨在实现从旺店通·企业奇门到金蝶云星空的数据无缝对接。

确保集成过程中的数据不漏单

首先，在系统对接过程中，我们需要确保旺店通·企业奇门的数据不漏单，这是保障业务连续性的关键一步。为此，我们调用了wdt.stockin.order.query.purchase接口，该接口允许我们获取最新的采购入库订单信息。在设置上，通过定时任务来抓取接口数据，以便精确检索每一笔新生成或变更的订单。同时，为应对可能出现的网络波动和接口限流等问题，采用分页查询机制并增加重试逻辑，从而最大程度地减少遗漏和错误。

大量数据快速写入到金蝶云星空

然后，将从旺店通获取的数据批量集成到金蝶云星空，需要考虑如何提升写入效率。我们使用了batchSave API进行批量插入操作，有效避免逐条写入所带来的性能瓶颈。此外，为处理两者之间的数据格式差异，我们进行了定制化的数据映射，对不同字段进行了精细化转换，以确保整个对接过程顺畅、准确无误。

数据实时监控与日志记录

为了增强整个集成过程的透明度与可追溯性，实现全生命周期管理，在连接与执行环节中引入了实时监控功能。通过轻易云提供的一系列可视化工具，可随时查看每个环节的数据流动状态，并且配置详尽的日志记录，引导用户及时发现并解决潜在的问题。这不仅有效提高了工作效率，还能迅速识别异常情况进行处理，大大降低了出错风险。

以上只是概述了一部分核心技术点，下文将继续深入探讨具体实现方法，包括API调用细节、数据映射规则以及异常处理策略等内容，敬请期待。打通用友BIP数据接口

调用旺店通·企业奇门接口获取并加工数据

在数据集成生命周期的第一步，我们需要调用源系统的API接口以获取原始数据，并对其进行初步加工。本文将详细探讨如何通过轻易云数据集成平台调用旺店通·企业奇门接口wdt.stockin.order.query.purchase，并对返回的数据进行处理。

接口调用配置

首先，我们需要配置API接口的调用参数。根据提供的元数据配置，我们可以看到以下关键字段：

api: wdt.stockin.order.query.purchase
method: POST
number: order_no
id: stockin_id
pagination: 分页参数，默认每页50条记录
idCheck: 是否进行ID检查，值为true
omissionRemedy: 数据遗漏补救机制，使用定时任务和接管请求
request: 请求参数，包括时间范围、状态、上层单据编号、仓库编号等
otherRequest: 其他请求参数，如分页大小和页号
condition_bk和condition: 查询条件

请求参数设置

在实际操作中，我们需要根据业务需求设置具体的请求参数。以下是一个典型的请求配置示例：

{
  "start_time": "{{LAST_SYNC_TIME|datetime}}",
  "end_time": "{{CURRENT_TIME|datetime}}",
  "status": "completed",
  "src_order_no": "",
  "warehouse_no": "",
  "page_size": "{PAGINATION_PAGE_SIZE}",
  "page_no": "{PAGINATION_START_PAGE}"
}

其中，start_time和end_time用于指定查询的时间范围，分别取上次同步时间和当前时间。status字段用于过滤已完成的订单。

数据处理与清洗

在获取到原始数据后，需要对其进行初步清洗和处理。以下是一些常见的数据处理步骤：

去重：根据stockin_id字段去重，确保每条记录唯一。
字段映射：将源系统中的字段映射到目标系统中。例如，将源系统中的order_no映射为目标系统中的订单编号。
数据格式转换：将日期时间字段转换为目标系统所需的格式。
过滤无效数据：根据业务规则过滤掉不符合要求的数据。例如，只保留备注中包含"114"的记录。

异常处理与补救机制

为了确保数据同步过程中的稳定性和可靠性，需要设置异常处理和补救机制。元数据配置中提供了一个定时任务（crontab）用于定期检查并补救遗漏的数据：

{
  "crontab": "44 * * * *",
  "takeOverRequest": [
    {
      "field": "start_time",
      "label": "开始时间",
      "type": "datetime",
      "value": "{{HOURE_AGO_1|datetime}}"
    },
    {
      "field": "end_time",
      "label": "结束时间",
      "type": "datetime",
      "value": "{{CURRENT_TIME|datetime}}"
    }
  ]
}

该配置表示每小时第44分钟执行一次检查任务，查询过去一小时内的数据并进行补救。

实践案例

假设我们需要同步采购入库单到金蝶系统，可以按照以下步骤进行操作：

配置API调用：按照上述请求参数设置，通过轻易云平台发起API调用。
获取原始数据：解析API返回的数据，并存储到临时表中。
清洗与转换：对临时表中的数据进行去重、字段映射、格式转换等操作。
写入目标系统：将清洗后的数据写入金蝶系统。

通过上述步骤，我们可以实现从旺店通·企业奇门接口获取采购入库单，并将其同步到金蝶系统。这不仅提高了数据处理效率，还确保了数据的一致性和准确性。打通金蝶云星空数据接口

使用轻易云数据集成平台实现采购入库数据同步至金蝶云星空

在数据集成的生命周期中，ETL（提取、转换、加载）过程是关键的一环。本文将详细探讨如何利用轻易云数据集成平台，将已经集成的源平台数据进行ETL转换，并最终通过金蝶云星空API接口写入目标平台。

数据请求与清洗

在进行ETL之前，我们首先需要从源系统中提取采购入库数据，并对其进行必要的清洗和预处理。这一步骤确保了后续的数据转换和加载能够顺利进行。

数据转换与写入

接下来，我们重点关注如何将清洗后的数据转换为金蝶云星空API接口所能接收的格式，并将其写入目标平台。以下是具体的元数据配置和操作步骤。

API接口配置

我们使用金蝶云星空的batchSave接口，通过POST方法提交采购入库数据。以下是主要字段及其配置：

FBillTypeID: 单据类型，固定值为"RKD01_SYS"。
FBusinessType: 业务类型，固定值为"CG"。
FBillNo: 单据编号，格式为"{order_no}-TC"。
FDate: 入库日期，对应源系统中的check_time字段。
FStockOrgId: 收料组织，固定值为"114"。
FPurchaseOrgId: 采购组织，固定值为"114"。
FSupplierId: 供应商，对应源系统中的provider_no字段。
FTakeDeliveryBill: 提货单号，对应源系统中的wms_result字段。

财务信息配置

财务信息部分包括结算组织和付款组织，这两个字段均固定为"114":

{
    "field": "FInStockFin",
    "label": "财务信息",
    "type": "object",
    "children": [
        {
            "field": "FSettleOrgId",
            "label": "结算组织",
            "type": "string",
            "parser": {"name": "ConvertObjectParser", "params": "FNumber"},
            "value": "114"
        },
        {
            "field": "FPayOrgId",
            "label": "付款组织",
            "type": "string",
            "parser": {"name": "ConvertObjectParser", "params": "FNumber"},
            "value": "114"
        }
    ]
}

明细信息配置

明细信息部分包含多个子字段，如物料编码、实收数量、含税单价等：

{
    "field": "FInStockEntry",
    "label": "明细信息",
    "value":"details_list",
    "type":"array",
    ...
}

每个子字段的具体配置如下：

FMaterialId: 物料编码，对应details_list.spec_no。
FRealQty: 实收数量，对应details_list.right_num。

FTaxPrice: 含税单价，通过查询获取：

_findCollection find FTaxPrice from 33cfe43b-bebf-3b08-8b57-7aff5e10f609 where FBillNo={outer_no} FMaterialId={{details_list.spec_no}}

FStockId: 仓库，对应源系统中的warehouse_no字段。

关联关系配置

关联关系用于维护与源单之间的映射关系：

{
    ...
    {
        "field":"FInStockEntry_Link",
        ...
        {
            ...
            {
                ...
                {
                    ...
                    {
                        ...
                        {
                            ...
                            {"field":"FInStockEntry_Link_FSBillId","label":"源单ID","type":"string","value":"_findCollection find FID from 33cfe43b-bebf-3b08-8b57-7aff5e10f609 where FBillNo={outer_no}"}
                        }
                    }
                }
            }
        }
    }
}

其他请求参数

除了上述主要字段外，还有一些其他请求参数需要配置：

[
    {"field":"FormId","label":"业务对象表单Id","type":"string","value":"STK_InStock"},
    {"field":"IsAutoSubmitAndAudit","label":"提交并审核","type":"bool","value":"true"},
    {"field":"Operation","label":"执行的操作","type":"string","value":"Save"},
    {"field":"IsVerifyBaseDataField","label":"验证基础资料","type":"bool","value":"true"}
]

这些参数确保了在提交数据时能够自动完成审核，并且验证基础资料的正确性。

实现步骤总结

从源系统提取并清洗采购入库数据。
根据元数据配置，将清洗后的数据转换为金蝶云星空API接口所能接收的格式。
使用POST方法调用金蝶云星空的batchSave接口，将转换后的数据写入目标平台。

通过上述步骤，我们可以高效地实现采购入库数据从源系统到金蝶云星空平台的无缝对接。如何开发企业微信API接口