菜单
Ozon FBO 按 timeslot 日期生成对照表 + 合并箱唛 PDF (build_by_date.py). 当用户说 "按日期整理对照表"、"按发运日期分对照表"、"准备交货 tab 的对照表"、"按预约时间合并箱唛"、"按日期合并 PDF"、"打印发货清单"、"司机交货前出对照表" 时触发. 默认只取 READY_TO_SUPPLY 状态 (Ozon 后台 "准备交货" tab), 输出 by_date/YYYY-MM-DD/{对照表.xlsx, 箱唛合并.pdf}.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/yulianggan/fbo-creater --skill fbo-by-date命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Ozon FBO 填装箱 + 箱唛 PDF + 对照表 (fill_boxes_labels.py). 当用户说"填箱"、"申报装箱"、"拉箱唛"、"拉 PDF 标签"、"箱唛打印"、"已建单要填箱"、"补上装箱明细"、"跑 skip-fill 后的下一步"、"单个 order 填箱" 时触发。支持 (a) 单 order_id 填; (b) 批量按 plan-result.json 填.
Ozon FBO 端到端发货编排. 当用户说"丝绸生活账号补 N 天 FBO"、"按安全天数发货"、"清空海外仓"、"补海外仓没货的 SKU"、"Q_X 发 N 箱你帮分集群"、"全自动发货"、"FBO 一键发"时触发. 自动 4 mode 决策 + 跑 create_fbo_plan + cron-style 自动 retry 直到全发完, 终态出对照表 Excel. wrapper 调用老 fbo-* 子 skill 的脚本, 不重复实现.
Ozon FBO 多集群发货 SOP 一把梭脚本 (create_fbo_plan.py). 当用户说"发 FBO"、"建 FBO 供货单"、"走 FBO SOP"、"multi-cluster 发货"、"多集群发货"、"按 plan.json 发 FBO"、"跑 FBO 计划"、"把 approved plan 推到 FBO"、"按 4181 plan 发货"、"按 batch_id 发货" 时触发。自动 multi-cluster 优先 + PARTIAL/NOT_AVAILABLE 降级到单集群 CROSSDOCK + 建箱+箱唛+对照表+ledger 台账。支持 3 种输入: plan.json / 4181 plan_id / 4181 batch_id.
基于 SOC 职业分类
正在显示 SKILL.md
| name | fbo-by-date |
| description | Ozon FBO 按 timeslot 日期生成对照表 + 合并箱唛 PDF (build_by_date.py). 当用户说 "按日期整理对照表"、"按发运日期分对照表"、"准备交货 tab 的对照表"、"按预约时间合并箱唛"、"按日期合并 PDF"、"打印发货清单"、"司机交货前出对照表" 时触发. 默认只取 READY_TO_SUPPLY 状态 (Ozon 后台 "准备交货" tab), 输出 by_date/YYYY-MM-DD/{对照表.xlsx, 箱唛合并.pdf}. |
场景: 司机来取货前, 按 Ozon 后台 "准备交货" tab 的预约日期, 整理每日的发货清单 + 把同日的所有箱唛 PDF 合并成 1 个文件方便打印.
脚本: /Users/mac/Documents/ozns/丝绸生活/海外仓发货表/2026-04-23海外仓发货/build_by_date.py (~280 行)
/v1/supply-order/list 拿账号下符合 state 的 supply (默认 READY_TO_SUPPLY)/v3/supply-order/get + /v1/supply-order/bundle + /v1/cargoes/gettimeslot.from 日期分组 (YYYY-MM-DD)箱唛合并.pdfcd /Users/mac/Documents/ozns/丝绸生活/海外仓发货表/2026-04-23海外仓发货
# 默认: 丝绸生活账号, 只取 READY_TO_SUPPLY (Ozon "准备交货" tab)
python3 build_by_date.py
# 多账号
python3 build_by_date.py --account 个人之路
# 指定日期范围 (ISO 8601)
python3 build_by_date.py --since 2026-04-22T00:00:00Z --to 2026-04-30T00:00:00Z
# 多状态 (逗号分隔)
python3 build_by_date.py --states "READY_TO_SUPPLY,SHIPPING_PREPARED"
# 全状态 (含 CANCELLED 历史)
python3 build_by_date.py --states all
--states 参数取值 (Ozon supply state 枚举):
| 值 | Ozon 后台 Tab | 含义 |
|---|---|---|
DRAFT / DATA_FILLING | "新的" | 草稿/数据填充中 |
READY_TO_SUPPLY (默认) | "准备交货" | 已切箱+箱唛, 等司机取货 |
SHIPPING_PREPARED / SUPPLY_PROCESSING | "在途商品和验收" | 在途/到仓清点中 |
SUPPLIED / SUPPLIED_PARTIALLY | "报告单据确认" | 已收货等确认 |
SUPPLY_REJECTED / CANCELLED | "档案" | 拒收/取消 (历史) |
by_date/
├── 2026-04-28/
│ ├── 对照表.xlsx # 22 列 (跟 create_fbo_plan.py 输出同)
│ └── 箱唛合并.pdf # 同日所有 supply PDF 合并
├── 2026-05-06/
│ ├── 对照表.xlsx
│ └── 箱唛合并.pdf
交货 ID | 供货 ID* | 状态 | 链路 | 集群 | macrolocal_cluster_id |
货位 ID* | 货位名称 | drop-off ID* | drop-off 名称 |
货号 (offer_id) | SKU | 条码 |
箱号 | cargo_id* | 该箱件数 |
总件数 | 总箱数 | 单箱装箱率 |
时段 | 箱唛 PDF 路径 | 备注/错误
* 标的 4 列 (供货 ID / 货位 ID / drop-off ID / cargo_id) 强制写成字符串 (number_format=@), 防 Excel 把 16 位长 ID 解析成科学计数法.
/v1/cargoes/get 响应里 cargo 不含 items 嵌套, 只有 cargo_id. 脚本用 /supply-order/bundle 拿 sku 总件 + box_size = 总件 / cargo 数 推算每箱 (跟 create_fbo_plan.py rows_per_box 一致)./supply-order/get.supplies[].cluster.name 在 READY_TO_SUPPLY 状态下不填. 用户需要可加 macrolocal_cluster_id → cluster_name 反查 (4182 /cluster/list, 未实现)./Users/mac/Documents/ozns/github/ozon_fbo_shipment_service/labels/ (Docker mount)<工作目录>/labels/ (本地 fallback)<supply_id>.pdf 或 supply_<supply_id>.pdf, 兜底 substring 匹配日期 orders supplies rows pdfs pages
2026-04-28 12 12 41 12 41
2026-05-06 1 1 3 1 3
13 orders 全 READY_TO_SUPPLY, 41+3=44 箱 = 44 页合并 PDF.
/v1/cargoes/get payload 字段是 supply_ids (list, minItems=1) — 单数 supply_id 422 Unprocessable. 详见 memory feedback_cargoes_get_supply_ids_list.md./v1/supply-order/list 必传 sort_by:1 — 默认 0 会乱序, 翻页 last_id 失效.order.timeslot.timeslot.from (不是 order.timeslot.from).bash /Users/mac/.claude/skills/sync_fbo_scripts.sh
/fbo-orchestrator — 端到端发货编排, 终态报告 step 调本 skill/fbo-status — build_shipment_overview.py 计划 vs 已发对照表 (按 cluster×SKU 聚合, 跟本 skill 按 date 分组互补)/fbo-fill-boxes — 单 order 填箱+箱唛reference_build_by_date.md — 实测数据 + 算法feedback_cargoes_get_supply_ids_list.md — /cargoes/get 字段坑reference_ozon_fbo_api.md — 4182 端点速查