菜单
Ozon FBO 填装箱 + 箱唛 PDF + 对照表 (fill_boxes_labels.py). 当用户说"填箱"、"申报装箱"、"拉箱唛"、"拉 PDF 标签"、"箱唛打印"、"已建单要填箱"、"补上装箱明细"、"跑 skip-fill 后的下一步"、"单个 order 填箱" 时触发。支持 (a) 单 order_id 填; (b) 批量按 plan-result.json 填.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/yulianggan/fbo-creater --skill fbo-fill-boxes命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | fbo-fill-boxes |
| description | Ozon FBO 填装箱 + 箱唛 PDF + 对照表 (fill_boxes_labels.py). 当用户说"填箱"、"申报装箱"、"拉箱唛"、"拉 PDF 标签"、"箱唛打印"、"已建单要填箱"、"补上装箱明细"、"跑 skip-fill 后的下一步"、"单个 order 填箱" 时触发。支持 (a) 单 order_id 填; (b) 批量按 plan-result.json 填. |
输入已建好的 supply_order → 查实际 items → 切箱 → /v1/cargoes/create → 拉箱唛 PDF → 写 Excel 对照表.
脚本: /Users/mac/Documents/ozns/丝绸生活/海外仓发货表/2026-04-23海外仓发货/fill_boxes_labels.py (~405 行)
create_fbo_plan.py --skip-fill 跑完了, 现在要填"/v3/supply-order/get 拿 order detail + supply_id/v1/supply-order/bundle 拿 Ozon 实际接受的 items (很关键 — 任何模式都可能过滤 SKU)/flow/upload-cargoes: cargoes/create → cargoes/create/info 轮询 → cargoes-label/create → cargoes-label/get → PDF 保存到 LABEL_DOWNLOAD_DIR/fbo-plan 产物同结构)/fbo-service-up)DATA_FILLING (未申报过箱) — 否则会报错cd /Users/mac/Documents/ozns/丝绸生活/海外仓发货表/2026-04-23海外仓发货
python3 fill_boxes_labels.py \
--order-id 100452984 \
--offer-id Q_MeiGongDao-HeiSe-Free \
--sku 3214793665 \
--qty 4200 \
--cluster Москва \
--box-size 300 \
--account 丝绸生活
必填 (单 order 模式): --order-id + --offer-id + --sku + --qty + --box-size.
可选: --cluster (写进对照表), --account (默认 丝绸生活), --fbo-service (默认 127.0.0.1:4182), --out-xlsx, --dry-run.
plan-result.json 是 restock_planner.py --execute 产出的 fbo_plan_*.result.json, 里面有已建好的 order_ids.
python3 fill_boxes_labels.py \
--plan-result /path/to/fbo_plan_Q_MeiGongDao-HeiSe-Free_20260422.result.json \
--box-size 300 \
--account 丝绸生活
脚本会逐行读 result.json, 对每条有 order_ids 的记录, 逐 order 申报.
--order-id 或 --plan-result (二选一, 互斥必填)--box-size (必填): 单箱装箱率--offer-id / --sku / --qty: 单 order 模式必填--cluster: 对照表列用, 单 order 模式可选--account: 账号名 (默认 丝绸生活)--fbo-service: 默认 http://127.0.0.1:4182--out-xlsx: 默认 fbo_mapping_<date>.xlsx--dry-run: 只切箱 + 打表, 不调 Ozon (保护已建好的单, 看切箱计划是否合理)fbo_mapping_<YYYYMMDD_HHMMSS>.xlsx (22 列)LABEL_DOWNLOAD_DIR (容器 /app/labels → 宿主 /Users/mac/Documents/ozns/github/ozon_fbo_shipment_service/labels/); 每 supply_id 一个 PDFSUPPLY_ITEM_NOT_FOUND原计划件数 ≠ supply 实际接受件数. 脚本已默认调 /supply-order/bundle, 所以不会发. 若还出, 说明 supply 后来被改过 (时段 update 可能引发), 重看 /supply-order/get 对一下数.
DATA_FILLING 之外的状态也想填不行. Ozon 的 cargoes/create 只接受 DATA_FILLING 状态. SHIPPING_PREPARED 之后只能用 /supply-order/content/update 改.
file_url 返 S3 URL正常. /v1/cargoes-label/get 返的 file_url 是 presigned S3 (1h 过期), 脚本已自动下并落本地. /v1/cargoes-label/file/{guid} 这个路径是 404, 不要用.
脚本沿用 create_fbo_plan.py 的 22 列 schema, 空集群/cargo_ids 就是空. 检查 order 是不是多 SKU 但只填了一个.
--dry-run 和真实跑差别?dry-run 不会调 cargoes/create, 只 print 切箱方案 + 写 xlsx. 真实跑会建箱 + 拉 PDF.
create_fbo_plan.py 里 fill 阶段跑的/cargoes/create 已成功 (cargoes READY_TO_SUPPLY) 但 label/create 返 500/429 时, 不要重跑 /flow/upload-cargoes (会建重复 cargoes). 直接走恢复:
# 1. 拿现有 cargo_id
cargoes = post("/v1/cargoes/get", {"supply_id": supply_id})
# 注意: 响应里 supply[0].cargoes 嵌套 (不是顶层 cargoes)
cargo_ids = [c["cargo_id"] for c in cargoes["supply"][0]["cargoes"]]
# 2. 直接 label/create (跳过 cargoes/create)
post("/v1/cargoes-label/create", {"cargo_ids": cargo_ids})
# 3. poll cargoes-label/get
post("/v1/cargoes-label/get", {"task_id": task_id})
# 4. PDF 用 curl 下 (Surge MITM, urllib 拿不到)
curl -o supply_X.pdf "$file_url"
相关 memory: feedback_cargo_label_recovery.md
bash /Users/mac/.claude/skills/sync_fbo_scripts.sh
/fbo-service-up — 4182 服务运维/fbo-plan — 建 plan + 自动 fill (默认行为, 不需要再单独 fill, 除非 --skip-fill)/restock-to-fbo — 批量建 order, 产 plan-result.json 直接喂模式 Breference_fill_boxes_labels.md — 脚本契约feedback_always_verify_supply_actual_items.md — 必须 bundle 再切箱的原因reference_ozon_fbo_api.md — cargoes-label PDF URL 细节