### PACKAGE-金蝶云星辰商品库存对接旺店通盘点单技术案例分享
在实现系统间高效数据集成的过程中，准确无误的数据传输和处理尤为重要。本文将着重介绍如何通过轻易云数据集成平台实现`金蝶云星辰V2`的商品库存对接到`旺店通·企业奇门`盘点单。本次集成方案涵盖了从获取数据、处理转换、批量写入至最终监控与错误重试机制的一系列步骤。
首先，通过调用金蝶云星辰V2接口 `/jdy/v2/scm/inventory` 来抓取最新的商品库存数据。为了确保不漏单，我们设定了定时可靠的抓取任务，并且进行了分页和限流控制，以应对接口返回的大量数据，从而避免请求超时或被API限流所影响。
在获得初步的数据后，需要解决两者之间的数据格式差异问题。这一步涉及进行必要的数据映射与转换操作，使得原本属于不同系统的数据能够兼容。此处使用自定义函数，将金蝶云提供的JSON格式转化为符合旺店通·企业奇门标准的XML或其他合适格式。
紧接着，将经过转换后的大规模数据批量快速写入到旺店通·企业奇门，通过调用其写入API `wdt.stock.sync.by.pd` 完成这一过程。在这个环节中特别注意的是，需针对可能出现的网络异常情况实施相应的错误重试机制，以及记录相关日志以便于后续审计和监控。
最后，为确保整个流程中的各个环节都能得到实时监控，在轻易云平台上配置了详细日志记录功能。这不仅帮助我们掌握每一次任务执行状态，还能在出现问题时迅速定位并解决故障，提高整体业务运作效率与透明度。
以上就是贯穿此次集成工作的关键步骤与考虑要素，下面将在具体章节中进一步展开详细技术解析和实际配置示例。
### 调用金蝶云星辰V2接口获取并加工数据
在轻易云数据集成平台中，调用源系统接口是数据处理生命周期的第一步。本文将深入探讨如何通过调用金蝶云星辰V2接口`/jdy/v2/scm/inventory`获取并加工数据，以实现与旺店通盘点单的对接。
#### 接口概述
金蝶云星辰V2接口`/jdy/v2/scm/inventory`主要用于查询商品库存信息。该接口采用GET方法进行请求，返回的数据包含商品的库存详情。以下是该接口的元数据配置：
```json
{
"api": "/jdy/v2/scm/inventory",
"effect": "QUERY",
"method": "GET",
"number": "material_number",
"id": "material_id",
"name": "material_number",
"idCheck": true,
"request": [
{
"field": "modify_end_time",
"label": "修改时间-结束时间的时间戳(毫秒)",
"type": "string",
"describe": "修改时间-结束时间的时间戳(毫秒)",
"value": "{CURRENT_TIME}000"
},
{
"field": "modify_start_time",
"label": "修改时间-开始时间的时间戳(毫秒)",
"type": "string",
"describe": "修改时间-开始时间的时间戳(毫秒)",
"value": "{LAST_SYNC_TIME}000"
},
{
"field": "page",
"label": "当前页，默认1",
"type": "string",
"describe": "当前页，默认1",
"value": "1"
},
{
"field": "page_size",
"label": "每页显示条数默认10",
"type": "string",
"describe": "每页显示条数默认10",
"",
" value ": ""10""
}
],
"autoFillResponse ": true
}
```
#### 请求参数配置
在调用该接口时，需要配置以下请求参数：
1. **modify_end_time**: 修改时间的结束时间戳（毫秒），通常设置为当前系统时间。
2. **modify_start_time**: 修改时间的开始时间戳（毫秒），通常设置为上次同步的时间。
3. **page**: 当前页码，默认为1。
4. **page_size**: 每页显示条数，默认为10。
这些参数确保了我们能够获取到最新修改的库存数据，并且可以分页获取大量数据。
#### 数据请求与清洗
在实际操作中，我们首先需要构建请求URL，并附加上述参数。例如：
```http
GET /jdy/v2/scm/inventory?modify_end_time=1633036800000&modify_start_time=1632950400000&page=1&page_size=10
```
该请求将返回符合条件的库存数据。接下来，我们需要对返回的数据进行清洗和转换，以便后续处理。
#### 数据转换与写入
返回的数据通常是JSON格式，需要解析并提取出有用的信息。例如：
```json
{
“data”: [
{
“material_id”: “12345”,
“material_number”: “ABC123”,
“quantity”: “100”
},
...
],
“total_count”: 50,
...
}
```
我们需要提取出`material_id`、`material_number`和`quantity`等字段，并根据业务需求进行转换。例如，将数量字段转换为整数类型或进行单位换算。
#### 自动填充响应
轻易云平台提供了自动填充响应功能（autoFillResponse），可以简化数据处理过程。启用该功能后，平台会自动将API响应中的字段映射到目标系统所需的格式，大大减少了手动处理的数据量。
#### 实践案例
假设我们需要将金蝶云星辰中的库存数据同步到旺店通盘点单中，可以按照以下步骤操作：
1. **调用接口**：使用上述配置调用金蝶云星辰V2接口获取库存数据。
2. **解析响应**：解析API返回的JSON数据，提取出必要字段。
3. **数据清洗**：对提取出的字段进行清洗和转换，例如单位换算、类型转换等。
4. **写入目标系统**：将处理后的数据写入旺店通盘点单中，实现系统间的数据同步。
通过以上步骤，我们可以高效地实现不同系统间的数据无缝对接，提高业务透明度和效率。
### 使用轻易云数据集成平台将金蝶云星辰商品库存对接到旺店通盘点单
在数据集成的生命周期中，第二步是关键，即将已经集成的源平台数据进行ETL转换，并转为目标平台所能够接收的格式，最终写入目标平台。本文将详细介绍如何使用轻易云数据集成平台，将金蝶云星辰的商品库存数据转换并写入到旺店通·企业奇门API接口。
#### 元数据配置解析
在本案例中，我们需要将金蝶云星辰的商品库存数据通过ETL流程转换为旺店通·企业奇门API接口所能接受的格式。以下是具体的元数据配置：
```json
{
"api": "wdt.stock.sync.by.pd",
"effect": "EXECUTE",
"method": "POST",
"idCheck": true,
"request": [
{
"field": "warehouse_no",
"label": "仓库编号",
"type": "string",
"describe": "代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于创建指定仓库单据信息",
"value": "{stock_number}"
},
{
"field": "mode",
"label": "盘点方式",
"type": "string",
"describe": "0表示单品盘点，1表示货位盘点，如果mode没有传参或数值无效 默认为0单品盘点"
},
{
"field": "api_outer_no",
"label": "API单号",
"type": "string",
"describe": "外部单号唯一标识",
"value": "{random}"
},
{
"field": "is_check",
"label": "是否审核",
"type": "string",
"describe": "1：自动审核 0：不自动审核 默认0",
"value": 1
},
{
"field": "is_post_error",
...
```
#### 数据请求与清洗
首先，我们从金蝶云星辰获取商品库存数据。这一步通常包括调用源系统的API接口，获取原始数据，并进行初步的数据清洗和验证。例如，我们可以通过以下步骤获取并清洗数据：
1. **调用金蝶云星辰API**：获取商品库存信息。
2. **数据验证**：确保每个字段的数据类型和格式符合预期。
3. **初步清洗**：去除重复或无效的数据记录。
#### 数据转换与写入
接下来，我们需要将清洗后的数据转换为旺店通·企业奇门API接口所能接受的格式，并通过POST请求写入目标系统。以下是具体步骤：
1. **字段映射**：根据元数据配置，将金蝶云星辰的数据字段映射到旺店通·企业奇门API接口字段。例如：
- `warehouse_no` 映射为 `{stock_number}`
- `api_outer_no` 映射为 `{random}`
- `goods_list` 中的 `spec_no` 映射为 `{material_number}`
- `goods_list` 中的 `stock_num` 映射为 `{qty}`
2. **构建请求体**：根据映射关系，构建POST请求体。例如：
```json
{
...
{
field: 'warehouse_no',
value: 'WH001'
},
...
goods_list: [
{
spec_no: 'SKU12345',
stock_num: '100'
}
]
}
```
3. **发送请求**：使用HTTP POST方法，将构建好的请求体发送到旺店通·企业奇门API接口。
#### 实例代码示例
以下是一个Python示例代码，用于展示如何实现上述过程：
```python
import requests
import json
# 获取金蝶云星辰商品库存数据（假设已完成）
source_data = [
{"stock_number":"WH001",
...
{"material_number":"SKU12345",
...
{"qty":"100"}
]
# 构建请求体
def build_request_body(data):
request_body = {
'warehouse_no': data['stock_number'],
'mode': '0',
'api_outer_no': generate_random_string(),
'is_check': '1',
'is_post_error': '1',
'is_create_stock': '1',
'goods_list': []
}
for item in data['goods_list']:
goods_item = {
'spec_no': item['material_number'],
'stock_num': item['qty']
}
request_body['goods_list'].append(goods_item)
return request_body
# 发送POST请求
def send_post_request(url, body):
headers = {'Content-Type': 'application/json'}
response = requests.post(url, data=json.dumps(body), headers=headers)
if response.status_code == 200:
print("Data successfully sent to WDT")
else:
print(f"Failed to send data: {response.text}")
# 主函数
if __name__ == "__main__":
url = "<WDT_API_ENDPOINT>"
for record in source_data:
request_body = build_request_body(record)
send_post_request(url, request_body)
```
以上代码展示了如何从源系统获取原始数据、进行字段映射、构建请求体并最终发送POST请求至目标系统。通过这种方式，可以实现不同系统间的数据无缝对接，提高业务效率和透明度。
