快递柜系统设计（中）：取件与取回
快递柜系统设计（中）：取件与取回——包裹怎么从柜子到人手上
文章目录
- 快递柜系统设计（中）：取件与取回——包裹怎么从柜子到人手上
- 一、取件：两种打开方式
- 方式一：输入单号
- 方式二：扫码取件
- 二、超时收费：免费存放是有时限的
- 三、取回：快递员把没人取的包裹拿回来
- 四、寄存：个人也能用快递柜
- 五、状态闭环
- 六、总结
取件不是简单的"开门"。有超时收费、多件一次取、快递员取回。每一层都有状态判断。
一、取件：两种打开方式
用户取件有两条入口：输入单号和扫码取件。
方式一：输入单号
用户收到的短信里有流水号（不是快递单号，是系统生成的取件码）。在柜机屏幕上输入：
柜机：用户输入流水号 │ ▼ 后端：验证流水号是否有效、是否已取、是否超时 │ ├─ 超时需要缴费 → 跳扫码支付流程 → 支付成功 → 继续 │ ▼ 后端 → 柜机：开门 │ ▼ 用户取件 → 关门 │ ▼ 后端：记录取件成功 → 接口回写物流信息（通知快递公司） │ ▼ 柜机：显示"取件成功"方式二：扫码取件
用户用公众号或 APP 扫码登录后，系统自动列出该用户所有在柜的快递：
用户扫码登录 │ ▼ 后端：查询该用户的快递列表 │ ▼ 柜机：显示列表（快递单号、柜号） │ ▼ 用户选择要取的快递 │ ├─ 多件 → 逐件开门取件 └─ 单件 → 直接开门 │ ▼ 取件 → 关门 → 记录成功 → 回写物流信息 │ ├─ 还有快递没取 → 提示"是否继续" └─ 全部取完 → 显示"取件成功"扫码取件的优势是一次登录，多件一起取。不用每件输一次号码。
二、超时收费：免费存放是有时限的
不是长期免费仓库。超过 N 小时，取件时自动触发收费：
柜机：开门前 → 后端判断是否超时 │ ├─ 未超时 → 直接开门 │ └─ 已超时 → 提示"需缴纳超时费 X 元" │ ▼ 跳转扫码支付（微信/支付宝） │ ▼ 支付成功 → 开门取件超时收费标准在后端配置——按小时、按柜型。支付成功后柜门才开。不是先取后付——物理控制做在支付之后，防止恶意不付。
伪代码实现：
// 取件（通用入口） function 取件(取件码): rec = SELECT * FROM 投递记录 WHERE 取件码=取件码 AND 状态='待取件' if rec is None: return error("取件码无效或已取件") // 超时判断 hours = NOW() - rec.投递时间 if hours > 免费存放时长(rec.柜型): 超时费 = 计算超时费(hours, rec.柜型) payResult = 发起扫码支付(超时费) if not payResult.ok: return error("需支付超时费" + 超时费 + "元") // 开门 柜机.openDoor(rec.柜号) 柜机.waitDoorClose(rec.柜号, timeout=60) // 记录成功 UPDATE 投递记录 SET 状态='已取件', 取件时间=NOW() WHERE ID=rec.ID UPDATE 柜子 SET 状态='空闲' WHERE 柜号=rec.柜号 // 回写物流 物流回写(rec.运单号, "已签收", NOW()) return "取件成功" // 扫码取件（一次登录取多件） function 扫码取件(用户ID): // 根据手机号模糊匹配：用户可能用不同的手机号 list = SELECT * FROM 投递记录 WHERE 收件人电话 LIKE CONCAT('%', 用户.手机号后4位) AND 状态='待取件' if len(list) == 0: return "没有待取快递" for item in list: 柜机.show("快递" + item.运单号 + " 柜号:" + item.柜号) for item in list: if 用户.选择(item): 取件(item.取件码) // 复用单个取件逻辑 if not 用户.是否继续(): break return "取件完成" // 取回（快递员收回超时未取的） function 取回包裹(快递员ID, 投递记录ID): rec = SELECT * FROM 投递记录 WHERE ID=投递记录ID AND 快递员ID=快递员ID if rec is None: return error("无权取回") if rec.状态 != '待取件': return error("已取走") 柜机.openDoor(rec.柜号) 柜机.waitDoorClose(rec.柜号, timeout=60) UPDATE 投递记录 SET 状态='已取回', 取回时间=NOW() WHERE ID=rec.ID UPDATE 柜子 SET 状态='空闲' WHERE 柜号=rec.柜号 物流回写(rec.运单号, "已退回", NOW()) 短信平台.send(rec.收件人电话, "您的快递因超时未被领取，已由快递员取回") return "取回成功"三、取回：快递员把没人取的包裹拿回来
投递后超过 N 天没人取，快递员要来取回包裹。流程是投递的逆操作：
快递员扫码登录 │ ▼ 后端：查询该快递员名下未取包裹清单 │ ▼ 柜机：显示列表 │ ▼ 快递员选择要取回的快递 → 开门 → 取出 → 关门 │ ▼ 后端：记录取回成功 → 接口回写物流信息 │ ▼ 短信平台 → 通知收件人"快递已被取回，请联系快递员"取回不是"删记录"。原投递记录保留，新增一条取回记录。物流信息回写后，快递公司系统里这单的状态从"待取件"变为"已退回"。
取回后短信通知收件人——不是悄悄拿走让人白跑一趟。
四、寄存：个人也能用快递柜
不是只有快递员能放东西。个人用户也能临时寄存——A 放个东西在柜子里，B 凭取货码来拿：
用户扫码登录 │ ▼ 录入手机号（寄存人的） │ ▼ 后端 → 短信平台：发验证码到手机 │ ▼ 录入验证码 + 收件人手机号 │ ▼ 后端：验证通过 → 查询空柜列表 │ ▼ 分配柜子 → 扫码支付寄存费 │ ▼ 开门 → 放件 → 关门 │ ▼ 后端 → 短信平台：发送取货码给收件人跟投递的区别：费用是寄存人当场付，不是从快递员账户扣。取货码发给收件人，发件人也留一份。
收件人拿取货码到柜机取件——流程跟快递取件一样。寄存是快递柜的增值场景，不是核心功能，但增加了柜子利用率。
五、状态闭环
包裹从投递到取件（或取回），柜子状态走一圈：
空闲 ──→ 占用（投递成功）──→ 取件成功 ──→ 空闲 │ └──→ 取回（超时未取）──→ 空闲柜子状态不会卡在中间态。关门事件是状态切换的唯一触发器——关门成功，状态更新；关门失败（传感器异常），告警。
六、总结
取件链路的设计重点是：
- 多种入口，同一条后端路径——输入单号、扫码、公众号，最终都是查同一张表、开门、回写
- 物理控制在支付之后——超时先付后开，不是先开后付
- 取回和寄存是投递的复用——不新建流程，复用了投递的开柜逻辑和取件的状态更新
- 每一步都有通知——取件成功回写物流，取回发短信通知收件人
下篇讲支付体系和 OCR 识别。