From 97a891a203db0dad543c1fad9624c64e6bac8738 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 20 Mar 2026 18:29:01 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=B0=8F=E7=A8=8B=E5=BA=8F=E5=87=BA?= =?UTF-8?q?=E8=A1=8C=E4=BA=BA=E4=BF=AE=E6=94=B9=20=E2=86=92=20=E8=87=AA?= =?UTF-8?q?=E5=8A=A8=E9=80=80=E4=BF=9D/=E4=BD=9C=E5=BA=9F=E5=90=88?= =?UTF-8?q?=E5=90=8C/=E9=87=8D=E6=96=B0=E6=8A=95=E4=BF=9D=E7=AD=BE?= =?UTF-8?q?=E7=BA=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 --- .../2026-03-20_mp_traveler_edit_cascade.md | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 changelogs/2026-03/2026-03-20_mp_traveler_edit_cascade.md diff --git a/changelogs/2026-03/2026-03-20_mp_traveler_edit_cascade.md b/changelogs/2026-03/2026-03-20_mp_traveler_edit_cascade.md new file mode 100644 index 0000000..ff507a7 --- /dev/null +++ b/changelogs/2026-03/2026-03-20_mp_traveler_edit_cascade.md @@ -0,0 +1,51 @@ +# 接口变更记录 — 2026-03-20（小程序出行人修改级联处理） + +> **类型** feature + +--- + +## 功能说明 + +小程序端用户可以在**行程开始前**随时修改出行人信息。修改后系统自动执行以下流程： + +1. **退保** — 作废已购买的保险单 +2. **作废合同** — 作废已签署/已创建的合同 +3. **重置待办** — INSURANCE、CONTRACT 待办回到待处理 +4. **流程状态回退** — processStatus 回退到 `PENDING_INSURANCE` +5. **自动重新投保+签约** — 如果订单已付款，系统自动用新出行人信息重新投保和签约 + +## 使用的接口（无变更） + +### `PUT` /mp/order/{orderId}/edit — 小程序编辑订单 + +请求参数不变： + +| 字段 | 类型 | 说明 | +|------|------|------| +| `departureDate` | String(日期) | 出发日期（可选） | +| `travelers` | Array | 出行人列表（可选，传则全量替换） | + +出行人对象： + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| `name` | String | 是 | 姓名 | +| `idCardType` | String | 是 | 证件类型：`ID_CARD`/`PASSPORT`/`OTHER` | +| `idCardNo` | String | 是 | 证件号 | +| `phone` | String | 否 | 手机号 | +| `gender` | Integer | 否 | 性别：1=男，2=女 | +| `birthday` | String(日期) | 否 | 出生日期 | +| `travelerType` | String | 否 | 类型：`ADULT`/`CHILD`/`BABY` | +| `nationality` | String | 否 | 国籍（默认中国） | +| `emergencyContact` | String | 否 | 紧急联系人 | +| `emergencyPhone` | String | 否 | 紧急联系人电话 | + +## 前端注意事项 + +| 项目 | 说明 | +|------|------| +| **可编辑状态** | 待支付、已付定金、已全额支付、已确认、待付尾款、待出行 | +| **不可编辑状态** | 旅行中、已完成、已取消、退款中、已退款 | +| **修改后的提示** | 修改出行人后，如果订单已付款，告知用户"系统正在重新处理保险和合同" | +| **全量替换** | 传 `travelers` 时是全量替换，请传所有出行人（不是增量修改） | +| **自动重新处理** | 后端自动退保→重新投保、作废合同→重新签约，前端无需额外调用 |