qipai/docs/api-changelog/2026-08-11-M09-REGRESSION-product-reconciliation.md

2026-08-11 M09-REGRESSION 商品逐单对账 API

新增接口

• GET /admin-api/product-orders/:orderId/reconciliation
• GET /app-api/management/product-orders/:orderId/reconciliation

接口要求 goods.order.read、goods.order.manage、tenant.manage 或 platform.manage，并继续执行租户与门店范围校验。响应包含订单金额聚合、支付退款聚合、净收入、库存占用/销售余额与不可变流水、订单来源寄存聚合、九项一致性检查及总一致性结果；接口只读，不自动修账。

权限一致性修复

• 商品订单管理路由与库存管理路由/服务将 platform.manage 视为租户级管理能力，与既有后台菜单和商品订单服务口径一致。
• 只有 platform.manage 不会绕过 tenantId；目标租户仍由已验证会话取得。普通门店员工没有授权门店时继续返回门店范围禁止错误。

兼容修复

库存列表和库存流水分页不再把 MySQL LIMIT/OFFSET 作为预处理参数传递。服务先把 page/pageSize 约束为安全整数，再将计算出的分页常量写入 SQL，以兼容 MySQL 8.4 驱动执行路径。