3.5 KiB
3.5 KiB
Change: 员工代收款功能前端对接
Why
8 月产品迭代新增「员工代收款」能力：员工线下代收款项后，通过创建核销申请、经企业微信审批完成账单核销；超级管理员可维护收款方式、查看全部账单并关闭账单。后端接口已按 docs/产品迭代8月份/员工代收款功能简介.md 落地，后台管理端目前缺少收款方式管理、账单列表与核销申请页面，普通员工与超级管理员的分类视图、以及线下订单付款凭证规则尚未接入。
本次已按后端实际契约对齐字段：列表响应统一使用 items / total / page / size；账单状态（0 待核销 / 1 部分核销 / 2 已核销 / 3 已关闭）与申请状态（0 审批中 / 1 已通过 / 2 已驳回 / 3 已撤销或已关闭）为数字枚举；收款方式列表返回 { items, page, size, total } 并支持 enabled / keyword 筛选；核销申请请求体使用 paid_amount、paid_at、payer_name、external_transaction_no、payment_voucher_keys 与 allocations。
What Changes
- 新增
employee-collection能力的前端类型与服务封装：收款方式 4 个接口、员工代收款账单 4 个接口、核销申请 4 个接口。 - 新增「收款方式管理」页面（仅超级管理员）：列表 + 新增/编辑弹窗 + 删除；已被核销申请引用的方式不可删除、不可修改
code（未被引用时可改），可停用。 - 新增「员工代收款账单」页面：应收/已核销/未核销/待处理账单统计 + 列表 + 详情；普通员工仅见本人账单，超级管理员可见全部；存在审批中申请时账单不可关闭，关闭必须填写原因。
- 新增「核销申请」页面：列表 + 详情（含分摊账单、付款凭证、付款信息与全部审批尝试记录）+ 创建/重新提交弹窗；一笔线下收款可核销 1～N 张账单，填写付款金额、付款方名称、付款时间、外部交易流水号、选择收款方式并上传付款凭证；提交后自动发起企微审批；仅已驳回申请可修改并重新提交，重新提交生成新的审批实例且历史记录不被覆盖。
- 扩展企业微信审批场景：新增
employee_collection_approval业务类型，复用既有企微应用列表、模板控件同步与业务字段查询接口。 - 调整订单创建：由平台账号操作、实际收款金额大于 0 且非赠送的线下订单会生成员工代收款账单，该场景
payment_voucher_key改为非必填，付款凭证改在核销申请中提交，字段结构保持不变。 - 附件接口仅返回对象 Key，统一通过系统既有预签名下载接口展示。
- 不实现后端接口、数据库、Worker、企微回调；不实现 H5/C 端页面。
Impact
- Affected specs:
employee-collection - Affected code:
src/types/api/employeeCollection.ts、src/api/modules/employeeCollection.ts、src/views/finance/employee-collection/*、src/router/routes/asyncRoutes.ts、src/router/routesAlias.ts、src/config/constants/augustIteration.ts、src/types/api/wecom.ts、src/views/settings/wecom/scenes/index.vue、src/views/order-management/order-list/index.vue、src/locales/langs/{zh,en}.json - Dependencies:
docs/产品迭代8月份/员工代收款功能简介.md - Contract note:
docs/admin-openapi.yaml未随仓库提供，字段以需求文档描述的后端契约与创建订单接口的 OpenAPI 片段为准；类型集中在单一文件，联调时便于收敛。