用途:该技能面向停车缴费交易域(trade),用于临停车辆查费、缴费订单回传、欠费批量补缴,以及预存款与运营积分预置以实现自动扣费。历史账单与缴费记录查询属于 parking 域(openydt-record),不在本域范围。
主要能力:读操作包括 openydt trade get-park-fee(实时查费,10 分钟内须完成缴费)和 openydt trade common-get-park-fee(按时间段估算未来费用)。写操作包括 pay-park-fee(缴费信息回传)、payback-batch(欠费批量补缴)、set-points(预置运营积分自动抵扣)、set-prestore-for-c-park 与 set-prestore-for-c-park-first-pay-before-leave(预置预存款)。所有写命令必须加 --yes,建议先 --dry-run 预览。
使用方式:开始前须先用 Read 工具读取 ../openydt-shared/SKILL.md(认证、签名、状态码、限速与安全规则)。缴费闭环中需将前序命令响应字段作为后续入参,例如查费响应中的 chargeBillNumber、shouldPayValue、parkingCode、chargeDate。金额单位为元(小数)。billCode 须全局唯一,重试时复用首次值以实现幂等;收到 907 表示幂等命中,应改用 openydt parking get-pay-bill 核对。912 表示查费超时,需重新查费。
适用场景:需要计算停车费、回传同步缴费订单、批量补缴欠费、为车辆充值预存款或预置积分以便自动扣费时使用。在场车确认、订单查询、进车补录属于 parking 域。
限制:所有写操作需 --yes 确认,否则被拦截;查费结果 10 分钟失效;示例中的 parkCode 与时间为 test 环境文档化测试值,照抄历史样例可能无效。本域未列出的接口可用 openydt api <cmd> --body '{...}' 兜底调用。