使用轻易云集成平台实现金蝶盘亏单到旺店通的数据传输

2021-04-21 05:48:33
轻易云集成顾问-彭萍

金蝶盘亏单到旺店通委外出库单（3000云仓）数据集成案例分享

在本次的系统对接集成过程中，我们聚焦于实现金蝶云星空中的盘盈/盘亏数据与旺店通·企业奇门的数据同步。具体方案是将金蝶云星空中的盘亏单据转换为旺店通中相应的委外出库单，用以支撑企业高效的数据流转和业务运作。

首先，我们需要从金蝶云星空获取对应的盘亏单数据。这部分工作通过调用executeBillQuery API接口来完成。此接口允许我们精确查询符合特定条件的账单，并支持分页处理，以确保能够稳定地抓取大量数据而不导致性能瓶颈或超时问题。

在数据提取过程中，轻易云平台提供了强大的高吞吐量写入能力，可以快速、高效地将大批量的数据导入目标系统，即旺店通·企业奇门。在此步骤中，使用API wdt.vip.wms.stockinout.order.push 接口进行每笔订单的数据推送操作。针对不同系统间可能存在的数据结构差异，灵活配置自定义转换逻辑也是解决方案的重要组成部分。

为了保障整个集成过程的可靠性和实时监控功能，该平台提供了一整套集中化监控与告警机制，包括对任务执行状态、性能指标以及出现异常情况时及时报警等一系列措施，从而有效保证了集成过程的透明性与操作安全。此外，对于由于网络波动或者接口响应延迟等原因引发的一些临时异常状况，设计并实现了错误重试策略，在确保不会漏掉任何一笔关键业务数据上起到了至关重要的作用。

本文将在后续部分详细介绍如何利用上述技术特性和方案细节，实现一个稳定、高效且可扩展性的金蝶盘亏单向旺店通委外出库单的数据对接过程，希望能为同类项目提供一些有价值的参考和实战经验。数据集成平台API接口配置

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

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

接口配置与请求参数

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

API: executeBillQuery
Method: POST
Pagination: 支持分页，每页大小为500条记录
Request Fields: 包含多个字段，如FBillEntry_FEntryID, FID, FBillNo, FDocumentStatus等
Other Request Parameters: 包括分页参数、过滤条件和需查询的字段集合等

以下是一个示例请求体，用于从金蝶云星空获取盘亏单数据：

{
  "FormId": "STK_StockCountLoss",
  "FieldKeys": "FBillEntry_FEntryID,FID,FBillNo,FDocumentStatus,FStockOrgId.FNumber,FDate,FBillTypeID,FStockerId,FCreatorId,FCreateDate,FModifierId,FModifyDate,FApproverId,FApproveDate,FNoteHead,FMaterialId.FNumber,FUnitID,FAcctQty,FCountQty,FLossQty,FStockId.FNumber,FStockStatusId,FOwnerid.FNumber,FPrice,FAmount,Fnote,FBomId,FMtoNo,FStockFlag,FLOT.FNumber,FProduceDate,FExpiryDate,F_UHZG_JJQty",
  "FilterString": "FApproveDate>='{{LAST_SYNC_TIME|datetime}}' and FStockOrgId.FNumber='3000' and FStockId.FNumber='1104'",
  "Limit": 500,
  "StartRow": 0,
  "TopRowCount": true
}

数据清洗与转换

在获取到原始数据后，下一步是对数据进行清洗和转换。这一步骤非常重要，因为它确保了最终写入目标系统的数据是准确且符合业务需求的。

字段映射与转换:
- 将金蝶云星空返回的数据字段映射到目标系统所需的字段。例如，将FBillEntry_FEntryID映射为目标系统中的唯一标识。
- 对日期格式进行转换，使其符合目标系统的要求。
数据过滤与校验:
- 根据业务规则对数据进行过滤。例如，只保留盘亏数量不为零的记录。
- 校验关键字段是否为空或格式是否正确，确保数据完整性。
批量处理与分页:
- 如果返回的数据量较大，需要进行分页处理。每次请求500条记录，并根据返回结果中的总行数继续请求下一页，直到获取所有数据。
- 批量处理可以提高效率，减少接口调用次数。

以下是一个示例代码片段，用于处理和转换从金蝶云星空获取的数据：

def process_data(raw_data):
    processed_data = []
    for record in raw_data:
        if record['FLossQty'] != '0':
            processed_record = {
                'entry_id': record['FBillEntry_FEntryID'],
                'bill_no': record['FBillNo'],
                'document_status': record['FDocumentStatus'],
                'stock_org': record['FStockOrgId.FNumber'],
                'date': convert_date_format(record['FDate']),
                'material_code': record['FMaterialId.FNumber'],
                'loss_qty': float(record['FLossQty']),
                # 更多字段映射...
            }
            processed_data.append(processed_record)
    return processed_data

def convert_date_format(date_str):
    # 假设原始日期格式为 YYYY-MM-DD，需要转换为 MM/DD/YYYY
    return datetime.strptime(date_str, '%Y-%m-%d').strftime('%m/%d/%Y')

实时监控与日志记录

在整个数据集成过程中，实时监控和日志记录是不可或缺的一部分。通过轻易云平台提供的可视化界面，可以实时监控每个环节的数据流动和处理状态。一旦出现异常，可以快速定位问题并进行修复。

日志记录则有助于追踪历史操作，为后续分析和审计提供依据。建议在每次接口调用、数据清洗和转换过程中都记录详细日志，包括请求参数、响应结果和处理步骤等信息。

综上所述，通过合理配置元数据、精细化的数据清洗与转换，以及完善的监控与日志机制，可以高效地实现从金蝶云星空获取盘亏单数据并加工，为后续的数据写入打下坚实基础。金蝶与CRM系统接口开发配置

利用轻易云数据集成平台实现金蝶盘亏单到旺店通委外出库单的ETL转换

在数据集成过程中，ETL（Extract, Transform, Load）是关键的一步。本文将详细探讨如何利用轻易云数据集成平台，将金蝶盘亏单的数据转换为旺店通·企业奇门API接口所能接收的格式，并最终写入目标平台。

数据转换与写入流程

数据请求与清洗：从源系统（如金蝶）获取原始数据，并进行必要的清洗操作。
数据转换与写入：将清洗后的数据按照目标系统（如旺店通）的要求进行转换，并通过API接口写入目标系统。

元数据配置解析

为了实现上述流程，我们需要配置元数据，以确保数据能够正确地映射和传输到目标平台。以下是具体的元数据配置：

{
  "api": "wdt.vip.wms.stockinout.order.push",
  "effect": "EXECUTE",
  "method": "POST",
  "idCheck": true,
  "operation": {
    "method": "merge",
    "field": "FBillNo,FDate,FStockId_FNumber",
    "bodyName": "details_listss",
    "bodySum": ["F_UHZG_JJQty"],
    "header": ["FBillNo", "FStockId_FNumber", "FBillTypeID", "Fnote"],
    "body": ["FMaterialId_FNumber", "FQty", "FPrice", "FLOT", "F_UHZG_JJQty"]
  },
  "request": [
    {
      "field": "api_outer_no",
      "label": "接口外部单号",
      "type": "string",
      "describe": "调用本接口时推送的唯一单据编号，避免重复推送数据",
      "value": "{FBillNo}"
    },
    {
      "field": "warehouse_no",
      ...

配置细节解析

API接口配置：
- api: 接口名称，为wdt.vip.wms.stockinout.order.push。
- method: 请求方法，为POST。
- idCheck: 是否进行ID检查，设置为true。
操作定义：
- method: 操作方法，这里使用的是merge，表示合并操作。
- field: 合并字段，为FBillNo,FDate,FStockId_FNumber。
- bodyName: 明细列表名称，为details_listss。
- bodySum: 明细字段汇总，为F_UHZG_JJQty。
- header: 表头字段，包括FBillNo, FStockId_FNumber, FBillTypeID, Fnote。
- body: 明细字段，包括FMaterialId_FNumber, FQty, FPrice, FLOT, F_UHZG_JJQty。
请求参数映射：
- api_outer_no: 接口外部单号，对应金蝶盘亏单中的FBillNo。
- warehouse_no: 仓库编号，对应金蝶盘亏单中的FStockId_FNumber。
- order_type: 出入类型，固定值为1（出库）。
- auto_check: 自动审核，固定值为1（自动审核）。
- remark: 备注，对应金蝶盘亏单中的Fnote。
货品明细映射：
- 每个货品明细包含以下字段：
  - spec_no: 商家编码，对应金蝶盘亏单明细中的FMaterialId_FNumber
  - num: 入库数量，对应金蝶盘亏单明细中的F_UHZG_JJQty
  - price: 价格，对应金蝶盘亏单明细中的FPrice
  - batch_no: 批次编号，对应金蝶盘亏单明细中的批次信息
  - remark: 备注

实际应用案例

假设我们有一个金蝶盘亏单，其表头和表体信息如下：

表头信息：
```
{
"FBillNo": "PKD20231001",
...
}
```
表体信息：
```
[
{
  ...
  ...
}
]
```

通过上述元数据配置，我们可以将这些信息转换为旺店通·企业奇门API所需的格式，并通过POST请求将其发送至目标系统，实现无缝的数据对接。

总结

本文详细介绍了如何利用轻易云数据集成平台，将金蝶盘亏单的数据转换为旺店通·企业奇门API接口所能接收的格式，并最终写入目标平台。通过合理配置元数据，我们能够确保每个字段都能正确映射，从而实现高效、准确的数据集成。如何开发用友BIP接口