# 京东订单处理API

<cite>
**本文档引用的文件**
- [card-jd-oder.ts](file://src/api/card-jd-oder.ts)
- [kami-api-card-info-jd-v1-order-history-res.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-history-res.ts)
- [kami-api-card-info-jd-v1-order-summary-list-res.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-summary-list-res.ts)
- [kami-internal-model-entity-v1-card-redeem-order-history.ts](file://src/api/generated/models/kami-internal-model-entity-v1-card-redeem-order-history.ts)
- [kami-api-card-info-jd-v1-order-summary-record.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-summary-record.ts)
- [index.vue](file://src/views/card-jd-info/order/index.vue)
- [api.md](file://src/assets/markdown/api.md)
</cite>

## 目录

1. [简介](#简介)
2. [核心功能](#核心功能)
3. [订单历史查询接口](#订单历史查询接口)
4. [订单汇总统计接口](#订单汇总统计接口)
5. [订单状态重置与管理](#订单状态重置与管理)
6. [API数据模型](#api数据模型)
7. [性能优化与错误处理](#性能优化与错误处理)

## 简介

京东订单处理API提供了一套完整的订单管理解决方案，支持订单历史查询、订单汇总统计、订单状态重置等核心功能。该API系统为开发者提供了高效、稳定的接口服务，用于管理和分析京东平台的订单数据。通过本API，用户可以实现对订单全生命周期的监控和操作。

## 核心功能

京东订单处理API主要包含以下核心功能：

- 订单历史记录查询：获取指定订单的操作历史详情
- 订单汇总统计：按时间、商户等维度进行订单数据统计
- 订单状态管理：支持订单状态的重置、回调等管理操作
- 订单导出功能：批量导出订单数据用于分析

这些功能通过RESTful API接口提供服务，采用JSON格式进行数据交换，确保了接口的通用性和易用性。

**Section sources**

- [index.vue](file://src/views/card-jd-info/order/index.vue#L0-L406)

## 订单历史查询接口

订单历史查询接口用于获取特定订单的详细操作历史记录。该接口通过订单号作为查询参数，返回订单的完整处理流程。

### 请求参数

| 参数名称 | 参数类型 | 是否必须 | 描述   |
| -------- | -------- | -------- | ------ |
| orderNo  | string   | 是       | 订单号 |

### 响应数据结构

响应数据包含订单历史记录列表，每个记录包含以下字段：

- id: 记录ID
- orderNo: 订单号
- accountId: 账户ID
- operationStatus: 操作状态
- responseRawData: 原始响应数据
- amount: 金额
- remark: 备注
- createdAt: 创建时间
- updatedAt: 更新时间

```mermaid
flowchart TD
A["客户端请求"] --> B["验证订单号"]
B --> C["查询订单历史记录"]
C --> D["组装响应数据"]
D --> E["返回JSON格式结果"]
```

**Diagram sources**

- [card-jd-oder.ts](file://src/api/card-jd-oder.ts#L139-L149)
- [kami-api-card-info-jd-v1-order-history-res.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-history-res.ts#L23-L30)

**Section sources**

- [card-jd-oder.ts](file://src/api/card-jd-oder.ts#L139-L149)
- [kami-api-card-info-jd-v1-order-history-res.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-history-res.ts#L23-L30)

## 订单汇总统计接口

订单汇总统计接口提供订单数据的聚合分析功能，支持分页和筛选查询。

### 使用方法

接口支持以下参数配置：

- 分页参数：current（当前页码）、pageSize（每页数量）
- 筛选条件：merchantId（商户ID）、dateRange（日期范围）、accountNickName（账户昵称）等

### 响应结构

响应数据包含总记录数和记录列表，每条记录包含：

- merchantUid: 商户UID
- merchantName: 商户名称
- succeedCount: 成功订单数
- totalCount: 订单总量
- rate: 成功率
- date: 统计日期
- failedCount: 失败订单数
- waitedCount: 待处理订单数

```mermaid
graph TB
subgraph "请求参数"
A[分页参数]
B[筛选条件]
end
subgraph "处理逻辑"
C[参数验证]
D[数据库查询]
E[数据聚合]
end
subgraph "响应数据"
F[总记录数]
G[记录列表]
end
A --> C
B --> C
C --> D --> E
E --> F
E --> G
```

**Diagram sources**

- [card-jd-oder.ts](file://src/api/card-jd-oder.ts#L92-L121)
- [kami-api-card-info-jd-v1-order-summary-list-res.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-summary-list-res.ts#L23-L36)

**Section sources**

- [card-jd-oder.ts](file://src/api/card-jd-oder.ts#L92-L121)
- [kami-api-card-info-jd-v1-order-summary-record.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-summary-record.ts#L0-L93)

## 订单状态重置与管理

订单状态重置功能允许管理员对异常订单进行状态调整和管理操作。

### 状态重置

系统支持多种订单状态的重置操作，包括：

- 成功状态重置
- 失败状态重置
- 待处理状态重置

### 回调管理

提供订单回调功能，当订单处理完成后，系统会向预设的回调URL发送通知。支持手动触发回调操作。

### 订单导出

支持批量导出订单数据，导出格式为CSV，包含所有订单字段信息。

```mermaid
stateDiagram-v2
[*] --> 待处理
待处理 --> 处理中 : 开始处理
处理中 --> 成功 : 兑换成功
处理中 --> 失败 : 兑换失败
失败 --> 重试 : 状态重置
成功 --> 回调 : 发送通知
失败 --> 回调 : 发送通知
回调 --> 完成 : 回调成功
回调 --> 失败 : 回调失败
```

**Diagram sources**

- [index.vue](file://src/views/card-jd-info/order/index.vue#L300-L375)
- [card-jd-oder.ts](file://src/api/card-jd-oder.ts#L157-L159)

**Section sources**

- [index.vue](file://src/views/card-jd-info/order/index.vue#L300-L375)

## API数据模型

本节详细说明API响应中的核心数据模型。

### KamiApiCardInfoJdV1OrderHistoryRes

订单历史响应模型，包含订单历史记录列表。

```mermaid
classDiagram
class KamiApiCardInfoJdV1OrderHistoryRes {
+list : Array<KamiInternalModelEntityV1CardRedeemOrderHistory>
}
class KamiInternalModelEntityV1CardRedeemOrderHistory {
+id : number
+orderNo : string
+accountId : string
+operationStatus : number
+responseRawData : string
+amount : number
+remark : string
+createdAt : string
+updatedAt : string
+deletedAt : string
}
KamiApiCardInfoJdV1OrderHistoryRes --> KamiInternalModelEntityV1CardRedeemOrderHistory : "包含"
```

**Diagram sources**

- [kami-api-card-info-jd-v1-order-history-res.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-history-res.ts#L23-L30)
- [kami-internal-model-entity-v1-card-redeem-order-history.ts](file://src/api/generated/models/kami-internal-model-entity-v1-card-redeem-order-history.ts#L0-L81)

### KamiApiCardInfoJdV1OrderSummaryListRes

订单汇总响应模型，包含汇总记录和总数。

```mermaid
classDiagram
class KamiApiCardInfoJdV1OrderSummaryListRes {
+total : number
+list : Array<KamiApiCardInfoJdV1OrderSummaryRecord>
}
class KamiApiCardInfoJdV1OrderSummaryRecord {
+merchantUid : string
+merchantName : string
+succeedCount : number
+totalCount : number
+rate : number
+date : string
+failedCount : number
+waitedCount : number
}
KamiApiCardInfoJdV1OrderSummaryListRes --> KamiApiCardInfoJdV1OrderSummaryRecord : "包含"
```

**Diagram sources**

- [kami-api-card-info-jd-v1-order-summary-list-res.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-summary-list-res.ts#L23-L36)
- [kami-api-card-info-jd-v1-order-summary-record.ts](file://src/api/generated/models/kami-api-card-info-jd-v1-order-summary-record.ts#L0-L93)

## 性能优化与错误处理

为确保API的高效稳定运行，建议采取以下优化和错误处理策略。

### 性能优化建议

1. 合理使用分页参数，避免一次性查询过多数据
2. 利用缓存机制存储频繁查询的结果
3. 批量操作时采用异步处理模式
4. 优化数据库查询语句，添加必要索引

### 错误处理策略

系统定义了完整的错误码体系：

- 0: 成功
- 100: 失败
- 19: 订单重复上传
- 20: 卡号不符合规则
- 其他状态码表示不同类型的处理异常

建议客户端实现重试机制，对临时性错误进行自动重试，并记录详细的错误日志用于问题排查。

**Section sources**

- [api.md](file://src/assets/markdown/api.md#L240-L255)
- [index.vue](file://src/views/card-jd-info/order/index.vue#L300-L375)
