feat(M08-B): 接入保洁微信转账适配器

2026-06-27 16:07:41 +08:00
parent 05907a6bea
commit b07c451700
22 changed files with 663 additions and 27 deletions
@@ -132,3 +132,11 @@
  - 说明：移除未结算协作者并把剩余奖励回算到负责人；负责人不可通过该接口移除。
 - `POST /admin-api/cleaning/settlements`
  - 追加说明：多人协作任务按 `qipai_cleaning_task_members.reward_cents` 分别为每个保洁员生成结算明细；所有有效成员均完成结算后任务才整体转为 `SETTLED`。
+## 2026-06-27 微信转账适配增量
+
+- `POST /admin-api/cleaning/settlements/:settlementId/wechat-transfer`
+  - 登录：必须。
+  - 权限：`cleaning.task.write`、`tenant.manage` 或 `PLATFORM_ADMIN`；服务层继续校验 `cleaning.settlement.write`。
+  - Body：`mode?: "API" | "MOCK"`，`note?: string`。
+  - 说明：对 `CONFIRMED` 保洁结算单发起微信商家转账。`API` 模式会校验门店/全局微信收款账户、商户凭据、保洁员微信 openid 和转账场景配置；`MOCK` 仅非生产环境可用。
+  - 返回：成功转账直接返回 `PAID` 结算单；微信返回 `FAIL` 时记录失败原因；微信返回待确认或处理中状态时保留 `CONFIRMED`，并返回 `payoutState`、`payoutReference` 和 `payoutPackageInfo`。