采购单API

索引

• 采购单详情
• 标题
• 列表
• "促"字详情
• 图表详情
• 补货数量
• 最近15天销量数据
• 当前商品实库信息
• 批量修改补货数据
• 供应商采购单
• 列表

重要说明(所有响应数据遵从以下基本格式)

{"status": 100, "msg": "成功", "data": {}}

• status
  业务状态码,int
  100:成功;101:失败;102:错误;103:异常
• msg
  业务消息,Sting
  成功;失败;错误;异常;服务端自定义消息内容
• data
  数据内容,Object

访问根路径

目前暂定为http://192.168.10.215:8080/purchase

关于分页(分页查询响应数据必须包含以下格式内容)

{"pageBean":  {"pageSize": 10, "curPage": 1, "pages":  5, "total": 48}}

• pageSize
  每页显示数量,int,默认20,可以由客户端请求参数指定pageSize=?

• curPage
  当前页码,int,必须由客户端请求参数指定curPage=?;注意:服务端返回当前页码是经过计算纠正

• pages
  总页数,int

• total
  记录总数,int

特殊字符

{xxxx}为路径参数变量名

---

采购单详情

• 获取采购单详情标题

@author

陶银

基本信息

  请求类型:HTTP
  URL:/purchase/detail/title/{gspids}
  请求方式:GET
  数据类型:*
  响应类型:json

请求头

参数名称	是否必须	描述	默认值
无

路径参数

参数名称	是否必须	规则	描述	示例
gspids	是	\d+(,\d+)*	商品gspid逗号(,)拼接字符串	1234,2424

请求参数

参数名称	是否必须	类型	描述	示例
无

请求体

参数名称	是否必须	类型	描述	示例
无

响应数据

参数名称	类型	描述	示例
gid	long	商品gid
gspid	long	商品gspid
supplyState	short	订货单等待状态
sellWell	short	畅销状态,1:畅;2:手畅3:常;4:慢
credit	short	是否赊账,0:否;1:是
outStock	short	是否缺货,0:否;1:是
special	short	特殊采购标识(具体尚不明)
infomalChannels	short	进渠道
attentionImg	String	关注截图
title	String	标题

---

• 获取采购单详情列表

@author

陶银

基本信息

  请求类型:HTTP
  URL:/purchase/detail/list?pageSize=xx&curPage=xx&search=xx
  请求方式:GET
  数据类型:*
  响应类型:json

请求头

参数名称	是否必须	描述	默认值
无

路径参数

参数名称	是否必须	规则	描述	示例
无

请求参数

参数名称	是否必须	类型	描述	示例
search	是	String	查询条件json数据编码后字符串(详情见下表:search详情)	详细查询条件根据页面而定

search详情

参数名称	是否必须	类型	描述	示例
wid	是	int	仓库id
gid	否	long	商品编号
supid	是	long	供应商编号
masterUid	否	long	采购负责人
saleHot	否	int[]	畅销状态(1:畅,3:常,3:慢)
stockNum	否	short	是否为0库存(1:是,2:否)
attention	否	short	确认时间(4:未确认,1:明天:2:明天后)
stockOut	否	short	商家是否缺货(1:是,2:否)
dealType	否	short[]	已处理类型
attentionShow	否	short	有无关注点商品(1:有)
attentionShowBeginTime	否	long	关注商品开始时间
attentionShowEndTime	否	long	关注商品结束时间
passageShow	否	short	有无到货日期商品(1:有)
passageShowBeginTime	否	long	到货日期商品开始时间
passageShowEndTime	否	long	到货日期商品结束时间
isMark	否	short	是否有批注(1:有)
isMarkBeginTime	否	long	批注开始时间
isMarkEndTime	* 否*	long	批注结束时间
goodsAlert	否	short	有进货提醒商品(1:有)
isUnSaleable	否	short	是否滞销(1:是)
brandName	否	String	品牌名称
subject	否	String	商品名称
supName	否	String	供应商名称
supplierNo	否	String	商家货号
box	否	String	整箱数
stats	否	String	是否需补货(NEED_REPLENISH:需补货;其他:非需补货)
orderSale	是	String	销量排序
orderStock	否	String	库存排序
orderSupTitle	否	String	供应商标题排序
orderBrandId	否	String	品牌排序
purchaseAlert	否	String	进货提醒

请求体

参数名称	是否必须	类型	描述	示例
无

响应数据

参数名称	类型	描述	示例
gid	long	商品gid
gspid	long	商品gspid
clearNum	int	清仓数量
supid	int	供应商id
arrivalPeriod	int	到货周期
wid	int	仓库id
stockLock	int	锁库存
stockNow	int	虚库
stockNum	int	实库
stockSafe	int	安全库存
thisNum	int	本次保存对比值
oldThisNum	int	旧版保存对比值
oldInputNum	int	旧版input值
thisPrice	double	本次价格
supPrice	double	供应商价格
costPrice	double	花费价格
passage	long	到货时间
attention	long	缺货关注点时间
attentionType	short	缺货关注类型
selling	short	销售状态
stockMode	short	库存类型
stockModeTmp	short	原库存类型
salePrice	double	卖价
marketPrice	double	市场价
mark	String	标记
supName	String	供应商名称
sellingText	String	销售状态文本
stockModeText	Stirng	库存类型文本
stockModeTmpText	String	原库存类型文本
isUnSaleable	boolean	是否滞销
stateNumHtml	String	商品状态数量html文本

---

• 获取采购单促字详情

@author

夏银

基本信息

  请求类型:HTTP
  URL:/purchase/detail/promotion/{gspid};wid=?
  请求方式:GET
  数据类型:*
  响应类型:json

请求头

参数名称	是否必须	描述	默认值
无

路径参数

参数名称	是否必须	规则	描述	示例
gspid	是	(^[1-9] ([0-9])$)*	商品gspid	1234
wid	是	(^[1-9] ([0-9])$)*	仓库id	1

请求参数

参数名称	是否必须	类型	描述	示例
无

请求体

参数名称	是否必须	类型	描述	示例
无

响应数据

参数名称	类型	描述	示例
gspid	long	商品gspid	1234
title	String	标题	593;tiyan;体验中心二期
begtime	String	开始日期	1970-01-01 08:00
endtime	String	有效期天数(正常情况为int型数字字符串,特殊情况为"无限制")	171312332/无限制
nums	int	销量	1
beginDays	double	进行	30.00
avg	double	日均	0.01
hasDay	double	预测天数	7.00
prediction	double	预测销量	0.0
indexSales	Map	首页销售情况（详情见indexSales)
total	int	总销量	12
total_prediction	double	预测总销量	3.0

indexSales详情

参数名称	类型	描述	示例
nums_index	int	销量
beginDays_index	double	进行
avg_index	double	日均
hasDay_index	double	预测天数
prediction_index	double	预测销量

---

• 获取采购单图表详情

@author

夏银

基本信息

请求类型:HTTP

URL:/purchase/detail/salechart/{gspid};wid=?;saletype=?

请求方式:GET

数据类型:*

响应类型:json

请求头

参数名称	是否必须	描述	默认值
无

路径参数

参数名称	是否必须	规则	描述	示例
gspid	是	(^[1-9] ([0-9])$)*	商品gspid	1234
wid	是	(^[1-9] ([0-9])$)*	仓库id(1000：查询所有仓库；1：查询仓库id=1）	1000，1，2....
saletype	是	\d+	是否拆零(0:不含拆零;1:拆零)	0,1

请求参数

参数名称	是否必须	类型	描述	示例
无

请求体

参数名称	是否必须	类型	描述	示例
无

响应数据

参数名称	类型	描述	示例
gspid	long	商品gspid	1234
mon	String	年月	2014-12
mode	String	销售类型,1:正常售出；2：促销售出	1
num	int	销量	23

---

• 获取采购单补货数量

@author

夏银

基本信息

  请求类型:HTTP
  URL:/purchase/detail/prediction/{gspids};wid=?
  请求方式:GET
  数据类型:*
  响应类型:json

请求头

参数名称	是否必须	描述	默认值
无

路径参数

参数名称	是否必须	规则	描述	示例
gspids	是	(^[1-9] ([0-9])$)*	商品gspid逗号(,)拼接字符串	1234,2424
wid	是	(^[1-9] ([0-9])$)*	仓库id	1

请求参数

参数名称	是否必须	类型	描述	示例
无

请求体

参数名称	是否必须	类型	描述	示例
无

响应数据

参数名称	类型	描述	示例
gspid	long	商品gspid
value	String	补货数量，值可能是---,0,1...

---

• 获取最近15天销量数据

@author

吕潘锋

基本信息

  请求类型:HTTP
  URL:/purchase/detail/saledata/{gspids};wid=?
  请求方式:GET
  数据类型:*
  响应类型:json

请求头

参数名称	是否必须	描述	默认值
无

路径参数

参数名称	是否必须	规则	描述	示例
gspids	是	\d+(,\d+)*	商品gspid逗号(,)拼接字符串	1234,2424
wid	是	\\d+	仓库id	1

请求参数

参数名称	是否必须	类型	描述	示例
无

请求体

参数名称	是否必须	类型	描述	示例
无

响应数据

*当前请求体内容格式为列表(数组)

参数名称	类型	描述	示例
normal	String[][]	普通的销量
sales	String[][]	促销的销量
normalTotal	int	普通销量的总数
salesTotal	int	促销销量的总数
avgSalesNum	double	平均销量
gspid	long	gspid

---

• 获取当前商品实库信息

@author

吕潘锋

基本信息

  请求类型:HTTP
  URL:/purchase/detail/waregoodsinfo/{gspid}
  请求方式:GET
  数据类型:*
  响应类型:json

请求头

参数名称	是否必须	描述	默认值
无

路径参数

参数名称	是否必须	规则	描述	示例
gspid	是	\\d+	商品gspid	1234

请求参数

参数名称	是否必须	类型	描述	示例
无

请求体

参数名称	是否必须	类型	描述	示例
无

响应数据

*当前请求体内容格式为列表(数组)

参数名称	类型	描述	示例
guaranteePeriod	String	保质期
stockNum	long	当前库存量
leftDays	long	临期天数

---

• 批量修改补货数据

@author

吕潘锋

基本信息

  请求类型:HTTP
  URL:/purchase/detail/gsporderdata
  请求方式:PUT
  数据类型:*
  响应类型:json

请求头

参数名称	是否必须	描述	默认值
无

路径参数

参数名称	是否必须	规则	描述	示例
无

请求参数

参数名称	是否必须	类型	描述	示例
无

请求体

*当前请求体内容格式为列表(数组)

参数名称	是否必须	类型	描述	示例
gspid	是	long	gspid	123
num	是	long	采购数	23
price	是	double	价格	22.22

响应数据

参数名称	类型	描述	示例
无	String	信息更新成功

---

供应商采购单

• 供应商采购单列表

@author

陶银

基本信息

  请求类型:HTTP
  URL:/purchase/supplierorder/list?search=xx
  请求方式:GET
  数据类型:*
  响应类型:json

请求头

参数名称	是否必须	描述	默认值
无

路径参数

参数名称	是否必须	规则	描述	示例
无

请求参数

参数名称	是否必须	类型	描述	示例
search	是	String	查询条件json数据编码后字符串	详情见下表:search详情

search详情

参数名称	是否必须	类型	描述	示例
userid	否	long	补货员id(<=0时为全部补货员)
wid	是	int	仓库id
supcase	否	String	商家级别(为空时表示全部级别)

请求体

参数名称	是否必须	类型	描述	示例
无

响应数据

参数名称	类型	描述	示例
list	list	供应商采购单列表(详细见下表:list详情)
sum	map	汇总数据(详细见下表:sum详情)

list详情

参数名称	类型	描述	示例
supid	long	供应商id
name	String	供应商名称
quehuoQuickNum	int	缺货风险畅数量
quehuoQuickPrice	double	缺货风险畅金额
quehuoNormalNum	int	缺货风险常数量
quehuoNormalPrice	double	缺货风险常金额
quehuoSlowNum	int	缺货风险慢数量
quehuoSlowPrice	double	缺货风险慢金额
buhuoQuickNum	int	补货报警畅数量
buhuoQuickPrice	double	补货报警畅金额
buhuoNormalNum	int	补货报警常数量
buhuoNormalPrice	double	补货报警常金额
buhuoSlowNum	int	补货报警慢数量
buhuoSlowPrice	double	补货报警金额
quehuoForcusTotalNum	int	缺货关注点总数量
quehuoForcusQuickNum	int	缺货关注点畅数量
quehuoForcuseQuickNoPicNum	** int**	缺货关注点畅没有图片数量
quehuoForcusNormalNum	int	缺货关注点常数量
quehuoForcusNormalNoPicNum	int	缺货关注点常没有图片数量
purchaseRequirement	String	补货要求
planAlreadyNum	int	补货方案未处理数量
planAlreadyPrice	double	补货方案未处理金额
planTomorrowNum	int	补货方案明天处理数量
planTomorrowPrice	double	补货方案明天处理金额
planAftertomNum	int	补货方案后天处理数量
planAftertomPrice	double	补货方案后天处理金额
statusDiaoNum	int	补货状态调数量
statusDiaoPrice	double	补货状态调金额
statusZaiNum	int	补货状态在途数量
statusZaiPrice	double	补货状态在途金额
statusWaitNum	int	补货状态等数量
statusWaitPrice	double	补货状态等金额
checkPurchase	long	检查

sum详情

参数名称	类型	描述	示例
quehuoNumSum	int	缺货风险SKU总数
quehuoPriceSum	double	缺货风险金额总数
buhuoNumSum	int	补货预警SKU总数
buhuoPriceSum	double	补货预警金额总数
quickTotalSkuSum	int	畅总数
quickQuehuoForcusNumSum	int	畅缺货总数
quickSupNoSum	int	畅商家缺货总数
normalTotalSkuNum	int	常总数
normalQuehuoForcusNumSum	int	常缺货总数
normalSupNoSum	int	常商家缺货总数
statusDiaoNumSum	int	补货状态调总数
statusDiaoPriceSum	double	补货状态调金额总数
statusZaiNumSum	int	补货状态在总数
statusZaiPriceSum	int	补货状态在金额总数
statusWaitNumSum	int	补货状态等总数
statusWaitPriceSum	double	补货状态等金额总数

---