open-api/mes/供应商/列出供应商.md

### 列出供应商（ListSupplier）

此接口用于获取供应商

---

### 基本信息

方法：POST

URL: http://localhost:8033/open/ListSupplier

---

### 请求

请求参数

| 参数名 | 类型 | 必填 | 说明 |
| :-- | :-- | :-- | :-- |
| profile | string | 是 | 厂区编码 |
| search | string | 否 | 供应商编码、名称模糊查询 |

示例 1：模糊查询供应商

```
{
	"data": {
		"profile": "测试",
		"search": "互利",
	}
}
```

---

### 响应

响应字段

| 字段 | 类型 |  说明 |
| :-- | :-- | :-- |
| supplierCode | string | 供应商编码 |
| descriptions | string | 供应商名称 |
| country | string | 国家 |
| region | string | 省市 |

查询成功时，响应如下：

```
{
    "clock": "2023-07-05 13:43:46.740",
    "status": "ok",
    "data": {
        "list": [
            {
                "supplierCode": "1002210180004606",
                "descriptions": "国网江苏省电力有限公司宿迁供电分公司",
                "country": "china",
                "region": "beijing",
            },
            {
                "supplierCode": "1002210180004613",
                "descriptions": "国网江苏省电力有限公司徐州供电分公司",
                "country": "china",
                "region": "beijing",
            },
            {
                "supplierCode": "1002210180004620",
                "descriptions": "国网江苏综合能源服务有限公司",
                "country": "china",
                "region": "beijing",
            },
            {
                "supplierCode": "1002210180012203",
                "descriptions": "国网江苏省电力有限公司徐州市铜山区供电分公司",
                "country": "china",
                "region": "beijing",
            }
        ]
    }
}
```

查询报错：

```
{
  "clock": "2023-06-25 20:00:00.000",
  "status": "exception",
  "message": "查询失败",
  "data": {}
}
```