企业数据集成：新宝-金蝶云星空案例分析

  • 轻易云集成顾问-姚缘

发货单-收料通知单数据集成案例分享

在企业信息化建设中，数据的高效流转和准确对接至关重要。本文将聚焦于新宝-产业链协同平台与金蝶云星空之间的发货单-收料通知单数据集成案例，探讨如何通过轻易云数据集成平台实现这一目标。

在本次集成方案中，我们需要从新宝-产业链协同平台获取发货单数据，并将其批量写入到金蝶云星空系统中。为此，我们利用了新宝-产业链协同平台提供的API接口/wms/deliveryBill来定时可靠地抓取发货单数据，同时使用金蝶云星空的API接口batchSave进行数据写入。

为了确保整个集成过程的高效性和可靠性，我们采用了以下几项关键技术特性：

  1. 支持高吞吐量的数据写入能力：轻易云数据集成平台能够处理大量的数据请求，使得我们可以快速将大批量的发货单数据写入到金蝶云星空，极大提升了数据处理的时效性。

  2. 集中监控和告警系统：通过实时跟踪每个数据集成任务的状态和性能，我们能够及时发现并处理任何异常情况，确保整个流程顺畅无误。

  3. 自定义数据转换逻辑：由于新宝-产业链协同平台与金蝶云星空之间的数据结构存在差异，我们利用轻易云提供的数据转换功能，对抓取到的数据进行必要的格式转换，以适应目标系统的要求。

  4. 分页和限流处理：面对新宝-产业链协同平台接口可能存在的数据分页和限流问题，我们设计了相应的机制来逐页获取并合并所有需要的数据，从而保证不漏单、不重复。

  5. 异常处理与错误重试机制：在实际操作过程中，难免会遇到网络波动或其他意外情况导致的数据传输失败。为此，我们设置了完善的错误重试机制，以确保每一条发货单都能成功对接到金蝶云星空。

通过以上技术手段，本次发货单-收料通知单的数据集成不仅实现了高效、稳定、准确，还为后续更多业务场景下的数据对接奠定了坚实基础。在接下来的章节中，将详细介绍具体实施步骤及相关配置细节。 轻易云数据集成平台金蝶集成接口配置

用友与外部系统接口集成开发

调用新宝-产业链协同平台接口/wms/deliveryBill获取并加工数据

在数据集成过程中，调用源系统接口是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用新宝-产业链协同平台的接口/wms/deliveryBill，并对获取的数据进行加工处理。

接口配置与调用

首先，我们需要配置元数据，以便正确地调用新宝-产业链协同平台的接口。以下是关键的元数据配置：

{
  "api": "/wms/deliveryBill",
  "method": "POST",
  "number": "billNo",
  "id": "billNo",
  "idCheck": true,
  "sdk": "\\Adapter\\Donlim\\SDK\\DonlimSDK",
  "errorMsgKey": "msg",
  "dataListKey": "data",
  "autoPaging22": "page_no",
  "request": [
    {
      "field": "queryTime",
      "label": "queryTime",
      "type": "string",
      "describe": "查询大于时间范围内数据，只支持查询跨度1个月内的数据",
      "value": "{{LAST_SYNC_TIME|dateTime}}"
    }
  ]
}

该配置中，api字段指定了要调用的API路径，即/wms/deliveryBill。method字段定义了请求方法为POST。为了确保每次请求都能唯一标识一个发货单，我们使用了billNo作为唯一标识符。

数据请求与清洗

在实际操作中，我们需要根据业务需求设置查询参数。例如，通过设置queryTime来限定查询时间范围。这一步骤可以有效减少不必要的数据传输，提高效率。

{
  field: 'queryTime',
  label: 'queryTime',
  type: 'string',
  describe: '查询大于时间范围内数据，只支持查询跨度1个月内的数据',
  value: '{{LAST_SYNC_TIME|dateTime}}'
}

通过上述配置，可以实现定时可靠地抓取新宝-产业链协同平台接口的数据，并确保每次抓取的数据都是最新的。

数据转换与写入

获取到原始数据后，需要对其进行清洗和转换，以适应目标系统的要求。在这个过程中，可以利用轻易云提供的自定义数据转换逻辑功能，对数据进行格式调整和字段映射。例如，将发货单中的某些字段映射到金蝶云星空系统中的相应字段。

{
    // 示例：将发货单号映射为收料通知单号
    sourceField: 'billNo',
    targetField: 'receiptNoticeNo'
}

这种灵活的映射方式能够满足不同业务场景下的数据处理需求，确保集成过程顺利进行。

分页与限流处理

在处理大量数据时，分页和限流是不可避免的问题。通过元数据配置中的autoPaging22字段，可以自动处理分页请求，从而避免一次性拉取过多数据导致性能问题。同时，还可以设置限流策略，防止因频繁请求导致服务器压力过大。

{
    autoPaging22: 'page_no'
}

异常处理与重试机制

在实际操作中，不可避免会遇到各种异常情况，如网络故障、接口返回错误等。为了保证集成任务的稳定性，需要实现异常处理和重试机制。当出现错误时，通过捕获错误信息（如通过元数据中的errorMsgKey: msg)），记录日志并触发重试机制，以确保最终成功完成任务。

综上所述，通过合理配置元数据，并结合轻易云提供的强大功能，可以高效地实现从新宝-产业链协同平台获取并加工发货单数据，为后续的数据转换和写入打下坚实基础。这不仅提高了业务透明度和效率，也为企业数字化转型提供了有力支持。 如何对接金蝶云星空API接口

用友与MES系统接口开发配置

集成方案：发货单-收料通知单

在数据集成的生命周期中，第二步是将源平台的数据进行ETL转换，使其符合目标平台金蝶云星空API接口的格式要求，并最终写入目标平台。本文将详细探讨这一过程，特别是如何将新宝-产业链协同平台的数据转换为金蝶云星空能够接收的格式。

ETL转换与数据映射

在数据集成过程中，ETL（Extract, Transform, Load）转换是一个关键步骤。我们需要从源平台提取数据，对数据进行必要的清洗和转换，然后将其加载到目标平台。在这个案例中，我们需要将新宝-产业链协同平台的发货单数据转换为金蝶云星空API接口能够接收的收料通知单数据。

元数据配置解析

元数据配置是实现ETL转换的核心部分。以下是主要字段及其配置：

  1. 基本信息字段

    • FBillTypeID: 单据类型，固定值 FHTZD01_SYS。
    • FBillNo: 单据编号，直接映射。
    • FSaleOrgId: 销售组织，固定值 100。
    • FDate: 日期，使用 {applyTime} 动态值。
    • FCustomerID: 客户，通过 ConvertObjectParser 解析器，将 {orgId} 转换为相应的客户编号。

  2. 明细信息字段

    • F_GZHQ_Base: 物料编码，通过解析器将 {{deliveryDetail.materialNo}} 转换为对应的物料编码。
    • FQty: 销售数量，直接映射 {{deliveryDetail.materialNum}}。
    • FStockID: 出货仓库，固定值 CK003。

  3. 关联关系表

    • FEntity_Link_FRuleId: 转换规则，固定值 SaleOrder-OutStock。
    • FEntity_Link_FSBillId: 源单内码，通过 _findCollection 动态查找。

数据转换逻辑

为了确保数据能够正确地从新宝-产业链协同平台写入到金蝶云星空，我们需要实现以下几项关键技术：

  1. 自定义数据转换逻辑 使用自定义的数据转换逻辑来适应特定业务需求和数据结构。例如，将客户ID、物料编码等字段通过解析器进行动态转换，以确保目标系统能够识别这些数据。

  2. 批量处理与高吞吐量支持 为了提高处理效率，我们可以利用轻易云的数据写入能力，实现批量处理和高吞吐量支持。这使得大量发货单数据能够快速被写入金蝶云星空系统，从而提升整体处理时效性。

  3. 分页与限流处理 在调用新宝-产业链协同平台接口时，需要考虑分页和限流问题。通过合理设置分页参数和限流策略，可以避免因请求过多而导致的接口超时或失败。

  4. 异常处理与重试机制 在对接过程中，如果发生异常情况，需要有相应的错误处理机制。例如，当某个请求失败时，可以记录日志并触发重试机制，以确保所有数据都能成功写入目标系统。

  5. 实时监控与日志记录 通过轻易云提供的集中监控和告警系统，可以实时跟踪数据集成任务的状态和性能。一旦发现问题，可以及时进行干预和修正。

实现示例

以下是一个简化后的实现示例，用于展示如何配置和调用API接口：

{
    "api": "batchSave",
    "method": "POST",
    "request": [
        {
            "field": "FBillTypeID",
            "value": "FHTZD01_SYS"
        },
        {
            "field": "FBillNo",
            "value": "{billNo}"
        },
        {
            "field": "FSaleOrgId",
            "value": "100"
        },
        {
            "field": "FDate",
            "value": "{applyTime}"
        },
        {
            "field": "FCustomerID",
            "parser": {
                "name": "ConvertObjectParser",
                "params": "FNumber"
            },
            "value": "{orgId}"
        }
    ],
    ...
}

以上配置展示了如何将基础字段映射到金蝶云星空API接口所需格式。实际应用中，还需根据业务需求完善其他字段及其对应关系。

注意事项

在进行数据对接时，需要特别注意以下几点：

  • 确保所有必填字段都已正确映射并赋值。
  • 验证基础资料是否有效，以避免因无效数据导致的对接失败。
  • 定期检查日志记录，以便及时发现并解决潜在问题。

通过上述步骤，可以高效地完成从新宝-产业链协同平台到金蝶云星空的数据集成，实现自动化、可靠的数据传输。 金蝶与SCM系统接口开发配置

金蝶与外部系统打通接口

版权声明

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

金蝶云星辰与聚水潭对接
更多系统对接方案