# P16 仲裁与保证金接口清单（设计稿）

> 需后端支持后启用。资金相关接口仅记录状态，不做真实收付。

## 工单
- `POST /api/disputes` 发起争议（order_id、type、claim、evidence_ids）
- `GET /api/disputes` 工单列表（角色、阶段、时效）
- `GET /api/disputes/:id` 工单详情（诉求、证据、时间线）
- `POST /api/disputes/:id/evidence` 提交证据（type、file_ref、note）
- `POST /api/disputes/:id/reply` 答辩（说明、evidence_ids）
- `POST /api/disputes/:id/decision` 仲裁结论（liability、basis、actions）
- `POST /api/disputes/:id/appeal` 复议申请（新证据、理由）

## 保证金
- `GET /api/deposits/rules?category=` 类目保证金规则
- `POST /api/deposits` 登记保证金要求（order_id、amount、rule_ref）
- `POST /api/deposits/:id/confirm` 双方确认缴纳方式（voucher_ref）
- `POST /api/deposits/:id/release` 登记退还
- `POST /api/deposits/:id/deduct` 登记扣除（依据、金额、结论号）

## 台账
- `GET /api/escrow/ledger?order_id=` 台账明细
- `POST /api/escrow/ledger` 新增台账记录（stage、amount、status、voucher）

## 信用联动
- `POST /api/credit/adjust` 依据结论调整信用（account_id、delta、reason、case_id）

## 约定
- 全部接口返回 `{code:0, data:{}, msg:"ok"}`
- 金额单位为分；时间 ISO 8601，时区 Asia/Shanghai
- 结论与日志不可删除，仅可追加复议记录
- 权限：买家、服务商仅可见自身工单；仲裁工作台需平台运营权限
