舟谱订单导入

舟谱系统订单导入模板生成（自提订单+调拨订单分开，每表只有1个sheet）。当下单表数据需要转化为舟谱系统可导入的Excel格式时使用。

Security Scan

The skill's code and instructions match the stated purpose (generating Zhoupu import Excel from local order + price spreadsheets); nothing requests unrelated secrets or external endpoints, though the included Python scripts require Python + pandas/openpyxl which the metadata did not declare.

Purpose & Capability

Name/description (生成舟谱导入模板) align with the provided scripts and SKILL.md: both scripts read local Excel price/order files and produce Excel import templates. Minor mismatch: registry metadata declared 'required binaries: none', but the runtime requires Python and libraries (pandas, openpyxl). This is likely an omission rather than malicious, but the skill will not run without those dependencies.

Instruction Scope

SKILL.md instructs the agent (or user) to run the two Python scripts on local Excel files, use specific arguments, and follow a manual approval step. Instructions reference only local file paths and the Zhoupu portal URL for human upload — no instructions to read unrelated system files, access network services, or transmit data to unknown endpoints. The strict verification/approval steps are explicitly stated.

Install Mechanism

No install spec (instruction-only with bundled scripts). That is low-risk: nothing is downloaded at install time. The included scripts will be executed locally if invoked; they are plain Python and not obfuscated. There are no external download URLs or installers.

Credentials

The skill requests no environment variables or credentials, and the scripts do not perform network calls. Proportionality is good. Note: the scripts will read arbitrary Excel files you provide and example local paths under C:\Users\... or workspace — you should only point them at intended spreadsheet files. Also the skill metadata omits required runtime dependencies (Python + pandas + openpyxl).

Persistence & Privilege

always is false and the skill is user-invocable. It does not modify other skills or request permanent presence. The default ability for the agent to invoke the skill autonomously remains enabled (disable-model-invocation=false), which is standard — combine this with the human approval note in SKILL.md if you require manual review before generation.

Assessment

This skill appears to be what it says: a local Excel-to-Excel template generator for the Zhoupu system. Before installing or running it: 1) Verify you have Python and the required packages (pandas, openpyxl); the skill metadata did not list these. 2) Inspect the two included Python scripts locally (they are plain text) and run them in a safe environment; they do not make network requests. 3) Only pass in the intended order/price Excel files (do not point the tool at sensitive unrelated files). 4) Follow the SKILL.md manual approval step (send generated file to the named reviewer) if your process requires human verification — otherwise an agent with autonomous invocation could generate files without that human check. 5) If you need stricter controls, disable autonomous invocation for this skill or run the scripts manually in a sandboxed environment.

舟谱系统订单导入模板生成

核心规则（2026-04-09 更新）

一、客户分类（下单表列名）

下单表列名	客户类型	舟谱系统客户名	价格类型
唐成	分销商	唐成	分销价格
黄家伟	分销商	黄家伟	分销价格
易胜琳	分销商	易胜玲	分销价格
胡奎奎	分销商	胡奎奎	分销价格
朱青峰	分销商	朱青峰	分销价格
谢总	分销商	宜城谢总	分销价格
吾悦	门店（永辉）	永辉吾悦店	永辉价格
东津	门店（永辉）	永辉东津店	永辉价格
民发	门店（永辉）	永辉民发店	永辉价格
沃尔玛	门店（沃尔玛）	沃尔玛	沃尔玛价格
檀溪美联	门店（美联）	美联檀溪店	美联价格

分销商和门店全部填入自提订单导入模板。

二、名称转换规则（舟谱系统特有）

• 易胜琳（下单表）→ 易胜玲（舟谱）
• 谢总（下单表）→ 宜城谢总（舟谱）
• 吾悦（下单表）→ 永辉吾悦店（舟谱）
• 东津（下单表）→ 永辉东津店（舟谱）
• 民发（下单表）→ 永辉民发店（舟谱）
• 檀溪美联（下单表）→ 美联檀溪店（舟谱）

三、源单据号规则

格式：ZT + 到货日期YYYYMMDD + 序号（4位补零）

示例：ZT202604080001

关键：一个客户只能有一个源单据号！ 该客户所有商品行都使用同一个单号，不能每个商品单独一个单号，否则舟谱系统报错。

四、自提订单导入模板字段（8列）

字段	说明	固定值/来源
*源单据号	ZT+日期+序号，一个客户共用一个号	按规则生成
客户名称	舟谱系统名称	按名称转换规则
*业务员	业务员	张俊峰
部门	部门	湖北福宝商贸有限公司
*仓库	仓库	总仓
商品名称	商品名称	从下单表/价格表取
商品条码	条码（数字）	从下单表/价格表取
*单位	单位	从价格表取，一个条码对应一个单位
*数量	数量	从下单表取

只填这9列，不要填其他列！

五、调拨订单模板字段

（参考调拨订单样表，独立sheet，独立文件）

• 调拨业务员8人：程欢欢、刘善涛、毛辉、周运潘、田顺达、王琴、刘正宝、秦小芳
• 调出仓=总仓，调入仓=业务员名+仓（如"程欢欢仓"、"秦小芳仓"）
• 源单据号格式：DB + 日期 + 序号（2位，如 DB2026040801）
• 商品条码是必填字段，条码为空时尝试用简称关键词匹配

六、价格来源

使用用户提供的第一张价格表（价格表20260406.xlsx），对应字段：

• 分销价格 → 分销商
• 永辉价格 → 永辉吾悦/东津/民发
• 沃尔玛价格 → 沃尔玛
• 美联价格 → 美联檀溪

七、下单表注意事项

• 下单表底部有合计行（条码为空），脚本自动跳过
• 下单表中"+Nd到货"或"+Nd发货"后面的备注不影响匹配
• 长条码在Excel中存为科学计数法，脚本自动处理
• 如价格表无某条码价格，用 --extra-prices 参数补充

---

业务流程

1. 业务员/导购/分销商用企业微信智能表格报单
2. 张俊峰导出Excel给到AI
3. AI填入下单表后发给郝洋（销售经理）审核修改
4. 郝洋确认后，AI生成舟谱导入模板
5. 导入舟谱系统

审核环节必须经过郝洋，不能跳过。

---

脚本用法

1. 自提订单

cd C:\Users\友恒鑫\.qclaw\skills\zhoupu-order-import\scripts
python generate_order_import.py --order <下单表.xlsx> --price <价格表.xlsx> --arrival <YYYYMMDD>

参数：

参数	必填	说明
--order	✅	下单表Excel
--price	✅	价格表Excel（第一张：价格表20260406.xlsx）
--arrival	✅	到货日期YYYYMMDD
--sheet	❌	工作表名关键词
--start-seq	❌	起始序号，默认1
--output	❌	输出路径
--extra-prices-file	❌	补充价格JSON文件

2. 调拨订单

cd C:\Users\友恒鑫\.qclaw\skills\zhoupu-order-import\scripts
python generate_transfer_order.py --order <下单表.xlsx> --price <价格表.xlsx> --arrival <YYYYMMDD>

---

常见问题

导入失败（成功0条）

最常见原因：源单据号重复

舟谱要求一个客户只有一个源单据号。如果同一客户的多个商品各用不同单号，就会报错。

价格缺失

用 --extra-prices-file 参数补充。格式：

{"条码字符串": {"分销价格": 10.5, "永辉价格": 12.0, "美联价格": 8.5}}

无条码产品

下单表部分产品条码列为空，脚本按简称（去掉"+Nd到货"）匹配价格表。匹配失败则跳过（无法导入舟谱，需手动处理）。

起始序号冲突

舟谱系统已有单号，再次导入时需用更大的起始序号避开。

---

文件路径参考

• 价格表：C:\Users\友恒鑫\.qclaw\media\inbound\价格表20260406---22d216fe-73cf-4d63-b169-2890f50d4965.xlsx
• 下单表蒙牛：C:\Users\友恒鑫\.qclaw\media\inbound\最新26年4月下单表4.8_2---a0898a17-fd59-4733-89a9-cbb1ded1c44d.xlsx
• 下单表简爱：C:\Users\友恒鑫\.qclaw\media\inbound\26年简爱下单表4.8---6c2adf1c-1a1c-41fc-8fca-3b4fa2984e27.xlsx
• 补充价格：C:\Users\友恒鑫\.qclaw\workspace\extra_prices.json

舟谱系统导入操作路径

登录地址： https://portal.zhoupudata.com/saas/main

自提订单导入

采销管理 → 自提订单 → 批量操作 → 批量导入 → 选择文件 → 立即导入

调拨订单导入

采销管理 → 调拨订单 → 批量操作 → 批量导入 → 选择文件 → 立即导入

---

生成后验证规则（2026-04-11 经验总结——零返工核心）

⚠️ 最重要原则：用下单表的"合计行"作为数量基准，永远不要自己累加

下单表底部有"合计："行（row[2] == '合计：'），每个客户/仓库的数量 Excel 已经算好了。

为什么要这样做：

• 下单表个别行含公式（=SUM(G2:Y2) 类），Python data_only 模式读出来值不准
• 下单表中间嵌有"加单汇总行"（如 row[2] == '合计：' 且有唐成=647这类），读到会数量翻倍
• 每次"看起来差不多"但差几十到几百件，根因都是这个

正确流程：

1. 读取下单表 → 直接定位合计行（找 row[2] == '合计：' 的那一行）
2. 从合计行取出每个客户/仓库的数量
3. 生成模板
4. 生成后统计模板里每个客户的实际合计件数，逐行对比合计行数字
5. 完全一致才发文件；有差异立刻查，不发送

其他验证项

条码匹配一致性：

• 脚本优先用下单表 Col2 的条码去价格表匹配
• 风险： 下单表里的条码可能填错（如冠爆珠条码填给每日鲜酪）
• 必须做： 匹配到条码后，对比下单表 Col4 产品名与价格表产品名，明显不一致时告警

价格表会更新：

• 用户可能随时更新价格表（补充条码、修正价格）
• 每次生成时使用最新收到的价格表文件（media/inbound 里的最新版本）

无条码产品处理：

• 以下产品长期无条码，脚本跳过并告警，需手动处理：
  • 蒙牛轻食BOX原味195g
  • 果纤维青提牛油果200g
  • 果纤维芭乐菠萝混合味200g
  • 现代牧场0乳糖软牛奶185ml
  • 每日鲜语双蛋白牛乳250ml
  • 简爱原味酸奶吸吸乐100g

---

文件路径参考

• 最新价格表：C:\Users\友恒鑫\.qclaw\media\inbound\价格表20260411---4b327b26-5d15-4009-9387-10ae1cc79362.xlsx
• 最新下单表：C:\Users\友恒鑫\.qclaw\media\inbound\最新26年4月下单表4.8_4月10日到货---b878112b-48db-420e-9ce9-daf9a672532c.xlsx
• 补充价格：C:\Users\友恒鑫\.qclaw\workspace\extra_prices.json

上传目录

生成后上传到：C:\tmp\openclaw\uploads\