API文档

wms.StockPd.queryStockPd（盘点单查询）

¥标准

1.接口说明

1.1 接口描述：获取ERP内盘点单信息

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

1.3 增量获取:

1.4 时间跨度：

1.5注意事项：【权限校验】：仓库权限

2.调用场景

2.1 举例说明：

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

是

分页

params

名称	字段	类型	长度	必须	描述
开始时间	start_time	String	40	是	开始时间，按照最后修改时间增量查询数据，yyyy-MM-dd HH:mm:ss格式
结束时间	end_time	String	40	是	结束时间，上同开始时间
仓库编号	warehouse_no	String	40	否	仓库编号
盘点单号	pd_no	String	20	否	系统盘点单编号，默认PD开头
商家编码	spec_no	String	40	否	商家编码
货品编号	goods_no	String	40	否	货品编号
状态	status	Int	4	否	不传默认获取全部 10：已取消 20：编辑中 30：待盘点 31：盘点中 33：部分盘点 35：待结算 40：已完成
制单人	employee_no	String	40	否	制单人（员工编号）

pager

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

名称

字段

类型

长度

必须

描述

分页大小

page_size

Int

否

分页大小

页号

page_no

Int

否

从0开始

4.响应参数

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

名称

字段

类型

长度

必须

描述

状态码

status

Int

状态码,0表示正常

错误信息

message

String

无错误信息不返回

响应正文数据

data

Map<String, Object>

响应正文数据

data

名称	字段	类型	长度	必须	描述
数据节点	pd_list	List<Map<String, Object>>		Y	响应数据节点
总数	total_count	Int	11	Y	总数

pd_list

名称	字段	类型	长度	必须	描述
盘点单id	rec_id	Int	11	是	盘点单id
盘点单号	pd_no	String	20	是	系统盘点单号，默认PD开头
仓库编号	warehouse_no	String	40	是	仓库编号
仓库id	warehouse_id	Int		是	仓库id
盘点方案	mode	Int	4	是	盘点方案 0：单品盘点 1：货位明细盘点 2：明细盘点 3：货位单品盘点
盘点单状态	status	Int	4	是	盘点单状态 10：已取消 20：编辑中 30：待盘点 31：盘点中 33：部分盘点 35：待结算 40：已完成
制单人	creator_no	String	40	是	制单人（员工编号）
操作员	operator_no	String	40	是	操作员（员工编号）
备注	remark	String	255	是	备注
修改时间	modified	Date	40	是	最后修改时间
创建时间	created	Date	40	是	创建时间

5.请求示例

Json格式请求报文

[
    {
        "start_time":"2023-1-1 00:00:00",
        "end_time":"2023-1-31 00:00:00"
    }
]

PHP

<?php  
header("Content-Type: text/html; charset=UTF-8");  
date_default_timezone_set("Asia/Shanghai");  

$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret")
  
$params = new stdClass();  
$params->start_time = '2023-1-1 00:00:00';  
$params->end_time = '2023-1-31 00:00:00';  
  
$data = $client->call("method: wms.StockPd.queryStockPd", $params);

6.响应示例

6.1 正常响应示例

JSON

{
    "status": 0,
    "data": {
        "pd_list": [{
            "mode": 2,
            "creator_no": "nff",
            "pd_no": "PD2023022108",
            "warehouse_no": "234234234",
            "created": "2023-02-21 14:59:27",
            "modified": "2023-02-21 14:59:27",
            "remark": "",
            "rec_id": 9650,
            "operator_no": "nff",
            "warehouse_id": 330,
            "status": 40
        }],
        "total_count": 1
    }
}

6.2 异常响应示例

JSON	{ "status": 100, "message": "invalid http status 502" }