openydt-record

openydt-record — 停车记录域 (parking)

CRITICAL：开始前 MUST 先用 Read 工具读取 ../openydt-shared/SKILL.md，了解认证 / profile / 签名 / 状态码 / 限速 / 安全等通用约定，再执行本域命令。

意图路由

• “查在场车 / 在场车辆 / 现在场内有哪些车” → get-park-on-site-car
• “进场记录 / 进车记录” → get-car-in-list；“出场记录” → get-car-out-list
• “全量进出明细 / 经营分析原始数据” → 按 [[openydt-shared]] 的全量分页规则导出本地 NDJSON 快照
• “基于离场明细重算 / 核验停车时长、分布或分位数” → 先读 references/parking-duration-analysis.md，再运行随附脚本
• “逃费 / 疑似跟车 / 按放行模式统计 / 异常放行 / 遥控开闸分析” → 先读 references/parking-record-enums.md，以 CLI schema 的枚举与领域语义为准
• “直接调用平台停车时长分布等聚合统计” → [[openydt-data]]
• “某条停车记录详情” → get-park-detail（或忽略状态 get-park-detail-ignore-status）
• “缴费记录 / 历史账单” → get-pay-bill / get-payment-record-detail-list / get-park-pay-bill-by-car-nos-and-pay-time（实时应缴金额请用 trade 域 get-park-fee，本域只查历史）
• “欠费 / 欠费记录” → get-car-arrearage-list / get-arrears-list-by-operator / get-arrears-count
• “进车补录 / 补录进场” → supplement-parking-record-in
• “盘点离场 / 批量清场 / 盘点记录” → inventory-car（写）/ get-inventory-record（读）
• “锁车 / 解锁 / 锁车状态” → lock-car / unlock-car / get-car-lock-status
• 跨域提示：月票/电子券/访客/黑名单等不在本域，分别使用 openydt ticket（见 [[openydt-monthticket]]）/ openydt coupon（见 [[openydt-coupon]]）/ openydt visitor / openydt blacklist（见 [[openydt-list]]）；实时算费/缴费见 [[openydt-billing]]。

可用命令

命令统一以 openydt parking <use> 调用。写操作（写）均需追加 --yes 确认。

日本語名	コマンド	読み取り/書き込み	主なパラメーター
チャネルに車両があるか確認	openydt parking check-channel-exist-car	読み取り	parkCode, channelCode
駐車中の車両を照会	openydt parking get-park-on-site-car	読み取り	parkCodeList, enterTimeFrom, enterTimeTo, pageNum, pageSize
入場記録を照会	openydt parking get-car-in-list	読み取り	parkCode, isPresence, startTime, endTime, pageNum, pageSize
出場記録を照会	openydt parking get-car-out-list	読み取り	parkCode, carNo（単数）, leaveStartTime/leaveEndTime または enterTimeFrom/enterTimeTo（いずれか必須）, pageNum, pageSize（≤100）
駐車記録の詳細	openydt parking get-park-detail	読み取り	parkCode, parkingCode/carCode（いずれかで特定）
棚卸記録を照会	openydt parking get-inventory-record	読み取り	parkCodeList, inventoryStartTime, inventoryEndTime, remark
棚卸による出場処理	openydt parking inventory-car	書き込み	parkCode, enterTimeEnd, carNo/carNos/parkingCodes, remark
駐車記録の詳細（ステータスを無視）	openydt parking get-park-detail-ignore-status	読み取り	parkCode, parkingCode/carCode（いずれかで特定）
チャネル権限を照会	openydt parking get-channel-permission	読み取り	parkCode, channelId, carCode, operatorTime, plateColor
支払い記録を照会	openydt parking get-pay-bill	読み取り	parkingCode（+parkCode）
支払い明細リスト	openydt parking get-payment-record-detail-list	読み取り	parkCode, pageNum, pageSize
支払い明細ファイル	openydt parking get-payment-record-detail-file	読み取り	parkCode, payTime
車両番号と支払い時刻で請求情報を照会	openydt parking get-park-pay-bill-by-car-nos-and-pay-time	読み取り	carNoList, pageNum, pageSize
車両の未払い記録	openydt parking get-car-arrearage-list	読み取り	carNo, parkCodeList（任意の絞り込み）
運営事業者の未払い記録	openydt parking get-arrears-list-by-operator	読み取り	pageSize, pageNum
運営事業者の未払い件数	openydt parking get-arrears-count	読み取り	（body は空でも可）
未払い画像の詳細	openydt parking get-arrears-detail	読み取り	（body は空でも可）
システム外ゲート開放記録	openydt parking get-abnormal-open-gate-list	読み取り	parkCodeList, openGateTimeFrom, openGateTimeTo
異常出場記録	openydt parking get-abnormal-out-list	読み取り	parkCodeList, leaveTimeFrom, leaveTimeTo
車両のロック状態を確認	openydt parking get-car-lock-status	読み取り	carNo / cardNumber
入車記録を補完登録	openydt parking supplement-parking-record-in	書き込み	parkCode, carCode, enterTime, channelCode, carCodeType, carCodeColor, parkOrArea
入場画像を補完登録	openydt parking supplement-parking-record-image	書き込み	parkCode, parkingCode, parkOrArea, carCodeImage, carImage, parkingType
駐車中の車両番号を修正	openydt parking correct-car-no	書き込み	parkCode, parkingCode, newCarNo, correctTime, correctName, operateType
チャネルで入出場待ちの車両番号を修正	openydt parking correct-car-on-channel	書き込み	parkCode, channelCode, newCarNo, correctTime
入出場確認の撮影後に車両番号を修正	openydt parking correcting-car-code-after-car-in-out-confirm-phone	書き込み	parkCode, channelId, newCarNo, correctTime
車両をロック	openydt parking lock-car	書き込み	carNo / cardNumber, lockReason
ロックを解除	openydt parking unlock-car	書き込み	carNo / cardNumber, unlockReason
チャネルコードをスキャンしてセルフ入出場	openydt parking scan-channel-code-in-out	書き込み	parkCode, channelSeq, userUniqCode
路上駐車車両をセルフ登録	openydt parking roadside-car-check-in	書き込み	carNo, positionNo, longitude, latitude
駐車場のインターセプトポリシーを作成	openydt parking create-intercept-policy	書き込み	parkCode, policyName, tags
駐車場のインターセプトポリシーを削除	openydt parking delete-intercept-policy	書き込み	parkCode
未払いを取り消し	openydt parking cancellation-of-arrears	書き込み	recordId, status, remark, operator
口座振替処理の注文を更新	openydt parking update-wihhold-detail-bill	書き込み	thirdBillCode, billStatus, billCallbackDate

本表に記載されていない parking ドメインの呼び出し可能なインターフェース（getHisParkDetail／getParkPayBill／getParkingPosition／getParkingSpaceInfo／paymentRecordQuery*／selfInOutForCloudPark／typingRandomCodeInOut／scanChannelCodeInOutFlow／supplyCarIn-Out-Pic など）は、openydt api <cmd> --body '{...}' で呼び出します（書き込み操作では --yes を指定し、先に --dry-run を実行してください）。車両タグの付与／解除：openydt api addCarTags ／ openydt api delCarTags（書き込み、--yes が必要）。body は catalog/catalog.json の sampleBody を参照してください。詳しくは [[openydt-api-explorer]] を参照してください。 ⚠️ update-wihhold-detail-bill 里的 wihhold 是平台接口编码 updateWihholdDetailBill 的原始拼写（平台侧 typo，本应是 withhold）。CLI 按平台编码逐字发送，必须照此拼写、不要「纠正」为 withhold，否则平台返回 status=9 接口不存在。

查询、校正进出记录或处理通道会话前，读 references/pitfalls.md；它收录出场字段、在场时间范围、状态判定与会话过期等分支。

写操作幂等（避免重试重复）

• update-wihhold-detail-bill 用 thirdBillCode 去重——重试复用同值，绝不新生成。
• supplement-parking-record-in / inventory-car / correct-* 无显式幂等键：网络超时/网关 404 触发的自动重试可能重复补录或重复盘点离场。重发前先用读命令确认首次是否已生效：
  • 补录前：check-channel-exist-car 确认通道是否已有在场记录；
  • 盘点前：get-inventory-record 确认该时段是否已存在盘点操作；
  • 在场查验：get-park-on-site-car 确认车牌是否仍在场，避免重复补录重复入账。
• 详见 [[openydt-shared]] 的 ../openydt-shared/references/write-idempotency.md。

多步业务流程(在场/进出查询→详情、进车补录、锁车/解锁、欠费→取消)见 references/flows.md,跑多步链路前先 Read。

示例

示例 parkCode/时间为文档化测试值（仅 test 环境：1ZS7H5PQH9 / PTD2YBBZ，2026 相对时间）；照抄历史 sampleBody 中的旧 parkCode/时间会撞无效车场或过期时间段。写操作建议先把 --yes 换成 --dry-run 预览签名请求，确认后再 --yes。

读：查询某车场指定时段进场记录（含指定车牌过滤、分页）

openydt parking get-car-in-list --body '{
  "parkCode": "1ZS7H5PQH9",
  "carNoArray": ["粤EJW962"],
  "isPresence": "0",
  "startTime": "20260601000000",
  "endTime": "20260601235959",
  "pageNum": 1,
  "pageSize": 10
}'

读：查询某车场指定出场时段的出场记录（注意字段名与 in-list 不同：carNo 单数 + leaveStartTime/leaveEndTime）

openydt parking get-car-out-list --body '{
  "parkCode": "PTD2YBBZ",
  "carNo": "粤EJW987",
  "leaveStartTime": "20260531000000",
  "leaveEndTime": "20260531235959",
  "pageNum": 1,
  "pageSize": 10
}'

写：进车补录（注意 --yes，响应返回 parkingCode 供后续补图/校正使用）

openydt parking supplement-parking-record-in --yes --body '{
  "parkCode": "1ZS7H5PQH9",
  "carCode": "粤EJW962",
  "enterTime": "20260601080000",
  "channelCode": "AA123C",
  "carCodeType": 1,
  "carCodeColor": 1,
  "parkOrArea": 1
}'

写：锁定指定车辆（注意 --yes）

openydt parking lock-car --yes --body '{
  "cardNumber": "A12345",
  "carNo": "粤EJW962",
  "lockReason": "测试锁车"
}'