markdown

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

### 旺店通入库单-金蝶其他入库单【预入库】集成案例分享

在企业信息化管理中，数据的高效流动和准确对接是提升业务效率的关键。本文将聚焦于一个具体的系统对接集成案例：如何将旺店通·企业奇门的数据无缝集成到金蝶云星空中，实现旺店通入库单与金蝶其他入库单【预入库】的高效对接。

#### 数据获取与写入能力

首先，我们需要从旺店通·企业奇门系统中获取相关数据。通过调用`wdt.stockin.order.query`接口，可以定时可靠地抓取到最新的入库单数据。这一过程不仅确保了数据不漏单，还能处理接口分页和限流问题，保证了数据获取的稳定性和连续性。

#### 实时监控与告警系统

为了确保整个数据集成过程的顺利进行，我们利用了平台提供的集中监控和告警系统。该系统能够实时跟踪每个数据集成任务的状态和性能，一旦出现异常情况，立即触发告警机制，并记录详细日志以便后续分析和处理。这种实时监控大大提升了数据处理过程中的透明度和可靠性。

#### 数据转换与映射

在完成数据获取之后，需要将这些数据快速写入到金蝶云星空中。由于两个系统之间的数据格式存在差异，我们使用自定义的数据转换逻辑来适应特定业务需求。在这一过程中，通过调用金蝶云星空的`batchSave`接口，将转换后的数据批量写入目标平台，实现了大量数据的快速、高效集成。

#### 数据质量与异常处理

为了确保最终写入的数据质量，我们引入了严格的数据质量监控和异常检测机制。一旦发现任何数据问题，系统会自动进行错误重试，并记录详细日志供后续审查。这种机制不仅提高了整体数据质量，还有效减少了人工干预，提高了工作效率。

通过上述技术手段，本次集成方案成功实现了旺店通·企业奇门与金蝶云星空之间的数据无缝对接，为企业提供了一套高效、可靠的数据管理解决方案。
![金蝶与SCM系统接口开发配置](https://pic.qeasy.cloud/D16.png)

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

### 调用旺店通·企业奇门接口wdt.stockin.order.query获取并加工数据

在数据集成的生命周期中，第一步是从源系统获取数据，并进行初步加工处理。本文将详细探讨如何通过轻易云数据集成平台调用旺店通·企业奇门接口`wdt.stockin.order.query`来实现这一过程。

#### 配置元数据

首先，我们需要配置元数据，以便正确调用API接口并获取所需的数据。以下是关键的元数据配置项：

- **api**: `wdt.stockin.order.query`
- **method**: `POST`
- **number**: `order_no`
- **idCheck**: `true`

这些配置项定义了我们要调用的API接口及其请求方法，同时指定了用于唯一标识订单的字段`order_no`。

#### 请求参数设置

为了确保我们能够准确地获取到所需的数据，需要设置一系列请求参数。这些参数包括时间范围、单据类别、状态等。具体如下：

```json
[
  {"field":"start_time","label":"开始时间","type":"datetime","describe":"按最后修改时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss","value":"{{LAST_SYNC_TIME|datetime}}"},
  {"field":"end_time","label":"结束时间","type":"datetime","describe":"按最后修改时间增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss","value":"{{CURRENT_TIME|datetime}}"},
  {"field":"order_type","label":"源单据类别","type":"string","describe":"源单据类别 10 预入库","value":"10"},
  {"field":"status","label":"入库单状态","type":"string","describe":"入库单状态 80 已完成（默认查询已完成单据）","value":"80"}
]
```

这些参数确保我们只获取特定类型和状态的入库单，并且按照最后修改时间进行增量更新。

#### 分页与限流处理

由于可能存在大量的数据，我们需要对API请求进行分页处理，以避免一次性拉取过多数据导致性能问题。分页参数如下：

```json
[
  {"field": "page_size", "label": "分页大小", "type": "string", "describe": "每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40", "value": "50"},
  {"field": "page_no", "label": "页号", "type": "string", "describe": "不传值默认从0页开始"}
]
```

通过设置合理的分页大小和页号，可以有效控制每次请求的数据量，从而提高系统稳定性和响应速度。

#### 数据过滤与条件设置

为了进一步精确筛选出符合业务需求的数据，可以使用条件过滤功能。例如，我们可以排除某些仓库或特定原因的入库单：

```json
[
  [{"field": "stockin_reason", "logic": "notlike", "value": "生产"}, {"field": "warehouse_name", "logic": "like", "value": "七遇"}],
  [{"field":"stockin_reason","logic
![如何开发企业微信API接口](https://pic.qeasy.cloud/S30.png)

![用友BIP接口开发配置](https://pic.qeasy.cloud/QEASY/A78.png)

### 集成方案：旺店通入库单-金蝶其他入库单【预入库】

在数据集成生命周期的第二步，将已经集成的源平台数据进行ETL转换，并转为目标平台金蝶云星空API接口所能够接收的格式，是一个至关重要的环节。本文将深入探讨如何配置和使用元数据，将旺店通的入库单数据转换并写入到金蝶云星空中。

#### 数据请求与清洗

首先，通过调用旺店通·企业奇门接口`wdt.stockin.order.query`获取原始数据。这一步需要处理分页和限流问题，以确保数据请求的稳定性和完整性。通过定时任务可靠抓取接口数据，避免遗漏订单。

#### 数据转换与写入

将清洗后的数据进行ETL转换，使其符合金蝶云星空API要求的格式。以下是关键字段及其配置：

- **FBillNo（单据编号）**：映射为`order_no`，用于唯一标识每一张单据。
- **FBillTypeID（单据类型）**：固定值为`QTRKD01_SYS`，通过`ConvertObjectParser`进行对象转换。
- **FStockOrgId（库存组织）**：映射为`warehouse_no`，同样使用`ConvertObjectParser`进行解析。
- **FDate（日期）**：格式化为日期时间字符串，映射为`stockin_time`。
- **FDEPTID（部门）**：根据不同的仓库编号映射到具体部门，通过自定义逻辑实现。
- **FOwnerTypeIdHead（货主类型）**：固定值为`BD_OwnerOrg`。
- **FOwnerIdHead（货主）**：固定值为`100`，使用对象解析器进行转换。

明细信息部分（FEntity）包括多个子字段：

- **FMATERIALID（物料编码）**：映射为明细列表中的规格编号字段 `details_list.spec_no`。
- **FQty（实收数量）**：映射为明细列表中的商品数量 `details_list.goods_count`。

这些字段通过元数据配置，实现从旺店通的数据格式到金蝶云星空API格式的转换。例如：

```json
{
  "field": "FBillNo",
  "label": "单据编号",
  "type": "string",
  "describe": "单据编号",
  "value": "{order_no}"
}
```

#### 数据写入目标平台

通过调用金蝶云星空API接口 `batchSave`, 使用 POST 方法提交转换后的数据。配置如下：

```json
{
  "api": "batchSave",
  "method": "POST",
  "idCheck": true,
  ...
}
```

在实际操作中，需要特别注意以下几点：

1. **验证基础资料有效性**：设置 `IsVerifyBaseDataField` 为 `true`, 确保所有基础资料在金蝶系统中有效。
2. **自动提交并审核**：设置 `IsAutoSubmitAndAudit` 为 `true`, 实现自动化流程，提高效率。
3. **错误处理与重试机制**：对于写入过程中可能出现的错误，需要设计异常处理和重试机制，确保数据一致性。

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

为了确保整个ETL过程的稳定运行，可以利用集中的监控和告警系统，实时跟踪每个任务的状态和性能。同时，通过日志记录功能，对每次操作进行详细记录，以便后续审计和问题排查。

综上所述，通过合理配置元数据和调用相关API接口，可以高效地实现旺店通入库单到金蝶云星空其他入库单【预入库】的数据集成。在此过程中，充分利用平台提供的数据质量监控、异常检测、自定义逻辑等功能，可以大幅提升数据处理的准确性和时效性。
![用友与WMS系统接口开发配置](https://pic.qeasy.cloud/T21.png)

![企业微信与OA系统接口开发配置](https://pic.qeasy.cloud/QEASY/A69.png)

实现旺店通与金蝶云的高效数据集成

旺店通入库单-金蝶其他入库单【预入库】集成案例分享

数据获取与写入能力

首先，我们需要从旺店通·企业奇门系统中获取相关数据。通过调用wdt.stockin.order.query接口，可以定时可靠地抓取到最新的入库单数据。这一过程不仅确保了数据不漏单，还能处理接口分页和限流问题，保证了数据获取的稳定性和连续性。

实时监控与告警系统

数据转换与映射

在完成数据获取之后，需要将这些数据快速写入到金蝶云星空中。由于两个系统之间的数据格式存在差异，我们使用自定义的数据转换逻辑来适应特定业务需求。在这一过程中，通过调用金蝶云星空的batchSave接口，将转换后的数据批量写入目标平台，实现了大量数据的快速、高效集成。

数据质量与异常处理

通过上述技术手段，本次集成方案成功实现了旺店通·企业奇门与金蝶云星空之间的数据无缝对接，为企业提供了一套高效、可靠的数据管理解决方案。金蝶与SCM系统接口开发配置

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

调用旺店通·企业奇门接口wdt.stockin.order.query获取并加工数据

在数据集成的生命周期中，第一步是从源系统获取数据，并进行初步加工处理。本文将详细探讨如何通过轻易云数据集成平台调用旺店通·企业奇门接口wdt.stockin.order.query来实现这一过程。

配置元数据

首先，我们需要配置元数据，以便正确调用API接口并获取所需的数据。以下是关键的元数据配置项：

api: wdt.stockin.order.query
method: POST
number: order_no
idCheck: true

这些配置项定义了我们要调用的API接口及其请求方法，同时指定了用于唯一标识订单的字段order_no。

请求参数设置

为了确保我们能够准确地获取到所需的数据，需要设置一系列请求参数。这些参数包括时间范围、单据类别、状态等。具体如下：

[
  {"field":"start_time","label":"开始时间","type":"datetime","describe":"按最后修改时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss","value":"{{LAST_SYNC_TIME|datetime}}"},
  {"field":"end_time","label":"结束时间","type":"datetime","describe":"按最后修改时间增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss","value":"{{CURRENT_TIME|datetime}}"},
  {"field":"order_type","label":"源单据类别","type":"string","describe":"源单据类别 10 预入库","value":"10"},
  {"field":"status","label":"入库单状态","type":"string","describe":"入库单状态 80 已完成（默认查询已完成单据）","value":"80"}
]

这些参数确保我们只获取特定类型和状态的入库单，并且按照最后修改时间进行增量更新。

分页与限流处理

由于可能存在大量的数据，我们需要对API请求进行分页处理，以避免一次性拉取过多数据导致性能问题。分页参数如下：

[
  {"field": "page_size", "label": "分页大小", "type": "string", "describe": "每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40", "value": "50"},
  {"field": "page_no", "label": "页号", "type": "string", "describe": "不传值默认从0页开始"}
]

通过设置合理的分页大小和页号，可以有效控制每次请求的数据量，从而提高系统稳定性和响应速度。

数据过滤与条件设置

为了进一步精确筛选出符合业务需求的数据，可以使用条件过滤功能。例如，我们可以排除某些仓库或特定原因的入库单：

[
  [{"field": "stockin_reason", "logic": "notlike", "value": "生产"}, {"field": "warehouse_name", "logic": "like", "value": "七遇"}],
  [{"field":"stockin_reason","logic
![如何开发企业微信API接口](https://pic.qeasy.cloud/S30.png)

![用友BIP接口开发配置](https://pic.qeasy.cloud/QEASY/A78.png)

### 集成方案：旺店通入库单-金蝶其他入库单【预入库】

在数据集成生命周期的第二步，将已经集成的源平台数据进行ETL转换，并转为目标平台金蝶云星空API接口所能够接收的格式，是一个至关重要的环节。本文将深入探讨如何配置和使用元数据，将旺店通的入库单数据转换并写入到金蝶云星空中。

#### 数据请求与清洗

首先，通过调用旺店通·企业奇门接口`wdt.stockin.order.query`获取原始数据。这一步需要处理分页和限流问题，以确保数据请求的稳定性和完整性。通过定时任务可靠抓取接口数据，避免遗漏订单。

#### 数据转换与写入

将清洗后的数据进行ETL转换，使其符合金蝶云星空API要求的格式。以下是关键字段及其配置：

- **FBillNo（单据编号）**：映射为`order_no`，用于唯一标识每一张单据。
- **FBillTypeID（单据类型）**：固定值为`QTRKD01_SYS`，通过`ConvertObjectParser`进行对象转换。
- **FStockOrgId（库存组织）**：映射为`warehouse_no`，同样使用`ConvertObjectParser`进行解析。
- **FDate（日期）**：格式化为日期时间字符串，映射为`stockin_time`。
- **FDEPTID（部门）**：根据不同的仓库编号映射到具体部门，通过自定义逻辑实现。
- **FOwnerTypeIdHead（货主类型）**：固定值为`BD_OwnerOrg`。
- **FOwnerIdHead（货主）**：固定值为`100`，使用对象解析器进行转换。

明细信息部分（FEntity）包括多个子字段：

- **FMATERIALID（物料编码）**：映射为明细列表中的规格编号字段 `details_list.spec_no`。
- **FQty（实收数量）**：映射为明细列表中的商品数量 `details_list.goods_count`。

这些字段通过元数据配置，实现从旺店通的数据格式到金蝶云星空API格式的转换。例如：

```json
{
  "field": "FBillNo",
  "label": "单据编号",
  "type": "string",
  "describe": "单据编号",
  "value": "{order_no}"
}

数据写入目标平台

通过调用金蝶云星空API接口 batchSave, 使用 POST 方法提交转换后的数据。配置如下：

{
  "api": "batchSave",
  "method": "POST",
  "idCheck": true,
  ...
}

在实际操作中，需要特别注意以下几点：

验证基础资料有效性：设置 IsVerifyBaseDataField 为 true, 确保所有基础资料在金蝶系统中有效。
自动提交并审核：设置 IsAutoSubmitAndAudit 为 true, 实现自动化流程，提高效率。
错误处理与重试机制：对于写入过程中可能出现的错误，需要设计异常处理和重试机制，确保数据一致性。

实时监控与日志记录

综上所述，通过合理配置元数据和调用相关API接口，可以高效地实现旺店通入库单到金蝶云星空其他入库单【预入库】的数据集成。在此过程中，充分利用平台提供的数据质量监控、异常检测、自定义逻辑等功能，可以大幅提升数据处理的准确性和时效性。用友与WMS系统接口开发配置

企业微信与OA系统接口开发配置