ircloud-assistant/skills/irun-yidianhuo/create-order.md

创建订单

用户提供客户信息 + 商品信息（名称、单位、数量），自动完成订单创建。

触发条件

用户表达以下意图时触发：

• "帮我下单" / "创建订单" / "录个订单"
• "我要订货" / "订一批货"
• 提供商品名称 + 数量时（如"5件鸡肉"）

---

第一步：查询客户

用户可能提供：客户名称、客户编码

调用客户搜索接口：

POST https://openapi.77ircloud.com/organization-aggregation/customer/search
Header: access_token, Content-Type: application/json
Body: {"pageNum":1,"pageSize":10,"keyword":"客户名称或编码"}

返回结果中找到对应客户，记录 id（即 buyerId）。

注意：

• 如果客户不存在，返回错误并告知用户
• 如果搜索结果有多个，选择第一个（默认取第一个）

---

第二步：查询商品

用户提供：商品名称、单位名称（如"包"、"件"、"斤"、"瓶"）、购买数量

调用商品搜索接口（见 product-suite.md）：

GET https://suite.77ircloud.com/product-aggregation/v1/products?pageSize=30&currentPage=1&queryTag=true&queryInventories=true&loadSortingTag=true&loadSortingTagName=true&q={商品名称}
Header: authorization={jwt}, x-exclude-login-mutex=77ircloud

在返回结果中找对应商品，默认取第一个，记录：

• skuId → 下单用 productSku
• multiUnitId → 下单用 unitId
• unitName → 与用户提供的单位核对

如果商品有多单位（如"件"和"包"），根据用户提供的单位名称匹配对应的 multiUnitId。

---

第三步：计算金额

• salePrice = originalPrice = 商品的 basePrice（第一档价格）
• subtotal = salePrice × 购买数量
• productTotalAmount = 所有商品 subtotal 之和
• orderTotalAmount = productTotalAmount（无额外运费/优惠时）

---

第四步：组装订单参数

{
  "buyerId": "{客户ID}",
  "orderDetails": [{
    "productSku": "{skuId}",
    "productSpu": "{skuId}",   // 用 skuId 作为 spuId
    "purchaseNumbers": {购买数量},
    "unitId": "{multiUnitId}",
    "salePrice": {单价},
    "originalPrice": {单价},
    "saleRate": 100.0,
    "subtotal": {小计金额},
    "type": "NORMAL"
  }],
  "productTotalAmount": {商品总金额},
  "orderTotalAmount": {订单总金额},
  "productDiscountAmount": 0,
  "orderDiscountAmount": 0,
  "totalFreight": 0,
  "orderSource": "APP",
  "orderStatus": "ORDER_AUDIT_PENDING",
  "deliveryMethodId": 1
}

字段说明：

字段	默认值	说明
deliveryMethodId	1（到店自提）	可选，用户指定则用用户值
orderSource	APP	固定
orderStatus	ORDER_AUDIT_PENDING	固定
saleRate	100.0	固定
productDiscountAmount	0	固定
orderDiscountAmount	0	固定
totalFreight	0	固定

用户可能指定的额外参数：

• deliveryMethodId: 1=到店自提, 2=送货上门（需要客户有配送地址）

---

第五步：调用下单接口

POST https://openapi.77ircloud.com/order-aggregation/organizations/orders
Header: access_token, Content-Type: application/json
Body: 见上面

返回格式：

{
  "code": 200,
  "message": "操作成功",
  "data": 2390029347669600   // 这是订单ID
}

---

第六步：返回订单编号

下单接口只返回订单 ID，不返回订单编号。需要再查一次订单详情：

POST https://openapi.77ircloud.com/order-aggregation/organizations/orders/search
Body: {"pageNum":1,"pageSize":100,"withDetails":true}

在结果中用返回的订单 ID 找到对应订单，返回 orderCode。

---

完整流程示例

用户输入： "帮华誉供货链下 3 包嘉吉尚选霸王鸡肉条"

执行：

1. 客户搜索"华誉供货链" → buyerId: 2364948772653120（默认取第一个）
2. 商品搜索"嘉吉尚选霸王鸡肉条" → 默认取第一个结果：skuId: 2116793372668192, multiUnitId: 2116793372668193, basePrice: 18.9
3. 组装参数：purchaseNumbers=3, subtotal=56.7, productTotalAmount=56.7
4. 调用下单接口 → orderId: 2390029347669600
5. 查询订单详情 → orderCode: CA000000-260331-102428

返回： "订单创建成功！订单编号：CA000000-260331-102428"

---

注意事项

1. 用户输入可能是语音转文字，注意处理口语化表达（如"3件"="3件"、"5斤"="5斤"）
2. 单位匹配：商品接口返回 unitName，用户可能说"件"或"包"，需匹配
3. 商品多规格：用户未指定单位时，默认用第一个单位
4. 库存检查：创建订单前不强制检查库存，但可以查一下 availableAmount 告知用户
5. 下单失败常见原因：
   • 客户未配置配送方式（到店自提也需配置）→ 改用 deliveryMethodId=1
   • 必填字段缺失 → 检查 productSku, unitId, purchaseNumbers 等