markdown

![](https://pic.qeasy.cloud/QEASY/A6.png)

### 21 赠品销售退库单集成方案(无关联)

在企业的日常运营中，数据的高效流转和准确对接至关重要。本文将聚焦于一个具体的系统对接集成案例：如何将旺店通·旗舰奇门的数据集成到金蝶云星空，以实现21 赠品销售退库单的无缝对接。

为了确保数据在两个平台之间顺利传输，我们利用了旺店通·旗舰奇门提供的API接口`wdt.wms.stockin.refund.querywithdetail`来获取数据，并通过金蝶云星空的`batchSave`接口进行批量写入。这一过程中，轻易云数据集成平台发挥了关键作用，通过其高吞吐量的数据写入能力，使得大量数据能够快速被处理和传输，大大提升了整体效率。

此外，为了保证数据质量和实时性，我们配置了集中监控和告警系统，实时跟踪每个数据集成任务的状态和性能。这不仅帮助我们及时发现并处理异常，还确保了整个流程透明可视、可控。

在实际操作中，我们还需要应对一些技术挑战，例如处理旺店通·旗舰奇门接口的分页和限流问题，以及解决两者之间的数据格式差异。通过自定义的数据转换逻辑，我们成功地适配了特定业务需求，确保数据在传输过程中的完整性和一致性。

总之，通过这一方案，不仅实现了旺店通·旗舰奇门与金蝶云星空之间的数据无缝对接，还极大提升了业务流程的自动化程度，为企业带来了显著的效率提升。
![打通用友BIP数据接口](https://pic.qeasy.cloud/D6.png)

![电商OMS与ERP系统接口开发配置](https://pic.qeasy.cloud/QEASY/A51.png)

### 调用旺店通·旗舰奇门接口wdt.wms.stockin.refund.querywithdetail获取并加工数据

在轻易云数据集成平台的生命周期中，调用源系统接口是至关重要的一步。本文将详细探讨如何通过调用旺店通·旗舰奇门接口`wdt.wms.stockin.refund.querywithdetail`来获取并加工赠品销售退库单的数据。

#### 接口配置与请求参数

首先，我们需要配置元数据，以便正确地调用该接口。以下是关键的元数据配置：

```json
{
  "api": "wdt.wms.stockin.refund.querywithdetail",
  "method": "POST",
  "number": "order_no",
  "id": "order_no",
  "idCheck": true,
  "request": [
    {
      "field": "pager",
      "label": "分页参数",
      "type": "object",
      "children": [
        {"field": "page_size", "label":"分页大小", "type":"string", "value":"50", "parent":"pager"},
        {"field": "page_no",   "label":"页号",   "type":"string",   "value":"1",   "parent":"pager"}
      ]
    },
    {
      ...
    }
  ],
  ...
}
```

上述配置定义了API的基本信息和请求参数，其中包括分页参数和业务参数。分页参数确保我们能够处理大量数据，而业务参数则根据具体需求进行定制化设置。

#### 分页与限流处理

为了高效地处理大规模数据，我们采用分页机制，每次请求返回50条记录。通过调整`page_no`字段，可以逐页获取所有符合条件的数据。此外，为了避免触发接口的限流机制，我们可以在每次请求之间加入适当的延时，确保不会超出API调用频率限制。

#### 数据质量监控与异常检测

在数据集成过程中，实时监控和异常检测是必不可少的环节。轻易云平台提供了强大的监控和告警系统，可以实时跟踪每个任务的状态。一旦发现异常，如网络故障或数据格式错误，系统会立即发出告警，并自动尝试重试操作。这种机制极大地提高了数据集成过程的可靠性。

#### 自定义数据转换逻辑

不同系统间的数据结构往往存在差异，因此需要自定义转换逻辑以适应特定业务需求。例如，从旺店通·旗舰奇门获取的数据可能包含多个字段，但目标系统金蝶云星空只需要其中一部分。在这种情况下，可以编写自定义脚本，对原始数据进行清洗和转换，使其符合目标系统的要求。

```json
{
  ...
  {
    ...
    {"field":"start_time","label":"开始时间","type":"string","value":"{{LAST_SYNC_TIME|datetime}}","parent":"params"},
    {"field":"end_time","label":"结束时间","type":"string","value":"{{CURRENT_TIME|datetime}}","parent":"params"},
    ...
  }
}
```

上面的例子展示了如何使用模板变量动态生成查询时间范围，这样可以确保每次同步操作都能捕获最新的数据变化。

#### 实时监控与日志记录

为了进一步提升透明度和可追溯性，轻易云平台支持对整个数据处理过程进行实时监控和日志记录。通过可视化界面，用户可以直观地查看每个步骤的执行情况，包括成功率、处理时间等关键指标。这不仅有助于及时发现问题，还能为后续优化提供有力依据。

### 总结

通过以上步骤，我们成功实现了从旺店通·旗舰奇门接口获取并加工赠品销售退库单的数据。在这个过程中，利用轻易云平台强大的功能，包括高吞吐量的数据写入能力、集中监控与告警、自定义转换逻辑等，大大提升了数据集成效率和可靠性。
![打通钉钉数据接口](https://pic.qeasy.cloud/S13.png)

![钉钉与MES系统接口开发配置](https://pic.qeasy.cloud/QEASY/A22.png)

### 将赠品销售退库单数据转换并写入金蝶云星空

在数据集成生命周期的第二步，我们需要将已经集成的源平台数据进行ETL（提取、转换、加载）处理，以符合目标平台金蝶云星空API接口的要求，并最终将数据写入金蝶云星空。本文将详细探讨这一过程的技术细节及注意事项。

#### 数据请求与清洗

首先，我们从源系统（如旺店通·旗舰奇门）中获取赠品销售退库单的数据。这一步通常通过调用特定API接口来实现，例如`wdt.wms.stockin.refund.querywithdetail`接口，用于获取退库单的详细信息。在获取数据时，需要处理分页和限流问题，以确保数据请求的稳定性和完整性。

#### 数据转换

接下来是关键步骤：数据转换。我们需要根据金蝶云星空API接口的要求，对源数据进行结构化转换。以下是元数据配置中的一些关键字段及其转换逻辑：

1. **单据编号（FBillNo）**：
   ```json
   {"field":"FBillNo","label":"单据编号","type":"string","describe":"单据编号","value":"{order_no}"}
   ```
   这里，`order_no`是从源系统获取的订单编号，直接映射到目标字段`FBillNo`。

2. **单据类型（FBillTypeID）**：
   ```json
   {"field":"FBillTypeID","label":"单据类型","type":"string","describe":"单据类型","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"QTCKD01_SYS"}
   ```
   单据类型在金蝶云星空中有固定值`QTCKD01_SYS`，通过`ConvertObjectParser`解析器进行转换。

3. **日期（FDate）**：
   ```json
   {"field":"FDate","label":"日期","type":"string","describe":"日期","value":"{modified}"}
   ```
   日期字段直接取自源系统中的修改时间字段`modified`。

4. **明细信息（FEntity）**：
   明细信息是一个复杂对象数组，需要逐项映射和转换。例如，物料编码、实发数量、发货仓库等字段都需要进行相应的解析和映射。
   
   - **物料编码（FMaterialId）**：
     ```json
     {"field":"FMaterialId","label":"物料编码","type":"string","describe":"基础资料","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"{{details_list.spec_no}}"}
     ```
     物料编码通过解析器将`details_list.spec_no`转换为目标系统识别的格式。
   
   - **实发数量（FQty）**：
     ```json
     {"field":"FQty","label":"实发数量","type":"string","describe":"数量","value":"{{details_list.goods_count}}"}
     ```
     实发数量直接映射为`details_list.goods_count`。
   
   - **发货仓库（FStockId）**：
     ```json
     {"field":"FStockId","label":"发货仓库","type":"string","describe":"基础资料","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"_findCollection find FNumber from 9c02adb6-7e63-326e-b5b3-dea634490062 where F_KD_WDTSTOCK={warehouse_no}"}
     ```
     发货仓库通过复杂查询语句进行映射，确保仓库编号与目标系统一致。

#### 数据写入

完成所有必要的数据转换后，即可调用金蝶云星空的API接口进行数据写入。以下是关键配置：

- **批量保存接口（batchSave）**：
  ```json
  {"api": "batchSave", "method": "POST", "idCheck": true, "operation": {"rowsKey": "array", "rows": 1, "method": "batchArraySave"}}
  ```

- **业务对象表单ID（FormId）**：
  ```json
  {"field": "FormId", "label": "业务对象表单Id", "type": "string", "describe": "必须填写金蝶的表单ID如:PUR_PurchaseOrder", "value": "STK_MisDelivery"}
  ```

- **自动提交并审核（IsAutoSubmitAndAudit）**：
  ```json
  {"field": "IsAutoSubmitAndAudit", "label": "提交并审核", "type": "bool", "value": true}
  ```

在调用API接口时，确保所有必填字段已正确映射，并且遵循金蝶云星空API文档中的格式要求。若遇到异常情况，如网络故障或数据格式错误，应实现错误重试机制，以保证数据最终成功写入。

#### 实时监控与日志记录

为了确保整个ETL过程顺利进行，可以利用平台提供的实时监控和日志记录功能。通过集中监控和告警系统，及时发现并处理潜在问题，提高数据集成任务的可靠性和稳定性。

总结来说，通过合理配置元数据，并利用轻易云平台提供的数据转换工具，我们可以高效地将赠品销售退库单的数据从源平台转化为符合金蝶云星空API接口要求的格式，并成功写入目标系统，实现无缝的数据集成。
![金蝶与MES系统接口开发配置](https://pic.qeasy.cloud/T26.png)

![系统集成平台API接口配置](https://pic.qeasy.cloud/QEASY/A69.png)

实现21赠品销售退库单的无缝对接方案

21 赠品销售退库单集成方案(无关联)

为了确保数据在两个平台之间顺利传输，我们利用了旺店通·旗舰奇门提供的API接口wdt.wms.stockin.refund.querywithdetail来获取数据，并通过金蝶云星空的batchSave接口进行批量写入。这一过程中，轻易云数据集成平台发挥了关键作用，通过其高吞吐量的数据写入能力，使得大量数据能够快速被处理和传输，大大提升了整体效率。

总之，通过这一方案，不仅实现了旺店通·旗舰奇门与金蝶云星空之间的数据无缝对接，还极大提升了业务流程的自动化程度，为企业带来了显著的效率提升。打通用友BIP数据接口

电商OMS与ERP系统接口开发配置

调用旺店通·旗舰奇门接口wdt.wms.stockin.refund.querywithdetail获取并加工数据

在轻易云数据集成平台的生命周期中，调用源系统接口是至关重要的一步。本文将详细探讨如何通过调用旺店通·旗舰奇门接口wdt.wms.stockin.refund.querywithdetail来获取并加工赠品销售退库单的数据。

接口配置与请求参数

首先，我们需要配置元数据，以便正确地调用该接口。以下是关键的元数据配置：

{
  "api": "wdt.wms.stockin.refund.querywithdetail",
  "method": "POST",
  "number": "order_no",
  "id": "order_no",
  "idCheck": true,
  "request": [
    {
      "field": "pager",
      "label": "分页参数",
      "type": "object",
      "children": [
        {"field": "page_size", "label":"分页大小", "type":"string", "value":"50", "parent":"pager"},
        {"field": "page_no",   "label":"页号",   "type":"string",   "value":"1",   "parent":"pager"}
      ]
    },
    {
      ...
    }
  ],
  ...
}

分页与限流处理

为了高效地处理大规模数据，我们采用分页机制，每次请求返回50条记录。通过调整page_no字段，可以逐页获取所有符合条件的数据。此外，为了避免触发接口的限流机制，我们可以在每次请求之间加入适当的延时，确保不会超出API调用频率限制。

数据质量监控与异常检测

自定义数据转换逻辑

{
  ...
  {
    ...
    {"field":"start_time","label":"开始时间","type":"string","value":"{{LAST_SYNC_TIME|datetime}}","parent":"params"},
    {"field":"end_time","label":"结束时间","type":"string","value":"{{CURRENT_TIME|datetime}}","parent":"params"},
    ...
  }
}

上面的例子展示了如何使用模板变量动态生成查询时间范围，这样可以确保每次同步操作都能捕获最新的数据变化。

实时监控与日志记录

总结

通过以上步骤，我们成功实现了从旺店通·旗舰奇门接口获取并加工赠品销售退库单的数据。在这个过程中，利用轻易云平台强大的功能，包括高吞吐量的数据写入能力、集中监控与告警、自定义转换逻辑等，大大提升了数据集成效率和可靠性。打通钉钉数据接口

钉钉与MES系统接口开发配置

将赠品销售退库单数据转换并写入金蝶云星空

数据请求与清洗

首先，我们从源系统（如旺店通·旗舰奇门）中获取赠品销售退库单的数据。这一步通常通过调用特定API接口来实现，例如wdt.wms.stockin.refund.querywithdetail接口，用于获取退库单的详细信息。在获取数据时，需要处理分页和限流问题，以确保数据请求的稳定性和完整性。

数据转换

单据编号（FBillNo）：
```
{"field":"FBillNo","label":"单据编号","type":"string","describe":"单据编号","value":"{order_no}"}
```
这里，order_no是从源系统获取的订单编号，直接映射到目标字段FBillNo。

单据类型（FBillTypeID）：

{"field":"FBillTypeID","label":"单据类型","type":"string","describe":"单据类型","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"QTCKD01_SYS"}

单据类型在金蝶云星空中有固定值QTCKD01_SYS，通过ConvertObjectParser解析器进行转换。

日期（FDate）：

{"field":"FDate","label":"日期","type":"string","describe":"日期","value":"{modified}"}

日期字段直接取自源系统中的修改时间字段modified。

明细信息（FEntity）：明细信息是一个复杂对象数组，需要逐项映射和转换。例如，物料编码、实发数量、发货仓库等字段都需要进行相应的解析和映射。

物料编码（FMaterialId）：

{"field":"FMaterialId","label":"物料编码","type":"string","describe":"基础资料","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"{{details_list.spec_no}}"}

物料编码通过解析器将details_list.spec_no转换为目标系统识别的格式。

实发数量（FQty）：

{"field":"FQty","label":"实发数量","type":"string","describe":"数量","value":"{{details_list.goods_count}}"}

实发数量直接映射为details_list.goods_count。

发货仓库（FStockId）：

{"field":"FStockId","label":"发货仓库","type":"string","describe":"基础资料","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"_findCollection find FNumber from 9c02adb6-7e63-326e-b5b3-dea634490062 where F_KD_WDTSTOCK={warehouse_no}"}

发货仓库通过复杂查询语句进行映射，确保仓库编号与目标系统一致。

数据写入

完成所有必要的数据转换后，即可调用金蝶云星空的API接口进行数据写入。以下是关键配置：

批量保存接口（batchSave）：

{"api": "batchSave", "method": "POST", "idCheck": true, "operation": {"rowsKey": "array", "rows": 1, "method": "batchArraySave"}}

业务对象表单ID（FormId）：

{"field": "FormId", "label": "业务对象表单Id", "type": "string", "describe": "必须填写金蝶的表单ID如:PUR_PurchaseOrder", "value": "STK_MisDelivery"}

自动提交并审核（IsAutoSubmitAndAudit）：

{"field": "IsAutoSubmitAndAudit", "label": "提交并审核", "type": "bool", "value": true}

实时监控与日志记录

总结来说，通过合理配置元数据，并利用轻易云平台提供的数据转换工具，我们可以高效地将赠品销售退库单的数据从源平台转化为符合金蝶云星空API接口要求的格式，并成功写入目标系统，实现无缝的数据集成。金蝶与MES系统接口开发配置

系统集成平台API接口配置