메뉴
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에서 현재 제공할 수 있는 파일을 다운로드하세요.
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 细节