TK 电商工具箱

商品管理和订单管理都依赖你自己的 Firebase Firestore 项目。第一次使用时，先把数据库创建好、规则发布好，再回到网站连接。

创建 Firebase 项目

1. 打开 Firebase Console，新建一个项目。
2. 添加应用时选择 网页。
3. 不用勾选 Firebase Hosting。
4. 复制系统生成的整段 firebaseConfig。

创建 Firestore 数据库

1. 在项目里进入 Firestore Database。
2. 创建数据库时建议选择 区域级 和 生产模式。
3. 创建完成后，进入 Rules 页面。

发布 Firestore 规则

网站提供了最新的 Firestore 规则。你需要把规则复制到 Firebase Console 里并发布。

• 第一次使用时，需要先发布一次规则。
• 以后如果页面提示“需要更新 Firestore 规则”，也要重新复制并发布一次。

在网站里连接数据库

1. 回到网站，进入 商品管理 或 订单管理。
2. 点击 连接 Firebase。
3. 粘贴整段 firebaseConfig。

什么时候需要更新规则

通常不是每次加字段都要重新发布规则。一般在以下情况需要更新：

• 新增了新的集合。
• 权限模型发生变化。
• 页面弹出了“需要更新 Firestore 规则”的统一提示。

如果需要更新规则，直接打开 Firebase Console，复制最新规则，在 Firestore Rules 页面重新发布即可。

数据库连接后还有哪些事要知道

• 数据保存在哪里：订单和商品资料都保存到你自己的 Firebase Firestore。网站不会把你的业务数据保存到作者自己的数据库。
• 离线怎么工作：网站使用 Firestore 自带的离线缓存。离线时也能继续操作，恢复联网后会自动同步。
• 换设备怎么恢复：只要新设备连接的是同一个 Firebase 项目，并填入同一套 firebaseConfig，就可以恢复数据。
• 一个项目连一次就够吗：是。商品管理和订单管理共用同一个 Firestore 项目。连一次，两个模块都会直接复用。

利润计算器用于统一测算售价、利润，并在已知售价的情况下复盘实际利润。它包含三个模式：定价旧、定价新、利润复盘。

• 定价旧：适合按旧的逻辑快速反推原价、折扣和利润率，适合保留原来的计算习惯。
• 定价新：适合更精细地计算采购价、海外运费、平台手续费、汇率与折扣档位，也支持先算运费再回填。
• 利润复盘：适合在售价已经确定后，复盘这笔单子的实际利润和表现。
• 全局参数共用：利润计算器里的汇率和海外运费参数，会和订单管理共用同一套全局口径。

定价新公式与字段说明

• 总费用：采购价 + 海外运费。采购价是1688/拼多多等平台采购商品的实际成本，包含国内运费，平台的减免也算进去。。
• 海外运费：（基础费 + 每千克重量费 × 计费重 − 用户承担）× 运费倍率 ÷ 汇率 + 贴单费。
  可以先用海外运费计算器输入实重、尺寸和货物类型，系统会按计费重估算运费。计算结果会自动填入海外运费框；如果你已经知道运费，也可以直接手动输入海外运费。
  • 基础费 + 每千克重量费 × 计费重：官方运费计算公式，具体数值可查看 日本跨境直邮商家物流服务价卡。
  • 计费重：根据实重和尺寸计算出的体积重进行比较，体积重>实重*1.5，计费重=体积重。否则计费重=实重。体积大的比较吃亏，除非单价很高。
  • 用户承担：不包邮，用户会出350円，在这里扣掉。
  • 运费倍率：必须>=1，用于整体放大当前运费结果的系数。给运费留出余量
  • 贴单费：中转仓到海外需要重新贴单，默认1.2元。
• 日元售价：原价 × 折扣 × (1 − 平台手续费)。商家商品一般会打折扣，目前是按4折后还有1.4倍来算的，同时tk平台会有个手续费，扣完之后才给到商家。
• 人民币到手价：日元售价 ÷ 汇率
• 利润：利润 = 人民币到手价： - 总费用
• 原价反推：总费用 × 目标利润率 × 汇率 ÷ [基准折扣 × (1 − 平台手续费)]。系统会根据目标利润率、基准折扣、手续费、总费用和汇率，反推出一个可参考的商品原价，这个价就是上架商品时填入的价格。

商品管理用于维护商品主档、SKU等，目的是让后续录订单时可以直接复用，不再重复填写。

商品主档里维护什么

• 所属账号：用来区分商品属于哪个店铺账号，不同账号下可以有同名商品
• TK ID：TikTok Shop 里的商品ID
• 商品名称
• 1688 链接：方便后续回查和采购
• 图片链接
• 货物类型
• SKU 列表：一个商品下面挂一个或多个 SKU

新增商品时，推荐怎么录

1. 先填商品主档
2. 再新增 SKU
3. 最后做参数调整

SKU 怎么新增

商品弹窗里有两种方式：

• 新增单个SKU：适合只有一个规格，或者只想手动补一个新 SKU。
• 新增多个SKU：适合颜色、尺寸这类组合规格场景。

例如输入：

• 规格维度 1：白、黑、蓝
• 规格维度 2：S、M、L

系统会自动生成 白 / S、白 / M、蓝 / L 这样的多个 SKU。

SKU 明细

• SKU 名称：给人看，建议写成一眼能认出来的规格名，例如 白 / S、黑 / L。
• SKU ID：系统会自动生成，主要用于内部识别和订单关联。
• 重量：填商品这个 SKU 的实际重量，单位是 g。
• 尺寸：按 长×宽×高 填写，单位是 cm，例如 20×15×10。

参数调整怎么用

• 所有 SKU 的重量和尺寸都一样：先生成全部 SKU，匹配关键词 留空，直接填写重量和尺寸，系统会同步到全部 SKU。
• 按分组不同：例如按 S / M / L 分组，先生成全部 SKU，匹配关键词填S ，同时填写重量和尺寸，系统会同步到所有匹配到S的SKU，如白 / S，黑 / S，蓝 / S，没命中的 SKU原来的值保持不变。其他同理。
• 各SKU的重量尺寸输入框也可单独修改：比如其中某一两个 SKU 需要单独修正。

保存时会校验什么

• 每个商品至少要有一个 SKU。
• 每个 SKU 都必须有 SKU 名称。
• 每个 SKU 都必须有有效的 重量 和 尺寸。

如果缺少这些值，对应输入框会变红，系统不会让你保存。

商品列表怎么看多 SKU

商品列表支持按账号查看、搜索、分页，以及点击行展开多 SKU 明细。

当某个商品有多个 SKU 时，点击该商品所在行即可展开，查看每个 SKU 的明细：SKU 名称、SKU ID、重量、尺寸、预估海外运费。

商品和订单管理怎么联动

商品管理不是单独存在的，它和订单管理是联动的。

在订单管理里：

• 新增订单时可以关联商品，以及继续选到具体的 SKU。
• 关联商品 下拉支持按 商品 ID / 商品名称 搜索。
• 关联 SKU 下拉支持按 SKU ID / SKU 名称 搜索。

关联后，系统会自动带出商品名称、单件重量和单件尺寸。

• 而且订单保存时会写入自己的快照，所以后面即使你改了商品或 SKU，历史订单也不会被反向改乱。

订单管理用于记录采购、物流、入仓进度，并自动汇总销售额、支出和预估利润。

现在一张订单可以包含多个商品、多个 SKU，以及每个 SKU 各自的数量，也就是说，订单已经不是“一个订单只对应一个商品 / 一个 SKU”的结构了。

订单管理包含什么

• 账号：用来区分订单属于哪个店铺账号
• 订单列表：切换账号时，列表同步切换到该账号的订单
• 搜索、分页和导出
• 新增 / 编辑订单
• 订单明细
• 顶部统计汇总

新增订单时，推荐怎么录

• 先填基本信息：账号、下单时间、订单号、采购日期。最晚到仓时间 会按下单时间 + 6 天自动生成。
• 再填订单明细项：在 订单明细 里逐条添加商品 / SKU / 数量。如果商品资料已经建好，优先关联商品和 SKU。关联后，系统会自动带出商品名称、单件重量和单件尺寸，这些值后面仍然可以手动修改。
• 再看订单级汇总：总件数 会按所有明细数量自动求和，总重量 会按所有明细 单件重量 × 数量 自动汇总，总尺寸 需要你按实际打包情况自己调整，预估总海外运费 会按当前的 总重量 + 总尺寸 自动计算。
• 再填订单级金额：总售价（日元） 是整张订单的总售价，总采购额（元） 是整张订单的总采购额，它们不再按明细逐条填写。
• 最后补快递信息：快递公司、快递单号、订单状态。订单预警 会自动生成。

关联商品不是强制项，但推荐这样录，后面会顺很多。即使不关联商品，也可以手动把订单录完整。

关联商品和 SKU 后，会发生什么

• 关联商品 下拉支持按 商品 ID / 商品名称 搜索。
• 关联 SKU 下拉支持按 SKU ID / SKU 名称 搜索。
• 选中商品和 SKU 后，系统会自动带出商品名称、单件重量和单件尺寸。
• 这些自动带出的值，后面仍然可以手动修改，不会被锁住。
• 订单保存时会写入自己的快照，所以后面就算商品或 SKU 修改了，历史订单也不会被反向改乱。

订单明细怎么理解

订单明细 是订单里真正买了什么。

一张订单里可以有多条明细，每条明细代表：

• 一个商品
• 一个 SKU
• 这个 SKU 的数量

这意味着：

• 一个订单可以有多个 SKU。
• 同一个 SKU 可以通过 数量 表示买了多件。

通常建议同一个 SKU 直接用 数量 表示多件，不要重复加两条完全一样的明细。

重量、尺寸和预估总海外运费怎么理解

现在重量、尺寸和运费分成了两层：

• 订单明细 里的 单件重量 / 单件尺寸
• 订单级 的 总重量 / 总尺寸 / 预估总海外运费

规则是：

• 总件数：按所有明细数量自动求和。
• 总重量：按所有明细 单件重量 × 数量 自动汇总。
• 总尺寸：不会自动乱算，需要你按实际打包情况自己调整。
• 预估总海外运费：会按订单级最终的 总重量 + 总尺寸 自动计算。

所以：重量系统可以给你自动参考；尺寸仍然建议你按实际包裹自己确认；预估总海外运费会始终跟着当前的总重量和总尺寸重新计算。如果你改了总重量或总尺寸，预估总海外运费也会跟着更新。

订单里的金额口径

• 总售价：录入的是 日元。
• 总采购额：录入的是 人民币。
• 预估总海外运费：录入的是 人民币。
• 预估利润：显示的是 人民币。

预估利润公式：

预估利润 = 总售价（日元）÷ 汇率 -（总采购额 + 预估总海外运费）

这里用的是和利润计算器共用的全局汇率。

订单状态会自动变化吗

会，但只在合适的场景下自动调整。

• 新增订单时，如果录入了快递单号，系统会按规则把状态切到更合适的状态。
• 如果快递公司没填，系统也会尽量根据单号自动识别。
• 如果你后续手动修改状态，系统不会强行覆盖你的手动选择。

订单统计怎么看

订单页顶部会分成两组统计：

• 当前筛选：只统计当前账号标签和当前搜索结果下的订单。
• 全部订单：统计当前数据库里的全部订单，不受筛选影响。

每组会展示：

• 总销售额
• 总采购额
• 预估总海外运费
• 预估总利润

其中：

• 总销售额 是收入。
• 总采购额 + 预估总海外运费 是支出。
• 预估总利润 = 总销售额 - 总支出。

搜索、分页和导出怎么用

• 搜索支持：下单时间、订单号、产品名称、快递信息。
• 如果输入的是日期格式，系统会优先按 下单时间 搜索。
• 分页支持在列表上方和下方切换，方便长表格查看。
• 导出 CSV 会把当前列表里的订单导出成表格文件。
• 新增订单后，页面会保留在当前分页，不会跳回第一页。