API文档

stockin_order_query.php（查询入库单管理）

¥标准

1.接口说明

1.1 接口描述：获取旺店通ERP的各种业务类型的入库单就其明细信息

1.2 适用版本：网页版

1.3注意事项：①获取的各业务类型的入库单信息，不包含上层单据内容。

（举例：采购入库单的上层单据是采购单，本接口能查采购入库单，不能查采购单信息）

②本接口退货入库类型单据不进行返回，获取退货入库类型的数据需调用查询退货入库单接口

2.调用场景

2.1 举例说明：自有商城接入ERP、金蝶接入、用友接入、SAP接入等

3.请求参数说明

3.1 请求地址

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

名称	字段	类型	长度	必须	描述
开始时间	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	10	否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里
页号	page_no	int	10	否	不传值默认从0页开始
单据类别	order_type	int	4	否	单据类别 1采购入库, 2调拨入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库
入库单状态	status	int	4	否	入库单状态 10已取消20编辑中25待价格确认30待审核32待推送33推送失败35委外待入库60待结算80已完成（按照状态查询时必须传原单据类别，如果未传status则默认查询80已完成单据）
仓库编号	warehouse_no	varchar	40	否	代表仓库所有属性的唯一编码，用于仓库区分， ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据信息(不支持一次推送多个仓库编号)
上层单据编号	src_order_no	varchar	40	否	上层单据编号，传该字段可以不传开始时间和结束时间
入库单号	stockin_no	varchar	40	否	入库单号，传该字段可以不传开始时间和结束时间
外部API单号	outer_no	varchar	40	否	外部系统入库单的唯一单据编号，传该字段可以不传开始时间和结束时间（创建入库单时所传outer_no字段）

4.响应参数

4.1 公共响应参数

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

4.2 业务响应参数

stockin_list

名称	字段	类型	长度	必须	描述
入库单主键id	id	int	11	是	入库单主键id
入库单号	stockin_no	varchar	40	是	系统入库单号，默认为RK开头
仓库ID	warehouse_id	smallint	6	是	仓库id
入库类型	src_order_type	tinyint	4	是	1采购入库, 2调拨入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 '
入库id	src_order_id	int	11	是	入库id
其他入库原因	stockin_reason	int	11	是	其他入库原因
物流公司	logistics_id	int	11	是	物流公司
邮费分摊类型	post_share_type	int	11	是	邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊
经办人ID	create_by	int	11	是	经办人id
最后修改时间	modify_date	datetime			最后修改时间
仓库名称	warehouse_name	varchar	40	是	ERP内系统仓库名称
状态	status	tinyint	4	是	10已取消20编辑中25待价格确认30待审核32待推送33推送失败35委外待入库60待结算80已完成
入库时间	stockin_date	datetime	datetime	是	入库时间，格式：YYYY-MM-DD HH:MM:SS 同modified含义相同，如需入库时间可取check_time字段值
创建时间	create_date	datetime	datetime	是	创建时间，格式：yyyy-MM-dd HH:mm:ss
备注	remark	varchar	255	是	备注
货品种类	sku_type_count	smallint	6	是	货品种类
入库原因	stockin_reason	varchar	32	是	入库原因
货品数量	sku_count	decimal	(19,4)	是	货品数量
货款总额	goods_amount	decimal	(19,4)	是	货款总额
邮费	post_amount	decimal	(19,4)	是	邮费
源单号	src_order_no	varchar	40	是	上层单据编号，如果是采购入库就是采购单号，调拨入库就是调拨号，以此类推
外部单号	outer_no	varchar	40	是	外部单号
物流单号	logistics_no	varchar	40	否	物流单号,
货品列表节点	stock_in_order_detail_list	data[ ]		是	响应参数的2级数据节点，包含单个入库单所有货品属性信息的数据节点，节点下数据字段详见下述“stockin_list”列表

stock_in_order_detail_list

名称	字段	类型	长度	必须	描述
入库单主键id	stockin_id	int	11	是	入库单主键id
主键	id	int	11	是	主键（与业务无关）
上层单据明细主键	src_order_detail_id	int	11	是	上层单据明细主键
入库类型	src_order_type	tinyint	4	是	1采购入库, 2调拨入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 '
规格ID	sku_id	int	11	是	规格ID
批次	batch_id	int	11	是	批次
货位ID	stockin_position_id	int	11	是	货位ID，入库时默认ID，后来做货位调拨不再修改
入库数量	real_num	decimal	(19,4)	是	入库数量
辅助单位	unit_id	smallint	6	是	辅助单位
预期入库数量	num	decimal	(19,4)	是	预期入库数量（基本单位数量，显示可自动转换成辅助单位）
创建时间	create_date	datetime		是	创建时间
商家编码	sku_no	varchar	40	是	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
参考成本价	ref_cost_price	decimal	(19,4)	是	参考成本价
生产日期	production_date	datetime		是	生产日期，格式：yyyy-MM-dd HH:mm:ss
有效期天数	validity_days	int	11	是	有效期天数
有效期	expire_date	datetime		是	有效期，格式：yyyy-MM-dd HH:mm:ss
原价	purchase_price	decimal	(19,4)	是	原价
税后单价	stockin_price	decimal	(19,4)	是	税后单价
税后金额	stockin_amount	decimal	(19,4)	是	税后金额
备注	remark	varchar	255	是	入库单备注
货品名称	spu_name	varchar	255	是	货品名称
货品编号	spu_no	varchar	40	是	代表货品(spu)所有属性的编号，SPU概念介绍,单击这里
规格名称	sku_name	varchar	100	是	规格名称
批次号	batch_no	varchar	20	是	批次号
货位编号	location_name	varchar	40	是	货位编号