49 lines
1.7 KiB
Markdown
49 lines
1.7 KiB
Markdown
# 铱云易订货 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`
|