从金蝶云星空到管易云：生产入库单数据集成案例

  • 轻易云集成顾问-钟敏甜

金蝶云星空与管易云的数据集成案例分享

在企业信息化建设中，数据的高效流动和准确对接是实现业务流程自动化的关键。本文将分享一个实际运行的系统对接集成案例：如何将金蝶云星空中的生产入库单数据集成到管易云的其他入库单中。

案例背景

在本次集成方案中，我们需要从金蝶云星空获取生产入库单数据，并将其写入到管易云作为其他入库单。这一过程不仅要求高效的数据传输，还需确保数据的一致性和完整性。为此，我们利用了轻易云数据集成平台提供的一系列特性来实现这一目标。

技术要点

  1. 高吞吐量的数据写入能力：为了应对大量生产入库单数据的快速处理需求，我们采用了轻易云平台支持的大规模并发写入功能，确保数据能够及时、高效地导入到管易云系统中。

  2. 实时监控与告警系统：通过集中监控和告警机制，我们可以实时跟踪每个数据集成任务的状态和性能。一旦出现异常情况，系统会立即发出告警通知，以便及时采取措施，避免业务中断。

  3. API接口调用：

    • 从金蝶云星空获取生产入库单数据时，我们使用了executeBillQuery API接口，该接口支持分页查询，能够有效处理大批量数据。
    • 将获取的数据写入到管易云时，调用的是gy.erp.stock.other.in.add API接口，通过该接口完成其他入库单的创建。

  4. 自定义数据转换逻辑：由于金蝶云星空与管易云之间的数据结构存在差异，我们在集成过程中设计了自定义的数据转换逻辑，以确保两者之间的数据格式匹配，从而保证数据准确无误地传输。

  5. 异常处理与错误重试机制：在实际操作过程中，不可避免地会遇到网络波动或API限流等问题。我们通过设置异常处理和错误重试机制，有效提升了系统的稳定性和可靠性。

  6. 定时抓取与批量处理：为了保证金蝶云星空中的最新生产入库单能够及时同步至管易云，我们配置了定时任务来定期抓取新生成的数据，并进行批量处理，提高整体效率。

通过上述技术手段，本次集成方案不仅实现了金蝶-生产入库单到管易-其他入库单的数据对接，还显著提升了整个流程的自动化程度和运行效率。在后续章节中，将详细介绍具体实施步骤及技术细节。 钉钉与MES系统接口开发配置

金蝶云星空API接口配置

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

在轻易云数据集成平台中，调用源系统金蝶云星空接口executeBillQuery是生命周期的第一步。此步骤至关重要，因为它决定了后续数据处理和写入的基础。以下将详细探讨如何配置和使用该接口来获取生产入库单数据，并进行必要的数据加工。

配置元数据

首先，我们需要根据提供的元数据配置metadata，设置请求参数。这些参数包括字段名称、类型、描述等信息，用于定义从金蝶云星空系统中提取的数据结构。

{
  "api": "executeBillQuery",
  "method": "POST",
  "request": [
    {"field":"FEntity_FEntryID","label":"id","type":"string"},
    {"field":"FMoEntrySeq","label":"FMoEntrySeq","type":"string"},
    {"field":"FID","label":"实体主键","type":"string"},
    {"field":"FBillNo","label":"单据编号","type":"string"},
    {"field":"FMoBillNo","label":"生产订单编号","type":"string"},
    {"field":"FMaterialId_FNumber","label":"物料编码","type":"string"},
    {"field":"FMaterialId_FName","label":"物料名称","type":"string"},
    {"field": "FRealQty", "label": "实收数量", "type": "string"}
  ],
  "otherRequest": [
    {"field": "Limit", "value": "{PAGINATION_PAGE_SIZE}"},
    {"field": "StartRow", "value": "{PAGINATION_START_ROW}"},
    {"field": "FilterString", "value": "FApproveDate>='{{LAST_SYNC_TIME|dateTime}}'"},
    {"field": "FormId", "value": "PRD_INSTOCK"}
  ]
}

调用API接口

通过上述配置，我们可以构建一个HTTP POST请求来调用executeBillQuery接口。关键参数包括：

  • FormId: 表单ID，例如"PRD_INSTOCK"，用于指定业务对象表单。
  • FieldKeys: 查询字段集合，通过解析器将数组转换为字符串。
  • FilterString: 用于过滤条件，例如按时间戳过滤最近更新的数据。
  • 分页参数：Limit和StartRow用于控制分页查询。

示例请求体如下：

{
  "FormId": "PRD_INSTOCK",
  "FieldKeys": ["FBillNo", ...],
  ...
}

数据清洗与转换

获取到原始数据后，需要对其进行清洗和转换，以适应目标系统（如管易云）的要求。这一步骤包括但不限于：

  1. 字段映射：将金蝶云星空中的字段映射到管易云对应的字段。例如，将“FBillNo”映射为“order_no”。
  2. 数据格式转换：确保日期、数字等字段格式符合目标系统要求。
  3. 异常处理：检测并处理异常值，如缺失或无效的数据。

例如，将原始数据中的物料编码和实收数量进行转换：

[
  {
    "_id" : ObjectId("..."),
    ...
    FMaterialId_FNumber: 'M001',
    FRealQty: '100'
  }
]

经过清洗后的结果可能如下：

[
  {
    "material_code" : 'M001',
    "received_qty" : '100'
  }
]

实现高效分页与限流

为了确保大批量数据的高效处理，必须实现分页机制，并注意限流问题。通过设置合理的分页大小（如每次查询100条记录），可以避免一次性拉取过多数据导致性能问题。同时，需监控API调用频率，避免触发源系统的限流策略。

实时监控与日志记录

在整个过程中，实时监控与日志记录是不可或缺的一部分。通过轻易云平台提供的集中监控和告警系统，可以实时跟踪每个集成任务的状态和性能。一旦发现异常情况，可以及时采取措施进行修复。

综上所述，通过合理配置元数据、调用金蝶云星空接口、实施有效的数据清洗与转换，以及利用轻易云平台强大的监控功能，可以高效完成从金蝶到管易的数据集成任务，为企业提供可靠的数据支持。 金蝶与CRM系统接口开发配置

打通用友BIP数据接口

金蝶云星空生产入库单数据集成到管易云其他入库单的ETL转换

在数据集成过程中，关键的一步是将源平台的数据进行ETL转换，以满足目标平台API接口的需求。本文将详细探讨如何将金蝶云星空中的生产入库单数据通过轻易云数据集成平台转换为管易云API接口所能接收的格式，并最终写入管易云系统。

数据请求与清洗

首先，通过金蝶云星空的API接口获取生产入库单的数据。在这个过程中，需要确保从金蝶云星空获取的数据是完整且准确的。可以通过调用金蝶云星空的executeBillQuery接口来定时抓取生产入库单的数据，同时要处理分页和限流问题，确保数据不漏单。

{
  "api": "executeBillQuery",
  "params": {
    "billType": "生产入库单",
    "page": 1,
    "pageSize": 100
  }
}

数据转换与写入

一旦获取到生产入库单的数据，接下来需要将其转换为管易云其他入库单所需的格式。根据元数据配置，我们需要将金蝶云星空中的字段映射到管易云API所需字段。

  • FSTOCKID 映射到 warehouse_code
  • FBillNo 映射到 wms_bizcode
  • FMATERIALID_FNumber 映射到 item_code
  • FMaterialId_FNumber 映射到 sku_code
  • FQty 映射到 qty
  • FDate 映射到 stockDate
  • FStockLocId 映射到 location_code

此外，还需要确保商品列表（details）的每个商品信息都按照上述映射规则进行转换。

{
  "api": "gy.erp.stock.other.in.add",
  "method": "POST",
  "params": {
    "warehouse_code": "{FSTOCKID}",
    "note": "",
    "type": "",
    "wms_bizcode": "{FBillNo}",
    "details": [
      {
        "item_code": "{FMATERIALID_FNumber}",
        "sku_code": "{FMaterialId_FNumber}",
        "barcode": "",
        "qty": "{FQty}",
        "stockDate": "{FDate}",
        "location_code": "{FStockLocId}"
      }
    ]
  }
}

实现高效的数据写入

为了确保大量数据能够快速写入管易云系统，轻易云平台支持高吞吐量的数据写入能力。这使得在处理大批量数据时，能够保持较高的效率和稳定性。此外，轻易云平台还提供了批量集成功能，可以一次性将多个生产入库单转换并写入目标平台。

数据质量监控与异常处理

在整个ETL过程中，实时监控和异常处理是不可或缺的一部分。轻易云平台提供了集中监控和告警系统，可以实时跟踪数据集成任务的状态和性能。一旦发现数据质量问题或异常情况，可以及时进行处理。例如，当遇到网络波动或接口调用失败时，可以实现错误重试机制，以保证数据传输的可靠性。

{
  "errorRetryPolicy": {
    "maxRetries": 3,
    "retryIntervalSeconds": 5
  }
}

自定义数据转换逻辑

为了适应特定业务需求，轻易云平台支持自定义数据转换逻辑。例如，对于某些特定类型的商品，可能需要额外的字段映射或特殊处理逻辑。可以通过配置自定义脚本来实现这些需求，从而确保每个业务场景下的数据都能正确地进行转换和写入。

实时监控与日志记录

最后，为了全面掌握数据处理过程，轻易云平台提供了详细的日志记录功能。从数据请求、清洗、转换到最终写入，每个环节都可以进行实时监控和记录。这不仅有助于快速定位问题，还能为后续优化提供参考依据。

通过上述步骤，我们可以高效地实现金蝶云星空生产入库单数据向管易云其他入库单的ETL转换，并确保整个过程的数据质量和稳定性。 用友与外部系统接口集成开发

金蝶与SCM系统接口开发配置

版权声明

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

轻易云企业AIGC应用
更多系统对接方案