WriteoffCode（核销码）

概述

WriteoffCode 表示自提/核销类订单的唯一核销凭证，用于标识订单在核销流程中的状态与凭证信息。

业务含义

自提/核销类订单唯一核销凭证。

字段定义

字段名	类型	必填	默认值	说明	状态值枚举
codeId	string	是	-	核销码 ID	-
orderId	string	是	-	关联订单 ID	-
codeNo	string	是	-	编号	-
qrToken	string	是	-	动态二维码 token	-
expireAt	datetime	否	null	二维码当前 token 过期时间	-
status	enum	是	unused	核销状态	unused, used, expired
verifiedAt	datetime	否	null	核销时间	-
verifiedBy	string	否	null	核销执行人	-

状态说明

状态值	含义
unused	未核销
used	已核销
expired	已过期

说明

• codeId 用于唯一标识一条核销码记录。
• orderId 用于关联具体订单。
• qrToken 为动态二维码令牌，通常需要结合 expireAt 判断当前二维码是否仍然有效。
• 当核销完成后，可记录 verifiedAt 和 verifiedBy 以追踪核销操作。