メニュー
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コマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Ozon FBO 按 timeslot 日期生成对照表 + 合并箱唛 PDF (build_by_date.py). 当用户说 "按日期整理对照表"、"按发运日期分对照表"、"准备交货 tab 的对照表"、"按预约时间合并箱唛"、"按日期合并 PDF"、"打印发货清单"、"司机交货前出对照表" 时触发. 默认只取 READY_TO_SUPPLY 状态 (Ozon 后台 "准备交货" tab), 输出 by_date/YYYY-MM-DD/{对照表.xlsx, 箱唛合并.pdf}.
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-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 细节