Ganymede Boston

管理端使用说明

增值服务费率 · 产品导入导出

版本 2026-10-11

Ganymede 管理端使用说明

版本：2026-10-11 · 本文档只覆盖 10 月新增和改动的管理端功能，其余功能沿用原有操作方式。每次更新看更新日志。

一、增值服务费率

贴标、刻码、拍照、扫描序列号这类在仓库另外做的活，以前只能在账单上手工加一行。现在可以像其他费用一样配置费率，按客户开启、按产品调价，并在出账时自动进账单。

入口：费率设置 → 费率中心 → 页面底部「增值服务」。

💡 服务目录是全站共用的，费率是按客户配的。建一项服务不等于哪个客户就会被收这笔钱 —— 还要在那个客户的行上开启并定价。

1.1 新建一项服务

Step 1 点「+ 新增服务」

Step 2 填中文名和英文名（只有这两项要填）

Step 3 选计价单位和计费依据，可填一个建议单价

Step 4 点「创建服务」—— 这时只是进了目录，还没有任何客户被收费

服务代码（例如 vas.engraving）由系统按英文名自动生成，显示在中英文名下方，一般不用管。它是账单明细回指这项服务的依据，所以建好之后不能改 —— 改了历史账单就指向一个不存在的服务。确实需要自定义时点旁边的「改」。

1.2 给客户开启和定价

页面顶部先选客户。卡片按状态分三段，分段依据和真实计费判定完全一致：

分段	含义
全局启用	该客户所有产品按同一个价收
只按产品启用	没有全局价，只有被单独定价的那几个产品收费
未对该客户启用	目录里有这项服务，但这个客户没开

全局价

打开那一行的开关，在行上的输入框填单价即可。关掉开关是删掉这条费率，不是存 0 —— 0 表示「这项服务免费」，和「没开这项服务」是两回事。

按产品单独定价

Step 1 点那一行的「按产品」

Step 2 勾选要单独定价的产品

Step 3 在上方填单价 → 点「应用到已选」（或直接在每行右边输入）

Step 4 点「保存」

⚠ 勾选只是选中，不等于定价。 只勾选不填价就点保存，系统会提示「已选 N 项，但还没给它们定价」。必须经过「应用到已选」或在行内输入单价这一步，才会有待保存的改动。

弹窗里只显示该客户名下的产品，并且排除物料／包材（标题会写明排除了几项）。没有单独定价的产品按全局价收。清掉某个产品的覆盖价是删行，不是存 0，之后它回落到全局价。

1.3 计费依据 —— 决定费率会不会真的收到钱

这是新建服务时最需要想清楚的一项。徽章颜色就是提示：绿自动进账单、蓝要人工、黄这条路还不通。

依据	怎么算	状态
跟随检修数量（不含错误产品）	用的就是检修费现在那个公式：良品 + 准新品 + 各类问题件，扣掉「发错货」。	可直接用
跟随出库件数	出多少件收多少份。适合贴标、拍照这类每件必做的。	可直接用
只挂费率，手工开账单	费率存着备查，账单上手工加一行。	可直接用
按作业记录计费	需要一张通用的「增值服务作业」表来记录「给哪个 SKU 做了多少」。	这张表还不存在，设了费率也不会自动进账单

💡 为什么要扣掉错误产品：判定为「发错货」的部分走 错误产品 独立通道，那边自带处理费和检修费。不扣的话同一件货会被收两次。

⚠ 配了费率不等于会收到钱。 选「跟随检修数量」的服务，只有该客户有检修记录时才会产生账单行；选「跟随出库件数」的，要有出库记录。如果这项活实际是在入库或出库时做的，却配成了「跟随检修数量」，那它永远不会计费，而且不会有任何报错提示。

账单上会是两行

「跟随检修数量」的服务和检修费按同一批件数计算，所以账单上会并排出现两行。描述统一写成 增值服务：类型 以示区分：

明细	数量	单价
检修费	1,343 件	$18.00
增值服务：刻码	1,343 件	$0.25

1.4 停用和删除

点那一行最右边的 ⋯。

操作	效果
改为停用	服务留在目录里，已经开启的客户不受影响、继续计费，但不能再给新客户开启。历史账单的引用保持完整。
删除服务	从目录移除，并连带清掉所有客户的费率。有未付清账单在用时会被拒绝。

⚠ 删除弹窗里的占用数是「全站」口径，不是当前这个客户的。删除会影响每一个客户，所以只看当前客户会让人误以为可以删。有历史账单用过的，优先选「停用」：删了之后那些账单的文字和金额还在，但点不回费率记录了。

「未付清」的判定是 应收金额 − 已收金额 > 0，不是看账单状态 —— 状态是手工改的，会和实际收款脱节。

二、产品导入 / 导出

2.1 现在可以直接传 xlsx

模板下载和产品导出写出来的都是 .xlsx，以前导入却只收 .csv —— 系统给你一个文件又不肯收回去。现在两种格式都收，「下载模板 → 填 → 上传」和「导出 → 改 → 导回」两条路都通了。

入库、出库、库存、代发这几个导入口也一并支持了。

2.2 增值服务列

模板和导出文件的最右边会按当前在用的服务动态生成列，表头形如 刻码 [vas.engraving]。

单元格填什么	效果
留空	不改动（保持原有费率）
数字，例如 `0.60`	这一行「关联客户」里列出的所有客户都按这个价
`086-ZL:0.60;171-INV:0.50`	各客户各自的价；没提到的客户不动
`-`	清除这个产品的单独定价，回落到全局价

💡 留空 = 不改动，这一条很重要。宽表里绝大多数格子是空的，如果空格子意味着清零，一次导入就会把没填的费率全清掉。

⚠ 每次都重新下载模板。 列是按当前服务目录生成的。新建一项服务之后，旧模板里不会有那一列 —— 填了也不会生效，而且界面不会提示。反过来，如果表里有系统不认识的服务代码，整单会被取消（不会导入一半），这是为了避免「填了一整列价格却一分钱没进系统」。

2.3 同一产品多个客户不同价

一个产品可能被多个客户登记，各自的检测费或增值服务费可能不同。导出时：各客户同价就写纯数字，不同价写成 客户代码:单价;客户代码:单价。导入两种都认。

检测费列同样支持这种写法。纯数字的老写法行为完全不变，手上存着旧文件的不受影响。

2.4 导入过程中不要离开页面

导入是一行一行串行写的，一百多行要跑几分钟。页面底部会显示进度条（导入中 73 / 165（44%）），中途关闭或刷新浏览器会弹确认。

⚠ 中途刷新会只写进去一半。 已写入的部分不会回滚。补救办法是把同一个文件再导一次 —— 导入是按 SKU 匹配的，已存在就更新、不存在才新建，重复导入不会产生重复产品。

三、这次顺带修掉的老问题

做上面这些功能时撞出几个一直存在的问题，一并记在这里，免得以后有人以为是新引入的。

问题	原来的表现
代发批量导入从来没成功过	每次都报 `parseCSVRow is not defined`，和真实原因毫无关系，也没法自己绕过。
导出再导回会覆盖别家的检测费	导出只写第一个客户的费用，却列出全部客户。导回去时所有客户的检测费被覆盖成第一个客户的 —— 一次看起来无害的往返就能改掉别人的费率。
客户看不懂增值服务那一行	客户端账单把它归进「杂费」，导出时显示成英文 `vas`。

📝 更新日志

按时间倒序，最新的在最上面。

2026-10-11 — 增值服务费率 · 产品导入导出

费率中心新增「增值服务」区：自由新增删除服务、按客户开启定价、可针对单个产品覆盖价、删除前检查账单占用。详见第一章。
服务代码自动生成：新建服务只填中英文名，代码按英文名推导，撞名自动加序号。需要时可手填。
四种计费依据，其中「跟随检修数量（不含错误产品）」复用检修费现有的数量公式，仓库不用额外录入任何东西。
账单新增「增值服务」小计，排在检测费下方（这两项常是同一批件数，挨着放便于核对）。明细描述统一为「增值服务：类型」。
产品导入支持 xlsx，入库 / 出库 / 库存 / 代发导入口一并支持。
产品模板和导出含增值服务列，按当前服务目录动态生成；支持「客户代码:单价」表达多客户不同价。
导入加进度条和离开拦截，避免中途刷新导致只写入一半。
修复：代发批量导入一直报 parseCSVRow is not defined；导出再导回会覆盖其他客户的检测费；客户端账单把增值服务归进「杂费」。