diff --git a/changelogs/2026-03/2026-03-21_order_travelers_api.md b/changelogs/2026-03/2026-03-21_order_travelers_api.md new file mode 100644 index 0000000..6261074 --- /dev/null +++ b/changelogs/2026-03/2026-03-21_order_travelers_api.md @@ -0,0 +1,97 @@ +# 新增:获取订单出行人接口 + +**日期**: 2026-03-21 +**服务**: hl-order-service +**类型**: 新增接口 + +--- + +## 功能说明 + +新增管理端独立获取订单出行人接口,用于保险投保页面自动填充被保人信息。 + +--- + +## 接口清单 + +| 方法 | 路径 | 说明 | +|------|------|------| +| GET | /admin/order/{orderId}/travelers | 获取指定订单的出行人列表 | + +--- + +## 详细定义 + +### GET /admin/order/{orderId}/travelers + +#### 请求参数 + +| 参数 | 位置 | 类型 | 必填 | 说明 | +|------|------|------|------|------| +| orderId | path | Long | 是 | 订单ID | + +#### 响应示例 + +```json +{ + "code": 200, + "message": "成功", + "data": [ + { + "orderTravelerId": "2034962583668371457", + "orderId": "2034961514288623617", + "name": "张三", + "idCardType": "ID_CARD", + "idCardNo": "152125199101022016", + "phone": "13800138000", + "gender": 1, + "birthday": "1991-01-02", + "travelerType": "ADULT", + "nationality": "中国", + "emergencyContact": "李四", + "emergencyPhone": "13800138001", + "email": null, + "createTime": "2026-03-20 19:57:42" + } + ] +} +``` + +#### 响应字段说明 + +| 字段 | 类型 | 说明 | +|------|------|------| +| orderTravelerId | String | 出行人ID | +| orderId | String | 订单ID | +| name | String | 姓名 | +| idCardType | String | 证件类型(字典:id_card_type)ID_CARD/PASSPORT/OTHER | +| idCardNo | String | 证件号码 | +| phone | String | 手机号(可能为null) | +| gender | Integer | 性别(字典:gender)1=男 0=女 | +| birthday | String | 出生日期 yyyy-MM-dd | +| travelerType | String | 出行人类型(字典:traveler_type)ADULT/CHILD/BABY | +| nationality | String | 国籍 | +| emergencyContact | String | 紧急联系人 | +| emergencyPhone | String | 紧急联系电话 | + +--- + +## 使用场景 + +### 保险投保页面 - 自动填充被保人 + +1. 用户输入关联订单ID +2. 调用 `GET /admin/order/{orderId}/travelers` 获取出行人列表 +3. 将出行人信息映射为被保人(姓名、证件号、性别、生日) +4. 自动填充到被保人列表,无需手动添加 + +### 字段映射(出行人 → 被保人) + +| 出行人字段 | 被保人字段 | +|-----------|-----------| +| name | name | +| idCardType | idCardType | +| idCardNo | idCardNo | +| gender(1=男→MALE, 0=女→FEMALE) | gender | +| birthday | birthday | +| phone | phone |