API文档

operational_order_query.php（运营仓单据查询）

1.接口说明

1.1 接口描述：查询erp系统，运营仓单据数据。即仓储->运营仓管理->运营仓单据管理的数据信息

1.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 财务系统、SAP、数据分析等系统的对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/operational_order_query.php
正式环境	https://openapi.huice.com/openapi/operational_order_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 业务请求参数

名称	字段	类型	必须	描述
运营仓名称	warehouse_nam	string	否	运营仓名
单据号	order_no	string	否	单据号
类型	order_type	in	否	类型，枚举："11": "分配", "12": "归还", "13": "调拨"
实体仓库id	warehouse_id	long	否	代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
单据状态	status	int	否	单据状态，枚举："10": "待审核", "50": "已完成"
开始时间	start_time	datetime	是	按最后修改时间增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
结束时间	end_time	datetime	是	按最后修改时间增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
分页大小	page_size	int	否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里
页号	page_no	int	否	页号默认从0开始

4.响应参数

4.1 公共响应参数

名称	字段	类型	必须	描述
错误码	code	int	是	错误码，0成功
错误描述	message	varchar	是	错误描述
数据总条数	total_count	int	是	符合条件的数据总条数，当page_no=0时返回，用来分页
运营仓单据列表节点	data	data[]	是	响应参数的1级数据节点，包含当前页的运营仓及其明细的数据节点,节点下数据字段详见下述" data"和“detail_list”

4.2 业务响应参数

data

名称	字段	类型	长度	必须	描述
单据号	order_no	string		是	单据号
运营仓名称	op_warehouse_name	string		是	运营仓名称
类型	order_type	int		是	类型，枚举："11": "分配", "12": "归还", "13": "调拨"
单据状态	status	int		是	单据状态，枚举："10": "待审核", "50": "已完成"
仓库id	real_warehouse_id	long		是	实体仓库id，代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
仓库名称	real_warehouse_name	string		是	实体仓库名称
货品种类数	goods_type_count	int		是	货品种类数
货品数量	goods_count	decimal	(19,4)	是	货品数量
制单人姓名	create_by	string		是	制单人姓名
制单时间	create_date	datetime		是	制单时间
审核时间	check_time	datetime		是	审核时间
备注	remark	string		是	备注
运营单明细节点	detail_list	data[]			响应参数的2级数据节点，,节点下数据字段详见下述“detail_list”

detail_list

名称	字段	类型	长度	必须	描述
商品id	sku_id	int	11	是	商品id
货品简称	spu_short_name	int	11	是	货品简称
商家编码	sku_no	varchar	20	是	商家编码
库存数量	num	varchar	40	是	库存数量
可用库存	available_num	varchar	255	是	可用库存
公共可用库存	public_available_num	varchar	64	是	公共可用库
备注	remark	varchar	32	是	备注

5.响应示例

5.1 正常响应示例

JSON

{
	"code": "0",
	"message": "",
	"total_count": "7",
	"purchase_list": [{
		"apply_id": "118",
		"purchase_apply_no": "POA202005190001",
		"status": "30",
		"createtor_name": "wanxie2-test",
		"warehouse_no": "wanxie2-test",
		"name": "wanxie2-test",
		"real_num": "200.0000",
		"ref_num": "200.0000",
		"unref_num": "0.0000",
		"expected_time": "0000-00-00 00:00:00",
		"remark": "",
		"modified": "2020-05-19 11:57:04",
		"created": "2020-05-19 11:48:44",
		"details_list": [{
			"rec_id": "335",
			"apply_id": "118",
			"remark": "",
			"purchase_apply_no": "POA202005190001",
			"spec_name": "默认规格",
			"spec_no": "fapiao",
			"goods_name": "demlution test product",
			"brand_no": "BD201911060035",
			"brand_name": "无",
			"class_name": "无",
			"goods_no": "fapiao",
			"short_name": "dem product",
			"real_num": "100.0000",
			"ref_num": "100.0000",
			"provider_no": "",
			"provider_name": ""
		}, {
			"rec_id": "336",
			"apply_id": "118",
			"remark": "",
			"purchase_apply_no": "POA202005190001",
			"spec_name": "默认规格",
			"spec_no": "fapiao2",
			"goods_name": "demlution test product 2",
			"brand_no": "BD201911060035",
			"brand_name": "无",
			"class_name": "无",
			"goods_no": "fapiao2",
			"short_name": "dem test 2",
			"real_num": "100.0000",
			"ref_num": "100.0000",
			"provider_no": "",
			"provider_name": ""
		}]
	}]
}

5.2 异常响应示例

JSON	{ "code": 2180, "message": "start_time与end_time时间跨度不能超过最大范围30天" }