Authored by bblu

。。

1 -供应商接口服务定义  
2 ----------------------  
3 -  
4 -  
5 -  
6 -## 创建供应商列表查询接口  
7 -  
8 -> 接口名: '/supplier/supplier/getCreateSupplierList'  
9 -  
10 -### 入参  
11 -  
12 --------------------------  
13 -|属性名称|类型|例子|说明|  
14 -|--------|----|----|----|  
15 -|id|String|123|供应商ID|  
16 -|status|String|100|供应商状态(100:暂存,200:审核中,300:通过,900:驳回)|  
17 -|timeSort|String|asc|时间排序(asc:正序,desc:倒序)|  
18 ----------------------  
19 -  
20 -### 返回  
21 -  
22 -``` json  
23 -{  
24 - "code":200,  
25 - "message":"操作成功",  
26 - "data": {  
27 - "list": [  
28 - {  
29 - "id": "", 供应商ID  
30 - "supplierCode": "", 供应商编号  
31 - "supplierName": "", 供应商名称  
32 - "businessLicense": "", 营业执照电子版  
33 - "legalPerson": "", 法人姓名  
34 - "linkman": "", 联系人姓名  
35 - "phone": "", 联系人电话  
36 - "fax": "", 传真  
37 - "email": "", 邮箱  
38 - "url": "", 网址  
39 - "taxCertificate": "", 税务登记证电子版  
40 - "bankName": "", 开户行  
41 - "bankAccount": "", 开户账号  
42 - "category": "", 供应商类别  
43 - "createTime": "", 创建时间  
44 - "updateTime": "", 更新时间  
45 - "static_p": "",  
46 - "isLock": "",  
47 - "foundTime": "", 成立时间  
48 - "beginOperateTime": "", 经营开始时间  
49 - "endOperateTime": "", 经营结束时间  
50 - "isFreeze": "", 是否冻结(Y:是,N:否)  
51 - "status": "", 状态(100:暂存,200:审核中,300:通过,900:驳回)  
52 - "operations": "", 最近操作(1:创建,2:编辑,3:冻结,4:解冻)  
53 - "registeredAddress": "", 注册地址  
54 - "registeredCapital": "", 注册资本  
55 - "businessLicensePic": "", 组织机构代码证  
56 - "businessRange": "", 经营范围  
57 - "legalIdentityCard": "", 法人身份证电子  
58 - "createPid": "", 创建人  
59 - "contactPhone": "", 公司联系电话  
60 - "contactAddress": "", 公司联系地址  
61 - "accountOpeningLicense": "", 开户许可证电子版  
62 - "taxpayerQualificationCertificate": "", 纳税人资格证明电子版  
63 - "industryLicense": "" 行业许可证电子版  
64 - }  
65 - ],  
66 - "page": 0,  
67 - "size": 50,  
68 - "total": 1000,  
69 - "totalPage":20  
70 - }  
71 -}  
72 -  
73 -```  
74 -  
75 -  
76 -## 供应商列表查询接口  
77 -  
78 -> 接口名: '/supplier/supplier/getManageSupplierList'  
79 -  
80 -### 入参  
81 -  
82 --------------------------  
83 -|属性名称|类型|例子|说明|  
84 -|--------|----|----|----|  
85 -|id|String|123|供应商ID|  
86 -|status|String|100|供应商状态(100:暂存,200:审核中,300:通过,900:驳回)|  
87 -|isFreeze|String|N|生效状态(N:已生效,Y:不生效)|  
88 ----------------------  
89 -  
90 -### 返回  
91 -  
92 -``` json  
93 -{  
94 - "code":200,  
95 - "message":"操作成功",  
96 - "data": {  
97 - "list": [  
98 - {  
99 - "id": "", 供应商ID  
100 - "supplierCode": "", 供应商编号  
101 - "supplierName": "", 供应商名称  
102 - "businessLicense": "", 营业执照电子版  
103 - "legalPerson": "", 法人姓名  
104 - "linkman": "", 联系人姓名  
105 - "phone": "", 联系人电话  
106 - "fax": "", 传真  
107 - "email": "", 邮箱  
108 - "url": "", 网址  
109 - "taxCertificate": "", 税务登记证电子版  
110 - "bankName": "", 开户行  
111 - "bankAccount": "", 开户账号  
112 - "category": "", 供应商类别  
113 - "createTime": "", 创建时间  
114 - "updateTime": "", 更新时间  
115 - "static_p": "",  
116 - "isLock": "",  
117 - "foundTime": "", 成立时间  
118 - "beginOperateTime": "", 经营开始时间  
119 - "endOperateTime": "", 经营结束时间  
120 - "isFreeze": "", 是否冻结(Y:是,N:否)  
121 - "status": "", 状态(100:暂存,200:审核中,300:通过,900:驳回)  
122 - "operations": "", 最近操作(1:创建,2:编辑,3:冻结,4:解冻)  
123 - "registeredAddress": "", 注册地址  
124 - "registeredCapital": "", 注册资本  
125 - "businessLicensePic": "", 组织机构代码证  
126 - "businessRange": "", 经营范围  
127 - "legalIdentityCard": "", 法人身份证电子  
128 - "createPid": "", 创建人  
129 - "contactPhone": "", 公司联系电话  
130 - "contactAddress": "", 公司联系地址  
131 - "accountOpeningLicense": "", 开户许可证电子版  
132 - "taxpayerQualificationCertificate": "", 纳税人资格证明电子版  
133 - "industryLicense": "" 行业许可证电子版  
134 - }  
135 - ],  
136 - "page": 0,  
137 - "size": 50,  
138 - "total": 1000,  
139 - "totalPage":20  
140 - }  
141 -}  
142 -  
143 -```  
144 -  
145 -  
146 -## 审核供应商列表查询接口  
147 -  
148 -> 接口名: '/supplier/supplier/getAuditSupplierList'  
149 -  
150 -### 入参  
151 -  
152 --------------------------  
153 -|属性名称|类型|例子|说明|  
154 -|--------|----|----|----|  
155 -|id|String|123|供应商ID|  
156 ----------------------  
157 -  
158 -### 返回  
159 -  
160 -``` json  
161 -{  
162 - "code":200,  
163 - "message":"操作成功",  
164 - "data": {  
165 - "list": [  
166 - {  
167 - "id": "", 供应商ID  
168 - "supplierCode": "", 供应商编号  
169 - "supplierName": "", 供应商名称  
170 - "businessLicense": "", 营业执照电子版  
171 - "legalPerson": "", 法人姓名  
172 - "linkman": "", 联系人姓名  
173 - "phone": "", 联系人电话  
174 - "fax": "", 传真  
175 - "email": "", 邮箱  
176 - "url": "", 网址  
177 - "taxCertificate": "", 税务登记证电子版  
178 - "bankName": "", 开户行  
179 - "bankAccount": "", 开户账号  
180 - "category": "", 供应商类别  
181 - "createTime": "", 创建时间  
182 - "updateTime": "", 更新时间  
183 - "static_p": "",  
184 - "isLock": "",  
185 - "foundTime": "", 成立时间  
186 - "beginOperateTime": "", 经营开始时间  
187 - "endOperateTime": "", 经营结束时间  
188 - "isFreeze": "", 是否冻结(Y:是,N:否)  
189 - "status": "", 状态(100:暂存,200:审核中,300:通过,900:驳回)  
190 - "operations": "", 最近操作(1:创建,2:编辑,3:冻结,4:解冻)  
191 - "registeredAddress": "", 注册地址  
192 - "registeredCapital": "", 注册资本  
193 - "businessLicensePic": "", 组织机构代码证  
194 - "businessRange": "", 经营范围  
195 - "legalIdentityCard": "", 法人身份证电子  
196 - "createPid": "", 创建人  
197 - "contactPhone": "", 公司联系电话  
198 - "contactAddress": "", 公司联系地址  
199 - "accountOpeningLicense": "", 开户许可证电子版  
200 - "taxpayerQualificationCertificate": "", 纳税人资格证明电子版  
201 - "industryLicense": "" 行业许可证电子版  
202 - }  
203 - ],  
204 - "page": 0,  
205 - "size": 50,  
206 - "total": 1000,  
207 - "totalPage":20  
208 - }  
209 -}  
210 -  
211 -```  
212 -  
213 -  
214 -## 获取供应商列表(id/name)接口  
215 -  
216 -> 接口名: '/supplier/supplier/getSupplierListByIdName'  
217 -  
218 -### 入参  
219 -  
220 --------------------------  
221 -|属性名称|类型|例子|说明|  
222 -|--------|----|----|----|  
223 -|idName|String|1054|供应商ID或供应商名称|  
224 ----------------------  
225 -  
226 -### 返回  
227 -  
228 -``` json  
229 -{  
230 - "code":200,  
231 - "message":"操作成功",  
232 - "data": [  
233 - {  
234 - "id": "",  
235 - "text":""  
236 - }  
237 - ]  
238 -  
239 -}  
240 -  
241 -```  
242 -  
243 -  
244 -## 获取供应商详情接口  
245 -  
246 -> 接口名: '/supplier/supplier/getSupplier'  
247 -  
248 -### 入参  
249 -  
250 --------------------------  
251 -|属性名称|类型|例子|说明|  
252 -|--------|----|----|----|  
253 -|id|String|1054|供应商ID|  
254 ----------------------  
255 -  
256 -### 返回  
257 -  
258 -``` json  
259 -{  
260 - "code":200,  
261 - "message":"操作成功",  
262 - "data": {  
263 - "id": "", 供应商ID  
264 - "supplierCode": "", 供应商编号  
265 - "supplierName": "", 供应商名称  
266 - "businessLicense": "", 营业执照电子版  
267 - "legalPerson": "", 法人姓名  
268 - "linkman": "", 联系人姓名  
269 - "phone": "", 联系人电话  
270 - "fax": "", 传真  
271 - "email": "", 邮箱  
272 - "url": "", 网址  
273 - "taxCertificate": "", 税务登记证电子版  
274 - "bankName": "", 开户行  
275 - "bankAccount": "", 开户账号  
276 - "category": "", 供应商类别  
277 - "createTime": "", 创建时间  
278 - "updateTime": "", 更新时间  
279 - "static_p": "",  
280 - "isLock": "",  
281 - "foundTime": "", 成立时间  
282 - "beginOperateTime": "", 经营开始时间  
283 - "endOperateTime": "", 经营结束时间  
284 - "isFreeze": "", 是否冻结(Y:是,N:否)  
285 - "status": "", 状态(100:暂存,200:审核中,300:通过,900:驳回)  
286 - "operations": "", 最近操作(1:创建,2:编辑,3:冻结,4:解冻)  
287 - "registeredAddress": "", 注册地址  
288 - "registeredCapital": "", 注册资本  
289 - "businessLicensePic": "", 组织机构代码证  
290 - "businessRange": "", 经营范围  
291 - "legalIdentityCard": "", 法人身份证电子  
292 - "createPid": "", 创建人  
293 - "contactPhone": "", 公司联系电话  
294 - "contactAddress": "", 公司联系地址  
295 - "accountOpeningLicense": "", 开户许可证电子版  
296 - "taxpayerQualificationCertificate": "", 纳税人资格证明电子版  
297 - "industryLicense": "" 行业许可证电子版  
298 - }  
299 -}  
300 -  
301 -```  
302 -  
303 -## 新增供应商接口  
304 -  
305 -> 接口名: '/supplier/supplier/addSupplier'  
306 -  
307 -### 入参  
308 -  
309 --------------------------  
310 -|属性名称|类型|例子|说明|  
311 -|--------|----|----|----|  
312 -|id|int|43|供应商ID|  
313 -|supplierCode|String|-|供应商编号|  
314 -|supplierName|String|-|供应商名称|  
315 -|businessLicense|String|-|营业执照电子版|  
316 -|legalPerson|String|张三|法人姓名|  
317 -|linkman|String|李四|联系人姓名|  
318 -|phone|String|-|联系人电话|  
319 -|fax|String|-|传真|  
320 -|email|String|-|邮箱|  
321 -|url|String|-|网址|  
322 -|taxCertificate|String|-|税务登记证电子版|  
323 -|bankName|String|-|开户行|  
324 -|bankAccount|String|-|开户账号|  
325 -|category|int|-|供应商类别|  
326 -|createTime|String|2011-10-12|创建时间|  
327 -|updateTime|String|2011-11-12|更新时间|  
328 -|static_p|int|-|-|  
329 -|isLock|int|-|-|  
330 -|foundTime|String|2001-10-10|成立时间|  
331 -|beginOperateTime|String|2001-12-21|经营开始时间|  
332 -|endOperateTime|String|2100-02-12|经营结束时间|  
333 -|isFreeze|String|N|是否冻结(Y:是,N:否)|  
334 -|status|int|200|状态(100:暂存,200:审核中,300:通过,900:驳回)|  
335 -|operations|int|1|最近操作(1:创建,2:编辑,3:冻结,4:解冻)|  
336 -|registeredAddress|String|-|注册地址|  
337 -|registeredCapital|String|5551166|注册资本|  
338 -|businessLicensePic|String|-|组织机构代码证|  
339 -|businessRange|String|-|经营范围|  
340 -|legalIdentityCard|String|-|法人身份证电子|  
341 -|createPid|int|43|创建人|  
342 -|contactPhone|String|-|公司联系电话|  
343 -|contactAddress|String|-|公司联系地址|  
344 -|accountOpeningLicenseid|String|-|开户许可证电子版|  
345 -|itaxpayerQualificationCertificated|String|-|纳税人资格证明电子版|  
346 -|industryLicense|String|-|行业许可证电子版|  
347 ----------------------  
348 -  
349 -### 返回  
350 -  
351 -``` json  
352 -{  
353 - "code":200,  
354 - "message":"新增成功"  
355 -}  
356 -  
357 -```  
358 -  
359 -  
360 -## 修改供应商接口  
361 -  
362 -> 接口名: '/supplier/supplier/updateSupplier'  
363 -  
364 -### 入参  
365 -  
366 --------------------------  
367 -|属性名称|类型|例子|说明|  
368 -|--------|----|----|----|  
369 -|id|int|43|供应商ID|  
370 -|supplierCode|String|-|供应商编号|  
371 -|supplierName|String|-|供应商名称|  
372 -|businessLicense|String|-|营业执照电子版|  
373 -|legalPerson|String|张三|法人姓名|  
374 -|linkman|String|李四|联系人姓名|  
375 -|phone|String|-|联系人电话|  
376 -|fax|String|-|传真|  
377 -|email|String|-|邮箱|  
378 -|url|String|-|网址|  
379 -|taxCertificate|String|-|税务登记证电子版|  
380 -|bankName|String|-|开户行|  
381 -|bankAccount|String|-|开户账号|  
382 -|category|int|-|供应商类别|  
383 -|createTime|String|2011-10-12|创建时间|  
384 -|updateTime|String|2011-11-12|更新时间|  
385 -|static_p|int|-|-|  
386 -|isLock|int|-|-|  
387 -|foundTime|String|2001-10-10|成立时间|  
388 -|beginOperateTime|String|2001-12-21|经营开始时间|  
389 -|endOperateTime|String|2100-02-12|经营结束时间|  
390 -|isFreeze|String|N|是否冻结(Y:是,N:否)|  
391 -|status|int|200|状态(100:暂存,200:审核中,300:通过,900:驳回)|  
392 -|operations|int|1|最近操作(1:创建,2:编辑,3:冻结,4:解冻)|  
393 -|registeredAddress|String|-|注册地址|  
394 -|registeredCapital|String|5551166|注册资本|  
395 -|businessLicensePic|String|-|组织机构代码证|  
396 -|businessRange|String|-|经营范围|  
397 -|legalIdentityCard|String|-|法人身份证电子|  
398 -|createPid|int|43|创建人|  
399 -|contactPhone|String|-|公司联系电话|  
400 -|contactAddress|String|-|公司联系地址|  
401 -|accountOpeningLicenseid|String|-|开户许可证电子版|  
402 -|itaxpayerQualificationCertificated|String|-|纳税人资格证明电子版|  
403 -|industryLicense|String|-|行业许可证电子版|  
404 ----------------------  
405 -  
406 -### 返回  
407 -  
408 -``` json  
409 -{  
410 - "code":200,  
411 - "message":"修改成功!"  
412 -}  
413 -  
414 -```