hl-api-changelog/changelogs/2026-03/26_1200_group_code.md

订单新增4位团号(groupCode)

日期: 2026-03-26 服务: hl-order-service

---

新增字段

订单列表和详情接口新增 groupCode 字段：

字段	类型	说明	示例
groupCode	String(4)	4位团号，司机/酒店沟通用	"9854"

返回位置：

• GET /mp/order/list → MpOrderListVO.groupCode
• GET /mp/order/{id} → MpOrderDetailVO.groupCode（通过product字段）
• GET /admin/order/list → OrderListVO.groupCode
• GET /admin/order/{id} → OrderDetailVO.groupCode

生成规则：

• 4位数字，年度内唯一且不连续（LCG混淆算法）
• 每年1月1日序号重置
• 创建订单时自动生成，无需前端传参

用途：司机和酒店之间快速交流的短编号，比完整订单号更方便口头沟通。