外观
站外自动发货
「站外自动发货」用于把机构的课程通过兑换码供给第三方自动发货平台阿奇索：买家在您（或机构合作）的店铺购买已关联的商品后，阿奇索向魔果采购兑换码，并在店铺侧自动发货给买家。机构后台的这个页面负责三件事：完成供货账号接入配置、查看采购 / 通知 / 兑换 / 撤单情况、核对平台服务账单。
页面顶部说明原文：
阿奇索向魔果采购兑换码并负责店铺侧发货；在此查看采购、通知和兑换情况
入口：机构后台 → 营销工具 → 站外自动发货，页面包含 「接入配置」「供货订单」「平台服务账单」 三个页签。页面顶部说明条右侧有操作按钮（三个页签通用）：「阿奇索接入帮助」（打开阿奇索接入帮助文档）；「补充兑换码库存」（跳转到「课程兑换」页面购买兑换码，本页面不重复实现购买流程）——后者仅在「使用已有兑换码」模式下显示，「下单时自动生成」模式无需备货，不显示此按钮。
使用前提：您需要已在阿奇索开通店铺自动发货环境，并在阿奇索侧完成货源账号绑定与商品关联。奇豆、短信费用、店铺自动发货规则等属于阿奇索侧的配置与计费，在阿奇索平台内操作，与魔果无关。可供货的课程范围：在售的收费大班课；免费课程不在可供货范围内。
兑换码来源有两种模式（在「接入配置」页签查看当前模式）：
- 使用已有兑换码：您预先在「课程兑换」购买兑换码备货，店铺出单时从库存分配，服务费在购入兑换码环节已结算；
- 下单时自动生成：无需预购库存，店铺出单时魔果即时生成兑换码，每成功兑换一张按下单时的服务费率计一次服务费，事后按账期出「平台服务账单」核对（见下文第三节）。
模式由平台侧统一配置，页面上只读展示；如需变更模式或费率，请联系平台。
页面入口及「生成供货账号」「查看凭据」「重置商户凭据」按钮按角色权限显示。若机构 Owner 以外的老师 / 运营看不到入口或按钮，请让 Owner 在「机构管理 → 人员管理」页的「角色管理」标签下，为相应角色配置「站外自动发货」的页面与操作权限，详见 人员与角色管理。
一、接入配置
页签顶部的接入步骤说明（与页面原文一致）：
- 复制供应商授权码，在 91 卡券仓库添加魔果供应商。
- 生成供货账号，将下方凭据复制到阿奇索货源账号。
- 在阿奇索自动发货设置中选择货源账号，搜索课程并完成商品关联。
卡片 「货源平台商户信息」 下注明：「每个机构使用一套独立账号，请配置到当前机构对应的阿奇索货源账户。」各字段如下：
| 字段 | 说明 |
|---|---|
| 兑换码来源 | 只读展示当前计费模式：「下单时自动生成」或「使用已有兑换码」 |
| 供应商授权码 | 明文展示，点 「复制」。用于在 91 卡券仓库添加魔果供应商 |
| 魔果商户供货账号 | 生成后明文展示（未生成前显示「尚未生成」），点 「复制」。对应阿奇索的商户供货账号（app_id） |
| 商户密钥 | 默认打码显示；未生成时显示「尚未生成」，已生成未初始化时显示「待初始化」。需点 「查看凭据」 获取 |
| 解密密钥 | 同上，默认打码。「查看凭据」返回的是可直接填入阿奇索的格式 |
| IV | 同上，默认打码 |
| 91 卡券仓库 | 点 「打开 91 卡券仓库」 新窗口打开 |
1. 生成供货账号
尚未生成账号时，点 「生成供货账号」。成功后提示：「账号已生成，请查看并配置商户密钥、解密密钥和 IV」。
2. 查看凭据
点 「查看凭据」 打开弹窗 「查看货源平台商户信息」，顶部提醒：「以下内容可直接复制到阿奇索货源账号，请妥善保管。」弹窗内可逐项复制：魔果商户供货账号、商户密钥、解密密钥、IV。关闭弹窗后明文即清空，需要时可再次查看。
将这几项按同名字段填入阿奇索货源账号配置即可（填写格式以阿奇索侧要求为准）。
3. 重置商户凭据
点 「重置商户凭据」 需二次确认，确认弹窗标题「确认重置商户凭据？」，正文：
重置后旧商户密钥、解密密钥和 IV 立即失效，需要同步修改阿奇索货源账号，否则新订单将验签或解密失败。
点 「确认重置」 执行，成功后提示「商户凭据已重置，请重新查看并更新阿奇索配置」。
请务必在重置后尽快同步更新阿奇索侧配置，否则在两边配置不一致期间产生的新采购会验签或解密失败。
操作失败时的常见提示：「接入配置加载失败，请稍后重试」「供货账号生成失败，请稍后重试」「商户凭据获取失败，请稍后重试」「商户凭据重置失败，请稍后重试」；复制成功提示「复制成功」，失败提示「复制失败，请手动复制」。若提示为服务端返回的其他内容，请按提示处理或联系平台。
二、供货订单
1. 筛选
- 搜索框：输入 「阿奇索采购单号或魔果供货号」 精确查询（超长会提示「订单号不能超过 128 个字符」）。
- 课程 ID：按课程筛选。
- 兑换码来源：按下单时的兑换码来源筛选，选项为 「使用已有兑换码」/「自动生成兑换码」。
- 采购结果：采购成功 / 采购失败。
- 兑换码使用：未兑换 / 部分兑换 / 全部兑换。
- 魔果接单时间范围：起止时间选择器。
- 「导出当前结果」：按当前筛选条件导出订单 CSV（文件名形如「站外自动发货订单_时间戳.csv」）；该按钮按查看权限显示。导出失败提示「供货订单导出失败」（网络异常时为「供货订单导出失败，请稍后重试」）。
2. 列表
列表列：阿奇索采购单号、下单账号、魔果供货号、课程、采购数量、兑换码使用、采购结果、结果通知、取消请求、魔果接单时间、供货时间、操作。
各状态的含义（鼠标悬停状态徽章可见提示）：
- 采购结果：「采购成功」提示「魔果已分配兑换码，不代表买家已收到发货短信」；「采购失败」悬停可见「失败原因」「失败代码」。
- 兑换码使用：成功订单显示已兑换张数 / 采购总数（如 2 / 5），表示买家侧兑换进度；有作废码时显示「已兑换 N / 已作废 M / 共 K」；失败订单显示「-」。
- 结果通知（魔果向阿奇索回传采购结果的状态）：
- 「无需通知」：采购失败已在下单接口返回，无需发送成功结果通知；
- 「待通知」：尚无阿奇索确认结果；
- 「阿奇索已确认」：阿奇索接口已确认，不代表买家已收到发货短信；
- 「通知异常」：通知失败或超时，请按阿奇索采购单号核对；对方可能已处理。
- 取消请求（阿奇索发起撤单的处理结果）：
- 无撤单请求时显示「-」；
- 「已撤销」（绿色）：撤单已由系统自动完成，订单中未兑换的兑换码已同步作废，学员无法再兑换；
- 「撤销失败」（红色）：鼠标悬停可见失败原因（如「订单中存在已兑换的兑换码，无法整单撤销」；未记录原因时悬停显示「未记录拒绝原因」）；
- 「历史待处理」（橙色）：系统升级前记录的历史取消请求，当时未自动作废兑换码，需人工核对（详见订单详情提示）。
注意口径：「阿奇索采购单号」「魔果接单时间」都不是买家在店铺的订单号 / 下单时间；「阿奇索已确认」也不能证明买家已收到发货短信；「已撤销」只代表魔果侧作废了码，店铺订单是否退款请以店铺 / 阿奇索为准。
3. 订单详情
点操作列 「查看详情」 打开抽屉「供货订单详情」，上方为订单信息（含 阿奇索采购单号、下单账号、魔果供货号、课程、课程 ID、兑换码来源（下单时自动生成 / 使用已有兑换码）、采购数量、兑换码使用、采购结果、结果通知、通知状态更新时间、取消请求；有撤单请求时另有 「取消请求时间」，撤销失败时另有 「撤销失败原因」；失败订单另有「失败代码」「失败原因」；魔果接单时间、供货时间）。
订单信息下方为 「价格与服务费」 区块：
- 「课程价格」「采购金额」：按下单时的价格快照展示；无历史价格快照时课程价格显示「暂无历史价格快照」。
- 「服务费率」「服务费」（单笔应计）「已计费数量」「已产生服务费」：自动生成模式下展示；「使用已有兑换码」模式的订单此处显示「已在兑换码购入环节处理」。
- 升级前记录的历史取消请求订单，会有一条橙色警示：「这是升级前记录的历史取消请求，系统未自动作废兑换码，请人工核对。」
再下方 「兑换明细」 表列出本次采购的每一张码：序号、兑换码（每条可点 「复制码」 或 「复制链接」，成功分别提示「复制成功」「兑换链接已复制到粘贴板」，失败提示「复制失败，请手动复制」）、兑换状态（未兑换 / 已兑换 / 已作废，作废为红色标签）、兑换学员 ID、兑换时间，明细独立分页。
三、平台服务账单
「平台服务账单」页签用于核对自动生成兑换码模式下产生的服务费账单。
出账规则（与后端逻辑一致）：
- 平台于每月 8 日为机构生成上一自然月的服务账单，账单按机构 × 账期唯一；
- 计费口径：只统计该账期内「下单时自动生成」模式订单中成功兑换的兑换码，每张按下单时的服务费率快照计一次费；
- 机构当期没有计费明细时不产生账单——未开通或未使用自动生成模式的机构，此页签通常为空。
筛选：账期 按「账期开始月份」至「账期结束月份」选择月份范围。
列表列：账单号、账期（起止日期区间）、服务类型（固定为「站外自动发货」）、计费兑换码数、账单金额、生成时间、操作（查看明细 / 导出）。
点 「查看明细」 打开抽屉 「平台服务账单明细」：上方为 账单号、服务类型、账期、计费兑换码数、账单金额、生成时间；下方 「按实际兑换计费明细」 表按供货订单逐行列出：阿奇索采购单号、魔果供货号、课程（含课程 ID）、采购数量、本期计费数量、课程价格、采购金额、服务费率、服务费。展开某一行的箭头可查看该订单本期计费的每一张码：本期已计费兑换码（N 个），列为 序号、兑换码、兑换码生成时间、兑换时间、服务费。
点 「导出」 下载该账单 CSV（文件名形如「平台服务账单_账单号.csv」）。
加载 / 导出失败的常见提示：「平台服务账单加载失败」「平台服务账单加载失败，请稍后重试」「账单明细加载失败」「账单明细加载失败，请稍后重试」「账单导出失败，请稍后重试」；若提示为服务端返回的其他内容，请按提示处理或联系平台。
四、与「课程兑换」的关系（机构侧与学员侧）
- 阿奇索采购成功后拿到的是原始兑换码，没有领取链接、没有新的兑换方式：买家（学员）仍在魔果现有入口使用兑换码——学员端「头像 → 课程兑换」，操作与平时完全一致，参见 使用课程兑换码。兑换被撤销作废的码时，学员会看到提示「兑换码已作废，请联系商家」（含义见 平台提示说明）。
- 被站外订单占用的码，在机构后台「教务管理 → 课程兑换 → 兑换码」列表的「兑换码」列显示 「已分配至站外订单」，操作列变为 「查看供货订单」，点击跳转到本页面「供货订单」中对应订单的详情；无查看权限时提示「无法打开站外发货订单，请确认当前账号有查看权限」。普通的码仍按原方式复制码 / 复制链接，见 创建兑换码操作指引。
- 「兑换码」列表的「使用情况」筛选与状态标签新增 「已作废」（红色）：撤单成功的站外订单中未兑换的码会自动进入该状态。
- 使用已有兑换码模式下：兑换码库存 = 机构未使用且未被站外订单占用的兑换码。店铺出单时若库存不足会导致采购失败（提示「兑换码库存不足」），请及时通过 「补充兑换码库存」 购买。下单时自动生成模式下无需备货，服务费按成功兑换后付费结算，见上文「平台服务账单」。
五、常见问题
Q：这个页面会替我操作阿奇索店铺吗？ 不会。商品搜索与关联、店铺侧发货都由阿奇索调用魔果开放接口自动完成；本页提供凭据配置、结果查看和账单核对，不提供补货、重试、退款等人工处理。阿奇索发起的撤单由魔果后台自动处理并在此展示结果，无需（也无法）在本页操作。
Q：「取消请求」列的「已撤销」「撤销失败」「历史待处理」分别要怎么处理？ 「已撤销」：系统已自动作废该订单中未兑换的码，学员再兑换会提示「兑换码已作废，请联系商家」，一般无需处理；「撤销失败」：多为订单中已有被学员兑换的码（「订单中存在已兑换的兑换码，无法整单撤销」），悬停徽章可见具体原因，如需进一步处理请联系买家侧 / 平台核对；「历史待处理」：是系统升级前记录的取消请求，当时未自动作废兑换码，请按详情页的橙色警示人工核对是否需要同步处理店铺退款。
Q：「通知异常」怎么办？ 表示魔果回传给阿奇索的结果通知失败或超时，阿奇索可能已处理。请按「阿奇索采购单号」在阿奇索侧核对采购结果；反复异常请联系平台。
Q：重置了商户凭据，但阿奇索还没来得及改，会怎样？ 在阿奇索侧更新前，新订单会验签或解密失败。请尽快把「查看凭据」中的新商户密钥、解密密钥和 IV 同步到阿奇索货源账号。
Q：平台服务费是怎么产生的？在哪里核对？ 仅「下单时自动生成」模式产生服务费：每张兑换码被学员成功兑换时，按下单时的服务费率计一次费。每月 8 日生成上一自然月的「平台服务账单」，在「平台服务账单」页签核对并导出。服务费率由平台统一设定，如需调整请联系平台。「使用已有兑换码」模式的服务费在购入兑换码环节已结算，不另行出账。
说明：本页面属于机构后台（需登录访问），暂未配图，请以实际界面为准。