|
|
供应商接口服务定义
|
|
|
---------------------
|
|
|
#### 创建供应商页接口
|
|
|
|
|
|
|
|
|
|
|
|
## 创建供应商列表查询接口
|
|
|
|
|
|
> 接口名: '/supplier/supplier/getCreateSupplierList'
|
|
|
|
|
|
##### 入参
|
|
|
### 入参
|
|
|
|
|
|
-------------------------
|
|
|
|属性名称|类型|例子|说明|
|
|
|
|--------|----|----|----|
|
|
|
|id|int|10|id|
|
|
|
|status|int|100|供应商状态(100:暂存,200:审核中,300:通过, 900: 驳回)|
|
|
|
|timeSort|string|asc,desc|排序(asc:正序, desc:倒序)|
|
|
|
#### 返回
|
|
|
|id|String|123|供应商ID|
|
|
|
|status|String|100|供应商状态(100:暂存,200:审核中,300:通过,900:驳回)|
|
|
|
|timeSort|String|asc|时间排序(asc:正序,desc:倒序)|
|
|
|
---------------------
|
|
|
|
|
|
### 返回
|
|
|
|
|
|
``` json
|
|
|
{
|
|
|
"code": 200,
|
|
|
"message": "请求成功",
|
|
|
"dade":[{
|
|
|
//id
|
|
|
"id":10,
|
|
|
//供应商名称
|
|
|
"supplierName":"南京新与力广告传媒",
|
|
|
// 更新时间
|
|
|
"updateTime":"2016-01-14 16:30:23",
|
|
|
// 供应商状态
|
|
|
"status":100,
|
|
|
// 是否冻结
|
|
|
"isFreeze":"Y",
|
|
|
// 最近操作
|
|
|
"operations":"1"
|
|
|
}]
|
|
|
"code":200,
|
|
|
"message":"操作成功",
|
|
|
"data": {
|
|
|
"list": [
|
|
|
{
|
|
|
"id": "", 供应商ID
|
|
|
"supplierCode": "", 供应商编号
|
|
|
"supplierName": "", 供应商名称
|
|
|
"businessLicense": "", 营业执照电子版
|
|
|
"legalPerson": "", 法人姓名
|
|
|
"linkman": "", 联系人姓名
|
|
|
"phone": "", 联系人电话
|
|
|
"fax": "", 传真
|
|
|
"email": "", 邮箱
|
|
|
"url": "", 网址
|
|
|
"taxCertificate": "", 税务登记证电子版
|
|
|
"bankName": "", 开户行
|
|
|
"bankAccount": "", 开户账号
|
|
|
"category": "", 供应商类别
|
|
|
"createTime": "", 创建时间
|
|
|
"updateTime": "", 更新时间
|
|
|
"static_p": "",
|
|
|
"isLock": "",
|
|
|
"foundTime": "", 成立时间
|
|
|
"beginOperateTime": "", 经营开始时间
|
|
|
"endOperateTime": "", 经营结束时间
|
|
|
"isFreeze": "", 是否冻结(Y:是,N:否)
|
|
|
"status": "", 状态(100:暂存,200:审核中,300:通过,900:驳回)
|
|
|
"operations": "", 最近操作(1:创建,2:编辑,3:冻结,4:解冻)
|
|
|
"registeredAddress": "", 注册地址
|
|
|
"registeredCapital": "", 注册资本
|
|
|
"businessLicensePic": "", 组织机构代码证
|
|
|
"businessRange": "", 经营范围
|
|
|
"legalIdentityCard": "", 法人身份证电子
|
|
|
"createPid": "", 创建人
|
|
|
"contactPhone": "", 公司联系电话
|
|
|
"contactAddress": "", 公司联系地址
|
|
|
"accountOpeningLicense": "", 开户许可证电子版
|
|
|
"taxpayerQualificationCertificate": "", 纳税人资格证明电子版
|
|
|
"industryLicense": "" 行业许可证电子版
|
|
|
}
|
|
|
],
|
|
|
"page": 0,
|
|
|
"size": 50,
|
|
|
"total": 1000,
|
|
|
"totalPage":20
|
|
|
}
|
|
|
}
|
|
|
|
|
|
```
|
|
|
#### 供应商列表页接口
|
|
|
|
|
|
|
|
|
## 供应商列表查询接口
|
|
|
|
|
|
> 接口名: '/supplier/supplier/getManageSupplierList'
|
|
|
|
|
|
##### 入参
|
|
|
### 入参
|
|
|
|
|
|
-------------------------
|
|
|
|属性名称|类型|例子|说明|
|
|
|
|--------|----|----|----|
|
|
|
|id|int|10|id|
|
|
|
|status|int|100|供应商状态(100:暂存,200:审核中,300:通过, 900: 驳回)|
|
|
|
|isFreeze|string|Y,N|生效状态(Y:已冻结, N:生效中)|
|
|
|
##### 返回
|
|
|
> 同创建供应商页接口
|
|
|
#### 供应商审核列表页接口
|
|
|
|id|String|123|供应商ID|
|
|
|
|status|String|100|供应商状态(100:暂存,200:审核中,300:通过,900:驳回)|
|
|
|
|isFreeze|String|N|生效状态(N:已生效,Y:不生效)|
|
|
|
---------------------
|
|
|
|
|
|
### 返回
|
|
|
|
|
|
``` json
|
|
|
{
|
|
|
"code":200,
|
|
|
"message":"操作成功",
|
|
|
"data": {
|
|
|
"list": [
|
|
|
{
|
|
|
"id": "", 供应商ID
|
|
|
"supplierCode": "", 供应商编号
|
|
|
"supplierName": "", 供应商名称
|
|
|
"businessLicense": "", 营业执照电子版
|
|
|
"legalPerson": "", 法人姓名
|
|
|
"linkman": "", 联系人姓名
|
|
|
"phone": "", 联系人电话
|
|
|
"fax": "", 传真
|
|
|
"email": "", 邮箱
|
|
|
"url": "", 网址
|
|
|
"taxCertificate": "", 税务登记证电子版
|
|
|
"bankName": "", 开户行
|
|
|
"bankAccount": "", 开户账号
|
|
|
"category": "", 供应商类别
|
|
|
"createTime": "", 创建时间
|
|
|
"updateTime": "", 更新时间
|
|
|
"static_p": "",
|
|
|
"isLock": "",
|
|
|
"foundTime": "", 成立时间
|
|
|
"beginOperateTime": "", 经营开始时间
|
|
|
"endOperateTime": "", 经营结束时间
|
|
|
"isFreeze": "", 是否冻结(Y:是,N:否)
|
|
|
"status": "", 状态(100:暂存,200:审核中,300:通过,900:驳回)
|
|
|
"operations": "", 最近操作(1:创建,2:编辑,3:冻结,4:解冻)
|
|
|
"registeredAddress": "", 注册地址
|
|
|
"registeredCapital": "", 注册资本
|
|
|
"businessLicensePic": "", 组织机构代码证
|
|
|
"businessRange": "", 经营范围
|
|
|
"legalIdentityCard": "", 法人身份证电子
|
|
|
"createPid": "", 创建人
|
|
|
"contactPhone": "", 公司联系电话
|
|
|
"contactAddress": "", 公司联系地址
|
|
|
"accountOpeningLicense": "", 开户许可证电子版
|
|
|
"taxpayerQualificationCertificate": "", 纳税人资格证明电子版
|
|
|
"industryLicense": "" 行业许可证电子版
|
|
|
}
|
|
|
],
|
|
|
"page": 0,
|
|
|
"size": 50,
|
|
|
"total": 1000,
|
|
|
"totalPage":20
|
|
|
}
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
## 审核供应商列表查询接口
|
|
|
|
|
|
> 接口名: '/supplier/supplier/getAuditSupplierList'
|
|
|
|
|
|
##### 入参
|
|
|
### 入参
|
|
|
|
|
|
-------------------------
|
|
|
|属性名称|类型|例子|说明|
|
|
|
|--------|----|----|----|
|
|
|
|id|int|10|id|
|
|
|
##### 返回
|
|
|
|id|String|123|供应商ID|
|
|
|
---------------------
|
|
|
|
|
|
> 同创建供应商页接口
|
|
|
### 返回
|
|
|
|
|
|
#### 供应商新增编辑接口
|
|
|
> 接口名: '/supplier/supplier/addSupplier'
|
|
|
##### 入参
|
|
|
``` json
|
|
|
{
|
|
|
"code":200,
|
|
|
"message":"操作成功",
|
|
|
"data": {
|
|
|
"list": [
|
|
|
{
|
|
|
"id": "", 供应商ID
|
|
|
"supplierCode": "", 供应商编号
|
|
|
"supplierName": "", 供应商名称
|
|
|
"businessLicense": "", 营业执照电子版
|
|
|
"legalPerson": "", 法人姓名
|
|
|
"linkman": "", 联系人姓名
|
|
|
"phone": "", 联系人电话
|
|
|
"fax": "", 传真
|
|
|
"email": "", 邮箱
|
|
|
"url": "", 网址
|
|
|
"taxCertificate": "", 税务登记证电子版
|
|
|
"bankName": "", 开户行
|
|
|
"bankAccount": "", 开户账号
|
|
|
"category": "", 供应商类别
|
|
|
"createTime": "", 创建时间
|
|
|
"updateTime": "", 更新时间
|
|
|
"static_p": "",
|
|
|
"isLock": "",
|
|
|
"foundTime": "", 成立时间
|
|
|
"beginOperateTime": "", 经营开始时间
|
|
|
"endOperateTime": "", 经营结束时间
|
|
|
"isFreeze": "", 是否冻结(Y:是,N:否)
|
|
|
"status": "", 状态(100:暂存,200:审核中,300:通过,900:驳回)
|
|
|
"operations": "", 最近操作(1:创建,2:编辑,3:冻结,4:解冻)
|
|
|
"registeredAddress": "", 注册地址
|
|
|
"registeredCapital": "", 注册资本
|
|
|
"businessLicensePic": "", 组织机构代码证
|
|
|
"businessRange": "", 经营范围
|
|
|
"legalIdentityCard": "", 法人身份证电子
|
|
|
"createPid": "", 创建人
|
|
|
"contactPhone": "", 公司联系电话
|
|
|
"contactAddress": "", 公司联系地址
|
|
|
"accountOpeningLicense": "", 开户许可证电子版
|
|
|
"taxpayerQualificationCertificate": "", 纳税人资格证明电子版
|
|
|
"industryLicense": "" 行业许可证电子版
|
|
|
}
|
|
|
],
|
|
|
"page": 0,
|
|
|
"size": 50,
|
|
|
"total": 1000,
|
|
|
"totalPage":20
|
|
|
}
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
## 获取供应商列表(id/name)接口
|
|
|
|
|
|
> 接口名: '/supplier/supplier/getSupplierListByIdName'
|
|
|
|
|
|
### 入参
|
|
|
|
|
|
-------------------------
|
|
|
|属性名称|类型|例子|说明|
|
|
|
|--------|----|----|----|
|
|
|
|status|int|100|供应商状态(100:暂存,200:提交审核)|
|
|
|
|supplierName|String|nike|供应商名称|
|
|
|
|supplierCode|String|123456|营业执照号|
|
|
|
|foundTime|Date|2012-12-12|成立日期|
|
|
|
|beginOperateTime|Date|2012-12-12|经营开始时间|
|
|
|
|endOperateTime|Date|2012-12-12|经营结束时间|
|
|
|
|registeredAddress|string|澳门|公司注册地址|
|
|
|
|legalPerson|string|张三|法人代表姓名|
|
|
|
|registeredCapital|string|nike|注册资本|
|
|
|
|contactPhone|string|nike|公司联系电话|
|
|
|
|contactAddress|string|xx省xx市|公司联系地址|
|
|
|
||||必填项,选填项不在其中|
|
|
|
|
|
|
##### 返回
|
|
|
|idName|String|1054|供应商ID或供应商名称|
|
|
|
---------------------
|
|
|
|
|
|
### 返回
|
|
|
|
|
|
``` json
|
|
|
{
|
|
|
"code": 200,
|
|
|
"message": "保存成功",
|
|
|
"code":200,
|
|
|
"message":"操作成功",
|
|
|
"data": [
|
|
|
{
|
|
|
"id": "",
|
|
|
"text":""
|
|
|
}
|
|
|
]
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
#### 供应商审核接口
|
|
|
> 接口名: '/supplier/supplier/updateSupplier'
|
|
|
|
|
|
##### 入参
|
|
|
## 获取供应商详情接口
|
|
|
|
|
|
> 接口名: '/supplier/supplier/getSupplier'
|
|
|
|
|
|
### 入参
|
|
|
|
|
|
-------------------------
|
|
|
|属性名称|类型|例子|说明|
|
|
|
|--------|----|----|----|
|
|
|
|id|int|10|供应商名称|
|
|
|
|status|int|100|供应商状态(100:暂存,200:审核中,300:通过, 900: 驳回)|
|
|
|
##### 返回
|
|
|
|id|String|1054|供应商ID|
|
|
|
---------------------
|
|
|
|
|
|
### 返回
|
|
|
|
|
|
``` json
|
|
|
{
|
|
|
"code": 200,
|
|
|
"message": "提交成功",
|
|
|
"code":200,
|
|
|
"message":"操作成功",
|
|
|
"data": {
|
|
|
"id": "", 供应商ID
|
|
|
"supplierCode": "", 供应商编号
|
|
|
"supplierName": "", 供应商名称
|
|
|
"businessLicense": "", 营业执照电子版
|
|
|
"legalPerson": "", 法人姓名
|
|
|
"linkman": "", 联系人姓名
|
|
|
"phone": "", 联系人电话
|
|
|
"fax": "", 传真
|
|
|
"email": "", 邮箱
|
|
|
"url": "", 网址
|
|
|
"taxCertificate": "", 税务登记证电子版
|
|
|
"bankName": "", 开户行
|
|
|
"bankAccount": "", 开户账号
|
|
|
"category": "", 供应商类别
|
|
|
"createTime": "", 创建时间
|
|
|
"updateTime": "", 更新时间
|
|
|
"static_p": "",
|
|
|
"isLock": "",
|
|
|
"foundTime": "", 成立时间
|
|
|
"beginOperateTime": "", 经营开始时间
|
|
|
"endOperateTime": "", 经营结束时间
|
|
|
"isFreeze": "", 是否冻结(Y:是,N:否)
|
|
|
"status": "", 状态(100:暂存,200:审核中,300:通过,900:驳回)
|
|
|
"operations": "", 最近操作(1:创建,2:编辑,3:冻结,4:解冻)
|
|
|
"registeredAddress": "", 注册地址
|
|
|
"registeredCapital": "", 注册资本
|
|
|
"businessLicensePic": "", 组织机构代码证
|
|
|
"businessRange": "", 经营范围
|
|
|
"legalIdentityCard": "", 法人身份证电子
|
|
|
"createPid": "", 创建人
|
|
|
"contactPhone": "", 公司联系电话
|
|
|
"contactAddress": "", 公司联系地址
|
|
|
"accountOpeningLicense": "", 开户许可证电子版
|
|
|
"taxpayerQualificationCertificate": "", 纳税人资格证明电子版
|
|
|
"industryLicense": "" 行业许可证电子版
|
|
|
}
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
#### 供应商冻结解冻接口
|
|
|
> 接口名: '/supplier/supplier/updateSupplier'
|
|
|
## 新增供应商接口
|
|
|
|
|
|
> 接口名: '/supplier/supplier/addSupplier'
|
|
|
|
|
|
### 入参
|
|
|
|
|
|
##### 入参
|
|
|
-------------------------
|
|
|
|属性名称|类型|例子|说明|
|
|
|
|--------|----|----|----|
|
|
|
|id|int|10|供应商名称|
|
|
|
|isFreeze|string|Y,N|生效状态(Y:已冻结, N:生效中)|
|
|
|
##### 返回
|
|
|
|id|int|43|供应商ID|
|
|
|
|supplierCode|String|-|供应商编号|
|
|
|
|supplierName|String|-|供应商名称|
|
|
|
|businessLicense|String|-|营业执照电子版|
|
|
|
|legalPerson|String|张三|法人姓名|
|
|
|
|linkman|String|李四|联系人姓名|
|
|
|
|phone|String|-|联系人电话|
|
|
|
|fax|String|-|传真|
|
|
|
|email|String|-|邮箱|
|
|
|
|url|String|-|网址|
|
|
|
|taxCertificate|String|-|税务登记证电子版|
|
|
|
|bankName|String|-|开户行|
|
|
|
|bankAccount|String|-|开户账号|
|
|
|
|category|int|-|供应商类别|
|
|
|
|createTime|String|2011-10-12|创建时间|
|
|
|
|updateTime|String|2011-11-12|更新时间|
|
|
|
|static_p|int|-|-|
|
|
|
|isLock|int|-|-|
|
|
|
|foundTime|String|2001-10-10|成立时间|
|
|
|
|beginOperateTime|String|2001-12-21|经营开始时间|
|
|
|
|endOperateTime|String|2100-02-12|经营结束时间|
|
|
|
|isFreeze|String|N|是否冻结(Y:是,N:否)|
|
|
|
|status|int|200|状态(100:暂存,200:审核中,300:通过,900:驳回)|
|
|
|
|operations|int|1|最近操作(1:创建,2:编辑,3:冻结,4:解冻)|
|
|
|
|registeredAddress|String|-|注册地址|
|
|
|
|registeredCapital|String|5551166|注册资本|
|
|
|
|businessLicensePic|String|-|组织机构代码证|
|
|
|
|businessRange|String|-|经营范围|
|
|
|
|legalIdentityCard|String|-|法人身份证电子|
|
|
|
|createPid|int|43|创建人|
|
|
|
|contactPhone|String|-|公司联系电话|
|
|
|
|contactAddress|String|-|公司联系地址|
|
|
|
|accountOpeningLicenseid|String|-|开户许可证电子版|
|
|
|
|itaxpayerQualificationCertificated|String|-|纳税人资格证明电子版|
|
|
|
|industryLicense|String|-|行业许可证电子版|
|
|
|
---------------------
|
|
|
|
|
|
### 返回
|
|
|
|
|
|
``` json
|
|
|
{
|
|
|
"code": 200,
|
|
|
"message": "修改成功",
|
|
|
"code":200,
|
|
|
"message":"新增成功"
|
|
|
}
|
|
|
|
|
|
```
|
|
|
##### 查看供应商接口
|
|
|
> 接口名: '/supplier/supplier/getSupplier'
|
|
|
|
|
|
##### 入参
|
|
|
|
|
|
## 修改供应商接口
|
|
|
|
|
|
> 接口名: '/supplier/supplier/updateSupplier'
|
|
|
|
|
|
### 入参
|
|
|
|
|
|
-------------------------
|
|
|
|属性名称|类型|例子|说明|
|
|
|
|--------|----|----|----|
|
|
|
|id|int|123|id|
|
|
|
|id|int|43|供应商ID|
|
|
|
|supplierCode|String|-|供应商编号|
|
|
|
|supplierName|String|-|供应商名称|
|
|
|
|businessLicense|String|-|营业执照电子版|
|
|
|
|legalPerson|String|张三|法人姓名|
|
|
|
|linkman|String|李四|联系人姓名|
|
|
|
|phone|String|-|联系人电话|
|
|
|
|fax|String|-|传真|
|
|
|
|email|String|-|邮箱|
|
|
|
|url|String|-|网址|
|
|
|
|taxCertificate|String|-|税务登记证电子版|
|
|
|
|bankName|String|-|开户行|
|
|
|
|bankAccount|String|-|开户账号|
|
|
|
|category|int|-|供应商类别|
|
|
|
|createTime|String|2011-10-12|创建时间|
|
|
|
|updateTime|String|2011-11-12|更新时间|
|
|
|
|static_p|int|-|-|
|
|
|
|isLock|int|-|-|
|
|
|
|foundTime|String|2001-10-10|成立时间|
|
|
|
|beginOperateTime|String|2001-12-21|经营开始时间|
|
|
|
|endOperateTime|String|2100-02-12|经营结束时间|
|
|
|
|isFreeze|String|N|是否冻结(Y:是,N:否)|
|
|
|
|status|int|200|状态(100:暂存,200:审核中,300:通过,900:驳回)|
|
|
|
|operations|int|1|最近操作(1:创建,2:编辑,3:冻结,4:解冻)|
|
|
|
|registeredAddress|String|-|注册地址|
|
|
|
|registeredCapital|String|5551166|注册资本|
|
|
|
|businessLicensePic|String|-|组织机构代码证|
|
|
|
|businessRange|String|-|经营范围|
|
|
|
|legalIdentityCard|String|-|法人身份证电子|
|
|
|
|createPid|int|43|创建人|
|
|
|
|contactPhone|String|-|公司联系电话|
|
|
|
|contactAddress|String|-|公司联系地址|
|
|
|
|accountOpeningLicenseid|String|-|开户许可证电子版|
|
|
|
|itaxpayerQualificationCertificated|String|-|纳税人资格证明电子版|
|
|
|
|industryLicense|String|-|行业许可证电子版|
|
|
|
---------------------
|
|
|
|
|
|
##### 返回
|
|
|
### 返回
|
|
|
|
|
|
``` json
|
|
|
{
|
|
|
//公司名称
|
|
|
"supplierName":"南京新与力广告传媒",
|
|
|
// 营业执照号
|
|
|
"supplierCode":"1234567890",
|
|
|
// 成立日期
|
|
|
"foundTime":"2015-1-1",
|
|
|
// 营业期限-start
|
|
|
"beginOperateTime":"2015-1-1",
|
|
|
// 营业期限-end
|
|
|
"endOperateTime":"2020-1-1",
|
|
|
// 注册所在地
|
|
|
"registeredAddress":"中华民国",
|
|
|
// 法人代表姓名
|
|
|
"legalPerson":"XXX",
|
|
|
// 法人身份证电子版
|
|
|
"legalIdentityCard":"https://www.baidu.com/img/baidu_jgylogo3.gif",
|
|
|
// 注册资本
|
|
|
"registeredCapital":"1W",
|
|
|
// 营业执照电子版
|
|
|
"":"https://www.baidu.com/img/baidu_jgylogo3.gif",
|
|
|
// 经营许可证
|
|
|
"":"https://www.baidu.com/img/baidu_jgylogo3.gif",
|
|
|
// 税务登记证
|
|
|
"":"https://www.baidu.com/img/baidu_jgylogo3.gif",
|
|
|
// 经营范围
|
|
|
"businessRange":"小吃",
|
|
|
// 公司联系电话
|
|
|
"contactPhone":"00100100",
|
|
|
// 公司联系地址
|
|
|
"contactAddress":"XX省XX市XXX街道10号",
|
|
|
// 联系人
|
|
|
"linkman":"XXX",
|
|
|
// 联系电话
|
|
|
"phone":"001001001001",
|
|
|
// 传真
|
|
|
"fax":"00100100",
|
|
|
// 邮件地址
|
|
|
"email":"XXX@qq.com",
|
|
|
// 网址
|
|
|
"url":"www.google.cn",
|
|
|
// 开户行
|
|
|
"bankName":"ICBC",
|
|
|
// 开户账号
|
|
|
"bankAccount":"001010001001"
|
|
|
"code":200,
|
|
|
"message":"修改成功!"
|
|
|
}
|
|
|
|
|
|
``` |
|
|
\ No newline at end of file |
...
|
...
|
|