Ganymede 客户端使用说明

版本：2026-07-14 · 本文档介绍 5 月底以后新增的客户端功能，原有功能请参考完整使用手册。每次更新看更新日志。

一、国际代发物流（International Dropship）

原本「代发订单」仅支持美国境内发货，现已升级支持发送到世界各地。下单流程不变，下面只列变化点。

1.1 收件地址：国家选择

新建代发订单时，「国家 / Country」从默认锁定 US 改为可选下拉框，支持全球主流承运商覆盖的国家。

键盘可直接输入国家名首字母快速定位（例如输入 "C" 跳到 China / Canada）
选择非 US 时，州 / 省字段自动切换为该国家的省 / 行政区列表
邮编格式不再强制 5 位，按目的国实际规则验证

1.2 包裹信息：必填

为避免承运商拒收和报价不准，国际代发的「重量 / 尺寸」必须填写真实数据。

⚠ 系统不再使用默认 1lb / 12 inch 兜底值。包裹信息留空将无法获取费率。

重量单位：磅 (lb)
尺寸单位：英寸 (in)，依次为长 × 宽 × 高

1.3 地址校验

提交订单时系统会自动校验收件地址：

地址合法 → 静默通过
部分字段被修正（例如 city 拼写）→ 弹窗确认是否接受修正
完全无效 → 弹出承运商返回的错误原因，可修改后重试

💡 如果收件人姓名 / 街道含有非拉丁字符（中文、阿拉伯文等），部分承运商可能拒绝。系统会先弹警告，建议改用对应国家本地拉丁拼音。

1.4 国际运费报价

获取费率的逻辑跟国内相同（多承运商对比 → 选最便宜或指定承运商）。常见国际承运商：

UPS / FedEx International
DHL Express
USPS（部分目的国，价格便宜但时效慢）

⚠ 国际运费通常高于国内。下单前请确认账户余额或透支额度足够。

二、自备面单（BYO Label）

「代发订单」新增「面单来源」选项，客户可上传自有 PDF 面单（无需从系统购买）。适用于已经有合作物流账号、或客户自行约 UPS 上门取件的场景。

2.1 单条下单 — 选择面单来源

新建代发订单弹窗最上方的「面单来源」二选一：

选项	说明
系统购买	（默认）下单后系统查询运费费率，您选择费率并扣款购买。
自备面单	您自己上传 PDF 面单文件。订单立即进入「待配货」状态，仓库扫描后正常出库。不扣账户余额。

2.2 自备面单文件要求

格式：PDF（推荐），也支持 PNG / JPG
尺寸：建议 4x6 英寸（标准热敏面单尺寸）
追踪号：上传时必须输入对应追踪号，仓库扫描配货依赖它
承运商：选择实际承运商（UPS / FedEx / USPS / DHL 等）

2.3 批量自备面单（CSV + PDF）

当一次有多个订单要下时，可用批量上传方式：

Step 1 在代发页面点击「批量自备面单」按钮

Step 2 下载 CSV 模板，按列填写：order_no, sku, qty, recipient_name, address, tracking_number, carrier...

Step 3 准备一个 PDF 文件，按 CSV 顺序拼接所有面单（每页一张），上传 CSV + PDF

Step 4 系统自动拆分 PDF 为单页，匹配到对应订单，逐单建立

💡 如果 PDF 页数和 CSV 行数不一致，系统会提示。请确认顺序一致再上传。

三、退货面单（Return Labels）

新增「退货面单」模块，专为退货退款场景设计。客户可购买退货面单提供给消费者，仓库收到包裹时自动匹配并入库。

3.1 单条购买

Step 1 左侧菜单 → 退货面单 → 「新建退货面单」

Step 2 填写寄件人地址（包裹发出地，即消费者地址）+ 包裹重量尺寸

Step 3 点「获取费率」→ 系统返回多承运商报价

Step 4 选择承运商 → 「确认购买」→ 余额扣费，面单生成

Step 5 面单 PDF 自动下载，可直接发邮件给消费者或打印

💡 收件地址（仓库地址）由系统自动填入，无需手动填。

3.2 批量购买（CSV 导入）

一次购买多张退货面单的高效方式：

Step 1 点击「批量购买」→ 下载 CSV 模板

Step 2 填写每一行：name, phone, street1, city, state, zip, length_in, width_in, height_in, weight_lb, carrier_pref（可选）

Step 3 上传 CSV → 系统逐行查询费率 → 显示「可购买 / 失败 / 总金额 / 余额」汇总

Step 4 余额充足 → 「确认批量购买」→ 逐张购买，结果实时显示

3.3 列表与状态

每张退货面单的状态机：

状态	含义	可操作
已购买	面单已生成，等待消费者寄出	下载 PDF、作废退款
已入库	仓库已收到包裹并扫描匹配	下载 PDF
已作废	未使用的面单已作废，钱包已退款	查看

3.4 批量操作

批量下载 PDF：勾选多张 → 「批量下载」→ 下载 ZIP 包
批量作废：勾选未入库的多张 → 「批量作废」→ 逐张作废并退款
导出 CSV：当前筛选结果导出，包含追踪号、状态、金额等

3.5 筛选

日期范围筛选
状态筛选（已购买 / 已入库 / 已作废）
关键词搜索（追踪号 / 收件人姓名 / 备注）

四、代发订单作废（Void Label）

购买面单后发现订单需要取消？现在客户端可自助作废，无需联系仓库。

4.1 作废条件

订单状态为「已购买面单 / label_purchased」
仓库尚未开始打印 / 拣货（一旦印过单子，订单就锁定无法自助作废）
面单购买时间在承运商政策允许的退款窗口内（多数承运商 30 天）

4.2 作废流程

Step 1 代发订单列表 → 找到对应订单 → 点「Void」按钮

Step 2 弹窗二次确认 → 显示将退还的金额

Step 3 确认 → 系统向承运商申请作废 → 订单状态变「已取消」

Step 4 钱包自动收到退款（流水类型：deduct_label 反向）

⚠ 部分承运商作废申请会返回「待确认」，可能需要几小时到一天才最终确认。已退款金额按承运商实际反馈，少数情况可能被拒绝退款。

五、代发订单：包裹信息必填 + 出库来源

5.1 包裹信息必填

为了避免承运商拒收和报价不准，新建代发订单时「重量 / 长 / 宽 / 高」是必填字段。

⚠ 留空或填 0 将无法获取费率。请按实际包裹尺寸填写。

重量：磅 (lb)
尺寸：英寸 (in)

💡 系统不再使用默认 1lb / 12in 兜底值。

5.2 出库来源

新建代发订单时，新增「出库来源」单选：

来源	用途
正常出库	从 qty_available（可发数）扣减。默认选项。
二手 / 翻新	从 qty_secondhand 扣减。用于销售二手或翻新品。
其他来源	从 qty_storage / qty_relabel 等其他可发字段扣减。详见仓库联系。

💡「差品」(qty_in_repair) 不会出现在出库来源选项里，避免误发未修品。

六、用钱包余额自助支付账单

每月仓储 / 操作账单确认后，您可以直接用钱包余额支付，无需联系仓库登记 ACH / 支票。

6.1 适用条件

账单状态为「已确认 (confirmed)」或「已发送 (sent)」
账单未付（paid_amount = 0）
钱包余额 + 透支额度 ≥ 账单金额

6.2 支付流程

Step 1 账单 → 找到对应账单 → 点击进入详情

Step 2 右下角「💳 用余额支付」按钮（仅符合条件时显示）

Step 3 弹出确认框，显示「当前余额 → 扣后余额」预览

Step 4 确认 → 钱包自动扣费 + 账单状态变「已付款」

💡 扣款流水类型为「账单扣款」(deduct_invoice)，在钱包流水中可查到对应账单号。

6.3 余额不够怎么办

扣后余额会超过透支上限时，系统会拒绝并提示具体差额。两个选择：

联系仓库给钱包充值
请仓库以传统方式（ACH / 支票）登记收款

七、临时账单（Ad-hoc Invoice）

「临时账单」是仓库为单次特殊任务（卡派接驳、装卸、加急等）开具的独立账单，不与月度账单混在一起。

7.1 识别临时账单

账单号前缀为 ADH-（月度账单是 INV-）
账单列表中带紫色「临时」标签
开具后直接为「已确认」状态，立即可见

7.2 处理方式

临时账单的支付流程与月度账单完全一致：

下载 PDF：可直接生成账单 PDF
用钱包余额自助支付：同上节
外部支付 (ACH / 支票)：仓库登记后状态变「已付款」

💡 临时账单完全独立结算，不影响月度账单。也可同月有多张临时账单 + 1 张月度账单同时存在。

八、密码忘记 / 重置

客户账号支持自助密码重置，无需联系管理员。

8.1 重置流程

Step 1 登录页 → 点「忘记密码？」链接

Step 2 输入您的客户编号（如 171-INV）+ 注册邮箱

Step 3 系统发送重置链接到您的邮箱

Step 4 邮箱收到邮件 → 点链接 → 设置新密码

Step 5 用新密码登录

8.2 注意事项

重置链接有效期 60 分钟，过期需重新申请
一个客户编号每天最多申请 5 次（防滥用）
如果忘记客户编号或注册邮箱，请联系仓库管理员

⚠ 请使用与仓库登记一致的邮箱。若没收到邮件，先检查垃圾邮件文件夹；仍找不到请联系仓库。

九、出库记录关联装箱单

「出库记录」列表新增「装箱单」列，方便查询每一笔出库属于哪一张装箱单。

9.1 显示规则

有关联装箱单 → 显示紫色的装箱单号 chip（例如 PK20260615-001）
无关联（散单出库）→ 显示 —
多 SKU 合并的出库组：概要行也显示对应装箱单号

9.2 CSV 导出

导出的 CSV 现在也包含「装箱单」列，方便您在 Excel 中按装箱单号筛选、对账。

💡 如果您看到出库记录的「装箱单」列是 —，说明这是散单出库（没有先生成装箱单）。从「装箱单」页面生成的出库自动关联。

附录：本期变更摘要

以下是本次手册补充涵盖的所有客户端新增功能：

功能	入口
国际代发物流	代发订单 → 新建 → 国家选择
自备面单（BYO）	代发订单 → 新建 → 面单来源选「自备」/ 批量上传
退货面单	左侧菜单 → 退货面单（单条 / 批量）
代发订单作废	代发订单列表 → 已购面单的行 → Void
包裹信息必填 + 出库来源	代发订单 → 新建表单（默认行为变化）
钱包余额支付账单	账单 → 详情 → 「💳 用余额支付」
临时账单	账单列表中显示，紫色「临时」标签 + `ADH-` 前缀
密码重置	登录页 → 忘记密码？
出库记录关联装箱单	出库记录 → 列表新增「装箱单」列 + CSV 导出

📝 更新日志

下面按时间倒序列出每次客户端的更新，最新的在最上面。

2026-07-21 — 退货管理（含"标记退货"）

页面改名：「退货面单」改成「退货管理」，下有两个 tab：「退货面单」（购买系统退货面单，跟原来一样）和「退货标记」（新）。
标记退货：点右上角橙色的 🏷 标记退货按钮，输入追踪号 + 选择关联 SKU + 数量 + 备注。用于您已经从其他渠道（Amazon 退货、其他平台）拿到 tracking，希望仓库收到时能对上货 —— 不需要在系统里购买退货面单。
仓库扫描自动匹配：仓库收到货扫追踪号时，系统会同时匹配「退货面单」和「退货标记」，命中后一键回填客户 + SKU 明细，仓库操作员核对后直接保存入库。
状态跟踪：标记的状态从「待收货」→「已收到」由仓库扫描自动切换。仓库收到前您可以点「作废」撤销标记。

2026-07-14 — 登录页语言切换

右上角语言按钮：登录页、忘记密码页、重置密码页右上角新增「中文 / EN」切换按钮，登录界面按选中语言单一显示，不再中英文混排。
自动识别系统语言：首次访问时按浏览器/操作系统语言自动选择 —— 中文系统默认中文，其他默认英文。之后你手动切换过就以你的选择为准（保存在浏览器本地）。

2026-07-14 — 已完成装箱单查询

装箱单页面新增「已完成」tab：原来只显示"待填写"的装箱单，仓库标记已出库后就消失了，导致你无法核对账单里的物料费（纸箱费 / 托盘费 / 打托费）。现在点顶部「已完成」tab 可以看到全部已出库的装箱单。
直接看到箱数 / 托盘数：列表每一行显示该单的总箱数、托盘数、运输类型（LTL / SP / PARCEL 等），方便你对照账单里的物料费明细。
年月筛选：右侧下拉选年份 + 月份，快速定位到某个账期对应的装箱单。
查看详情：每行「查看」按钮弹出该单完整信息（每种箱型的数量、每种托盘的规格、备注）。

2026-07-14 — 账单入库/出库按业务分类

入库费/分拣费：账单里的每行现在带上业务类型后缀（如「入库费 SKU123 · 一件代发」、「入库费 SKU456 · 检测」）—— 同一 SKU 的不同业务类型分开列，方便你按类目核对。
出库费：每行带上出库来源后缀（如「出库费 SKU789 · 良品」、「出库费 SKU789 · 差品」）。对应出库管理页面的 5 种来源：良品 / 二手 / 差品 / 换标 / 一般仓储。
不影响合计：只是把原来一行拆成按类型的多行，单价和总金额不变。

2026-07-14 — 账单 Excel 下载 & 退货运费显示

财务账单：查看账单弹窗底部除「下载 PDF」按钮外，新增 📊 下载 Excel 按钮。Excel 分「汇总」+「明细」两个 sheet：汇总列出账单号、账期、各类小计、合计；明细每一行都是一笔费用（类型、日期、SKU、说明、数量、单价、金额），支持排序/筛选/复制，方便你在电子表格里核对费用。
账单条目更全：即使是免费的 SKU（费率 $0），入库/出库/分拣数量也会显示在明细里，让数量能跟你的进出货记录对得上。金额是 $0，不影响账单合计。
退货运费显示：账单里新增「退货运费」分组（跟「代发运费」同类），列出本期购买的每一张退货面单及金额。这些运费之前购买时已从钱包扣掉，账单里显示为参考行（$0），不重复计入合计。作废且当期退款的面单不会出现。补缴项也改为「代发/退货预扣补缴」，覆盖两块钱包透支来源。

2026-07-03 — 地址校对增强

代发订单：点「提交订单」时系统会先校对收件人地址。承运商发现问题会弹「你填的 vs 建议地址」对话框，采用建议后会自动回填到表单再提交。
退货面单：点「获取费率」时同样先校对寄件人地址。
识别更全：以前只有承运商明确报错时才提示（如邮编错），现在城市（City）错但邮编对的情况也能识别 —— 会拿承运商规范化后的地址跟你填的做对比，有差异就弹提示。

2026-07-03 — SKU 自动带出重量/尺寸

代发订单：新建订单时选中 SKU 后，系统会根据仓库配置的产品尺寸/重量，自动填入包裹信息里的重量 & 长×宽×高。多个 SKU 或数量 > 1 时按「重量累加、尺寸取最大值」计算。自动填的字段是浅黄色背景，你可以手动修改（改过之后不再被自动覆盖）。
退货面单：新建退货面单时可以关联多个 SKU（点「+ 添加 SKU」加行），每行填 SKU + 数量，系统会按同样的规则自动带出包裹重量/尺寸。SKU 是选填的，你也可以完全跳过直接手动填。
退货面单 CSV 批量导入：CSV 模板新增 sku 列（可选）。填了 sku 且仓库产品库里配了尺寸/重量，就可以留空 weight_lb/length_in/width_in/height_in 列，系统自动补齐。
⚠️ 需要仓库先在产品页把每个 SKU 的长/宽/高/重量填好，才能享受自动带出。你若发现某 SKU 没有自动填进来，麻烦联系仓库补齐。

2026-06-27

地址粘贴自动识别：新建代发订单或退货面单时，在「地址行 1」直接粘贴完整地址（例 123 Main St, Boston, MA 02101），系统自动拆分城市/州/邮编到对应字段。支持带公寓号、ZIP+4 (5+4 位) 等常见格式。识别失败则按正常粘贴处理。

2026-06-26

退货面单购买修复：部分承运商强制要求发件地址包含邮箱字段（尤其 USPS），之前购买时会报错。系统现在自动兜底填入默认邮箱，客户无需额外操作。

2026-06-18

追踪号自动转大写：自备面单（BYO）填写追踪号时自动转大写，避免大小写不一致导致仓库匹配不到。仓库扫描入库时也会自动匹配大小写。
支持 USPS 后 22 位匹配：USPS 面单 tracking 是 30+ 位，物理面单条码只编码末尾 22 位，仓库扫描后能自动对应到原始单号。

2026-06-17

出库记录关联装箱单：出库记录列表新增「装箱单」列，CSV 导出也包含该列。详见第九章。
顶部加 ❓ 使用说明按钮：右上角语言切换和「退出」之间新增 ❓ 图标，点击打开本说明文档。

2026-06-10

退货面单 / 代发面单：余额校验支持透支额度：之前余额是负数时所有购买都被拒，现在按"扣后余额 ≥ -透支上限"判定，更准确。

2026-06-08 — 临时账单 + 钱包扣账单

临时账单（ADH-）：仓库可开具单次特殊任务的独立账单，账单列表带紫色「临时」标签。详见第七章。
用钱包余额自助支付账单：账单详情页加「💳 用余额支付」按钮（confirmed/sent 状态可见）。详见第六章。
钱包流水加新类型：账单扣款 / 调整(+) / 调整(-) 三种新流水类型。

2026-05-29 — 退货面单 + 代发自助 Void

退货面单：左侧菜单新增「退货面单」模块，支持单条 / 批量购买、批量下载 ZIP、CSV 导入导出。详见第三章。
代发订单自助作废：代发列表已购面单行新增「Void」按钮，可自助作废并退款。详见第四章。

2026-05-27 — 自备面单 + 国际代发

自备面单（BYO）：代发订单可选「自备面单」，上传自有 PDF 不走系统购买。支持单条 + 批量 CSV+PDF。详见第二章。
国际代发物流：代发订单解锁全球目的国，支持 UPS / FedEx / DHL / USPS 国际服务。详见第一章。
包裹信息必填 + 出库来源：新建代发订单时重量/尺寸必填，并新增「出库来源」选项。详见第五章。
密码忘记 / 重置：登录页新增「忘记密码？」自助流程。详见第八章。

💡 每次客户端更新后强烈建议强刷一次浏览器（Mac: Cmd+Shift+R / Win: Ctrl+Shift+R）确保加载最新版本。

如有疑问，请联系您的仓库客户经理或运营组。