# 寻梦 · 对接文档

> 寻梦（大件花材电商）项目的前端对接文档、业务口径与测试手册。每篇文档都有 Markdown 原文（URL 末尾加 .md），优先读取 Markdown。

接口文档通用约定：除文档另有说明，接口均为 POST + JSON，返回 `{ code, msg, data }`，`code != 0` 时直接提示 `msg`。

## 打包

- [体积设箱代码审查（业务口径）](https://doc.xfun.fun/volume-pack-review.md): 体积设箱试点（822547a2eb）代码审查结论：2 处必须修的空指针、3 处需与产品确认的口径风险、3 处一般问题（更新 2026-11-05）

## 仓库配货 / 打包

- [推荐箱型 / 设箱校验（前端对接）](https://doc.xfun.fun/box-suggest-api.md): 打包小程序设箱确认弹窗、货架列表合规筛选与角标、包裹详情设箱不符标识；运营后台打包配置预估可装重量（更新 2026-11-04）
- [推荐箱型 / 设箱校验（测试手册）](https://doc.xfun.fun/box-suggest-test-guide.md): 需求速读、白场与晚场完整测试步骤、供应商设箱校验、测试矩阵及可执行 SQL（更新 2026-11-04）
- [质检配货页分页（前端对接）](https://doc.xfun.fun/distribution-page-api.md): 配货列表分页 + 早班/待补/子货位标记与筛选；need/prepared 为货位数；支持发货时间与二级分类筛选（更新 2026-11-04）
- [打包页待补 / 早班 / 设箱（前端对接）](https://doc.xfun.fun/shelf-restock-api.md): 货架待补状态徽标、早班红底、设箱不符角标的渲染配色与三 tab 筛选映射，含早班跨午夜判断函数（更新 2026-11-04）
- [打包负责人物资申领（前端对接）](https://doc.xfun.fun/wms-material-apply-api.md): 负责人提交（含批量）/撤销申领，仓管分批出库、手动完成、拒绝；状态机、按钮显隐字段、出库记录，以及进销存出入库权限与库房库存口径（更新 2026-11-04）
- [员工处罚待确认弹窗（前端对接）](https://doc.xfun.fun/wms-punish-popup-api.md): pending-popup 接口：每日 14:00 批次、未登录则登录即弹、多端只弹一次均由后端判定；含调用时机、14 点定时参考实现与弹窗交互说明（更新 2026-11-04）
- [推荐箱型代码导读（业务口径）](https://doc.xfun.fun/box-suggest-code-guide.md): 现有按重量推荐箱型的代码入口、四处调用点、晚场重算与落库字段，附接手体积设箱（XYLZ-3678）要注意的坑（更新 2026-11-02）
- [推荐箱型 / 设箱校验（业务口径）](https://doc.xfun.fun/box-suggest-logic.md): 白场拆箱、中通 45kg 逐箱匹配、晚场加单重算（含昆明→店/仓→店按货架重算）、特殊花材专用箱、设箱校验完整口径（更新 2026-08-11）

## 包花厂集采

- [包花厂集采 11-04 接口变更（前端对接）](https://doc.xfun.fun/bulk-purchase-1104-api.md): 不参与等级免报价、货架按场次品种等级供应商分、供货单返回配货进度、多人同时盘点；覆盖供应商小程序、仓库 PDA、运营后台（更新 2026-11-04）
- [包花厂集采开发文档（业务口径）](https://doc.xfun.fun/bulk-purchase-dev-guide.md): 运营端 / 供应商端两服务分工、代码入口、接口清单、状态写入条件、Redis 锁与事务、定时任务、跨服务结算凭证、数据表与只读核查 SQL、已知坑（更新 2026-11-04）
- [包花厂集采业务逻辑（业务口径）](https://doc.xfun.fun/bulk-purchase-logic.md): 采购计划发布 → 按等级报价 → 自动定采 → 签到打印 → 扫码入库 → 盘点 → 超量处理 → T+3 结算的完整业务口径，附现场操作清单与常见问题排查（更新 2026-11-04）

## 冷库暂存花材

- [冷库库存转代卖（前端对接）](https://doc.xfun.fun/cold-convert-sale-api.md): 运营端转代卖两个接口 + 仓库小程序最终扎数确认，含口径规则与报错文案（更新 2026-11-04）
- [冷库暂存花材（前端对接）](https://doc.xfun.fun/%E5%86%B7%E5%BA%93%E6%9A%82%E5%AD%98%E8%8A%B1%E6%9D%90%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3.md): 运营端 / PDA 端 / 小程序端冷库暂存全部 25 个接口：库存与统计、联系记录、关联发货单与直接出库、转代卖、扫码入库、裸花登记与点击出库（更新 2026-11-04）
- [冷库暂存花材信息流（方案说明）](https://doc.xfun.fun/%E5%B7%B2%E6%89%93%E5%8C%85%E6%9C%AA%E6%89%93%E5%8C%85%E5%86%B7%E5%BA%93%E6%9A%82%E5%AD%98%E8%8A%B1%E6%9D%90%E4%BF%A1%E6%81%AF%E6%B5%81%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88.md): 已打包 / 未打包冷库暂存业务方案：暂存、关联、出库、发货信息闭环（含小程序 / PDA 界面示意）（更新 2026-11-04）

## 分销开票

- [分销开票调整优化（前端对接）](https://doc.xfun.fun/partner-invoice-adjust-api.md): 费用类型勾选分批开票（发票与收据）、30/60/90 时间筛选、申请单维度记录与撤销、逾期赔付标识；含核心口径与页面-接口对应（更新 2026-11-04）
- [繁花惠 / 优花速达开票（前端对接）](https://doc.xfun.fun/partner-invoice-api.md): 分销小程序发票中心（分组列表 / 一键开票 / 收据分屏）+ 运营后台平台开票管理；开票池为确认收货 5~95 天、10-01 场次起的订单，金额取开票快照（更新 2026-11-04）
- [繁花惠 / 优花速达开票（业务口径）](https://doc.xfun.fun/partner-invoice-logic.md): 开票池范围、票种与出票方、开票快照与金额拆分、物流费取数、申请撤销口径、「为什么没看到」速查表（更新 2026-11-04）
- [开票物流费与繁花包干（业务口径）](https://doc.xfun.fun/partner-invoice-logistics.md): 分销开票物流费怎么取数与固化、发票还是收据、繁花包干城市仓（繁花到店）订单的运费分摊与金额构成（更新 2026-11-04）
- [分销开票金额拆分（方案二·售后扣减）（业务口径）](https://doc.xfun.fun/partner-invoice-split-v2.md): 繁花惠 / 优花速达开票快照的拆分顺序、售后「谁售后扣谁」、优惠券如何被吸收、带数字的例子，以及实开会不会大于实付（更新 2026-11-03）
- [花店开票列表新增花材款（前端对接）](https://doc.xfun.fun/partner-invoice-admin-flower-api.md): 运营后台花店开票列表：开票类型新增花材款（按申请单聚合一行），按类型区分操作按钮，新增花材款关联供应商及订单弹窗（更新 2026-10-28）

## 农资商城

- [农资优惠券（前端对接）](https://doc.xfun.fun/peasant-coupon-api.md): 小程序端领券中心 / 券包 / 下单用券，运营后台模板 / 投放活动 / 券包与核销明细；含鉴权约定、枚举、状态流转与请求响应示例（更新 2026-11-04）

## 开票

- [供应商上传发票校验（前端对接）](https://doc.xfun.fun/supplier-invoice-upload-api.md): 上传发票时对图片/PDF 做 OCR 抬头硬校验，抬头与申请单不一致直接拦截；含 PDF 要求、报错文案与抬头比对规则（更新 2026-11-04）

## 供应商

- [供应商申诉调整（前端对接）](https://doc.xfun.fun/supplier-appeal-adjust-api.md): 首页质检问题（缺货+退货+换货）、质检汇总换货扎数与场次卡「已确认」口径及跳转、二级类目编码、状态标签、商品全称、客服只展示 ID、申诉凭证选填（更新 2026-10-29）
- [供应商申诉优化（前端对接）](https://doc.xfun.fun/supplier-punish-center-api.md): 首页本月扣款、我的处罚统计/明细/详情（处罚+退款支出+缺货赔付）、质检问题汇总；缺货赔付申诉 complainType=6；运营后台商品申诉 Tab 多类型列表与审核（更新 2026-10-29）
- [供应商申诉筛选（前端对接）](https://doc.xfun.fun/supplier-appeal-filter-api.md): 运营后台「供应商申诉」页新增订单号筛选（全部申诉 Tab）与售后单号筛选（售后申诉 Tab），列表与导出共用 POST /order/complain/list（更新 2026-10-28）
- [供应商画像（前端对接）](https://doc.xfun.fun/supplier-profile-api.md): 运营后台供应商列表/详情右侧抽屉：基础信息与标签编辑、经营概览与履约售后（近7/30天环比）、处罚明细、品类看板及明细、统计口径文案（更新 2026-10-28）
- [供应商入驻协议授权（前端对接）](https://doc.xfun.fun/supplier-agreement-auth-api.md): 入驻申请页协议弹窗：协议列表 / 注册回传协议版本、712 错误码处理；运营后台供应商详情【协议授权记录】及协议版本正文查看（更新 2026-10-17）