Authored by bblu

更新

供应商接口服务定义
---------------------
#### 创建供应商页接口
## 创建供应商列表查询接口
> 接口名: '/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
... ...