Ganymede Boston
使用说明
← 返回

Ganymede 客户端使用说明

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

一、国际代发物流(International Dropship)

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

1.1 收件地址:国家选择

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

1.2 包裹信息:必填

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

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

1.3 地址校验

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

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

1.4 国际运费报价

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

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

二、自备面单(BYO Label)

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

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

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

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

2.2 自备面单文件要求

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 确认「这箱含锂电池」勾选框的状态(详见 3.3)
Step 4 点「获取费率」→ 系统返回多承运商报价
Step 5 选择承运商 → 「确认购买」→ 余额扣费,面单生成
Step 6 面单 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(可选), hazmat(含锂电池就填「是」), notes
Step 3 上传 CSV → 系统逐行查询费率 → 显示「可购买 / 失败 / 总金额 / 余额」汇总
Step 4 余额充足 → 「确认批量购买」→ 逐张购买,结果实时显示
⚠ 用 Excel 编辑模板会吃掉邮编的前导零。 Excel 把 02896 当数字存成 2896,而全美约 1.3 万个邮编以 0 开头(整个新英格兰加 NJ、PR)。 系统现在会自动把 4 位邮编补回 5 位,并在汇总表那一行写明「邮编 2896 补成 02896」。 看到这条提示说明补过了,核对一下是不是你想要的那个邮编即可。
💡 汇总表的「状态」列会写出所有被系统改动过的地方 —— 邮编补零、hazmat 列没看懂、 carrier_pref 被忽略。没有提示就是完全按你填的走。购买前扫一眼这一列。

3.3 含锂电池的退货(危险品申报)

摄像头、门铃、音箱、带充电宝的设备 —— 凡是内置或附带锂电池的货物,按美国法规属于危险品, 寄件时必须申报。未申报被 USPS 查到,每件罚 $50。

怎么申报

判断标准是这一箱里实际装了什么,不是产品本身的属性 —— 同一个 SKU,退回主机要申报,只退一根数据线就不用。装箱的人最清楚,所以放在下单时勾。

勾上之后会发生什么

会不会更贵

我们在 2026-10-10 用真实地址实测了两个重量段,结论是默认档位不涨价:

服务1.14 lb15.56 lb申报后差价
USPS Ground Advantage(默认选的最便宜档)$7.09$11.39$0
USPS Priority Mail$12.06 → $19.56$18.09 → $25.59+$7.50

$7.50 的危险品附加费只打在 Priority 档上,Ground Advantage 申报前后同价。 而且同样的包裹 USPS Ground Advantage 本来就比最便宜的 UPS 还低(1.14 lb 省 $0.64、15.56 lb 省 $1.51), 所以申报基本不花钱,重件还更划算。

不确定就勾上。 漏报罚 $50/件,多报在默认档位是 $0 —— 代价完全不对称。CSV 里 hazmat 列写了系统认不出来的内容(例如「有电池」以外的自由发挥), 系统会按含锂电池处理并在汇总表标出来,也是出于同样的理由。

hazmat 列认这些写法:
算含电池 —— 是 / 有 / 带电池 / 含电池 / 有电池 / 锂电池 / y / yes / true / 1 / ✓
算普货 —— 留空 / 否 / 无 / 没有 / 不是 / 没电池 / 无电池 / 不带电池 / 不含电池 / no / 0 / ×
其他任何写法 —— 按含电池处理,并在汇总表提示「没看懂,已按含锂电池申报」

💡 如果贵司的货物绝大多数都含锂电池,可以联系仓库把默认勾选打开 —— 之后新建退货面单时这个框默认是勾上的,遇到纯配件退货再手动取消。

3.4 列表与状态

每张退货面单的状态机:

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

承运商那一列后面带 H 徽章的,表示这张面单按含锂电池申报过,纸质面单上也会有对应的 H 标记。没有徽章的是按普货发的。

3.5 批量操作

3.6 筛选

四、代发订单作废(Void Label)

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

4.1 作废条件

4.2 作废流程

Step 1 代发订单列表 → 找到对应订单 → 点「Void」按钮
Step 2 弹窗二次确认 → 显示将退还的金额
Step 3 确认 → 系统向承运商申请作废 → 订单状态变「已取消」
Step 4 钱包自动收到退款(流水类型:deduct_label 反向)
⚠ 部分承运商作废申请会返回「待确认」,可能需要几小时到一天才最终确认。已退款金额按承运商实际反馈,少数情况可能被拒绝退款。

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

5.1 包裹信息必填

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

⚠ 留空或填 0 将无法获取费率。请按实际包裹尺寸填写。
💡 系统不再使用默认 1lb / 12in 兜底值。

5.2 出库来源

新建代发订单时,新增「出库来源」单选:

来源用途
正常出库从 qty_available(可发数)扣减。默认选项。
二手 / 翻新从 qty_secondhand 扣减。用于销售二手或翻新品。
其他来源从 qty_storage / qty_relabel 等其他可发字段扣减。详见仓库联系。
💡「差品」(qty_in_repair) 不会出现在出库来源选项里,避免误发未修品。

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

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

6.1 适用条件

6.2 支付流程

Step 1 账单 → 找到对应账单 → 点击进入详情
Step 2 右下角「💳 用余额支付」按钮(仅符合条件时显示)
Step 3 弹出确认框,显示「当前余额 → 扣后余额」预览
Step 4 确认 → 钱包自动扣费 + 账单状态变「已付款」
💡 扣款流水类型为「账单扣款」(deduct_invoice),在钱包流水中可查到对应账单号。

6.3 余额不够怎么办

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

七、临时账单(Ad-hoc Invoice)

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

7.1 识别临时账单

7.2 处理方式

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

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

八、密码忘记 / 重置

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

8.1 重置流程

Step 1 登录页 → 点「忘记密码?」链接
Step 2 输入您的客户编号(如 171-INV)+ 注册邮箱
Step 3 系统发送重置链接到您的邮箱
Step 4 邮箱收到邮件 → 点链接 → 设置新密码
Step 5 用新密码登录

8.2 注意事项

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

九、出库记录关联装箱单

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

9.1 显示规则

9.2 CSV 导出

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

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

附录:本期变更摘要

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

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

📝 更新日志

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

2026-10-11 — 账单新增「增值服务」分组

2026-10-10 — 退货面单:锂电池申报 · 邮编前导零修复

2026-08-28 — 装箱明细来源列 · 物料库存 · 代发签名/保险 · 中国网络加速

2026-07-21 — 退货管理(含"标记退货")

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

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

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

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

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

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

2026-06-27

2026-06-26

2026-06-18

2026-06-17

2026-06-10

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

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

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

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

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