markdown

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

### 每刻借款单【借支单】集成到金蝶付款申请单的技术案例分享

在企业日常运营中，财务数据的高效管理和准确对接至关重要。本文将聚焦于一个具体的系统对接集成案例：如何将每刻平台上的借款单【借支单】数据集成到金蝶云星空的付款申请单中。通过这一案例，我们将展示如何利用轻易云数据集成平台实现高效、可靠的数据传输与转换。

首先，我们需要解决的是如何确保每刻平台的数据能够不漏单地被抓取并写入到金蝶云星空。这一过程中，定时可靠地抓取每刻接口数据是关键。我们使用了每刻提供的API接口`/api/openapi/form/loan`来获取借款单数据，并通过轻易云的数据质量监控和异常检测功能，及时发现并处理可能出现的数据问题。

其次，为了应对大量数据快速写入金蝶云星空的需求，我们采用了其批量保存API `batchSave`。轻易云平台支持高吞吐量的数据写入能力，使得大量数据能够快速被集成到目标系统中，从而提升了整体处理时效性。同时，通过自定义的数据转换逻辑，我们能够适应特定业务需求和不同的数据结构，确保数据格式的一致性。

在实际操作过程中，每刻与金蝶云星空之间存在着分页和限流的问题。为此，我们设计了一套完善的分页处理机制，并结合轻易云的平台特性，实现了对接口调用频率的有效控制。此外，为了保证整个集成过程的透明度和可追溯性，我们利用集中监控和告警系统实时跟踪任务状态，并记录详细日志以便后续分析和优化。

最后，在处理每刻与金蝶云星空之间的数据格式差异时，我们特别注意到了两者在字段映射上的不同。通过轻易云提供的可视化数据流设计工具，我们直观地配置了各项映射规则，确保所有关键字段都能正确对应，从而实现无缝对接。

以上是本次技术案例分享中的核心要点。在后续章节中，我们将详细探讨具体实施步骤及技术细节，包括如何调用每刻接口、处理分页与限流、以及异常处理与错误重试机制等内容。
![金蝶与WMS系统接口开发配置](https://pic.qeasy.cloud/D1.png)

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

### 调用每刻接口/api/openapi/form/loan获取并加工数据

在数据集成的生命周期中，调用源系统接口是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用每刻接口`/api/openapi/form/loan`，并对获取的数据进行初步加工处理。

#### 接口调用配置

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

- **API路径**：`/api/openapi/form/loan`
- **请求方法**：POST
- **分页条数**：默认设置为100
- **单据状态**：默认值为所有未删除单据（SETTLEMENT）

这些配置确保了我们能够高效地从每刻系统中抓取所需的数据。

#### 请求参数解析

为了准确获取所需的数据，我们需要设置多个请求参数：

1. **创建时间范围**：
   - `createdAtStart`
   - `createdAtEnd`

2. **审批通过时间范围**：
   - `approvedAtStart`
   - `approvedAtEnd`

3. **支付时间范围**：
   - `settledAtStart`
   - `settledAtEnd`

4. **分页控制**：
   - `pageSize`: 每页条数
   - `offset`: 当前页首条数据在所有数据中的偏移量

5. **单据状态**：
   - 例如，SETTLEMENT表示结算中。

这些参数帮助我们精确定位和筛选出符合条件的借款单数据。

#### 数据格式转换与清洗

在获取到原始数据后，需要对其进行格式转换和清洗，以便后续处理。以下是一个典型的格式转换示例：

```json
"formatResponse": [
    {"old":"customObject-CF506-0.userId","new":"customObject-CF506-0_userId","format":"string"}
]
```

此配置将字段`customObject-CF506-0.userId`重命名为`customObject-CF506-0_userId`，并确保其类型为字符串。这种转换有助于统一不同系统间的数据结构，避免因字段名称或类型不一致而导致的问题。

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

在实际操作过程中，不可避免会遇到网络波动、接口限流等问题。为了保证数据抓取的稳定性和可靠性，可以采用以下策略：

1. **分页与限流处理**：合理设置分页大小和请求频率，避免触发源系统的限流机制。
2. **异常重试机制**：当出现网络错误或其他异常时，可自动进行多次重试，以提高成功率。
3. **定时任务调度**：使用定时任务（如crontab）定期抓取新数据。例如，每两小时执行一次抓取任务：
    ```json
    "omissionRemedy": {
        "crontab": "2 */2 * * *"
    }
    ```

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

为了确保整个过程透明可控，可以利用轻易云平台提供的实时监控和日志记录功能。通过集中监控界面，可以随时查看任务执行状态、性能指标以及可能出现的问题，并及时采取措施进行调整。

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

最后，为了保证集成的数据质量，需要实施严格的数据质量监控和异常检测机制。一旦发现问题，如缺失字段、不匹配的数据类型等，应立即报警并启动相应的修复流程。这不仅能提高整体集成效率，还能有效防止错误传播到下游系统。

综上所述，通过合理配置元数据、精确设置请求参数、实施有效的异常处理与重试机制，以及利用实时监控和日志记录功能，我们可以高效地从每刻系统中获取并加工借款单【借支单】的数据，为后续写入金蝶付款申请单打下坚实基础。
![金蝶云星空API接口配置](https://pic.qeasy.cloud/S13.png)

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

### 每刻借款单到金蝶付款申请单的ETL转换与写入

在数据集成生命周期的第二步，将每刻借款单（借支单）数据转换为金蝶云星空API接口可接收的格式，并最终写入目标平台，是一个复杂但至关重要的过程。以下将详细探讨如何利用元数据配置完成这一任务。

#### 数据请求与清洗

首先，从每刻系统中提取借款单数据。通过调用每刻接口`/api/openapi/form/loan`，可以获取所需的数据。此阶段需要处理分页和限流问题，确保数据完整性和请求效率。

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

#### 数据转换

在数据转换阶段，需将从每刻获取的数据映射到金蝶云星空API所需的格式。这一过程需要遵循ETL（Extract, Transform, Load）方法中的Transform步骤，通过自定义转换逻辑，将原始数据字段映射到目标平台字段。

1. **字段映射**

- 单据编号（FBillNo）映射到`formCode`
   - 应付金额（FPAYAMOUNTFOR_H）映射到`paymentBaseAmount-amountStr`
   - 申请日期（FDATE）映射到`submittedAt`
   
   ```json
   {
     "field": "FBillNo",
     "label": "单据编号",
     "type": "string",
     "value": "{formCode}"
   },
   {
     "field": "FPAYAMOUNTFOR_H",
     "label": "应付金额",
     "type": "string",
     "value": "{{paymentBaseAmount-amountStr}}"
   },
   {
     "field": "FDATE",
     "label": "申请日期",
     "type": "string",
     "value": "{{submittedAt|datetime}}"
   }
   ```

2. **自定义转换逻辑**

为了适应特定业务需求，可以使用自定义逻辑进行数据转换。例如，将付款用途字段`customObject-CF199-detailBusinessCode`根据业务代码进行转换。

```json
   {
     "parent": "FPAYBILLSRCENTRY",
     "label": "付款用途",
     "field": "FPAYPURPOSEID",
     "type": "string",
     ...
     {
       "_function case '_findCollection find payerAccountType from e834a036-85f9-33be-bc48-168d584a3de6 where payeeTargetBusinessCode={formCode} _endFind' when '从公司支付宝账户付款' then 'JSFS32_SYS' else 'JSFS04_SYS' end"
     }
   }
   ```

3. **解析器使用**

使用解析器将复杂对象字段转换为金蝶云星空所需的基础资料ID。例如，将结算组织字段`customObject-CF561-text`解析为对应的组织ID。

```json
   {
     "_findCollection find F_JSJT_Text_MKBM from dac46c84-b360-329a-889f-f8bbb8cca5b1 where FName={{customObject-CF561-text}}"
   }
   ```

#### 数据写入

经过ETL转换后的数据，需要通过API接口批量写入金蝶云星空系统。该过程支持高吞吐量的数据写入能力，确保大量数据能够快速被集成。

1. **批量保存操作**

使用批量保存接口`batchSave`，通过POST方法将处理后的数据提交至金蝶云星空系统。同时，可以设置自动提交并审核选项，提高数据处理效率。

```json
   {
     "FormId": "CN_PAYAPPLY",
     ...
     {
       ...
       {
         "_function case when '{{customObject-CF199-text}}' in ('股东分红预支款') then '_findCollection find bizCode from 1c2d71bb-4cff-32a5-98aa-f04a13b4575f where name={{customObject-CF506-0.text}} _endFind' else '' end"
       }
       ...
       {
         "_function CASE LOCATE('其他应收款-职员借支','{{customObject-CF199-text}}')  WHEN 0 THEN 'CI161'  ELSE 'QTYS001' END"
       }
       ...
     }
   }
   ```

2. **实时监控与日志记录**

利用集中的监控和告警系统，实时跟踪数据集成任务的状态和性能，及时发现并处理异常情况。同时，通过日志记录功能，对整个ETL过程进行全面审计，确保数据质量和一致性。

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

在对接过程中可能会遇到各种异常情况，如网络波动、接口限流等。为了保证数据完整性，需要实现异常处理与错误重试机制。当出现错误时，根据预设的重试策略重新发送请求，直到成功为止。

```json
{
  ...
  {
    "_function case '_findCollection find payerAccountType from e834a036-85f9-33be-bc48-168d584a3de6 where payeeTargetBusinessCode={formCode} _endFind' when '从公司支付宝账户付款' then 'JSFS32_SYS' else 'JSFS04_SYS' end"
  }
}
```

通过上述步骤，我们能够有效地将每刻借款单的数据转化为金蝶云星空API接口可接收的格式，并顺利写入目标平台。这不仅提升了数据处理效率，还确保了业务流程的连续性和可靠性。
![钉钉与CRM系统接口开发配置](https://pic.qeasy.cloud/T14.png)

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

使用轻易云实现每刻借款单与金蝶付款申请单的无缝集成

每刻借款单【借支单】集成到金蝶付款申请单的技术案例分享

首先，我们需要解决的是如何确保每刻平台的数据能够不漏单地被抓取并写入到金蝶云星空。这一过程中，定时可靠地抓取每刻接口数据是关键。我们使用了每刻提供的API接口/api/openapi/form/loan来获取借款单数据，并通过轻易云的数据质量监控和异常检测功能，及时发现并处理可能出现的数据问题。

其次，为了应对大量数据快速写入金蝶云星空的需求，我们采用了其批量保存API batchSave。轻易云平台支持高吞吐量的数据写入能力，使得大量数据能够快速被集成到目标系统中，从而提升了整体处理时效性。同时，通过自定义的数据转换逻辑，我们能够适应特定业务需求和不同的数据结构，确保数据格式的一致性。

以上是本次技术案例分享中的核心要点。在后续章节中，我们将详细探讨具体实施步骤及技术细节，包括如何调用每刻接口、处理分页与限流、以及异常处理与错误重试机制等内容。金蝶与WMS系统接口开发配置

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

调用每刻接口/api/openapi/form/loan获取并加工数据

在数据集成的生命周期中，调用源系统接口是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用每刻接口/api/openapi/form/loan，并对获取的数据进行初步加工处理。

接口调用配置

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

API路径：/api/openapi/form/loan
请求方法：POST
分页条数：默认设置为100
单据状态：默认值为所有未删除单据（SETTLEMENT）

这些配置确保了我们能够高效地从每刻系统中抓取所需的数据。

请求参数解析

为了准确获取所需的数据，我们需要设置多个请求参数：

创建时间范围：
- createdAtStart
- createdAtEnd
审批通过时间范围：
- approvedAtStart
- approvedAtEnd
支付时间范围：
- settledAtStart
- settledAtEnd
分页控制：
- pageSize: 每页条数
- offset: 当前页首条数据在所有数据中的偏移量
单据状态：
- 例如，SETTLEMENT表示结算中。

这些参数帮助我们精确定位和筛选出符合条件的借款单数据。

数据格式转换与清洗

在获取到原始数据后，需要对其进行格式转换和清洗，以便后续处理。以下是一个典型的格式转换示例：

"formatResponse": [
    {"old":"customObject-CF506-0.userId","new":"customObject-CF506-0_userId","format":"string"}
]

此配置将字段customObject-CF506-0.userId重命名为customObject-CF506-0_userId，并确保其类型为字符串。这种转换有助于统一不同系统间的数据结构，避免因字段名称或类型不一致而导致的问题。

异常处理与重试机制

在实际操作过程中，不可避免会遇到网络波动、接口限流等问题。为了保证数据抓取的稳定性和可靠性，可以采用以下策略：

分页与限流处理：合理设置分页大小和请求频率，避免触发源系统的限流机制。
异常重试机制：当出现网络错误或其他异常时，可自动进行多次重试，以提高成功率。
定时任务调度：使用定时任务（如crontab）定期抓取新数据。例如，每两小时执行一次抓取任务：
```
"omissionRemedy": {
    "crontab": "2 */2 * * *"
}
```

实时监控与日志记录

数据质量监控与异常检测

综上所述，通过合理配置元数据、精确设置请求参数、实施有效的异常处理与重试机制，以及利用实时监控和日志记录功能，我们可以高效地从每刻系统中获取并加工借款单【借支单】的数据，为后续写入金蝶付款申请单打下坚实基础。金蝶云星空API接口配置

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

每刻借款单到金蝶付款申请单的ETL转换与写入

数据请求与清洗

首先，从每刻系统中提取借款单数据。通过调用每刻接口/api/openapi/form/loan，可以获取所需的数据。此阶段需要处理分页和限流问题，确保数据完整性和请求效率。

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

数据转换

字段映射

单据编号（FBillNo）映射到formCode
应付金额（FPAYAMOUNTFOR_H）映射到paymentBaseAmount-amountStr
申请日期（FDATE）映射到submittedAt

{
 "field": "FBillNo",
 "label": "单据编号",
 "type": "string",
 "value": "{formCode}"
},
{
 "field": "FPAYAMOUNTFOR_H",
 "label": "应付金额",
 "type": "string",
 "value": "{{paymentBaseAmount-amountStr}}"
},
{
 "field": "FDATE",
 "label": "申请日期",
 "type": "string",
 "value": "{{submittedAt|datetime}}"
}

自定义转换逻辑

为了适应特定业务需求，可以使用自定义逻辑进行数据转换。例如，将付款用途字段customObject-CF199-detailBusinessCode根据业务代码进行转换。

{
 "parent": "FPAYBILLSRCENTRY",
 "label": "付款用途",
 "field": "FPAYPURPOSEID",
 "type": "string",
 ...
 {
   "_function case '_findCollection find payerAccountType from e834a036-85f9-33be-bc48-168d584a3de6 where payeeTargetBusinessCode={formCode} _endFind' when '从公司支付宝账户付款' then 'JSFS32_SYS' else 'JSFS04_SYS' end"
 }
}

解析器使用

使用解析器将复杂对象字段转换为金蝶云星空所需的基础资料ID。例如，将结算组织字段customObject-CF561-text解析为对应的组织ID。
```
{
 "_findCollection find F_JSJT_Text_MKBM from dac46c84-b360-329a-889f-f8bbb8cca5b1 where FName={{customObject-CF561-text}}"
}
```

数据写入

经过ETL转换后的数据，需要通过API接口批量写入金蝶云星空系统。该过程支持高吞吐量的数据写入能力，确保大量数据能够快速被集成。

批量保存操作

使用批量保存接口batchSave，通过POST方法将处理后的数据提交至金蝶云星空系统。同时，可以设置自动提交并审核选项，提高数据处理效率。

{
 "FormId": "CN_PAYAPPLY",
 ...
 {
   ...
   {
     "_function case when '{{customObject-CF199-text}}' in ('股东分红预支款') then '_findCollection find bizCode from 1c2d71bb-4cff-32a5-98aa-f04a13b4575f where name={{customObject-CF506-0.text}} _endFind' else '' end"
   }
   ...
   {
     "_function CASE LOCATE('其他应收款-职员借支','{{customObject-CF199-text}}')  WHEN 0 THEN 'CI161'  ELSE 'QTYS001' END"
   }
   ...
 }
}

实时监控与日志记录

利用集中的监控和告警系统，实时跟踪数据集成任务的状态和性能，及时发现并处理异常情况。同时，通过日志记录功能，对整个ETL过程进行全面审计，确保数据质量和一致性。

异常处理与错误重试机制

{
  ...
  {
    "_function case '_findCollection find payerAccountType from e834a036-85f9-33be-bc48-168d584a3de6 where payeeTargetBusinessCode={formCode} _endFind' when '从公司支付宝账户付款' then 'JSFS32_SYS' else 'JSFS04_SYS' end"
  }
}

通过上述步骤，我们能够有效地将每刻借款单的数据转化为金蝶云星空API接口可接收的格式，并顺利写入目标平台。这不仅提升了数据处理效率，还确保了业务流程的连续性和可靠性。钉钉与CRM系统接口开发配置

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