markdown

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

### 吉客云数据集成到金蝶云星空：其他入库(负数)对接-其他出库单

在企业信息化系统中，数据的高效流转和准确对接是业务顺利运行的关键。本文将分享一个实际案例，展示如何通过轻易云数据集成平台，将吉客云中的“其他入库(负数)”数据无缝对接到金蝶云星空的“其他出库单”模块。

为了实现这一目标，我们利用了轻易云平台的一系列强大特性，包括高吞吐量的数据写入能力、实时监控与告警系统、自定义数据转换逻辑以及可视化的数据流设计工具。这些特性不仅确保了大量数据能够快速而准确地从吉客云传输到金蝶云星空，还提升了整个集成过程的透明度和管理效率。

首先，通过调用吉客云提供的API接口`erp.storage.goodsdocin.v2`，我们能够定时可靠地抓取所需的入库数据。为了应对分页和限流问题，我们设计了一套灵活的处理机制，确保每次请求都能获取完整且准确的数据集。同时，为了适应不同平台之间的数据格式差异，我们自定义了一套转换逻辑，使得数据在传输过程中能够自动进行格式调整。

在将处理后的数据写入金蝶云星空时，我们使用其提供的API接口`batchSave`进行批量操作。这不仅提高了数据写入的效率，还减少了网络请求次数，从而优化了整体性能。此外，通过集中监控和告警系统，我们可以实时跟踪每个集成任务的状态，一旦出现异常情况，系统会立即发出告警并启动错误重试机制，以确保所有数据都能成功对接，不漏单、不丢失。

总之，本案例展示了如何利用轻易云平台，实现吉客云与金蝶云星空之间的数据无缝对接，并通过一系列技术手段保证了整个过程的高效、稳定和可靠。在后续章节中，我们将详细介绍具体实施步骤及技术细节。
![如何开发用友BIP接口](https://pic.qeasy.cloud/D8.png)

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

### 调用吉客云接口erp.storage.goodsdocin.v2获取并加工数据

在轻易云数据集成平台中，调用吉客云接口`erp.storage.goodsdocin.v2`是数据集成生命周期的第一步。此步骤主要涉及从源系统获取原始数据，并进行初步的清洗和加工，以确保后续的数据处理和写入过程顺利进行。

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

首先，我们需要配置元数据以正确调用吉客云接口。以下是关键的请求参数：

- **分页页码（pageIndex）**：用于控制分页查询，从而避免一次性拉取大量数据导致性能问题。
- **分页页数（pageSize）**：每次请求返回的数据条数，默认设置为50。
- **入库单号（goodsDocNo）**：用于指定特定的入库单号。
- **创建时间的起始时间（startDate）**和**结束时间（endDate）**：用于限定查询范围，通常使用上次同步时间和当前时间来动态生成。
- **入库类型（inouttype）**：指定为104，即“其他入库”类型。

这些参数通过POST方法发送到API端点，以获取相应的数据。

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

为了确保只获取符合业务需求的数据，我们在元数据配置中添加了条件过滤：

```json
"condition":[
  [{"field":"userName","logic":"notlike","value":"外部"},
   {"field":"goodsDocDetailList.quantity","logic":"lt","value":"0"}]
]
```

上述条件表示我们只关心非外部用户创建且数量小于零的记录。这种过滤机制有效减少了无关数据，提高了处理效率。

#### 自动填充与扁平化处理

轻易云平台支持自动填充响应字段，这意味着我们可以预定义需要返回的字段列表，如下所示：

```json
"selelctFields": "goodsdocNo,inOutDate,userName,gmtCreate,inouttype,vendCustomerCode,warehouseCode,warehouseName,inOutReason,redStatus,financeBillStatus,goodsDocDetailList.goodsNo,goodsDocDetailList.quantity,goodsDocDetailList"
```

此外，通过`beatFlat`属性，我们可以将嵌套结构中的数组字段扁平化处理，使得后续的数据转换更加简便。例如，将`goodsDocDetailList`中的详细信息展开为独立记录。

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

在实际操作过程中，可能会遇到网络波动或接口限流等问题。为了保证数据抓取的可靠性，我们设计了异常处理和重试机制。例如，通过定时任务(crontab)来补救遗漏的数据：

```json
"omissionRemedy": {
  "crontab": "1 2 * * *",
  "takeOverRequest": [
    {"field": "startDate", "value": "_function FROM_UNIXTIME( unix_timestamp() -259200 , '%Y-%m-%d %H:%i:%s' )"}
  ]
}
```

该配置表示每天凌晨2点1分执行一次任务，回溯三天内未成功抓取的数据，从而确保不漏单。

#### 数据质量监控与日志记录

为了实时监控数据处理过程并及时发现问题，轻易云平台提供了强大的监控和日志功能。在调用吉客云接口时，可以开启详细日志记录，包括请求参数、响应结果以及错误信息。这些日志不仅有助于排查问题，还能为优化集成方案提供依据。

通过以上步骤，我们完成了从吉客云获取并初步加工数据的重要环节，为后续的数据转换与写入奠定了基础。在整个过程中，充分利用轻易云平台的可视化工具和自动化功能，大大提升了工作效率和准确性。
![如何对接金蝶云星空API接口](https://pic.qeasy.cloud/S6.png)

![打通金蝶云星空数据接口](https://pic.qeasy.cloud/QEASY/A133.png)

### 其他入库(负数)对接-其他出库单的ETL转换与写入金蝶云星空

在进行吉客云与金蝶云星空的数据集成过程中，第二步ETL转换至关重要。此过程将已集成的源平台数据进行提取、转换和加载（ETL），最终写入目标平台金蝶云星空API接口所能够接收的格式。

#### 数据提取与初步清洗

首先，从吉客云接口中提取原始数据。这些数据通常包含多个字段，如单号、单据编号、日期、库存组织等。为了确保数据质量和一致性，必须进行初步清洗。例如，将日期格式统一，去除冗余字段等。

#### 数据转换

数据转换是ETL过程中的核心步骤。根据元数据配置，我们需要将吉客云的数据映射到金蝶云星空API所需的格式。以下是几个关键字段的映射和转换逻辑：

1. **单据编号（FBillNo）**：直接从吉客云的`goodsdocNo`字段获取。
2. **单据类型（FBillTypeID）**：使用`ConvertObjectParser`解析器将仓库代码`warehouseCode`转换为金蝶云所需格式。
3. **库存组织（FStockOrgId）**：同样通过`ConvertObjectParser`解析器，将货主名称`goodsDocDetailList_ownerName`映射到库存组织。
4. **日期（FDate）**：直接从`inOutDate`字段获取并转换为标准日期格式。
5. **明细信息（FEntity）**：包括物料编码、库存状态、收货仓库和实收数量等字段。其中，实收数量需要乘以-1，以表示负数出库。

具体示例如下：
```plaintext
{
    "field": "FQty",
    "label": "实收数量",
    "type": "string",
    "describe": "数量",
    "value": "_function {{Fentity.goodsDocDetailList_quantity}} *(-1)",
    "parent": "FEntity"
}
```

#### 数据加载

经过转换后的数据，需要通过金蝶云星空API接口进行批量写入。我们采用的是`batchSave`接口，并设置相关参数确保数据正确写入：

- **FormId**：业务对象表单ID，例如"STK_MisDelivery"。
- **IsAutoSubmitAndAudit**：设为true，以便提交并审核数据。
- **InterationFlags**：允许负库存，设置为"STK_InvCheckResult"。

在实际操作中，通过POST请求将处理后的数据发送到金蝶云星空API接口：
```plaintext
{
    "api": "batchSave",
    "method": "POST",
    ...
}
```

#### 处理分页与限流问题

在处理大批量数据时，需要考虑分页和限流问题。可以通过分批次发送请求来避免超时或系统负载过高。同时，监控每个请求的响应状态，确保所有数据都成功写入目标系统。

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

为了提高系统的可靠性，需要设计异常处理与重试机制。当出现网络故障或API调用失败时，可以记录错误日志并进行重试操作。例如，在API返回错误码时，根据错误类型决定是否立即重试或延迟重试。

通过以上步骤，我们能够高效地将吉客云的数据转换并写入到金蝶云星空，实现两者之间的数据无缝对接。这不仅提升了业务流程的自动化程度，也确保了数据的一致性和准确性。
![用友与外部系统接口集成开发](https://pic.qeasy.cloud/T15.png)

![打通企业微信数据接口](https://pic.qeasy.cloud/QEASY/A17.png)

吉客云与金蝶云星空的数据无缝对接案例

吉客云数据集成到金蝶云星空：其他入库(负数)对接-其他出库单

首先，通过调用吉客云提供的API接口erp.storage.goodsdocin.v2，我们能够定时可靠地抓取所需的入库数据。为了应对分页和限流问题，我们设计了一套灵活的处理机制，确保每次请求都能获取完整且准确的数据集。同时，为了适应不同平台之间的数据格式差异，我们自定义了一套转换逻辑，使得数据在传输过程中能够自动进行格式调整。

在将处理后的数据写入金蝶云星空时，我们使用其提供的API接口batchSave进行批量操作。这不仅提高了数据写入的效率，还减少了网络请求次数，从而优化了整体性能。此外，通过集中监控和告警系统，我们可以实时跟踪每个集成任务的状态，一旦出现异常情况，系统会立即发出告警并启动错误重试机制，以确保所有数据都能成功对接，不漏单、不丢失。

总之，本案例展示了如何利用轻易云平台，实现吉客云与金蝶云星空之间的数据无缝对接，并通过一系列技术手段保证了整个过程的高效、稳定和可靠。在后续章节中，我们将详细介绍具体实施步骤及技术细节。如何开发用友BIP接口

用友与MES系统接口开发配置

调用吉客云接口erp.storage.goodsdocin.v2获取并加工数据

在轻易云数据集成平台中，调用吉客云接口erp.storage.goodsdocin.v2是数据集成生命周期的第一步。此步骤主要涉及从源系统获取原始数据，并进行初步的清洗和加工，以确保后续的数据处理和写入过程顺利进行。

接口配置与请求参数

首先，我们需要配置元数据以正确调用吉客云接口。以下是关键的请求参数：

分页页码（pageIndex）：用于控制分页查询，从而避免一次性拉取大量数据导致性能问题。
分页页数（pageSize）：每次请求返回的数据条数，默认设置为50。
入库单号（goodsDocNo）：用于指定特定的入库单号。
创建时间的起始时间（startDate）和结束时间（endDate）：用于限定查询范围，通常使用上次同步时间和当前时间来动态生成。
入库类型（inouttype）：指定为104，即“其他入库”类型。

这些参数通过POST方法发送到API端点，以获取相应的数据。

数据过滤与条件设置

为了确保只获取符合业务需求的数据，我们在元数据配置中添加了条件过滤：

"condition":[
  [{"field":"userName","logic":"notlike","value":"外部"},
   {"field":"goodsDocDetailList.quantity","logic":"lt","value":"0"}]
]

上述条件表示我们只关心非外部用户创建且数量小于零的记录。这种过滤机制有效减少了无关数据，提高了处理效率。

自动填充与扁平化处理

轻易云平台支持自动填充响应字段，这意味着我们可以预定义需要返回的字段列表，如下所示：

"selelctFields": "goodsdocNo,inOutDate,userName,gmtCreate,inouttype,vendCustomerCode,warehouseCode,warehouseName,inOutReason,redStatus,financeBillStatus,goodsDocDetailList.goodsNo,goodsDocDetailList.quantity,goodsDocDetailList"

此外，通过beatFlat属性，我们可以将嵌套结构中的数组字段扁平化处理，使得后续的数据转换更加简便。例如，将goodsDocDetailList中的详细信息展开为独立记录。

异常处理与重试机制

"omissionRemedy": {
  "crontab": "1 2 * * *",
  "takeOverRequest": [
    {"field": "startDate", "value": "_function FROM_UNIXTIME( unix_timestamp() -259200 , '%Y-%m-%d %H:%i:%s' )"}
  ]
}

该配置表示每天凌晨2点1分执行一次任务，回溯三天内未成功抓取的数据，从而确保不漏单。

数据质量监控与日志记录

通过以上步骤，我们完成了从吉客云获取并初步加工数据的重要环节，为后续的数据转换与写入奠定了基础。在整个过程中，充分利用轻易云平台的可视化工具和自动化功能，大大提升了工作效率和准确性。如何对接金蝶云星空API接口

打通金蝶云星空数据接口

其他入库(负数)对接-其他出库单的ETL转换与写入金蝶云星空

数据提取与初步清洗

数据转换

单据编号（FBillNo）：直接从吉客云的goodsdocNo字段获取。
单据类型（FBillTypeID）：使用ConvertObjectParser解析器将仓库代码warehouseCode转换为金蝶云所需格式。
库存组织（FStockOrgId）：同样通过ConvertObjectParser解析器，将货主名称goodsDocDetailList_ownerName映射到库存组织。
日期（FDate）：直接从inOutDate字段获取并转换为标准日期格式。
明细信息（FEntity）：包括物料编码、库存状态、收货仓库和实收数量等字段。其中，实收数量需要乘以-1，以表示负数出库。

具体示例如下：

{
    "field": "FQty",
    "label": "实收数量",
    "type": "string",
    "describe": "数量",
    "value": "_function {{Fentity.goodsDocDetailList_quantity}} *(-1)",
    "parent": "FEntity"
}

数据加载

经过转换后的数据，需要通过金蝶云星空API接口进行批量写入。我们采用的是batchSave接口，并设置相关参数确保数据正确写入：

FormId：业务对象表单ID，例如"STK_MisDelivery"。
IsAutoSubmitAndAudit：设为true，以便提交并审核数据。
InterationFlags：允许负库存，设置为"STK_InvCheckResult"。

在实际操作中，通过POST请求将处理后的数据发送到金蝶云星空API接口：

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

处理分页与限流问题

异常处理与重试机制

通过以上步骤，我们能够高效地将吉客云的数据转换并写入到金蝶云星空，实现两者之间的数据无缝对接。这不仅提升了业务流程的自动化程度，也确保了数据的一致性和准确性。用友与外部系统接口集成开发

打通企业微信数据接口