区域代理 · 收益与提现

1. 登录与入口

• 代理账户类型：user_type=5，数据表 yjd_adusers
• 登录地址：平台后台 mch/users/sigi（与平台/商家共用域名）
• 登录后首页：mch/store/index，菜单由角色 + menu_agent_open=1 控制
• 收益明细页：mch/region/agent/earnings
• 申请提现 / 记录：mch/region/agent/cash

2. 收益明细页说明

页面展示当前代理账户的汇总与逐笔流水，数据来自 region_agent_bill。

展示项	含义
账户余额	adusers.money，已入账且可发起提现的金额
待结算	订单已产生平台抽佣，等待订单完成/过售后期
可提现（汇总）	流水状态为「可提现」的分佣合计
累计分佣	不含已冲正记录的分佣总额

列表接口：mch/region/agent/get-earnings，支持按状态筛选（待结算 / 可提现 / 已提现 / 已冲正）。

2.1 流水状态

• 待结算（status=0）：分佣已记录，尚未入账代理余额
• 可提现（status=1）：订单完成后入账，计入 adusers.money
• 已提现（status=2）：对应金额已通过提现流程划出
• 已冲正（status=3）：退款/撤销等导致的回冲，不参与汇总

3. 提现流程

区域代理提现走平台提现审核模块，与渠道商、商家提现同一套 yjd_cashs 表，来源标识为 from=city_agent。

1. 代理在 PC region/agent/cash 或小程序「申请提现」提交
2. 平台财务在 mch/cash/index → Tab「区域代理」审核（from=city_agent）
3. 拒绝：余额退回 adusers.money；确认打款后标记已打款

4. 平台侧配置

• 创建/管理代理账户：mch/region/agent/index（平台管理员）
• 区域分佣比例：mch/finance-platform/region-agent-commission
• 提现审核：mch/cash/index，来源 city_agent
• 代理菜单权限：系统 → 角色管理 → 类型「区域代理」+ 勾选 menu_agent_open=1 的菜单

5. 小程序与旧入口（已废弃）

以下旧版「城市代理 / 城市分站」小程序能力已下线，请勿在 DIY 装修、自定义链接中继续配置：

• 页面路径 /ming_control/pages/city_agency/index/index
• 接口 city-agent/info、city-agent/list
• 接口 channel/user/cashsubmitagent（代理提现）

新入口（统一）：

• DIY / 装修链接：/tongcheng/region-agent/index/index
• 「我的」菜单：绑定代理手机号或代理 token 登录后自动显示「分站代理中心」
• 子包页面：收益明细、申请提现、提现记录（不含 PC 审核能力）
• API：tongcheng/region/agent/*（profile / earnings / cashsubmit / cashlog）

提现规则读取平台 财务 → 提现设置 → 区域代理提现设置（Option 组 city_agent_cash），与 PC 审核 from=city_agent 共用一套账。

6. 常见问题

• 看不到收益菜单？ 确认账户 user_type=5，且角色已勾选含「收益」的代理菜单（menu_agent_open=1）。
• 有待结算但没有余额？ 需等待关联订单完成并过售后期，系统才会将流水改为「可提现」并增加 adusers.money。
• 装修里还能选「区域代理」链接吗？ 已从小程序链接库移除；请引导代理使用 PC 后台或等待新版移动端。