markdown

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

### 旺店通-销售出库单-->金蝶-销售出库单【分销店铺】集成案例分享

在企业的日常运营中，数据的高效流转和准确对接是确保业务顺畅进行的关键。本文将聚焦于一个具体的系统对接集成案例：如何将旺店通·旗舰奇门中的销售出库单数据无缝集成到金蝶云星空中，实现两大平台间的数据同步与共享。

为了实现这一目标，我们利用了轻易云数据集成平台强大的数据处理能力和丰富的特性。首先，通过调用旺店通·旗舰奇门提供的API接口`wdt.wms.stockout.sales.querywithdetail`，我们能够定时可靠地抓取销售出库单数据。这一过程不仅保证了数据获取的及时性，还通过分页和限流机制有效避免了接口调用频率过高导致的问题。

在获取到原始数据后，我们需要解决的是如何将这些数据快速且准确地写入到金蝶云星空。为此，我们使用了金蝶云星空提供的批量写入API `batchSave`，结合轻易云平台支持的大量数据快速写入能力，使得大量销售出库单能够迅速被处理并存储到目标系统中。

此外，为确保整个集成过程中的数据质量和一致性，我们引入了实时监控与日志记录功能。这不仅帮助我们及时发现并处理任何可能出现的数据异常，还通过集中监控和告警系统实时跟踪任务状态，保障了整个流程的稳定运行。

最后，在实际操作过程中，不同系统之间的数据格式差异也是一个不可忽视的问题。通过自定义的数据转换逻辑，我们成功地将旺店通·旗舰奇门的数据格式转换为符合金蝶云星空要求的格式，从而实现了两大平台间的数据无缝对接。

以上就是本次技术案例开头部分内容，后续章节将详细介绍具体实施步骤及技术细节。
![用友与SCM系统接口开发配置](https://pic.qeasy.cloud/D1.png)

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

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

在数据集成过程中，调用源系统的API接口是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用旺店通·旗舰奇门接口`wdt.wms.stockout.sales.querywithdetail`，并对获取的数据进行初步加工处理。

#### 接口调用配置

首先，我们需要配置API请求参数，以确保能够正确地从旺店通·旗舰奇门系统中获取销售出库单的详细信息。以下是关键的元数据配置：

- **api**: `wdt.wms.stockout.sales.querywithdetail`
- **method**: `POST`
- **number**: `order_no`
- **id**: `stockout_id`
- **idCheck**: `true`

请求参数主要分为分页参数和业务参数两部分：

1. **分页参数（pager）**
   - `page_size`: 每页返回的数据条数，设置为50。
   - `page_no`: 当前页号，从1开始。

2. **业务参数（params）**
   - `start_time`: 数据查询的开始时间，使用上次同步时间。
   - `end_time`: 数据查询的结束时间，使用当前时间。
   - `status_type`: 出库单状态类型，这里设置为3，即按照指定状态字段查询。
   - `status`: 出库单状态详细，这里设置为110。
   - 其他可选字段如仓库编码、出库单编号、店铺编号等，根据具体需求进行配置。

#### 数据请求与清洗

在完成API调用配置后，通过轻易云平台发起HTTP POST请求，从旺店通·旗舰奇门系统中获取销售出库单数据。由于可能存在大量数据，需要处理分页和限流问题，以确保数据完整性和系统稳定性。

##### 分页处理

为了避免一次性拉取过多数据导致性能问题，我们采用分页机制，每次请求50条记录，并逐页获取直至没有更多记录返回。轻易云平台提供了自动化的分页处理功能，可以根据设定的`page_size`和`page_no`自动递增页号并发起下一次请求。

##### 数据清洗

从源系统获取的数据通常包含多种格式和冗余信息，需要进行清洗以便后续处理。常见的数据清洗步骤包括：

- 去除无效或重复记录
- 标准化日期格式
- 转换特定字段类型，如将字符串转换为数值或布尔值
- 合并或拆分字段以符合目标系统要求

例如，对于返回的SN信息，可以根据业务需求决定是否保留或过滤掉不必要的信息。

#### 数据转换与写入准备

在完成初步的数据清洗后，需要对数据进行转换，使其符合目标系统（金蝶云星空）的格式要求。这一步骤可以利用轻易云平台提供的自定义数据转换逻辑功能，根据具体业务规则编写转换脚本，将源数据映射到目标结构。例如，将旺店通中的订单编号映射到金蝶云星空中的相应字段，并确保所有必填项都已正确填充。

此外，还需考虑异常处理机制，如当某些关键字段缺失时，应如何补救或记录日志以便后续排查。在实际操作中，可以通过轻易云平台内置的监控和告警系统实时跟踪任务状态，并及时发现和解决潜在问题。

#### 实现高效可靠的数据集成

通过上述步骤，我们可以实现从旺店通·旗舰奇门系统到金蝶云星空系统之间高效、可靠的数据集成。在整个过程中，充分利用轻易云平台提供的可视化工具、自动化流程以及强大的监控能力，不仅简化了复杂操作，还提升了整体效率和透明度。

总之，通过合理配置API请求参数、有效处理分页与限流、精细化的数据清洗与转换，以及完善的异常处理机制，可以确保我们顺利完成生命周期第一步，为后续的数据写入打下坚实基础。
![金蝶与SCM系统接口开发配置](https://pic.qeasy.cloud/S19.png)

![金蝶与CRM系统接口开发配置](https://pic.qeasy.cloud/QEASY/A28.png)

### 将旺店通销售出库单数据转换并写入金蝶云星空

在数据集成过程中，将源平台的数据转换为目标平台所能接收的格式是至关重要的一步。以下将详细探讨如何利用轻易云数据集成平台，将旺店通的销售出库单数据进行ETL转换，并通过金蝶云星空API接口写入目标平台。

#### 数据请求与清洗

在数据转换之前，首先需要从旺店通获取销售出库单数据。我们可以通过调用`wdt.wms.stockout.sales.querywithdetail`接口来抓取相关数据。该接口支持分页和限流处理，确保大批量数据能够稳定获取。

#### 数据转换与映射

一旦获取到源数据，我们需要对其进行清洗和转换，使其符合金蝶云星空API的格式要求。这包括字段名称、数据类型以及特定值的转换。

##### 字段映射与转换

以下是部分关键字段的映射和转换逻辑：

- **单据类型（FBillTypeID）**：固定值`XSCKD01_SYS`，表示销售出库单。
- **单据编号（FBillNo）**：直接映射自源数据中的`order_no`。
- **日期（FDate）**：映射自`consign_time`。
- **发货组织（FStockOrgId）**：固定值`100.01`，通过参数`FNumber`进行解析。
- **销售组织（FSaleOrgId）**：映射自源数据中的`shop_no`，并通过参数`FNumber`进行解析。

```json
{
  "field": "FBillTypeID",
  "value": "XSCKD01_SYS"
},
{
  "field": "FBillNo",
  "value": "{order_no}"
},
{
  "field": "FDate",
  "value": "{consign_time}"
},
{
  "field": "FStockOrgId",
  "value": "100.01",
  "parser": {
    "name": "ConvertObjectParser",
    "params": "FNumber"
  }
}
```

##### 明细信息处理

对于明细信息，需要逐项进行处理和映射。例如：

- **物料编码（FMaterialID）**：映射自明细列表中的`goods_no`，并通过参数解析。
- **实发数量（FRealQty）**：映射自明细列表中的`goods_count`。
- **含税单价（FTaxPrice）**：映射自明细列表中的`sell_price`。
- **仓库（FStockID）**：映射自源数据中的`warehouse_no`，并通过参数解析。

```json
{
  "field": "FEntity",
  "children": [
    {
      "field": "FMaterialID",
      "value": "{{details_list.goods_no}}",
      "parser": {
        "name": "ConvertObjectParser",
        "params": "FNumber"
      }
    },
    {
      "field": "FRealQty",
      "value": "{{details_list.goods_count}}"
    },
    {
      "field": "FTaxPrice",
      "value": "{{details_list.sell_price}}"
    },
    {
      "field": "FStockID",
      "value": "{warehouse_no}",
      "parser": {
        "name": "ConvertObjectParser",
        "params": "FNumber"
      }
    }
  ]
}
```

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

完成所有字段的映射和转换后，我们将这些数据打包成符合金蝶云星空API接口要求的格式。使用API `batchSave`, 并通过POST方法提交。

```json
{
  "api": "/k3cloud/api/batchSave",
  ...
}
```

##### API调用配置

为了确保高效和可靠的数据写入，我们需要配置以下几个关键参数：

- **业务对象表单Id（FormId）**：设置为销售出库单对应的表单ID `SAL_OUTSTOCK`
- **执行操作（Operation）**：设置为 `Save`
- **提交并审核（IsAutoSubmitAndAudit）**：设置为 `true`
- **验证基础资料有效性（IsVerifyBaseDataField）**：设置为 `true`

```json
{
  ...
  {
    field: 'FormId',
    value: 'SAL_OUTSTOCK'
  },
  {
    field: 'Operation',
    value: 'Save'
  },
  {
    field: 'IsAutoSubmitAndAudit',
    value: true
  },
  {
    field: 'IsVerifyBaseDataField',
    value: true
  }
}
```

#### 异常处理与重试机制

在调用API过程中可能会遇到异常情况，例如网络问题或接口限流。我们需要实现异常处理与错误重试机制，以确保数据能够最终成功写入目标平台。

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

为了确保整个过程的透明性和可追溯性，我们需要启用实时监控和日志记录功能。这样可以随时跟踪每个集成任务的状态，并及时发现和解决潜在问题。

### 总结

通过以上步骤，可以高效地将旺店通销售出库单的数据转化为金蝶云星空所需的格式，并成功写入目标平台。这一过程充分利用了轻易云数据集成平台强大的ETL功能，实现了不同系统之间的数据无缝对接。
![打通用友BIP数据接口](https://pic.qeasy.cloud/T13.png)

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

数据高效流转：旺店通到金蝶的销售出库单集成

旺店通-销售出库单-->金蝶-销售出库单【分销店铺】集成案例分享

为了实现这一目标，我们利用了轻易云数据集成平台强大的数据处理能力和丰富的特性。首先，通过调用旺店通·旗舰奇门提供的API接口wdt.wms.stockout.sales.querywithdetail，我们能够定时可靠地抓取销售出库单数据。这一过程不仅保证了数据获取的及时性，还通过分页和限流机制有效避免了接口调用频率过高导致的问题。

在获取到原始数据后，我们需要解决的是如何将这些数据快速且准确地写入到金蝶云星空。为此，我们使用了金蝶云星空提供的批量写入API batchSave，结合轻易云平台支持的大量数据快速写入能力，使得大量销售出库单能够迅速被处理并存储到目标系统中。

以上就是本次技术案例开头部分内容，后续章节将详细介绍具体实施步骤及技术细节。用友与SCM系统接口开发配置

系统集成平台API接口配置

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

在数据集成过程中，调用源系统的API接口是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用旺店通·旗舰奇门接口wdt.wms.stockout.sales.querywithdetail，并对获取的数据进行初步加工处理。

接口调用配置

首先，我们需要配置API请求参数，以确保能够正确地从旺店通·旗舰奇门系统中获取销售出库单的详细信息。以下是关键的元数据配置：

api: wdt.wms.stockout.sales.querywithdetail
method: POST
number: order_no
id: stockout_id
idCheck: true

请求参数主要分为分页参数和业务参数两部分：

分页参数（pager）
- page_size: 每页返回的数据条数，设置为50。
- page_no: 当前页号，从1开始。
业务参数（params）
- start_time: 数据查询的开始时间，使用上次同步时间。
- end_time: 数据查询的结束时间，使用当前时间。
- status_type: 出库单状态类型，这里设置为3，即按照指定状态字段查询。
- status: 出库单状态详细，这里设置为110。
- 其他可选字段如仓库编码、出库单编号、店铺编号等，根据具体需求进行配置。

数据请求与清洗

分页处理

为了避免一次性拉取过多数据导致性能问题，我们采用分页机制，每次请求50条记录，并逐页获取直至没有更多记录返回。轻易云平台提供了自动化的分页处理功能，可以根据设定的page_size和page_no自动递增页号并发起下一次请求。

数据清洗

从源系统获取的数据通常包含多种格式和冗余信息，需要进行清洗以便后续处理。常见的数据清洗步骤包括：

去除无效或重复记录
标准化日期格式
转换特定字段类型，如将字符串转换为数值或布尔值
合并或拆分字段以符合目标系统要求

例如，对于返回的SN信息，可以根据业务需求决定是否保留或过滤掉不必要的信息。

数据转换与写入准备

实现高效可靠的数据集成

总之，通过合理配置API请求参数、有效处理分页与限流、精细化的数据清洗与转换，以及完善的异常处理机制，可以确保我们顺利完成生命周期第一步，为后续的数据写入打下坚实基础。金蝶与SCM系统接口开发配置

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

将旺店通销售出库单数据转换并写入金蝶云星空

数据请求与清洗

在数据转换之前，首先需要从旺店通获取销售出库单数据。我们可以通过调用wdt.wms.stockout.sales.querywithdetail接口来抓取相关数据。该接口支持分页和限流处理，确保大批量数据能够稳定获取。

数据转换与映射

一旦获取到源数据，我们需要对其进行清洗和转换，使其符合金蝶云星空API的格式要求。这包括字段名称、数据类型以及特定值的转换。

字段映射与转换

以下是部分关键字段的映射和转换逻辑：

单据类型（FBillTypeID）：固定值XSCKD01_SYS，表示销售出库单。
单据编号（FBillNo）：直接映射自源数据中的order_no。
日期（FDate）：映射自consign_time。
发货组织（FStockOrgId）：固定值100.01，通过参数FNumber进行解析。
销售组织（FSaleOrgId）：映射自源数据中的shop_no，并通过参数FNumber进行解析。

{
  "field": "FBillTypeID",
  "value": "XSCKD01_SYS"
},
{
  "field": "FBillNo",
  "value": "{order_no}"
},
{
  "field": "FDate",
  "value": "{consign_time}"
},
{
  "field": "FStockOrgId",
  "value": "100.01",
  "parser": {
    "name": "ConvertObjectParser",
    "params": "FNumber"
  }
}

明细信息处理

对于明细信息，需要逐项进行处理和映射。例如：

物料编码（FMaterialID）：映射自明细列表中的goods_no，并通过参数解析。
实发数量（FRealQty）：映射自明细列表中的goods_count。
含税单价（FTaxPrice）：映射自明细列表中的sell_price。
仓库（FStockID）：映射自源数据中的warehouse_no，并通过参数解析。

{
  "field": "FEntity",
  "children": [
    {
      "field": "FMaterialID",
      "value": "{{details_list.goods_no}}",
      "parser": {
        "name": "ConvertObjectParser",
        "params": "FNumber"
      }
    },
    {
      "field": "FRealQty",
      "value": "{{details_list.goods_count}}"
    },
    {
      "field": "FTaxPrice",
      "value": "{{details_list.sell_price}}"
    },
    {
      "field": "FStockID",
      "value": "{warehouse_no}",
      "parser": {
        "name": "ConvertObjectParser",
        "params": "FNumber"
      }
    }
  ]
}

数据写入目标平台

完成所有字段的映射和转换后，我们将这些数据打包成符合金蝶云星空API接口要求的格式。使用API batchSave, 并通过POST方法提交。

{
  "api": "/k3cloud/api/batchSave",
  ...
}

API调用配置

为了确保高效和可靠的数据写入，我们需要配置以下几个关键参数：

业务对象表单Id（FormId）：设置为销售出库单对应的表单ID SAL_OUTSTOCK
执行操作（Operation）：设置为 Save
提交并审核（IsAutoSubmitAndAudit）：设置为 true
验证基础资料有效性（IsVerifyBaseDataField）：设置为 true

{
  ...
  {
    field: 'FormId',
    value: 'SAL_OUTSTOCK'
  },
  {
    field: 'Operation',
    value: 'Save'
  },
  {
    field: 'IsAutoSubmitAndAudit',
    value: true
  },
  {
    field: 'IsVerifyBaseDataField',
    value: true
  }
}

异常处理与重试机制

在调用API过程中可能会遇到异常情况，例如网络问题或接口限流。我们需要实现异常处理与错误重试机制，以确保数据能够最终成功写入目标平台。

实时监控与日志记录

总结

通过以上步骤，可以高效地将旺店通销售出库单的数据转化为金蝶云星空所需的格式，并成功写入目标平台。这一过程充分利用了轻易云数据集成平台强大的ETL功能，实现了不同系统之间的数据无缝对接。打通用友BIP数据接口

用友BIP接口开发配置