206 lines
3.3 KiB
Markdown
206 lines
3.3 KiB
Markdown
# 基础数据查询接口
|
||
|
||
## 1. 仓库列表
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/invoicing-aggregation/warehouses
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"totalCount": 11,
|
||
"currentPage": 1,
|
||
"pageSize": 20,
|
||
"totalPage": 1,
|
||
"items": [
|
||
{
|
||
"id": 2116753909958624,
|
||
"code": "00000001",
|
||
"name": "总部仓库",
|
||
"type": 1,
|
||
"status": 1,
|
||
"orgId": 3607084,
|
||
"orgName": "总部"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
**用途：** 查询仓库列表，取 `items[].id` 作为 `warehouseId`（库存查询必填）
|
||
|
||
---
|
||
|
||
## 2. 员工列表
|
||
|
||
```
|
||
POST https://openapi.77ircloud.com/organization-aggregation/employees/search
|
||
```
|
||
|
||
**Header:** `access_token: {token}` + `Content-Type: application/json`
|
||
|
||
**Body：**
|
||
```json
|
||
{"pageNum": 1, "pageSize": 20}
|
||
```
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"items": [
|
||
{"id": 22652291, "name": "周总", "phone": "136xxx", "role": "MANAGER"}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 商品单位列表
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/product-aggregation/units
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{"id": 2116753910024416, "name": "个"},
|
||
{"id": 2116753910040800, "name": "箱"},
|
||
{"id": 2116753910057184, "name": "件"}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 4. 商品分类列表
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/product-aggregation/categories
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{"id": 2116753909967072, "name": "通用", "parentId": 0},
|
||
{"id": 2116766451460320, "name": "特价活动", "parentId": 0},
|
||
{"id": 2116766567037824, "name": "水产生品类", "parentId": 0}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 商品品牌列表
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/product-aggregation/brands
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{"id": 2116767916034272, "name": "意食客"},
|
||
{"id": 2116767991238144, "name": "其他品牌"}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 6. 省市区域列表
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/commondata/common/data/cities?parentId=0
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**参数：**
|
||
- `parentId`: 父级区域ID，传 `0` 获取省份列表
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{"id": 1, "cityId": 110100, "provinceId": 110000, "name": "北京市"},
|
||
{"id": 2, "cityId": 120100, "provinceId": 120000, "name": "天津市"}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 7. 物流公司列表
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/commondata/common/data/logistics-company
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{"id": 1, "name": "共速达", "code": "gongsuda", "phone": "400-111-0005"},
|
||
{"id": 2, "name": "邮政EMS速递", "code": "ems"}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 8. 价格等级列表
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/product-aggregation/level-prices
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**返回：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{"id": 0, "name": "基准订货价（市场价）", "levelIndex": 0},
|
||
{"id": 2116753910947264, "name": "尊宝配送价", "levelIndex": 1}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 9. 组织信息
|
||
|
||
```
|
||
GET https://openapi.77ircloud.com/organization-aggregation/organization/info
|
||
```
|
||
|
||
**Header:** `access_token: {token}`
|
||
|
||
**返回：** 组织基本信息
|