API文档

wms.stockout.Pack.search（装箱单查询)

¥定制

1.接口说明

1.1 接口描述：查询系统内非jit类型的装箱单

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

1.3 增量获取：支持

1.4 时间跨度：

1.5注意事项：

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

名称	字段	类型	必须	描述
开始时间	start_time	String	否	最后修改时间, yyyy-MM-dd HH:mm:ss格式当出库单号和物流单号未传的情况下，时间条件必传
结束时间	end_time	String	否	yyyy-MM-dd HH:mm:ss格式
单据类型	src_order_type	Byte	否	单据类型 1：销售出库 2：调拨出库 4：盘库出库 5：生产出库 14：采购退货出库 21：其它出库不传默认1
物流单号	logistics_no	String	否	物流单号
出库单号	stockout_no	String	否	出库单号
仓库编号	warehouse_no	String	否	仓库编号

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

名称	字段	类型	长度	必须	描述
装箱单唯一键	rec_id	Int	11	是	装箱单唯一键
装箱单号	order_no	String	40	是	装箱单号
状态	status	Byte	4	是	装箱单状态 10：未完成 15：延时发货 16：已发货 20：待结算 30：已完成
仓库编号	warehouse_no	String	40	是	仓库编号
出库单号	stockout_no	String	40	是	出库单号
源单据类型	src_order_type	Byte		是	源单据类型 1：销售出库 2：调拨出库 4：盘亏出库 5：生产出库 14：采购退货出库 21：其它出库
物流单号	logistics_no	String	50	是	物流单号
物流公司编号	logistics_company_no	String	20	是	ERP内手动维护的物流公司编号
重量	weight	Decimal(19,4)		是	称重重量
预估重量	calc_weight	Decimal(19,4)		是	预估重量
货品数量	goods_count	Decimal(19,4)		是	货品数量
货品种类数	goods_type_count	Int		是	货品种类数
打包员	packager_name	String	50	是	打包员
发货时间	consign_time	String		是	发货时间 yyyy-MM-dd HH:mm:ss格式
备注	remark	String	256	是	备注
最后修改时间	modified	String		是	最后修改时间 yyyy-MM-dd HH:mm:ss格式
创建时间	created	String		是	创建时间 yyyy-MM-dd HH:mm:ss格式
物流公司id	logistics_id	Int	11	是	物流公司id
仓库id	warehouse_id	Int	11	是	仓库id
打包员id	packager_id	Int	11	是	打包员id
明细信息	detail_list	List<Map<String, Object>>		是	明细数据

detail_list

名称	字段	类型	长度	必须	描述
明细唯一id	rec_id	Int	11	是	明细唯一id
装箱单唯一键	logistics_order_id	Int	11	是	装箱单唯一键
商家编码	spec_no	String	40	是	商家编码
单品id	spec_id	Int	11	是	单品id
规格名称	spec_name	String	100	是	规格名称
规格编码	spec_code	String	40	是	规格编码
条码	barcode	String	50	是	条码
残次品	defect	boolean	1	是	true：残次品 false：正品
数量	num	Decimal(19,4)		是	数量
货品编号	goods_no	String	40	是	货品编号
货品名称	goods_name	String	255	是	货品名称
批次号	batch_no	String	40	是	批次号
批次id	batch_id	Int	11	是	批次id
备注	remark	String	512	是	备注

5.请求示例

json格式请求报文	[ { "end_time": "2020-06-02 11:26:31", "start_time": "2020-05-12 11:00:00" } ]
PHP	<?php header("Content-Type: text/html; charset=UTF-8"); date_default_timezone_set("Asia/Shanghai"); require_once('wdtsdk.php'); $client = new WdtErpClient("url", "wdtapi3", "appkey", "secret"); $parMap = new stdClass(); $parMap->start_time = '2022-04-21 16:42:51'; $parMap->end_time = '2022-05-29 16:42:51'; $pager = new Pager(2, 0, true); try { $data = $client->pageCall("wms.stockout.Pack.search", $pager, $parMap); }catch(WdtErpException $e) { echo $e->getMessage(); } ?>
JAVA
C#

6.响应示例

6.1 正常响应示例

JSON

{
    "data": {
        "order_list": [
            {
                "calc_weight": 0.0065,
                "consign_time": "2022-04-27 16:42:51",
                "created": "2022-04-21 15:43:03",
                "detail_list": [
                    {
                        "barcode": "qq01",
                        "batch_id": 0,
                        "batch_no": "",
                        "defect": false,
                        "goods_name": "zxy的应用",
                        "goods_no": "zxydapp",
                        "logistics_order_id": 3441352,
                        "num": 1.0,
                        "rec_id": 377,
                        "remark": "",
                        "spec_code": "qq",
                        "spec_id": 4387,
                        "spec_name": "qq",
                        "spec_no": "qq"
                    }
                ],
                "goods_count": 1.0,
                "goods_type_count": 1,
                "logistics_company_no": "0914",
                "logistics_id": 62,
                "logistics_no": "ZS202204210059",
                "modified": "2022-04-27 16:42:51",
                "order_no": "LG22042174",
                "packager_id": 0,
                "packager_name": "系统",
                "rec_id": 3441352,
                "remark": "",
                "src_order_type": 1,
                "status": 20,
                "stockout_no": "CK2022042165",
                "warehouse_id": 314,
                "warehouse_no": "zxy-app",
                "weight": 1.2198
            }
        ],
        "total_count": 2
    },
    "status": 0
}

6.2 异常响应示例

JSON	{ "message": "您的查询时间过宽,查询时间不能大于30天", "status": 100 }