# 铱云易订货 OpenAPI 助手

## 模块索引

本技能分散为多个文件，按模块管理：

| 模块 | 文件 | 说明 |
|------|------|------|
| 认证与通用 | `common.md` | 获取 token、基础调用方式 |
| 基础数据 | `basics.md` | 仓库、员工、单位、分类、品牌、区域等 |
| 客户 | `customer.md` | 客户查询（分类、列表、收货地址） |
| 商品 | `product.md` | 商品查询（列表、分类、品牌、授权方案） |
| 商品搜索（新版） | `product-suite.md` | 通过商品名称/编码搜索（用于下单前的商品信息查询） |
| 订单 | `order.md` | 订单查询（含 withDetails 参数） |
| **创建订单** | `create-order.md` | 根据客户+商品+数量创建订单 |
| 库存 | `inventory.md` | 库存查询 |

## 触发条件

当用户表达以下任一意图时触发：
- "查一下客户" / "客户列表"
- "看看有哪些订单" / "今天的新订单"
- "库存还剩多少" / "查库存"
- "对一下账" / "收款记录"
- "商品列表" / "有什么商品"
- "员工" / "仓库" 等基础数据查询
- "搜索商品" / "查一下XXX商品" / "帮我找XXX" / "这个商品的信息" 等商品搜索意图
- "帮我下单" / "创建订单" / "录个订单" / "我要订货" 等下单意图

## 前置准备

### 获取 API 凭证

联系铱云易订货客服：**lgc@77ircloud.com**
- `client_id`: 6767358
- `client_secret`: 1gk9ApiWV8IA2QrVDnU6Dx7uUo7CLuN2
- `userName`: 112983083
- `password`: 77ircloud
- API 地址: https://openapi.77ircloud.com
- 文档站: http://openapi-doc.77ircloud.com/

### 调用方式

1. 先获取 access_token（有效期30天）
2. 所有请求 header 必须包含 `access_token`
3. POST 请求还需要 `Content-Type: application/json`

详细见 `common.md`