docs(changelog): 订单接口契约清单全文表格化(管理后台)
格式统一: 所有嵌套 VO 子类(SubFlowVO/TravelerPlainVO/ServiceStandardVO 子结构等 20+)由行内顿号改为 字段|类型|含义 三列表格; 每个接口补入参示例; 附录A枚举字典改表格展示。
这个提交包含在:
父节点
ab3770f9f9
当前提交
a0946839d8
@ -36,7 +36,7 @@
|
||||
**接口介绍**:管理后台订单列表,支持状态/标签/关键字/出发日期/来源/定制师等多条件过滤,分页返回。
|
||||
**本次修改点**:无字段变更(沿用现状,列表项含 6 步 flowStep 步骤条字段)。
|
||||
|
||||
**入参**(query)
|
||||
**入参**(query 参数)
|
||||
|
||||
| 字段 | 类型 | 必填 | 含义 | 示例 |
|
||||
|---|---|---|---|---|
|
||||
@ -52,7 +52,14 @@
|
||||
| cancelled | Boolean | 否 | 是否含已取消(默认 false) | false |
|
||||
| consultantName | String | 否 | 定制师姓名 LIKE | 李定制 |
|
||||
|
||||
**出参**:`PageResult<OrderListItemRespVO>`,外层 `records`(数组)+ `total`/`current`/`size` 等分页字段。单条 `OrderListItemRespVO`(35 字段):
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order?page=1&pageSize=10&orderStatus=CUSTOMIZING&keyword=张三
|
||||
```
|
||||
|
||||
**出参**:`PageResult<OrderListItemRespVO>`,外层 `records`(数组)+ `total`/`current`/`size` 分页字段。
|
||||
|
||||
单条 `OrderListItemRespVO`(35 字段):
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
@ -68,30 +75,50 @@
|
||||
| peopleSummary | String | 人数摘要 |
|
||||
| departureDate | LocalDate | 出发日(未定 null) |
|
||||
| tripDays | Integer | 行程天数 |
|
||||
| orderStatus / orderStatusName | String | 粗状态值 / 中文(附录 A) |
|
||||
| flowStatus / flowStatusName | String | 细状态值 / 中文(附录 A) |
|
||||
| orderStatus | String | 粗状态值(附录 A) |
|
||||
| orderStatusName | String | 粗状态中文 |
|
||||
| flowStatus | String | 细状态值(附录 A) |
|
||||
| flowStatusName | String | 细状态中文 |
|
||||
| flowStep | Integer | 6 步当前步序号(0=待支付,1-6,null=已取消) |
|
||||
| flowStepTotal | Integer | 总步数(6) |
|
||||
| flowStepCode | String | 当前步英文码(附录 A) |
|
||||
| currentSubFlows | List\<SubFlowVO\> | 当前步子流程(仅 RESOURCE 步非 null) |
|
||||
| totalAmount / paidAmount / balanceAmount | BigDecimal | 金额 / 实付 / 待付 |
|
||||
| totalAmount | BigDecimal | 订单金额 |
|
||||
| paidAmount | BigDecimal | 实付金额 |
|
||||
| balanceAmount | BigDecimal | 待付金额 |
|
||||
| consultantName | String | 定制师姓名 |
|
||||
| createSource / createSourceLabel | String | 来源值 / 中文 |
|
||||
| createSource | String | 来源值(附录 A) |
|
||||
| createSourceLabel | String | 来源中文 |
|
||||
| tags | List\<TagVO\> | 标签列表 |
|
||||
| createdAt | LocalDateTime | 创单时间 |
|
||||
| depositAmount / depositRatio | BigDecimal/Integer | 订金额 / 比例%(FULL 为 null) |
|
||||
| depositAmount | BigDecimal | 订金额(FULL 为 null) |
|
||||
| depositRatio | Integer | 订金比例%(FULL 为 null) |
|
||||
| paymentMode | String | DEPOSIT/FULL |
|
||||
| singleRoomSurcharge | BigDecimal | 单房差(未触发 null) |
|
||||
| agencyId / refundPolicyId | String | 旅行社 / 退款政策 ID |
|
||||
| agencyId | String | 旅行社主体 ID |
|
||||
| refundPolicyId | String | 退款政策 ID |
|
||||
| productSubtitle | String | 产品副标题 |
|
||||
|
||||
`SubFlowVO`:`code`(HOTEL/VEHICLE/GUIDE/PHOTOGRAPHER)、`name`、`status`(DONE/PROCESSING/WAITING)、`label`。
|
||||
`TagVO`:`name`、`type`(SYSTEM/MANUAL)、`color`(#RRGGBB)、`creator`。
|
||||
`SubFlowVO`(子流程)
|
||||
|
||||
**JSON 示例**
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| code | String | 子流程英文码 HOTEL/VEHICLE/GUIDE/PHOTOGRAPHER |
|
||||
| name | String | 子流程名称 |
|
||||
| status | String | DONE/PROCESSING/WAITING |
|
||||
| label | String | 显示标签(如"待配") |
|
||||
|
||||
`TagVO`(标签)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| name | String | 标签名 |
|
||||
| type | String | SYSTEM/MANUAL |
|
||||
| color | String | 十六进制色 #RRGGBB |
|
||||
| creator | String | 标签创建人姓名 |
|
||||
|
||||
**出参示例**
|
||||
```jsonc
|
||||
GET /v3/admin/order?page=1&pageSize=10&orderStatus=CUSTOMIZING
|
||||
|
||||
{
|
||||
"code": 200, "message": "成功", "success": true,
|
||||
"data": {
|
||||
@ -130,51 +157,146 @@ GET /v3/admin/order?page=1&pageSize=10&orderStatus=CUSTOMIZING
|
||||
- `overview` **重构**为 `customerInfo` + `remarkInfo` 两分类(原扁平字段,#3488)。
|
||||
- overview 出行人/联系电话/证件号改**明文**返回(idCard/phone/emergencyPhone 不脱敏,#3509)。
|
||||
|
||||
**入参**:path `id`(Long,必填)。
|
||||
**入参**
|
||||
|
||||
**出参**:`OrderDetailRespVO` = `main`(OrderMainVO) + `tags`(List\<TagVO\>) + `overview`(OverviewVO)。
|
||||
| 字段 | 位置 | 类型 | 必填 | 含义 |
|
||||
|---|---|---|---|---|
|
||||
| id | path | Long | 是 | 订单 ID |
|
||||
|
||||
`main`(OrderMainVO,47 字段)核心:
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order/1900000000000903
|
||||
```
|
||||
|
||||
**出参**:`OrderDetailRespVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| id / orderNo / teamNo / displayOrderNo | String | ID / 订单号 / 团号 / 展示号 |
|
||||
| productName / tierName / productSubtitle | String | 产品名 / 档位 / 副标题 |
|
||||
| orderStatus / orderStatusName | String | 粗状态值 / 中文 |
|
||||
| flowStatus / flowStatusName | String | 细状态值 / 中文 |
|
||||
| flowStep / flowStepTotal | Integer | 6 步序号(0/1-6/null) / 总步(6) |
|
||||
| main | OrderMainVO | 主单 + Tab 状态徽标 + 进度管道 |
|
||||
| tags | List\<TagVO\> | 标签区(结构同 §1 TagVO) |
|
||||
| overview | OverviewVO | 概览(客户信息 + 备注) |
|
||||
|
||||
`main`(OrderMainVO,47 字段)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| id | String | 订单 ID |
|
||||
| orderNo | String | 订单号(永不变) |
|
||||
| teamNo | String | 团号(未成团 null) |
|
||||
| displayOrderNo | String | 展示订单号 |
|
||||
| productName | String | 产品名 |
|
||||
| tierName | String | 档位名 |
|
||||
| productSubtitle | String | 产品副标题 |
|
||||
| orderStatus | String | 粗状态值(附录 A) |
|
||||
| orderStatusName | String | 粗状态中文 |
|
||||
| flowStatus | String | 细状态值(附录 A) |
|
||||
| flowStatusName | String | 细状态中文 |
|
||||
| flowStep | Integer | 6 步当前步序号(0/1-6/null) |
|
||||
| flowStepTotal | Integer | 总步数(6) |
|
||||
| flowDisplayText | String | 步骤展示文案(纯中文,不带 "X/6 ·") |
|
||||
| flowStepCode / flowStepStatus | String | 当前步英文码 / 状态(PROCESSING) |
|
||||
| totalAmount / paidAmount / balanceAmount | BigDecimal | 金额 / 实付 / 待付 |
|
||||
| departureDate / returnDate | LocalDate | 出发 / 返回日期 |
|
||||
| tripDays / tripNights | Integer | 行程天 / 夜数 |
|
||||
| createSource / createSourceLabel | String | 来源值 / 中文 |
|
||||
| flowStepCode | String | 当前步英文码(CANCELLED/待支付为 null) |
|
||||
| flowStepStatus | String | 当前步状态(PROCESSING=进行中) |
|
||||
| totalAmount | BigDecimal | 订单金额 |
|
||||
| paidAmount | BigDecimal | 实付金额 |
|
||||
| balanceAmount | BigDecimal | 待付金额 |
|
||||
| departureDate | LocalDate | 出发日期 |
|
||||
| returnDate | LocalDate | 返回日期 |
|
||||
| tripDays | Integer | 行程天数 |
|
||||
| tripNights | Integer | 行程夜数 |
|
||||
| createSource | String | 来源值(附录 A) |
|
||||
| createSourceLabel | String | 来源中文 |
|
||||
| confirmedAt | LocalDateTime | 确认订单时间 |
|
||||
| progressStepper | List\<PipelineNodeVO\> | 6 主节点进度管道(已取消返空数组) |
|
||||
| contractStatus / insuranceStatus / refundStatus | String | [Tab 徽标]合同/保险/退款状态(按字符串容错,附录 B) |
|
||||
| hasRefund / hasServiceStandard / hasFinanceDetail | Boolean | [Tab 徽标]是否有 退款/服务标准/财务明细 |
|
||||
| depositAmount / depositRatio | BigDecimal/Integer | 订金(FULL 为 null) |
|
||||
| paymentMode / payStatus | String | DEPOSIT/FULL ; UNPAID/DEPOSIT_PAID/FULLY_PAID |
|
||||
| contractStatus | String | [Tab 徽标]合同状态(按字符串容错,附录 B) |
|
||||
| insuranceStatus | String | [Tab 徽标]保险状态(附录 B) |
|
||||
| refundStatus | String | [Tab 徽标]退款状态 NONE/PROCESSING/COMPLETED |
|
||||
| hasRefund | Boolean | 是否有退款记录 |
|
||||
| hasServiceStandard | Boolean | 是否有服务标准快照 |
|
||||
| hasFinanceDetail | Boolean | 是否有财务明细(discount/surcharge>0) |
|
||||
| depositAmount | BigDecimal | 订金额(FULL 为 null) |
|
||||
| depositRatio | Integer | 订金比例%(FULL 为 null) |
|
||||
| paymentMode | String | DEPOSIT/FULL |
|
||||
| payStatus | String | 支付状态 UNPAID/DEPOSIT_PAID/FULLY_PAID |
|
||||
| singleRoomSurcharge | BigDecimal | 单房差(未触发 null) |
|
||||
| agencyId / refundPolicyId | String | 旅行社 / 退款政策 ID |
|
||||
| agencyId | String | 旅行社主体 ID |
|
||||
| refundPolicyId | String | 退款政策 ID |
|
||||
|
||||
`PipelineNodeVO`:`step`(1-6)、`code`(PROFILE/RESOURCE/CONFIRM/DEPART/REVIEW/SETTLE)、`name`、`status`(DONE/PROCESSING/WAITING)、`label`、`isCurrent`(Boolean)、`subFlows`(仅 RESOURCE 非 null)。
|
||||
`PipelineNodeVO`(进度节点)
|
||||
|
||||
`overview`(OverviewVO)= `customerInfo` + `remarkInfo`:
|
||||
- **CustomerInfoVO**:`contactName`、`contactPhone`(**明文**)、`agencyName`、`consultantName`、`peopleSummary`、`adultCount`、`childCount`、`youngChildCount`、`babyCount`、`createTime`、`emergencyContactName`、`emergencyContactPhone`(**明文**)、`travelers`(List\<TravelerPlainVO\>)。
|
||||
- **TravelerPlainVO**(明文出行人):`id`、`orderId`、`travelerType`(ADULT/CHILD/YOUNG_CHILD/BABY)、`name`、`gender`(1男/2女/0未知)、`birthday`、`idType`(ID_CARD/PASSPORT/BIRTH_CERT)、`idCard`(**明文**)、`nationality`、`race`、`phone`(**明文**)、`emergencyContact`、`emergencyPhone`(**明文**)、`roomGroupNo`、`profileStatus`(PENDING/COMPLETED)、`transportPlanIds`(List\<String\>)。
|
||||
- **RemarkInfoVO**:`customerRemark`(只读)、`consultantRemark`、`hotelRemark`(无需求 null)、`vehicleRemark`(无需求 null)。
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| step | Integer | 步序号 1-6 |
|
||||
| code | String | 节点码 PROFILE/RESOURCE/CONFIRM/DEPART/REVIEW/SETTLE |
|
||||
| name | String | 节点名称 |
|
||||
| status | String | DONE/PROCESSING/WAITING |
|
||||
| label | String | 显示标签 |
|
||||
| isCurrent | Boolean | 是否当前步 |
|
||||
| subFlows | List\<SubFlowVO\> | 子流程(仅 RESOURCE 节点非 null,结构同 §1) |
|
||||
|
||||
**JSON 示例**
|
||||
`overview`(OverviewVO)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| customerInfo | CustomerInfoVO | 客户信息分类 |
|
||||
| remarkInfo | RemarkInfoVO | 备注分类 |
|
||||
|
||||
`CustomerInfoVO`(客户信息)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| contactName | String | 联系人姓名 |
|
||||
| contactPhone | String | 联系电话(**admin 明文**) |
|
||||
| agencyName | String | 商户名(不存在为 null) |
|
||||
| consultantName | String | 定制师姓名 |
|
||||
| peopleSummary | String | 人数摘要 |
|
||||
| adultCount | Integer | 成人数 |
|
||||
| childCount | Integer | 儿童数 |
|
||||
| youngChildCount | Integer | 小童数 |
|
||||
| babyCount | Integer | 婴儿数 |
|
||||
| createTime | LocalDateTime | 创建时间 |
|
||||
| emergencyContactName | String | 紧急联系人姓名 |
|
||||
| emergencyContactPhone | String | 紧急联系人手机(**明文**) |
|
||||
| travelers | List\<TravelerPlainVO\> | 出行人集合(明文) |
|
||||
|
||||
`TravelerPlainVO`(出行人,明文 #3509)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| id | String | 出行人 ID |
|
||||
| orderId | String | 订单 ID |
|
||||
| travelerType | String | ADULT/CHILD/YOUNG_CHILD/BABY |
|
||||
| name | String | 姓名(占位行为 null) |
|
||||
| gender | String | 1=男 / 2=女 / 0=未知 |
|
||||
| birthday | LocalDate | 出生日期 |
|
||||
| idType | String | ID_CARD/PASSPORT/BIRTH_CERT |
|
||||
| idCard | String | 证件号(**明文**) |
|
||||
| nationality | String | 国籍(默认中国) |
|
||||
| race | String | 民族(默认汉族) |
|
||||
| phone | String | 出行人手机(**明文**) |
|
||||
| emergencyContact | String | 紧急联系人姓名 |
|
||||
| emergencyPhone | String | 紧急联系人电话(**明文**) |
|
||||
| roomGroupNo | Integer | 同住分组号 |
|
||||
| profileStatus | String | 资料完善 PENDING/COMPLETED |
|
||||
| transportPlanIds | List\<String\> | 关联大交通批次 ID 列表 |
|
||||
|
||||
`RemarkInfoVO`(备注)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| customerRemark | String | 用户备注(只读) |
|
||||
| consultantRemark | String | 定制师备注 |
|
||||
| hotelRemark | String | 用房备注(无需求 null) |
|
||||
| vehicleRemark | String | 用车备注(无需求 null) |
|
||||
|
||||
**出参示例**
|
||||
```jsonc
|
||||
GET /v3/admin/order/1900000000000903
|
||||
|
||||
{
|
||||
"code": 200, "message": "成功", "success": true,
|
||||
"data": {
|
||||
"main": {
|
||||
"id": "1900000000000903", "orderNo": "TEST-RESOURCE-903", "teamNo": null,
|
||||
"displayOrderNo": "TEST-RESOURCE-903", "productName": "长白山3日私家定制游", "tierName": "标准档",
|
||||
"productSubtitle": "私家小团·专车专导",
|
||||
"orderStatus": "CUSTOMIZING", "orderStatusName": "定制中",
|
||||
"flowStatus": "RESOURCE_PREPARING", "flowStatusName": "资源准备",
|
||||
"flowStep": 2, "flowStepTotal": 6, "flowDisplayText": "资源准备",
|
||||
@ -190,8 +312,7 @@ GET /v3/admin/order/1900000000000903
|
||||
"contractStatus": "NONE", "insuranceStatus": "NONE", "refundStatus": "NONE",
|
||||
"hasRefund": false, "hasServiceStandard": true, "hasFinanceDetail": false,
|
||||
"depositAmount": null, "depositRatio": null, "paymentMode": "FULL", "payStatus": "UNPAID",
|
||||
"singleRoomSurcharge": null, "agencyId": "8000000000000001", "refundPolicyId": "7000000000000001",
|
||||
"productSubtitle": "私家小团·专车专导"
|
||||
"singleRoomSurcharge": null, "agencyId": "8000000000000001", "refundPolicyId": "7000000000000001"
|
||||
},
|
||||
"tags": [],
|
||||
"overview": {
|
||||
@ -225,26 +346,64 @@ GET /v3/admin/order/1900000000000903
|
||||
**接口介绍**:订单财务明细,含金额汇总、支付/优惠/附加费三类明细列表。
|
||||
**本次修改点**:`SurchargeVO` **删除 `surchargeType` 字段**(恒 null 无数据源,#3523)——破坏性,前端引用处需移除。
|
||||
|
||||
**入参**:path `id`(Long,必填)。
|
||||
**入参**
|
||||
|
||||
| 字段 | 位置 | 类型 | 必填 | 含义 |
|
||||
|---|---|---|---|---|
|
||||
| id | path | Long | 是 | 订单 ID |
|
||||
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order/1900000000000903/finance
|
||||
```
|
||||
|
||||
**出参**:`FinanceVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| totalAmount / paidAmount / balanceAmount | BigDecimal | 总额 / 实付 / 待付 |
|
||||
| discountAmount / surchargeAmount / refundAmount | BigDecimal | 优惠 / 附加费 / 退款 汇总 |
|
||||
| totalAmount | BigDecimal | 订单总额 |
|
||||
| paidAmount | BigDecimal | 实付金额 |
|
||||
| balanceAmount | BigDecimal | 待付金额 |
|
||||
| discountAmount | BigDecimal | 优惠金额汇总 |
|
||||
| surchargeAmount | BigDecimal | 附加费汇总 |
|
||||
| refundAmount | BigDecimal | 退款金额汇总 |
|
||||
| payments | List\<PaymentVO\> | 支付明细 |
|
||||
| discounts | List\<DiscountVO\> | 优惠明细 |
|
||||
| surcharges | List\<SurchargeVO\> | 附加费用 |
|
||||
|
||||
`PaymentVO`:`id`、`payType`(DEPOSIT/BALANCE)、`amount`、`paidAt`、`status`(SUCCESS/PENDING/FAIL)。
|
||||
`DiscountVO`:`id`、`name`、`amount`、`type`(EARLY_BIRD/VIP/…)、`source`(MANUAL/AUTO)、`createdAt`。
|
||||
`SurchargeVO`:`id`、`name`、`amount`、`source`(HOTEL_ASSIGN/VEHICLE_ASSIGN/…)、`createdAt`。〔已删 `surchargeType`〕
|
||||
`PaymentVO`
|
||||
|
||||
**JSON 示例**
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| id | String | 支付记录 ID |
|
||||
| payType | String | DEPOSIT/BALANCE |
|
||||
| amount | BigDecimal | 支付金额 |
|
||||
| paidAt | LocalDateTime | 支付时间 |
|
||||
| status | String | SUCCESS/PENDING/FAIL |
|
||||
|
||||
`DiscountVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| id | String | 优惠 ID |
|
||||
| name | String | 优惠名称 |
|
||||
| amount | BigDecimal | 优惠金额 |
|
||||
| type | String | EARLY_BIRD/VIP/… |
|
||||
| source | String | MANUAL/AUTO |
|
||||
| createdAt | LocalDateTime | 创建时间 |
|
||||
|
||||
`SurchargeVO`(已删 `surchargeType`)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| id | String | 附加费 ID |
|
||||
| name | String | 附加费名称 |
|
||||
| amount | BigDecimal | 金额 |
|
||||
| source | String | HOTEL_ASSIGN/VEHICLE_ASSIGN/… |
|
||||
| createdAt | LocalDateTime | 创建时间 |
|
||||
|
||||
**出参示例**
|
||||
```jsonc
|
||||
GET /v3/admin/order/1900000000000903/finance
|
||||
|
||||
{
|
||||
"code": 200, "message": "成功", "success": true,
|
||||
"data": {
|
||||
@ -272,17 +431,51 @@ GET /v3/admin/order/1900000000000903/finance
|
||||
**接口介绍**:订单合同与保险状态 + 事件时间线。
|
||||
**本次修改点**:`events` **真实化**——来自 status_log / insurance_status_log,不再恒空(#3514)。
|
||||
|
||||
**入参**:path `id`(Long,必填)。
|
||||
**入参**
|
||||
|
||||
**出参**:`ContractInsuranceVO` = `contract` + `insurance`
|
||||
- `ContractVO`:`contractStatus`(附录 B)、`contractSignedAt`、`contractFileUrl`、`events`(List\<EventVO\>)。
|
||||
- `InsuranceVO`:`insuranceStatus`(附录 B)、`insurancePolicyNo`、`insurancePremium`、`events`(List\<EventVO\>)。
|
||||
- `EventVO`:`eventType`(GENERATE/SIGN/ISSUE/…)、`occurredAt`。
|
||||
| 字段 | 位置 | 类型 | 必填 | 含义 |
|
||||
|---|---|---|---|---|
|
||||
| id | path | Long | 是 | 订单 ID |
|
||||
|
||||
**JSON 示例**
|
||||
```jsonc
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order/1900000000000903/contract-insurance
|
||||
```
|
||||
|
||||
**出参**:`ContractInsuranceVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| contract | ContractVO | 合同子对象 |
|
||||
| insurance | InsuranceVO | 保险子对象 |
|
||||
|
||||
`ContractVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| contractStatus | String | 合同状态(附录 B) |
|
||||
| contractSignedAt | LocalDateTime | 签约时间 |
|
||||
| contractFileUrl | String | 合同文件 URL |
|
||||
| events | List\<EventVO\> | 合同事件时间线 |
|
||||
|
||||
`InsuranceVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| insuranceStatus | String | 保险状态(附录 B) |
|
||||
| insurancePolicyNo | String | 保单号 |
|
||||
| insurancePremium | BigDecimal | 保费 |
|
||||
| events | List\<EventVO\> | 保险事件时间线 |
|
||||
|
||||
`EventVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| eventType | String | 事件类型 GENERATE/SIGN/ISSUE/… |
|
||||
| occurredAt | LocalDateTime | 发生时间 |
|
||||
|
||||
**出参示例**
|
||||
```jsonc
|
||||
{
|
||||
"code": 200, "message": "成功", "success": true,
|
||||
"data": {
|
||||
@ -311,31 +504,48 @@ GET /v3/admin/order/1900000000000903/contract-insurance
|
||||
**接口介绍**:返回该订单**全部**发票(含已作废 VOIDED),按 applyAt 倒序。
|
||||
**本次修改点**:**新增接口**(#3517 / #3521)。无发票返回 `data:[]`。
|
||||
|
||||
**入参**:path `id`(Long,必填)。
|
||||
**入参**
|
||||
|
||||
| 字段 | 位置 | 类型 | 必填 | 含义 |
|
||||
|---|---|---|---|---|
|
||||
| id | path | Long | 是 | 订单 ID |
|
||||
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order/1900000000000903/invoices
|
||||
```
|
||||
|
||||
**出参**:`List<InvoiceVO>`(每条 23 字段)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| id / orderId | String | 发票 ID / 订单 ID |
|
||||
| invoiceType / invoiceTypeText | String | 类型值(附录 A) / 文案 |
|
||||
| titleType / titleName | String | 抬头类型(COMPANY/PERSONAL) / 名称 |
|
||||
| id | String | 发票 ID |
|
||||
| orderId | String | 订单 ID |
|
||||
| invoiceType | String | 类型值(附录 A) |
|
||||
| invoiceTypeText | String | 类型文案 |
|
||||
| titleType | String | 抬头类型 COMPANY/PERSONAL |
|
||||
| titleName | String | 抬头名称 |
|
||||
| taxNo | String | 税号(公司抬头/专票必填) |
|
||||
| amount | BigDecimal | 开票金额(元) |
|
||||
| status / statusText | String | 状态值(附录 A) / 文案 |
|
||||
| auditStatus | String | 内容安全机审(PENDING/APPROVED/MANUAL_REVIEW/REJECTED) |
|
||||
| applyReason / applyAt | String/LocalDateTime | 申请说明 / 申请时间 |
|
||||
| status | String | 状态值(附录 A) |
|
||||
| statusText | String | 状态文案 |
|
||||
| auditStatus | String | 机审 PENDING/APPROVED/MANUAL_REVIEW/REJECTED |
|
||||
| applyReason | String | 申请说明 |
|
||||
| applyAt | LocalDateTime | 申请时间 |
|
||||
| fileUrl | String | 发票文件 OSS 链接(UPLOADED 后有值) |
|
||||
| uploader / uploadedAt | String/LocalDateTime | 上传人 / 上传时间 |
|
||||
| uploader | String | 上传人 |
|
||||
| uploadedAt | LocalDateTime | 上传时间 |
|
||||
| deliveredAt | LocalDateTime | 送达时间(DELIVERED 时有值) |
|
||||
| voidReason | String | 作废原因(VOIDED 时有值) |
|
||||
| email / mailAddress | String | 邮箱(电子票) / 邮寄地址(纸质) |
|
||||
| bankName / bankAccount / registAddress / registPhone | String | 专票开户行/账号/注册地址/电话 |
|
||||
| email | String | 邮箱(电子发票) |
|
||||
| mailAddress | String | 邮寄地址(纸质发票) |
|
||||
| bankName | String | 开户行(专票) |
|
||||
| bankAccount | String | 开户账号(专票) |
|
||||
| registAddress | String | 注册地址(专票) |
|
||||
| registPhone | String | 注册电话(专票) |
|
||||
|
||||
**JSON 示例**
|
||||
**出参示例**
|
||||
```jsonc
|
||||
GET /v3/admin/order/1900000000000903/invoices
|
||||
|
||||
{
|
||||
"code": 200, "message": "成功", "success": true,
|
||||
"data": [{
|
||||
@ -362,23 +572,104 @@ GET /v3/admin/order/1900000000000903/invoices
|
||||
- `hotelGroup`/`vehicleGroup`.requirement **真实化**(#3385/#3493);assignment 增 `requirementId`。
|
||||
- `HotelAssignmentVO`(实配酒店)当前**恒返空**,待 house 域接通,前端按空处理勿报错。
|
||||
|
||||
**入参**:path `id`(Long,必填)。
|
||||
**入参**
|
||||
|
||||
**出参**:`ItineraryVO` = `hotelGroup` + `vehicleGroup`
|
||||
- `HotelGroupVO`:`requirement`(HotelRequirementBriefVO) + `assignments`(List\<HotelAssignmentVO\>)。
|
||||
- `VehicleGroupVO`:`requirement`(VehicleRequirementBriefVO) + `assignments`(List\<VehicleAssignmentVO\>)。
|
||||
| 字段 | 位置 | 类型 | 必填 | 含义 |
|
||||
|---|---|---|---|---|
|
||||
| id | path | Long | 是 | 订单 ID |
|
||||
|
||||
`HotelRequirementBriefVO`:`requirementId`、`version`、`status`(PENDING/PROCESSING/DONE)、`submittedAt`、`totalRoomCount`、`roomTypeSummary`、`specialTags`(List\<String\>)、`remark`、`claimerName`、`days`(List\<RequirementDayVO\>)。
|
||||
└ `RequirementDayVO`:`dayNumber`、`stayDate`、`remark`、`hotels`(List\<RequirementHotelVO\>)。
|
||||
└ `RequirementHotelVO`:`hotelId`(可 null)、`roomCategory`(TWIN/DOUBLE_BED)、`roomCategoryLabel`、`roomCount`、`budget`(可 null)。
|
||||
`HotelAssignmentVO`(恒空):`assignmentId`、`requirementId`、`familyIndex`、`dayNumber`、`stayDate`、`hotelName`、`roomType`、`plannedCost`、`remark`。
|
||||
`VehicleRequirementBriefVO`:`requirementId`、`version`、`status`、`submittedAt`、`vehicleTypeSummary`、`specialTags`、`remark`。
|
||||
`VehicleAssignmentVO`:`assignmentId`、`vehicleType`、`vehicleCount`、`licensePlate`、`brand`、`seats`、`plannedDailyFee`、`driverName`、`driverPhoneMasked`(脱敏)、`remark`。
|
||||
|
||||
**JSON 示例**
|
||||
```jsonc
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order/1900000000000903/itinerary
|
||||
```
|
||||
|
||||
**出参**:`ItineraryVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| hotelGroup | HotelGroupVO | 配房需求 + 实配 |
|
||||
| vehicleGroup | VehicleGroupVO | 配车需求 + 实配 |
|
||||
|
||||
`HotelGroupVO` = `requirement`(HotelRequirementBriefVO) + `assignments`(List\<HotelAssignmentVO\>)
|
||||
`VehicleGroupVO` = `requirement`(VehicleRequirementBriefVO) + `assignments`(List\<VehicleAssignmentVO\>)
|
||||
|
||||
`HotelRequirementBriefVO`(配房需求)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| requirementId | String | 需求 ID |
|
||||
| version | Integer | 版本号 |
|
||||
| status | String | PENDING/PROCESSING/DONE |
|
||||
| submittedAt | LocalDateTime | 提交时间 |
|
||||
| totalRoomCount | Integer | 合计间数 |
|
||||
| roomTypeSummary | String | 房型摘要(双床房×4 / 大床房×2) |
|
||||
| specialTags | List\<String\> | 特殊诉求标签 |
|
||||
| remark | String | 备注 |
|
||||
| claimerName | String | 房控接单人姓名 |
|
||||
| days | List\<RequirementDayVO\> | 按天结构化需求 |
|
||||
|
||||
`RequirementDayVO`(按天需求)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| dayNumber | Integer | 第几天 |
|
||||
| stayDate | LocalDate | 入住日(派生) |
|
||||
| remark | String | 当天备注 |
|
||||
| hotels | List\<RequirementHotelVO\> | 当天房型明细 |
|
||||
|
||||
`RequirementHotelVO`(房型明细)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| hotelId | String | 目标酒店 ID(可 null) |
|
||||
| roomCategory | String | 房型字典 code TWIN/DOUBLE_BED |
|
||||
| roomCategoryLabel | String | 房型中文标签 |
|
||||
| roomCount | Integer | 间数 |
|
||||
| budget | BigDecimal | 预算/间(可 null) |
|
||||
|
||||
`HotelAssignmentVO`(实配酒店,**当前恒返空**)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| assignmentId | String | 实配 ID |
|
||||
| requirementId | String | 关联配房需求 ID |
|
||||
| familyIndex | Integer | 家庭序号 |
|
||||
| dayNumber | Integer | 第几天 |
|
||||
| stayDate | LocalDate | 入住日 |
|
||||
| hotelName | String | 酒店名 |
|
||||
| roomType | String | 房型中文名 |
|
||||
| plannedCost | BigDecimal | 单价(元/间·晚) |
|
||||
| remark | String | 备注 |
|
||||
|
||||
`VehicleRequirementBriefVO`(配车需求)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| requirementId | String | 需求 ID |
|
||||
| version | Integer | 版本号 |
|
||||
| status | String | PENDING/PROCESSING/DONE |
|
||||
| submittedAt | LocalDateTime | 提交时间 |
|
||||
| vehicleTypeSummary | String | 车型摘要 |
|
||||
| specialTags | List\<String\> | 特殊诉求标签 |
|
||||
| remark | String | 备注 |
|
||||
|
||||
`VehicleAssignmentVO`(实配车辆)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| assignmentId | String | 实配 ID |
|
||||
| vehicleType | String | 车型 |
|
||||
| vehicleCount | Integer | 车辆数 |
|
||||
| licensePlate | String | 车牌 |
|
||||
| brand | String | 品牌 |
|
||||
| seats | Integer | 座位数 |
|
||||
| plannedDailyFee | BigDecimal | 计划日单价 |
|
||||
| driverName | String | 司机姓名 |
|
||||
| driverPhoneMasked | String | 司机手机(脱敏) |
|
||||
| remark | String | 备注 |
|
||||
|
||||
**出参示例**
|
||||
```jsonc
|
||||
{
|
||||
"code": 200, "message": "成功", "success": true,
|
||||
"data": {
|
||||
@ -419,28 +710,48 @@ GET /v3/admin/order/1900000000000903/itinerary
|
||||
**接口介绍**:订单大交通(抵达/返程)批次安排,含航班/车次/自驾、接送、关联出行人。
|
||||
**本次修改点**:原在详情主接口内,#3385 起拆为独立懒加载接口(字段不变)。无批次返回 `data:[]`。
|
||||
|
||||
**入参**:path `id`(Long,必填)。
|
||||
**入参**
|
||||
|
||||
| 字段 | 位置 | 类型 | 必填 | 含义 |
|
||||
|---|---|---|---|---|
|
||||
| id | path | Long | 是 | 订单 ID |
|
||||
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order/1900000000000903/transport-plans
|
||||
```
|
||||
|
||||
**出参**:`List<TransportPlanVO>`(每条 17 字段)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| id / orderId | String | 批次 ID / 订单 ID |
|
||||
| id | String | 批次 ID |
|
||||
| orderId | String | 订单 ID |
|
||||
| direction | String | 方向 ARRIVAL/DEPARTURE |
|
||||
| mode | String | TOGETHER(一起)/SEPARATE(分批) |
|
||||
| transportType | String | FLIGHT/TRAIN/SELF_DRIVE |
|
||||
| transportNo / carrier | String | 航班车次号 / 航司铁路公司 |
|
||||
| departStation / arriveStation | String | 出发站 / 到达站 |
|
||||
| departTime / arriveTime | LocalDateTime | 出发 / 到达时间 |
|
||||
| selfDrivePeriod / selfDriveEta | String/LocalDateTime | 自驾时段(MORNING/AFTERNOON/EVENING) / 预计到达 |
|
||||
| pickupRequired / pickupRemark | Boolean/String | 是否需接送 / 接送备注 |
|
||||
| travelers | List\<TravelerRef\> | 关联出行人({id,name}) |
|
||||
| transportNo | String | 航班号/车次号 |
|
||||
| carrier | String | 航司/铁路公司 |
|
||||
| departStation | String | 出发站 |
|
||||
| arriveStation | String | 到达站 |
|
||||
| departTime | LocalDateTime | 出发时间 |
|
||||
| arriveTime | LocalDateTime | 到达时间 |
|
||||
| selfDrivePeriod | String | 自驾时段 MORNING/AFTERNOON/EVENING |
|
||||
| selfDriveEta | LocalDateTime | 自驾预计到达时间 |
|
||||
| pickupRequired | Boolean | 是否需要接送 |
|
||||
| pickupRemark | String | 接送备注 |
|
||||
| travelers | List\<TravelerRef\> | 关联出行人 |
|
||||
| remark | String | 备注 |
|
||||
|
||||
**JSON 示例**
|
||||
```jsonc
|
||||
GET /v3/admin/order/1900000000000903/transport-plans
|
||||
`TravelerRef`(关联出行人)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| id | String | 出行人 ID |
|
||||
| name | String | 出行人姓名 |
|
||||
|
||||
**出参示例**
|
||||
```jsonc
|
||||
{
|
||||
"code": 200, "message": "成功", "success": true,
|
||||
"data": [{
|
||||
@ -464,7 +775,16 @@ GET /v3/admin/order/1900000000000903/transport-plans
|
||||
**接口介绍**:订单全生命周期状态/操作流水时间线。
|
||||
**本次修改点**:无字段变更。无记录返回 `data:[]`。
|
||||
|
||||
**入参**:path `id`(Long,必填)。
|
||||
**入参**
|
||||
|
||||
| 字段 | 位置 | 类型 | 必填 | 含义 |
|
||||
|---|---|---|---|---|
|
||||
| id | path | Long | 是 | 订单 ID |
|
||||
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order/1900000000000903/status-log
|
||||
```
|
||||
|
||||
**出参**:`List<LogTimelineVO>`
|
||||
|
||||
@ -473,13 +793,12 @@ GET /v3/admin/order/1900000000000903/transport-plans
|
||||
| occurredAt | LocalDateTime | 发生时间 |
|
||||
| operator | String | 操作人 |
|
||||
| action | String | 操作描述 |
|
||||
| fromStatus / toStatus | String | 变更前 / 后状态(有状态变更时有值) |
|
||||
| fromStatus | String | 变更前状态(有状态变更时有值) |
|
||||
| toStatus | String | 变更后状态(有状态变更时有值) |
|
||||
| amount | BigDecimal | 涉及金额(支付/退款时有值) |
|
||||
|
||||
**JSON 示例**
|
||||
**出参示例**
|
||||
```jsonc
|
||||
GET /v3/admin/order/1900000000000903/status-log
|
||||
|
||||
{
|
||||
"code": 200, "message": "成功", "success": true,
|
||||
"data": [
|
||||
@ -497,17 +816,61 @@ GET /v3/admin/order/1900000000000903/status-log
|
||||
**接口介绍**:订单退款申请明细(可多笔),含审批/到账进度时间线。
|
||||
**本次修改点**:无字段变更。**无退款申请时整节返回 `data:null`**(前端需与"订单不存在 581007"区分)。
|
||||
|
||||
**入参**:path `id`(Long,必填)。
|
||||
**入参**
|
||||
|
||||
**出参**:`RefundDetailVO` = `totalRefundAmount` + `applications`(List\<RefundApplicationVO\>)
|
||||
`RefundApplicationVO`:`applicationId`、`status`(附录 B)、`statusText`、`refundAmount`、`refundChannel`、`approverName`、`approvedAt`、`estimatedArriveDate`、`actualArriveDate`(未到账 null)、`progress`(List\<ProgressStepVO\>)、`items`(List\<RefundItemVO\>)。
|
||||
`ProgressStepVO`:`step`(APPLY/APPROVE/PAYOUT/ARRIVED)、`label`、`status`(DONE/ACTIVE/PENDING)、`occurredAt`(PENDING 时 null)。
|
||||
`RefundItemVO`:`itemName`、`reason`、`appliedAt`、`amount`(负数)。
|
||||
| 字段 | 位置 | 类型 | 必填 | 含义 |
|
||||
|---|---|---|---|---|
|
||||
| id | path | Long | 是 | 订单 ID |
|
||||
|
||||
**JSON 示例**
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order/1900000000000903/refund
|
||||
```
|
||||
|
||||
**出参**:`RefundDetailVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| totalRefundAmount | BigDecimal | 合计退款金额 |
|
||||
| applications | List\<RefundApplicationVO\> | 多笔退款申请 |
|
||||
|
||||
`RefundApplicationVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| applicationId | String | 申请 ID |
|
||||
| status | String | 状态(附录 B) |
|
||||
| statusText | String | 状态描述文案 |
|
||||
| refundAmount | BigDecimal | 退款金额 |
|
||||
| refundChannel | String | 退款渠道 |
|
||||
| approverName | String | 审批人 |
|
||||
| approvedAt | LocalDateTime | 审批时间 |
|
||||
| estimatedArriveDate | LocalDate | 预计到账日期 |
|
||||
| actualArriveDate | LocalDate | 实际到账日期(未到账 null) |
|
||||
| progress | List\<ProgressStepVO\> | 4 步进度时间线 |
|
||||
| items | List\<RefundItemVO\> | 退款明细行 |
|
||||
|
||||
`ProgressStepVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| step | String | APPLY/APPROVE/PAYOUT/ARRIVED |
|
||||
| label | String | 展示标签 |
|
||||
| status | String | DONE/ACTIVE/PENDING |
|
||||
| occurredAt | LocalDateTime | 发生时间(PENDING 时 null) |
|
||||
|
||||
`RefundItemVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| itemName | String | 项目名称 |
|
||||
| reason | String | 退款原因 |
|
||||
| appliedAt | LocalDateTime | 申请时间 |
|
||||
| amount | BigDecimal | 退款金额(负数) |
|
||||
|
||||
**出参示例**
|
||||
```jsonc
|
||||
// 空态(无退款)
|
||||
GET /v3/admin/order/1900000000000903/refund
|
||||
{"code": 200, "message": "成功", "success": true, "data": null}
|
||||
|
||||
// 有退款
|
||||
@ -539,19 +902,80 @@ GET /v3/admin/order/1900000000000903/refund
|
||||
**接口介绍**:订单服务标准(出团承诺 + 逐天行程 + 退费说明),数据源为产品侧预置并冻入订单快照的成品。
|
||||
**本次修改点**:**重构为一站式聚合**(#3340/#3351)——原 itinerary/notice/refundPolicy/serviceStandard/dayTips 五字段全部替换为本套 ServiceStandardVO 结构;读快照预置成品。**产品快照缺失时返回 `data:null`**。
|
||||
|
||||
**入参**:path `id`(Long,必填)。
|
||||
**入参**
|
||||
|
||||
**出参**:`ServiceStandardVO`:`title`、`subtitle`、`intro`(无结构 null)、`notices`(List\<NoticeItem\>)、`itinerary`(List\<DayVO\>)、`refundNotes`(List\<RefundNoteGroup\>)。
|
||||
`NoticeItem`:`title`、`content`、`remark`、`color`(#RRGGBB)、`contactName`、`phone`(后 4 项可选)。
|
||||
`DayVO`:`dayNumber`、`dayTitle`、`remark`(恒 null)、`itineraryNode`(List\<ItineraryNode\>)。
|
||||
└ `ItineraryNode`:`nodeName`、`description`、`contactName`(恒 null)、`phone`(恒 null)。
|
||||
`RefundNoteGroup`:`sourceName`、`intro`、`items`(List\<RefundItem\>)。
|
||||
└ `RefundItem`:`title`、`amount`(赠送为 0)、`unitLabel`(/人 /团 /辆)、`settleScope`(PER_PERSON/PER_TEAM/PER_VEHICLE)、`settleScopeLabel`、`remark`、`effectiveFrom`(null=无限制)、`effectiveTo`(null=无限制)。
|
||||
| 字段 | 位置 | 类型 | 必填 | 含义 |
|
||||
|---|---|---|---|---|
|
||||
| id | path | Long | 是 | 订单 ID |
|
||||
|
||||
**JSON 示例**(取自测试服 903 真实返回)
|
||||
```jsonc
|
||||
**入参示例**
|
||||
```
|
||||
GET /v3/admin/order/1900000000000903/service-standard
|
||||
```
|
||||
|
||||
**出参**:`ServiceStandardVO`
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| title | String | 标题("出团服务标准·"+产品名;name 空时退化为"出团服务标准") |
|
||||
| subtitle | String | 副标题(固定常量) |
|
||||
| intro | String | 服务标准简介(无结构 null) |
|
||||
| notices | List\<NoticeItem\> | 服务承诺条目扁平列表(无结构空列表) |
|
||||
| itinerary | List\<DayVO\> | 行程逐天列表 |
|
||||
| refundNotes | List\<RefundNoteGroup\> | 退费说明聚合列表(无退费说明空列表) |
|
||||
|
||||
`NoticeItem`(服务承诺条目)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| title | String | 主文案标题 |
|
||||
| content | String | 正文 |
|
||||
| remark | String | 灰色二级说明(可选) |
|
||||
| color | String | 文案颜色 #RRGGBB(可选) |
|
||||
| contactName | String | 联系人(可选) |
|
||||
| phone | String | 手机号(可选) |
|
||||
|
||||
`DayVO`(行程天)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| dayNumber | Integer | 天序号 |
|
||||
| dayTitle | String | 天标题 |
|
||||
| remark | String | 当天备注(恒 null) |
|
||||
| itineraryNode | List\<ItineraryNode\> | 当天点位列表 |
|
||||
|
||||
`ItineraryNode`(行程点位)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| nodeName | String | 点位名称 |
|
||||
| description | String | 点位描述 |
|
||||
| contactName | String | 联系人(占位,恒 null) |
|
||||
| phone | String | 手机号(占位,恒 null) |
|
||||
|
||||
`RefundNoteGroup`(退费说明分组)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| sourceName | String | 来源点位名称 |
|
||||
| intro | String | 退费说明备注 |
|
||||
| items | List\<RefundItem\> | 退费明细列表 |
|
||||
|
||||
`RefundItem`(退费明细)
|
||||
|
||||
| 字段 | 类型 | 含义 |
|
||||
|---|---|---|
|
||||
| title | String | 展示标题 |
|
||||
| amount | BigDecimal | 退费金额(赠送为 0) |
|
||||
| unitLabel | String | 展示文案 /人 /团 /辆 |
|
||||
| settleScope | String | 结算粒度 PER_PERSON/PER_TEAM/PER_VEHICLE |
|
||||
| settleScopeLabel | String | 结算粒度中文 |
|
||||
| remark | String | 备注 |
|
||||
| effectiveFrom | LocalDate | 生效起日(null=无限制) |
|
||||
| effectiveTo | LocalDate | 生效止日(null=无限制) |
|
||||
|
||||
**出参示例**(取自测试服 903 真实返回)
|
||||
```jsonc
|
||||
{
|
||||
"code": 200, "message": "成功", "success": true,
|
||||
"data": {
|
||||
@ -586,15 +1010,65 @@ GET /v3/admin/order/1900000000000903/service-standard
|
||||
|
||||
## 附录 A 枚举字典
|
||||
|
||||
- **OrderStatus**(粗状态):PENDING_PAY 待支付 / CUSTOMIZING 定制中 / PENDING_DEPARTURE 待出行 / TRAVELLING 出行中 / COMPLETED 已完成 / CANCELLED 已取消
|
||||
- **OrderFlowStatus**(细状态,12):AWAITING_PAY 待支付 / AWAITING_PROFILE 待补全信息 / RESOURCE_PREPARING 资源准备 / PENDING_CONFIRM 待确认 / PENDING_DEPARTURE 待出行 / TRAVELLING 出行中 / PENDING_REVIEW 待核单 / REVIEWING 核单中 / PENDING_SETTLE 待结算 / SETTLED 已结算 / COMPLETED 已完成 / CANCELLED 已取消
|
||||
- **OrderFlowMainStep**(6 主步,code→step):PROFILE 1 补全信息 / RESOURCE 2 资源准备 / CONFIRM 3 确认 / DEPART 4 出行 / REVIEW 5 核单 / SETTLE 6 结算。flowStep=0 待支付(未进步骤条);CANCELLED flowStep/flowStepCode=null
|
||||
- **OrderCreateSource**:CONSULTANT 定制师创建(默认/兜底) / CUSTOMER C端客户自下单
|
||||
- **payStatus**:UNPAID 未支付 / DEPOSIT_PAID 订金已付 / FULLY_PAID 全款已付
|
||||
- **paymentMode**:DEPOSIT 订金模式 / FULL 全款模式
|
||||
- **refundStatus**(main 徽标):NONE 无退款 / PROCESSING 退款中 / COMPLETED 已完成
|
||||
- **发票 invoiceType**:VAT_NORMAL 增值税普票 / VAT_SPECIAL 增值税专票 / ELECTRONIC 电子普票
|
||||
- **发票 status**:APPLIED 已申请 / ISSUED 已开票 / UPLOADED 已上传 / DELIVERED 已送达 / VOIDED 已作废
|
||||
### OrderStatus(订单粗状态)
|
||||
|
||||
| 值 | 中文 |
|
||||
|---|---|
|
||||
| PENDING_PAY | 待支付 |
|
||||
| CUSTOMIZING | 定制中 |
|
||||
| PENDING_DEPARTURE | 待出行 |
|
||||
| TRAVELLING | 出行中 |
|
||||
| COMPLETED | 已完成 |
|
||||
| CANCELLED | 已取消 |
|
||||
|
||||
### OrderFlowStatus(订单细状态,12 态)
|
||||
|
||||
| 值 | 中文 |
|
||||
|---|---|
|
||||
| AWAITING_PAY | 待支付 |
|
||||
| AWAITING_PROFILE | 待补全信息 |
|
||||
| RESOURCE_PREPARING | 资源准备 |
|
||||
| PENDING_CONFIRM | 待确认 |
|
||||
| PENDING_DEPARTURE | 待出行 |
|
||||
| TRAVELLING | 出行中 |
|
||||
| PENDING_REVIEW | 待核单 |
|
||||
| REVIEWING | 核单中 |
|
||||
| PENDING_SETTLE | 待结算 |
|
||||
| SETTLED | 已结算 |
|
||||
| COMPLETED | 已完成 |
|
||||
| CANCELLED | 已取消 |
|
||||
|
||||
### OrderFlowMainStep(6 主步,flowStepCode / progressStepper)
|
||||
|
||||
| code | step | 中文 |
|
||||
|---|---|---|
|
||||
| PROFILE | 1 | 补全信息 |
|
||||
| RESOURCE | 2 | 资源准备 |
|
||||
| CONFIRM | 3 | 确认 |
|
||||
| DEPART | 4 | 出行 |
|
||||
| REVIEW | 5 | 核单 |
|
||||
| SETTLE | 6 | 结算 |
|
||||
|
||||
> flowStep=0 表示"待支付"(步骤条未开始);CANCELLED 终态 flowStep=null、flowStepCode=null。
|
||||
|
||||
### 其他枚举
|
||||
|
||||
| 枚举字段 | 值 | 中文 |
|
||||
|---|---|---|
|
||||
| createSource | CONSULTANT / CUSTOMER | 定制师创建(默认/兜底) / C端客户自下单 |
|
||||
| payStatus | UNPAID / DEPOSIT_PAID / FULLY_PAID | 未支付 / 订金已付 / 全款已付 |
|
||||
| paymentMode | DEPOSIT / FULL | 订金模式 / 全款模式 |
|
||||
| refundStatus(main 徽标) | NONE / PROCESSING / COMPLETED | 无退款 / 退款中 / 已完成 |
|
||||
| invoiceType | VAT_NORMAL / VAT_SPECIAL / ELECTRONIC | 增值税普票 / 增值税专票 / 电子普票 |
|
||||
| invoice status | APPLIED / ISSUED / UPLOADED / DELIVERED / VOIDED | 已申请 / 已开票 / 已上传 / 已送达 / 已作废 |
|
||||
| invoice auditStatus | PENDING / APPROVED / MANUAL_REVIEW / REJECTED | 待审 / 通过 / 转人工 / 拒绝 |
|
||||
| titleType | COMPANY / PERSONAL | 公司 / 个人 |
|
||||
| transportType | FLIGHT / TRAIN / SELF_DRIVE | 飞机 / 火车 / 自驾 |
|
||||
| direction | ARRIVAL / DEPARTURE | 抵达 / 返程 |
|
||||
| settleScope | PER_PERSON / PER_TEAM / PER_VEHICLE | 按人 / 按团 / 按辆 |
|
||||
| travelerType | ADULT / CHILD / YOUNG_CHILD / BABY | 成人 / 儿童 / 小童 / 婴儿 |
|
||||
| idType | ID_CARD / PASSPORT / BIRTH_CERT | 身份证 / 护照 / 出生证 |
|
||||
| 通用 status | DONE / PROCESSING / WAITING | 完成 / 处理中 / 等待 |
|
||||
|
||||
## 附录 B 枚举口径差异(⚠️ 按字符串容错,配合 statusText)
|
||||
|
||||
@ -613,3 +1087,4 @@ GET /v3/admin/order/1900000000000903/service-standard
|
||||
- Issue:[#3517](https://git.1814.love:8443/wx/HL/issues/3517) [#3514](https://git.1814.love:8443/wx/HL/issues/3514) [#3509](https://git.1814.love:8443/wx/HL/issues/3509) [#3502](https://git.1814.love:8443/wx/HL/issues/3502) [#3500](https://git.1814.love:8443/wx/HL/issues/3500) [#3493](https://git.1814.love:8443/wx/HL/issues/3493) [#3488](https://git.1814.love:8443/wx/HL/issues/3488) [#3385](https://git.1814.love:8443/wx/HL/issues/3385) [#3340](https://git.1814.love:8443/wx/HL/issues/3340) [#3523](https://git.1814.love:8443/wx/HL/issues/3523)
|
||||
- PR:[#3521](https://git.1814.love:8443/wx/HL/pulls/3521) [#3524](https://git.1814.love:8443/wx/HL/pulls/3524) [#3510](https://git.1814.love:8443/wx/HL/pulls/3510) [#3388](https://git.1814.love:8443/wx/HL/pulls/3388)
|
||||
- 基线 commit:`f95757df7` | 后端负责人:腰苏图(订单 v3)
|
||||
```
|
||||
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户