API文档

setting.strategy.VirtualWarehouse.strategyAllocationQuery（虚拟仓库存分配策略查询)

¥标准

1.接口说明

1.1 接口描述：获取ERP虚拟仓库存分配策略查询页面的数据

1.2 适用版本：客户端 V1.6.0.6及以上版本

1.3 增量获取：

1.4 时间跨度：

1.5注意事项：该接口查询只能查询分配模式为货品的情况（mode=0）

2.调用场景

2.1 举例说明：自研商城、SCM、SRM、财务系统、SAP等系统的对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	http://47.92.239.46/openapi
正式环境	http://wdt.wangdian.cn/openapi

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	卖家账号, 由旺店通分配
接口账号	key	String	是	由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
盐	salt	String	是	由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称	method	String	是	调用的接口名称
版本号	v	String	是	1.0
秒级时间戳	timestamp	Int	是	秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名	sign	String	是	签名
分页大小	page_size	Int	否	分页大小，分页查询必传
分页编号	page_no	Int	否	分页编号，分页查询必传，标准接口page_no从0开始
是否计算查询结果的总条数	calc_total	Int	否	是否计算查询结果的总条数, 需要计算则1, 否则填0

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
查询参数	params	Map<String, Object>		是	查询参数
分页	pager	Pager		是	分页

名称

字段

类型

长度

必须

描述

查询参数

params

Map<String, Object>

是

查询参数

分页

pager

Pager

是

分页

params

名称	字段	类型	长度	必须	描述
仓库编号	virtual_warehouse_no	String	40	否	虚拟仓仓库编号 (暂不支持批量) (如果一个规则有多个使用其中一个搜索会将这个策略搜索出来也会显示这个策略全部的虚拟仓)
商家编码	spec_no	String	80	否	商家编码（前缀）
货品编号	goods_no	String	40	否	货品编号（前缀）
规则编号	rule_no	String	40	否	规则编号（前缀）
规则名称	rule_name	String	40	否	规则名称（前缀）

pager

名称	字段	类型	长度	必须	描述
分页大小	page_size	Int	4	否	分页大小
页号	page_no	Int	4	否	从0开始

4.响应参数

返回值为一个Map<String, Object>

名称	字段	类型	必须	描述
状态码	status	Int	是	状态码,0表示正常
错误信息	message	String	是	无错误信息不返回
单据信息	data	Map<String, Object>	是	单据信息

名称

字段

类型

长度

必须

描述

状态码

status

Int

是

状态码,0表示正常

错误信息

message

String

是

无错误信息不返回

单据信息

data

Map<String, Object>

是

单据信息

data

名称	字段	类型	长度	必须	描述
数据	order_list	List<Map<String, Object>>		是	明细数据
总数	total_count	Int	11	是	查询条件总单据数

名称

字段

类型

长度

必须

描述

数据

order_list

List<Map<String, Object>>

是

明细数据

总数

total_count

Int

是

查询条件总单据数

order_list

名称	字段	类型	长度	必须	描述
规则编号	rule_no	String	40	是	规则编号
规则名称	rule_name	String	40	是	规则名称
虚拟仓	name	String		是	货品明细的虚拟仓
分配模式	mode	Int		是	此接口限制mode=0货品模式，其他模式不支持拉取
明细信息	detail_list	List<Map<String, Object>>		否	明细信息

detail_list

名称	字段	类型	长度	必须	描述
主键id	rec_id	Int	11	是	明细主键id (修改接口需要传入该字段)
商家编码	spec_no	String	80	是	商家编码
货品编号	goods_no	String	40	是	货品编号
货品名称	goods_name	String	255	是	货品名称
品牌名称	brand_name	String		是	品牌名称
规格码	spec_code	String	40	是	规格码
规格名称	spec_name	String	255	是	规格名称
虚拟仓编号	warehouse_no	String	40	是	虚拟仓编号
虚拟仓名称	warehouse_name	String	40	是	虚拟仓名称
实际分配数量	sum_final_num	Decimal(19,4)		是	实际分配数量
锁定库存	num	Decimal(19,4)		是	锁定库存
锁定比例	ratio	Decimal(19,4)		是	锁定比例
分配优先级	priority	Decimal(19,4)		是	分配优先级
总数量	purchase_num	Decimal(19,4)		是	总数量

5.请求示例

json格式请求报文	[ { "rule_name" : "hjce超量锁定005", "spec_no" : "hjt9", "goods_no" : "hjt9", "rule_no" : "hjclsd005", "virtual_warehouse_no" : "hj444" } ]
PHP
JAVA
C#

6.响应示例

6.1 正常响应示例

JSON

{
    "status": 0,
    "data": {
        "total_count": 1,
        "order_list": [
            {
                "mode": 0,
                "rule_name": "hjce超量锁定005",
                "detail_list": [
                    {
                        "rec_id": 2589,
                        "order_id": 228,
                        "spec_id": 8150,
                        "warehouse_id": 80,
                        "ratio": 0.2000,
                        "num": 1.0000,
                        "priority": 4,
                        "purchase_num": 5.0000,
                        "created": 1766384368000,
                        "spec_no": "hjt9",
                        "goods_no": "hjt9",
                        "goods_name": "屁u屁u屁u",
                        "brand_id": 18,
                        "spec_code": "hjt9hh",
                        "spec_name": "fanrenjing ",
                        "sum_final_num": 3.0000,
                        "warehouse_name": "hjde不是很强仓仓",
                        "warehouse_no": "hj444",
                        "brand_name": "kzy品牌"
                    }
                ],
                "name": "hjde不是很强仓仓,hjde强强强强强仓",
                "rule_no": "hjclsd005",
                "order_id": 228
            }
        ]
    }
}

6.2 异常响应示例

JSON