线上订单
线上订单是微信小程序商城、桌台扫码、自购 GO 等线上渠道产生的订单在 ERP 里的统一处理台：看单、改收货信息、发货、成团、退款、驳回退款都在这里做完，做完之后订单才会以预订单的形式进入门店的生产与取货流程。
一、功能概述
菜单位置：O2O业务 → 微信商城 → 线上订单（页面地址 /admin/o2o/o2o_orderlist/）
| 用途 | 说明 |
|---|---|
| 查所有线上订单 | 按下单时间、订单状态、订单号、小票号、会员编号、手机号筛，支持模糊/精准 |
| 处理履约 | 「发货」把订单推到已发货，「开团」把拼团单确认成团 |
| 处理退款 | 「退款」「一键退款」「驳回」三种收敛方式，含第三方支付原路退回 |
| 改收货与生产信息 | 行点击打开「订单编辑」抽屉，改收货人、取货时间、取货门店、生产部门、生产班次 |
| 对账 | 「导出」生成 Excel，收款方式按会员/微信/电子券/扫呗/其他拆开 |
本页订单本身全部只读——列表里的任何一格都不能直接敲。状态只能通过工具栏的按钮变更，且服务端会复查状态，不满足就报「订单状态错误，请刷新数据！」。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | 刷新、条件、开团、发货、退款、一键退款、驳回、导出 |
| 主表 | 订单列表，只读；订单号是可点的超链，点开右侧编辑抽屉 |
| 查询条件回显 | 工具栏下方一行「查询条件: 本月 [2026/10/01至2026/10/27]」，说明当前生效的时间区间 |
| 下方联动区 | 两个页签 订单产品 / 产品详情，点主表某一行后展示该单的明细；未选中时提示「请选择订单行查看产品」 |
| 空态 | 「暂无订单数据」「共 0 条」 |
列一共 40 多列，按「订单信息 / 金额 / 收货与取货 / 退款 / 物流」分组：行号、订单日期、订单号、订单状态、预订小票号、商品总数、订单金额、订单类型、创建日期、更新日期、会员类别、会员编号、会员名称、微信昵称、买家留言、付款日期、付款方式、券类型、券号、券值、收货人姓名、收货人手机号、省、市、区、详细地址、取货状态、取货分店、联系电话、取货时间、取货方式、退款状态、申请日期、驳回日期、退款日期、退款原因、驳回原因、退款备注、是否物流、物流单号、物流公司名称、内部备注。金额区另有分列：会员、微信、电子券、扫呗、其他。
三、业务操作步骤
步骤 1：把要处理的单筛出来
点「条件」打开筛选弹窗：
| 组 | 可选项 |
|---|---|
| 下单时间 | 今天 / 昨天 / 本周 / 上周 / 本月 / 上月 / 最近 N 天（默认 30，可选 7、15、30、60、90、180、365、730 或自填）/ 指定月份（选年+月）/ 指定日期 / 指定时段（日期+时间，起止两个区间） |
| 其他过滤 | 订单状态（12 项）、订单类型（7 项） |
| 文本过滤 | 订单号、预订小票号、会员编号、收货人手机号、联系电话；每项右侧有「模糊 / 精准」开关 |
默认进来是「最近 30 天」。条件按人保存，下次打开本页自动带出上一次的筛选，不用重设。
订单类型的 7 项对应线上各来源：常规订单（小程序商城）、拼团订单、扫码预订（桌台扫码点餐）、秒杀订单、自助购、扫码点餐、自选订单（蛋糕自选）。
步骤 2：改收货与生产信息
点订单号打开「订单编辑 - 单号」抽屉：
- 只读：单据日期、单据编号、订货人、联系电话。
- 可改：收货人、收货联系电话、送货上门、送货地址、取货时间、提前小时、取货门店、生产部门、配送门店、生产班次、常用字、备注、内部备注。
- 「配送门店」只有勾了「送货上门」才能选；备注框占位提示「最多100个汉字」。
- 必填校验：请填写收货人和联系电话。
- 保存后回显「保存成功」，失败「保存失败」。
⚠ 只有状态为处理中且预订单尚未进入「已取货/已取消/已配送」这类终态的订单，才允许打开编辑抽屉；其余状态下点订单号只能看，不能改。
步骤 3：发货
选中一行 → 点「发货」→ 确认框「确认发货？」→ 弹发货窗：
| 字段 | 说明 |
|---|---|
| 配送方式 | 需要配送 / 无需配送 |
| 快递公司 | 需要配送时必选，取快递公司地址档案 |
| 快递单号 | 需要配送时必填 |
校验原文：「请选择快递公司」「请输入快递公司名称」「请输入快递单号」。成功回显「发货成功」，订单状态推进到已发货。
步骤 4：拼团单成团
拼团订单付款后停在待成团。选中一行 → 点「开团」→ 确认框「确认开团？」→ 成功后回显「开团成功！」，同时把对应的预订单从「拼团中」推进到「预订中」，拼团明细标记为已成团。
按钮只在状态为待成团时亮着；超时未成团的单，状态列会显示「待成团超时」。
步骤 5：退款 / 一键退款 / 驳回
| 按钮 | 用在哪 | 行为 |
|---|---|---|
| 退款 | 会员已申请退款、且预订单还没进生产 | 确认框「确认退款？」；按支付组成逐项退回，成功后状态改为已支付→同意退款，退款备注追加 [用户名]同意退款! |
| 一键退款 | 待支付、处理中、已发货、已完成、已取消、退款申请中，以及退款异常/回收券异常的单 | 确认框「确认一键退款？」，系统自动走完申请与同意，退款备注追加 [用户名]一键退款! |
| 驳回 | 状态为退款申请中 | 弹输入框「请输入驳回原因」（标题「驳回退款」），必填；成功后状态回到处理中，并打上「拒绝退款」标记，备注追加 ->[用户名]驳回退款! |
退款时如果订单已经进入生产环节，会先弹出警告：「当前订单已进入生产环节(状态名)，退款可能产生损失！」——确认了才继续。
第三方支付（微信等）不是 Django 直接退，而是调用收银侧的支付管理接口原路退回；支付宝类目会直接报「暂不支持[支付宝]退款!」。
步骤 6：处理退款异常与赠券回收
退款做到一半失败，订单会落到退款异常状态；重新点「一键退款」会补做未退的支付项，回显「退款异常订单已重新处理，退款成功！」，若仍有未退项则提示「退款异常订单仍有未退款支付项，请核实」。
如果这张单参与了下单送券活动，退款成功后会转为退单回收券异常并提示「订单存在未处理的赠券活动，请确认是否作废未使用券」。此时再点「一键退款」会弹出回收券处理窗：
- 横幅「该订单参与了以下赠券活动，关闭或确定后将自动作废未使用的券并关闭订单。」
- 表格列出券号 / 类型 / 状态。
- 没有可处理券时显示「订单暂无赠券活动或券已处理」。
- 点「确定」后回显「未使用券已作废，订单已关闭」，退款备注追加
|券已回收；作废失败报「作废券失败」。
步骤 7：导出
点「导出」，回显「已生成Excel文件，请在浏览器下载中查看」，文件按当前筛选条件导出。
四、字段详细说明
订单状态
| 界面状态 | 含义 | 下一步能做什么 |
|---|---|---|
| 待支付 | 下单未付款 | 只能等付款或取消 |
| 已支付 | 付款完成 | 可编辑、可发货 |
| 处理中 | 已进生产排程 | 可编辑、可发货、可退款 |
| 已发货 | 履约中 | 可一键退款 |
| 已完成 | 已取货/已送达 | 可一键退款 |
| 已取消 | 超时或手工取消 | 可一键退款 |
| 待成团 / 待成团超时 | 拼团单等人数 | 可开团 |
| 退款申请中 | 会员发起退款 | 可退款、可驳回 |
| 退款异常 | 部分支付项退失败 | 可一键退款补做 |
| 退单回收券异常 | 退款完成但赠券未回收 | 可一键退款走回收券处理 |
状态之外还有一组「取货状态 / 退款状态」列，分别来自预订单和退款标记：预订单侧是 预订中 / 生产中 / 已入库 / 取货中 / 已取货 / 已配送 / 已取消 / 中止制作；退款侧的四个标记是 申请退款 / 同意退款 / 拒绝退款 / 一键退款。
关键字段
| 界面字段 | 含义 |
|---|---|
| 订单号 / 预订小票号 | 订单号来自 O2O_OrderList；小票号是它转成 ERP 预订单后的单号（Pos_ReserveBill） |
| 订单金额 | 合计；下方 会员 / 微信 / 电子券 / 扫呗 / 其他 五列是按支付方式拆开的实收，加起来等于订单金额 |
| 付款方式 | 该单用到的支付通道 |
| 取货方式 | 商家配送 / 到店自提 / 快递发货 |
| 券类型 / 券号 / 券值 | 该单用了哪种电子券抵扣 |
| 微信昵称 | 下单会员绑定的微信昵称，与「会员名称」分列 |
| 买家留言 / 内部备注 | 前者来自小程序，后者只有 ERP 能写 |
| 申请日期 / 驳回日期 / 退款日期 / 退款原因 / 驳回原因 / 退款备注 | 退款链路的全过程留痕，退款备注按操作逐条追加 |
主表按「订单日期 + 订单号」定位，明细行里带「[加]」前缀的是加购/附加行。右侧「产品详情」页签里的商品图直接取网店商品的主图。
五、典型使用场景
场景一：自提蛋糕单改时间。 会员打电话说要晚一小时取。列表筛「本月」→ 找到单 → 点订单号 → 改「取货时间」与「提前小时」→ 保存，回显「保存成功」。门店的生产班次不变，只挪取货点。
场景二：拼团没拼成。 状态显示「待成团超时」，选中后点「一键退款」，微信原路退回，退款备注自动追加一键退款记录。
场景三：生产已经开工但会员要退。 状态是处理中、预订单已进入生产中，点「退款」会先弹「当前订单已进入生产环节(生产中)，退款可能产生损失！」——由店长确认是否继续，避免误退造成物料损失。
场景四：对账。 筛「上月」→ 导出，按 会员/微信/电子券/扫呗/其他 五列分别合计，即可和小程序商户平台、会员卡系统、券系统三张账对上。
六、权限控制与前置条件
- 本页在权限映射里没有对应的 ERP 菜单权限项（Django 侧新增页面），能进 O2O业务 的角色即可看到；能否改数据取决于点开的按钮，不由菜单控制。
- 前置条件：分店已设生产部门与生产班次（发货/编辑抽屉的下拉里取的是这两个档案）；需要配送的租户要先在快递公司地址里录好快递公司；微信支付退款要求收银侧支付管理（第三方收款）配置到位。
- 状态推进是服务端强校验的，界面按钮亮了但数据已被别人改过，会返回「订单状态错误，请刷新数据！」，刷新即可。
七、常见问题
问：列表一片空，是坏了吗？ 答：默认只查最近 30 天。点「条件」把下单时间改成「最近 730 天」或指定月份再看。
问：为什么「发货」按钮是灰的？ 答：发货要求订单状态是 已支付/处理中/已发货 之一，且取货方式是 商家配送 或 快递发货。到店自提的单不该发货。
问：「退款」和「一键退款」有什么区别？ 答：「退款」只处理会员已经申请、且预订单尚未进终态的单；「一键退款」是给异常收敛用的，可以对待支付、处理中、已发货、已完成、已取消以及退款异常/回收券异常的单强行走完整个退款链。
问：驳回要写原因吗？ 答：要。点「驳回」弹「请输入驳回原因」，原因会进退款备注并带上操作人。
问：改了订单为什么门店看不到？ 答：本页改的是线上订单与它对应的预订单。门店收银端按预订单显示，若预订单已进入「已取货 / 已取消 / 已配送」，本页就不允许再编辑，需要按线下流程处理。