用途:openydt-coupon 覆盖电子券与商家域(coupon)全流程,包括商家(trader)的增改冻删与查询、电子券模板创建、售券给商家、给车辆发券、查券与回收。车辆在停车场可用电子券抵扣部分或全部停车费;用券后的实际查费与缴费在 trade 域,在场车确认在 parking 域。
主要能力:商家侧提供 get-trader-info-by-trader-code、validate-trader-account-and-password、create-trader、edit-trader、frozen-trader、delete-trader、get-trader-list;券侧提供 create-coupon-template、create-coupon、create-fixed-coupon、sell-coupon、send-coupon、send-coupon-by-coupon-code、sync-scan-coupon-qr-code、print-coupon、lock-coupon、cancel-coupon,以及 query-car-code-valid-coupon、query-usable-coupon、query-coupon、query-coupon-template 系列、售卖与发券记录查询等。
使用方式:开始前 MUST 先用 Read 工具读取 ../openydt-shared/SKILL.md(认证/签名/状态码/限速/安全规则),未读不要执行任何命令。命令形如 openydt coupon <cmd>,必填参数按各命令给定;所有写命令必须加 --yes 确认,否则被拦截,建议先用 --dry-run 预览。典型闭环:create-trader → create-coupon-template → sell-coupon → send-coupon → query → cancel-coupon,需把前序响应字段(traderCode、traderCouponTemplateCode、sellBillId、couponSn)作为后续入参,不要凭空构造。本表未列但属券域的接口可用 openydt api <cmd> --body '{...}' 调用。
限制与注意事项:金额量纲由 couponType 决定(0 免费、1/2/3 金额券、4 时间券、5 不同计价券),balanceType 是结算类型;sell-coupon 的 transationNum 与 create-fixed-coupon 的 uniqNo 是幂等键,重试复用同值。delete-trader、cancel-coupon 等不可逆。查券 0 条不等于该车无券,需确认 parkCode 与时间窗。发券失败常见于商家被冻结、超出有效期或 sellMoney 不满足。示例中的 parkCode、编码与时间为文档化测试值或占位值,需取自前序响应。官方资料未提供收费与价格信息。