القائمة
通过 S/4HANA OData API 创建 STO 调拨订单（ZSTO_T1/ZSTO_T2）。当用户意图为：创建 STO、创建 SAP 调拨订单、公司间/工厂间调拨、指定发出工厂+接收工厂+物料+数量+交期创建采购订单时触发。必须强制执行「先 preview 确认、再 create」的双步骤门禁。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | sap-sto-create |
| description | 通过 S/4HANA OData API 创建 STO 调拨订单（ZSTO_T1/ZSTO_T2）。当用户意图为：创建 STO、创建 SAP 调拨订单、公司间/工厂间调拨、指定发出工厂+接收工厂+物料+数量+交期创建采购订单时触发。必须强制执行「先 preview 确认、再 create」的双步骤门禁。 |
通过 API_PURCHASEORDER_PROCESS_SRV 创建 STO 调拨订单，售后工厂发出时自动尝试创建外向交货单（JCo）。
The CLI is scripts/sap_sto_cli.py relative to this skill's directory.
python3 scripts/sap_sto_cli.py <command>
First run auto-installs dependencies. All commands output JSON to stdout.
| Command | Usage | Description |
|---|---|---|
plants | plants | 列出所有支持的工厂代码和名称 |
preview | preview --supply-plant PLANT --receiving-plant PLANT --material MAT:QTY[:DATE] [--material ...] [--delivery-date DATE] --batch-number BATCH_NO | 预览 STO 订单信息（不创建），生成一次性确认标识，输出 requires_confirmation=true + confirmation_summary |
create | create --supply-plant PLANT --receiving-plant PLANT --material MAT:QTY[:DATE] [--material ...] [--delivery-date DATE] --batch-number BATCH_NO --confirmed | 创建 STO 订单，必须显式传 --confirmed |
--material 可重复，格式 MAT:QTY 或 MAT:QTY:YYYY-MM-DD。--batch-number 为必输字段，最多14位。
preview 后直接 create。必须 preview → 输出确认摘要 → 用 question tool 询问用户 → 仅在获得明确确认后 → 单独调用 create --confirmed。preview 会生成一个新的一次性确认标识（写入 ~/.sap_sto_confirm_token.json）。create --confirmed 会立即消耗该标识——无论创建成功还是失败，标识均作废。同一对话内，任何情况下都不能复用上一次的确认——再次创建必须重新运行 preview，再次用 question tool 询问用户确认后，才能调用 create --confirmed。create 执行前会调用 SAP 查询 SupplierRespSalesPersonName eq '<batch_number>'，若已有匹配 PO 则拒绝创建并提示重复的 PO 号。需要用户更换批次号后重新 preview。SupplierRespSalesPersonName（供应商销售员）字段，作为永久标记。--delivery-date，逐行在 MAT:QTY:DATE 里指定；两者都不传会被本地拦截。P001 P002 P003 P004 P005）与售后工厂（A001 A002）必须跨类型组合；同类组合本地直接拦截。P005/P001 → ZSTO_T1；其余合法组合 → ZSTO_T2。526x → C001；P001 → C002；F1xx → C003；F2xx → C004；F3xx → C005。Supplier 必须留空字符串，否则 SAP 会拒绝。lib/linux/ → Linux，lib/macos/ → macOS，lib/windows/ → Windows）；macOS 用户需自行从 SAP Service Marketplace 下载 JCo 并将 libsapjco3.jnilib（或 libsapjco3.dylib）放入 scripts/lib/java/lib/macos/。YYYY-MM-DD 再调用。缺少必要环境变量，立即引导用户在技能根目录（SKILL.md 所在目录）执行首次配置流程，不要继续尝试创建订单。preview 成功返回：
{
"requires_confirmation": true,
"confirmation_summary": "...",
"order_data_preview": { "doc_type": "ZSTO_T2", "supply_plant": "P002", "company_code": "C003", "items": [...] }
}
create 成功返回：
{
"success": true,
"po_number": "4500012345",
"delivery_created": false,
"delivery_number": null,
"order_data": { "doc_type": "ZSTO_T2", "supply_plant": "P002", "company_code": "C003", "items": [...] }
}
create 失败返回：
{
"success": false,
"messages": [{ "type": "E", "message": "..." }],
"suggest": "...",
"order_data": { ... }
}
标准创建流程：
preview --supply-plant P002 --receiving-plant A002 --material MAT-001:3 --delivery-date 2026-05-30 --batch-number BATCH001confirmation_summary（含批次号），停止，用 question tool 询问用户是否确认create --supply-plant P002 --receiving-plant A002 --material MAT-001:3 --delivery-date 2026-05-30 --batch-number BATCH001 --confirmed### ✅ STO 订单创建成功 + 订单抬头表格 + 物料明细表格，采购订单号高亮 **_PO号_**### ❌ STO 订单创建失败 + 错误明细表格 + 可执行建议查看工厂列表：plants → 获取所有可用工厂代码，再做 preview/create
多物料：--material MAT1:QTY1:DATE1 --material MAT2:QTY2:DATE2（逐行交期），或统一用 --delivery-date DATE（整单交期）
首次配置（环境变量缺失时）：
cp .env.example .env（Windows：copy .env.example .env）.env，填入必填项：SAP_URL、SAP_ASHOST、SAP_SYSNR、SAP_CLIENT、SAP_USER、SAP_PASSWORDpreview 命令