API文档

stat_stock_pd_detail_query.php（查询盘点盈亏统计）

1.接口说明

1.1 接口描述：获取盘点盈亏统计数据

1.2 适用版本：客户端 V2.4.8.2及以上版本

1.3 增量获取：按照旺店通ERP盘点时间增量获取数据，请求时输入start_time和end_time作为时间跨度的筛选条件。

1.4 时间跨度：start_time和end_time最大跨度为30天，开始时间和结束时间取值范围为闭区间取值，例如2018-11-01 00:00:00至2018-11-30 23:59:59，建议根据获取数据量的多少适当减小时间跨度。

2.调用场景

2.1 线下ERP、财务系统等系统对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://sandbox.wangdian.cn/openapi2/stat_stock_pd_detail_query.php
正式环境	https://api.wangdian.cn/openapi2/stat_stock_pd_detail_query.php

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号	appkey	String	是	本开放平台“自助对接”功能模块内自助申请，获取方式点击这里
时间戳	timestamp	int	是	北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名	sign	String	是	API输入参数签名结果，签名算法介绍单击这里

3.3 业务请求参数

名称	字段	类型	必须	描述
盘点单编号	pd_no	varchar	否	系统盘点单编号，默认PD开头
开始时间	start_time	datetime	否	按盘点时间增量查询数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
结束时间	end_time	datetime	否	按盘点时间增量查询数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
页号	page_no	int	否	页号，0为第一页，默认为0
分页大小	page_size	int	否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
数据条数	total_count	int	11	否	只有，page_no = 0 时才返回的符合条件的数据总条数，用来分页
盘点单列表节点	pd_list	data[ ]		否	响应参数的1级数据节点，包含当前页的盘点盈亏信息的数据节点，节点下数据字段详见下述“pd_list”列表

4.2 业务响应参数

pd_list

名称	字段	类型	长度	必须	描述
盘点单ID	pd_id	int	11	是	盘点单据主键
盘点单号	pd_no	varchar	20	是	系统盘点单编号，默认PD开头
主键	rec_id	varchar	20	是	主键
盘点人	fullname	varchar	40	是	盘点人
仓库	warehouse_no	varchar	40	是	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
盘点时间	created	datetime		是	盘点时间，格式：yyyy-MM-dd HH:mm:ss
货品编号	goods_no	varchar	40	是	货品编号
货品名称	goods_name	varchar	40	是	货品名称
规格码	spec_code	varchar	40	是	规格码
商家编码	spec_no	varchar	40	是	商家编码
规格名称	spec_name	varchar	40	是	规格名称
原始库存	old_num	decimal	(19,4)	是	原始库存
盘点数量	new_num	decimal	(19,4)	是	盘点数量
盈余数量	yk_num	decimal	(19,4)	是	盈余数量盘亏为负值，盘盈为正值
货位	position_no	varchar	40	是	货位
盈余金额	total_price	decimal	(19,4)	是	盈余金额
备注	remark	varchar	255	是	备注

5.请求示例

PHP	<?php require_once ('../WdtClient.php'); $c = new WdtClient(); $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; $c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/stat_stock_pd_detail_query.php'; $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA	package com.wangdian.api.stock; import java.io.IOException; import java.util.HashMap; import java.util.Map; import com.wangdian.api.WdtClient; public class StockPDOrderQuery { public static void main(String[] args) { // TODO Auto-generated method stub WdtClient client = new WdtClient("传入sid", "传入appkey", "传入appsecret", "传入url"); //测试环境sid、appkey、密钥请到旺店通开放平台-自助对接-申请测试环境内查看，测试环境url=https://sandbox.wangdian.cn/openapi2/ //调用正式环境时请将sid、appkey、appsecret切换为实际参数，参数在旺店通开放平台-自助对接-应用管理内应用状态为已上线的应用中查看，调用正式环境注意切换正式环境url=https://api.wangdian.cn/openapi2/ Map<String, String> params = new HashMap<String, String>(); params.put("start_time", "2018-12-01 00:00:00"); params.put("end_time", "2018-12-10 00:00:00"); try { String response = client.execute("stat_stock_pd_detail_query.php", params); System.out.println(response); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } } }
C#	using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using WdtSdk; namespace StockPdOrderQuery { class StockPdOrderQuery { static void Main(string[] args) { WdtClient client = new WdtClient(); client.sid = ""; client.appkey = ""; client.appsecret = ""; client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/stat_stock_pd_detail_query.php"; client.putParams("start_time", "2019-01-16 00:00:00"); client.putParams("end_time", "2019-01-17 12:00:00"); string result = client.wdtOpenapi(); Console.WriteLine(result); Console.ReadKey(); } } }
python	import WdtClient t = WdtClient.WdtClient('appkey', 'appsecret', 'sid', 'http://sandbox.wangdian.cn/openapi2/') params = {} params.update({"pd_no": ''}) params.update({"start_time": '2021-01-01 00:00:00'}) params.update({"end_time": '2021-01-01 00:59:59'}) params.update({"page_size": '40'}) params.update({"page_no": '0'}) response = t.execute("stat_stock_pd_detail_query.php", params) print(response)

6.响应示例

6.1 正常响应示例

JSON

{
	"code":0,
	"message":"",
	"total_count":"5",
	"pd_list":[
		{
			"rec_id":"8229064",
			"pd_id":"22402",
			"pd_no":"PD2020052105",
			"fullname":"xc2-test",
			"created":"2020-05-21 11:29:59",
			"warehouse_no":"xc2-test",
			"goods_no":"12435340",
			"goods_name":"\u888b\u5b50",
			"spec_code":"",
			"spec_no":"12435340",
			"remark":"",
			"spec_name":"\u767d\u8272",
			"old_num":"24.0000",
			"new_num":"44.0000",
			"yk_num":"20.0000",
			"position_no":"ZANCUN",
			"total_price":"0.0000"
		},
		{
			"rec_id":"8229063",
			"pd_id":"22401",
			"pd_no":"PD2020052104",
			"fullname":"xc2-test",
			"created":"2020-05-21 11:15:43",
			"warehouse_no":"xc2-test",
			"goods_no":"12435340",
			"goods_name":"\u888b\u5b50",
			"spec_code":"",
			"spec_no":"12435341",
			"remark":"",
			"spec_name":"\u9ed1\u8272",
			"old_num":"0.0000",
			"new_num":"45.0000",
			"yk_num":"45.0000",
			"position_no":"ZANCUN",
			"total_price":"0.0000"
		},
		{
			"rec_id":"8229062",
			"pd_id":"22400",
			"pd_no":"PD2020052103",
			"fullname":"xc2-test",
			"created":"2020-05-21 11:15:33",
			"warehouse_no":"xc2-test",
			"goods_no":"12435340",
			"goods_name":"\u888b\u5b50",
			"spec_code":"",
			"spec_no":"12435340",
			"remark":"",
			"spec_name":"\u767d\u8272",
			"old_num":"0.0000",
			"new_num":"24.0000",
			"yk_num":"24.0000",
			"position_no":"ZANCUN",
			"total_price":"0.0000"
		},
		{
			"rec_id":"8229061",
			"pd_id":"22399",
			"pd_no":"PD2020052102",
			"fullname":"wancaoyi2-test",
			"created":"2020-05-21 09:56:16",
			"warehouse_no":"wancaoyi2-test",
			"goods_no":"wcy001",
			"goods_name":"Q50860021",
			"spec_code":"",
			"spec_no":"Q50860021Y0501",
			"remark":"",
			"spec_name":"\u9ed8\u8ba4\u89c4\u683c",
			"old_num":"0.0000",
			"new_num":"11.0000",
			"yk_num":"11.0000",
			"position_no":"ZANCUN",
			"total_price":"0.0000"
		},
		{
			"rec_id":"8229060",
			"pd_id":"22398",
			"pd_no":"PD2020052101",
			"fullname":"wancaoyi2-test",
			"created":"2020-05-21 09:34:43",
			"warehouse_no":"wancaoyi2-test",
			"goods_no":"wcy001",
			"goods_name":"Q50860021",
			"spec_code":"",
			"spec_no":"Q50860021Y0500",
			"remark":"",
			"spec_name":"\u9ed8\u8ba4\u89c4\u683c",
			"old_num":"0.0000",
			"new_num":"1.0000",
			"yk_num":"1.0000",
			"position_no":"ZANCUN",
			"total_price":"0.0000"
		}
	]
}

6.2 异常响应示例

JSON	{"code":2160,"message":"start_time和end_time为空或不是有效的时间格式"}

常用工具

API测试工具错误码查询 SDK下载