来集运跨境云仓

1平台与批次信息

一个批次 = 同一平台下的一批代贴单。批次号用于事后追溯与对账。

剩余物一旦填写就计入库存，因此 SKU 与数量必须同时填写（产品图自动引用该 SKU 在库存里的图）； 选弃用则只留记录、不入库存。快递商请手动选择。 面单文件中的条形码运单号由系统自动读取，并与您填写的快递单号自动建立映射。

2Excel 批量导入面单（面单文件可稍后补交）

按模板填写 快递单号 / 平台（下拉必填）/ SKU（必填）/ 产品名（选填）/ 产品数量 / 客户备注 / 仓库备注（仓库填，可不填），一次可提交上百单； 产品图列可留空。导入后订单即可在【面单管理】看到，面单文件与产品图可以稍后补交。
SKU 建议填到最小粒度（有颜色 / 尺寸变体的写 D01-Black-S 更便于仓库配货），但系统不强制，填 D01 也能提交。

3批量上传面单（仅支持 PDF）

仅支持 PDF 格式，可多选或拖拽，服务端自动转码并读取面单条形码运单号。按 快递单号.pdf 命名可自动解析快递单号，省去人工录入。
v4.5 速卖通组包揽收：提交页不再手填组包号—— 提交完成后到【②面单管理】勾选这些面单，点工具条【创建组包】，弹窗里 大包号可自填、留空则自动生成 5 位随机码（如 A7K2Q）， 确定后组包角标直接显示【大包号】，每个小包照常各贴各的面单。
速卖通揽收单请移步附件上传：在该行的【附件】列上传图片或 PDF（可传多个）， 预览打印时本组会额外出一页「附件第一个文件 / 图片」，交给揽收司机随大包带走。

4批量录入快递单号

方式A：纯单号列表，一行一个，按上传顺序对应。方式B：从 Excel 复制两列（文件名 + 单号），自动按文件名映射。

5一拆多 / 库存自动扣减

同一快递单号用括号序号拆成多件：SF123(1) … SF123(5)，最多 5 件，每件分别扣费。 拆满 5 件后请改用其它快递单号提交。

库存自动扣减：快递单号以 KC 开头、且本单 SKU 已在【⑥ 库存】里时，提交后按产品数量自动扣减该 SKU 库存（只扣到 0）；库存里没有该 SKU 也照常提交。 剩余物一旦填写即计入库存，SKU 与数量必须同时填写。

6校验并提交

产品图不在这里上传：提交后在【面单管理】对相应订单点补图片即可， 不要求任何命名格式，第一张图会作为产品图显示在面单管理 / 打印预览 / 核对清单。

面单管理

v4.5：勾选 ≥1 张面单 → 工具条【创建组包】，弹窗里大包号可自填（字母 / 数字 / - / _，最长 24 位）， 留空则自动生成 5 位随机码；确定后组包角标直接显示【大包号】，不再带 ①②③ 序列号。 勾选 ≥2 个不同快递单号 → 还可【创建合包】。两者区别：
· 创建合包：合成 1 个包裹，只出主单这一张面单，整包只按 1 单扣费，子单已扣费用自动退回；
· 创建组包（速卖通）：一个【大包号】把若干小包归到一起，每个小包各贴各的面单、计费不变，外面再套 1 个大包。
速卖通揽收单请移步附件上传：在每行的【附件】列单独上传图片 / PDF（可传多个，【管理】可删）。
预览打印时：一个组包额外出一页——该组第 1 个附件；没传附件的组回退为自动生成的「组包揽收单」（大包号 + 内含小包明细）；未成组的散单有附件也各出一页。
v4.4 第二批：勾选订单后用【批量改状态】可一次把多单改成已打印 / 已发货 / 异常 / 待打印；【导出CSV】直接按上方筛选（含日期跨度）导出。

打印设置

待打印队列

核对清单（A4 贴单核对）

A4 汇总清单，贴单时逐单打勾。列：√ / # / 运单号 / 快递单号 / 组包号 / 产品信息 / 产品缩图 / 备注， 合包的面单会标出 合包①/②/③，组包的面单标出 组包【大包号】（同一大包号的面单同属一个大包）。
SKU 数量恒显（含 ×1），可据此核对出库件数是否正确。
备注分客户备注（客户提交时填写，客户与管理员都可改）与仓库备注（仓库 / 运营填写，客户只读）两列，与【面单管理】共用同一份数据，编辑后立即刷新。

核对清单预览

账户充值

扫码付款后填写金额提交申请，管理员核对到账后批准，余额即时入账。 当前余额 0.00 元，单张面单扣费 0.00 元。

收款码与扣费单价

充值申请审批

费用明细

库存列表

展示剩余物入库时提交的产品图、SKU 与数量。管理员与客户都能按 SKU 查库存（支持模糊、空格分隔查多个）， 管理员额外保留按客户查；管理员可直接修改库存数量。备注栏双方可编辑，留存编辑人与编辑时间。

客户账号

客户账号由客户自行注册。此处可查看合作量、账户余额与单张面单扣费单价，并对客户进行充值 / 赠减；客户忘记密码时可用重置密码代其设置新密码（无需旧密码）。管理员自己的登录密码在页眉用户中心 → 重置密码中修改。

员工账号与权限

新建员工账号并勾选权限点；员工登录后只能看到被授权的板块（无权限的接口后端也会拦截）。

流程说明（v4.5）

• 客户注册：客户编码、名称、手机号（必填，11 位）、密码；手机号用于管理员在【客户管理】按号检索。
• 客户：选平台、快递商（必选） → 上传PDF 面单或Excel 批量导入 → 校验提交（提交即扣费）。每单SKU 必填、产品名选填；产品图不在这里上传，提交后到【面单管理】点「补图片」。
• 运营：【面单管理】按客户 / 平台 / 仓库 / 状态 / 日期范围筛选或多关键词搜索 → 【打印预览】按标签排序并设定时间范围 → 热敏标签连续打 → 拣货时用【④ 核对清单】逐单打勾 → 改状态为已打印，出库交接后可在打印预览页一键标记已发货。
• 扣费：客户扫码付款后在【费用中心】提交充值申请 → 管理员核对到账后「批准」→ 余额即时入账。提交面单自动按单价扣费；删除未打印的面单自动退回扣款；合包后整包只按 1 个面单扣费，子单已扣费用原路退回。
• 隔离：客户只能看到自己提交的单，且不能自行改打印状态；管理员可见全部；员工账号按勾选的权限点显示对应板块，后端同样拦截。
• 组包揽收（v4.5）：速卖通等需要组包揽收的订单，提交页不再手填组包号——勾选 ≥1 个面单点【创建组包】，弹窗里大包号可自填，留空则自动生成 5 位字母数字码（如 A7K2Q，已剔除易混淆的 0/O/1/I）；确定后组包角标直接显示【大包号】。速卖通揽收单到附件列上传，打印时每组额外出一页「附件第一个文件 / 图片」，计费不变（详见下方「组包」卡片）。

一拆多 / 剩余物 / 库存扣减

• 一拆多：同一快递单号按括号序号拆多件，SF123(1) … SF123(5)，最多 5 件，每件分别扣费；拆满后请改用其它单号或联系仓库。
• 剩余物：一旦填写即计入库存，SKU 与数量必须同时填写，缺一项则该单被拒收。产品图自动引用该 SKU 在【库存】里的产品图（库存里没有则用本单第一张产品图）。
• 自动出库扣减：提交的快递单号以 KC 开头、且填写的 SKU 已在库存里时，系统按本单产品数量自动扣减该 SKU 库存（只扣到 0，不会变负）；库存里没有该 SKU 则照常入库、不拦截。
• 合包后：主单与子单都可以各自填剩余物，谁填了、SKU 有剩余就按谁的 SKU 入库存。

补交的两个入口

• 补交面单：补的是面单文件（仅 PDF），自动读取条形码运单号。
• 补交图片：补的是产品图，不要求任何命名格式；第一张图会作为该单产品图，显示在面单管理 / 打印预览 / 核对清单。
• 未传面单的订单在面单列显示「待补交」，点击该占位块也能直接补交。

核对清单与库存检索

• ④ 核对清单：拣货 / 贴单用的核对单据，一单一行，列头固定 7 项——✓ / # / 运单号 / 快递单号 / 产品信息 / 产品缩图 / 备注。管理员可按运单号 / 快递单号 / 客户编号 / 备注搜索（空格分隔查多个），按日期范围筛选，勾选后打印 A4 或导出 CSV。
• 打印时面单与配货单各占一张纸：面单铺满整张纸，其后紧跟一整张同尺寸配货单（含快递单号、运单号、客户 / 平台 / 仓库、合包 / 组包序号、SKU × 数量、剩余物、客户备注 / 仓库备注与「□ 已核对 □ 已贴单」勾选项）。v4.4 起数量恒显——数量为 1 也显示 ×1，仓库可直接核对出库数量；合包 / 组包子单明细也带「合包 / 组包 N 单（合计件数 X）」。v4.5 起组包还会额外出一页「附件」（该组第一个附件，多为速卖通揽收单）。
• ⑥ 库存：客户与管理员都能按 SKU 查（支持模糊、空格分隔多个），管理员额外保留按客户查（输入框带客户编码候选）；列头为产品图 / SKU / 产品名 / 数量 / 所属客户 / 备注 / 更新时间 / 操作。
• ⑦ 客户管理支持按客户编码 / 名称 / 手机号搜索；② 面单管理与④ 核对清单支持按运单号 / 快递单号 / 客户编号 / 备注搜索。
• 备注栏处处可编辑：面单管理、核对清单、库存、客户管理的备注栏管理员与客户都能改，每条记录留存编辑人与编辑时间。

快递单号 ↔ 运单号 映射

• 快递单号：客户命名 / Excel 填写的单号（按文件名自动提取或手工录入）
• 运单号：系统读取面单文件里的条形码自动获得，两者在面单管理一一对应展示
• 条码读不到时运单号为空，不影响入库，可在【面单管理】手工核对

入库校验

• 快递商为必选项，由客户自行确认，不做自动识别
• 单号格式校验 + 全库重复检测（重复单自动跳过并计数）
• 面单文件可解析；PDF 由服务端转码为位图再排版，避免不同客户 PDF 边距差异裁掉条码

一票多件 / 合包怎么处理

• 一票多件（同一快递单号有多张面单）：系统不丢任何一张，全部入库并归入同一 label_group，列表显示「一票多件」角标，打印时连续输出，中间不插其他单。如其中某张是误传的旧面单，请在【面单管理】手动删除。
• 合包（一张面单对应多个快递单号）：在【面单管理】勾选 ≥2 个不同快递单号（其中至多一个已上传面单）→ 点「创建合包」，以已上传面单的那条为主单，其余为子单。
• 合包后主单与子单都留在列表里逐行显示（主单标「合包主单 ×N」，子单标「合包子单」，子单底色略浅），可随时对任一行点「解散合包」或「删」。
• 客户与管理员拥有相同的合包 / 解散合包权限，客户只能在自订单之间操作。
• 合包成功后整包只按 1 个面单扣费，子单此前已扣的费用自动退回余额并记入费用明细。打印时只出主单面单，不会重复出面单。

组包揽收（v4.5 · 速卖通等平台）

• 业务形态：多张面单其实是多个小包——每个小包各自贴自己的国际面单，外面套 1 个大包，揽收时只需 1 张速卖通揽收单。这与「合包」相反：合包是把几个单号并成一个包裹、只出一张面单。
• 怎么建（v4.5 新流程）：在【面单管理】勾选 ≥1 个面单 → 点工具条【创建组包】 → 弹窗里大包号可自填（字母 / 数字 / - / _，最长 24 位）， 留空则由系统自动生成 5 位字母数字码（如 A7K2Q，已剔除易混淆的 0/O/1/I）→ 点【确定创建组包】，列表「组包」角标直接显示【大包号】，不再带 ①②③ 序列号。 填了已存在的大包号＝把这几单并进原来那个大包（同一客户、同一平台才行）。
• 速卖通揽收单请移步附件上传：提交页已不再提供组包号输入框，揽收单／大包面单截图或 PDF 上传到该组的「附件」列（可多个，单个 ≤20MB、一次 ≤20 个）；只有 1 个面单也能建组，方便把大包与其子包单独管理。
• Excel 导入：模板已精简为 9 列，不再有「组包号」列；导入后按上面两步【创建组包】+ 上传附件即可。
• 计费不变：N 个小包照常各扣 1 单（不像合包退子单费用）。创建组包、解散都不退款也不补扣。
• 打印四规则：① 合包只出主单面单；② 组包每单都出自己的面单；③ 每个组包在所有小包面单之后追加一整页附件页——取该组第一个附件（图片原图 / PDF 首页）整页输出；该组还没传附件时才自动退回系统版「组包揽收单」（大包号 · 客户 / 平台 / 仓库 · 小包个数 · 合计件数 · 明细 · □已组包 □已揽收）；未组包但上传了附件的单条面单，也各出一页；④ 每张面单后跟一张配货单（一一对应、结尾无空白页），SKU 数量恒显。
• 解散：点「解散组包」即拆组、大包号清空；需要再组时重新勾选一次即可。
• 删单联动：组内小包被删到不足 2 单时自动解散。

面单管理与打印（v4.4 第二批）

• 导出 CSV：【导出CSV】就放在起始日期 / 结束日期旁边，选好时间跨度点一下即可导出，沿用页面当前的客户 / 平台 / 仓库 / 状态 / 日期 / 搜索词筛选，不再单独填「导出时间跨度」。
• 批量改状态：勾选订单后，用工具条【批量改状态】下拉选「已打印 / 已发货 / 异常 / 恢复待打印」→ 点【应用】，一次改完（只有管理员与有改状态权限的员工可用）。
• 配货单（原「核对条」）：每张面单对应一张配货单、独立成页，不会被多打出空白页；配货单上 SKU 右侧恒显数量（SKU ×N，1 件也显示 ×1），便于核对出库数量。
• 客户备注 / 仓库备注：客户备注由客户填写（易碎、包装要求等，会印在配货单上）；仓库备注由仓库 / 运营填写（缺货、换货、异常原因），客户只能看、不能改。两列在列表、打印队列、配货单、核对清单与 CSV 导出里各占一列。

命名规范（请发给客户）

• 面单：快递单号.pdf，如 SF1234567890123.pdf；一拆多：SF1234567890123(1).pdf
• 产品图：已取消命名要求。提交页不再上传产品图，提交后在【面单管理】点「补图片」，任意文件名均可，第一张即产品图
• 只支持 PDF 面单：提交页与补交入口仅接受 .pdf，非 PDF 会被直接拒收
• SKU 必填：建议写到最小粒度（有颜色 / 尺寸变体的写 D01-Black-S），但不强制；产品名选填，留空则用 SKU 展示
• Excel 批量导入模板列（v4.5 共 9 列）：快递单号 / 平台（下拉必填）/ 产品名（选填）/ SKU（必填）/ 产品数量 / 客户备注 / 仓库备注 / 运单号 / 产品图（可补交）——组包号不再在表格里填，导入后勾选面单【创建组包】自动分配大包号。
• 国际运单号不可重复：同一张面单重复提交、或两张面单识别出同一个运单号时，后一张直接拒收并提示「国际运单号重复」
• 备注分两列：客户备注客户自己填（易碎 / 包装要求等，会印在配货单上）；仓库备注由仓库填写（缺货 / 异常等），客户只能看不能改
• 客户编码建议与贵司 ERP 客户号一致，便于对账

部署与扩展

• 当前：FastAPI + SQLite + 本地磁盘，单端口 8000，可直接部署
• 生产建议：换 PostgreSQL；文件存对象存储（COS/OSS/S3）；面单含收件人 PII，需加密与定期清理
• 大客户可开放 POST /api/submit 接口由其系统直连推送