当前位置： API文档

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

¥标准   

1.接口说明

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

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

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

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

2.调用场景

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

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/stockin_order_query.php
正式环境https://openapi.huice.com/openapi/stockin_order_query.php

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
是购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号appkeyString
是本开放平台“自助对接”功能模块内自助申请，申请流程单击这里
时间戳timestampint
是

北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值

,旺店通企业版API服务端允许请求最大时间误差为5min，

date.timezone = Asia/Shanghai。

签名signString
是API输入参数签名结果，签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型长度必须描述
开始时间start_timedatetime
是制单开始时间，格式：yyyy-MM-dd HH:mm:ss
结束时间end_timedatetime
是制单结束时间，格式：yyyy-MM-dd HH:mm:ss
分页大小page_sizeint10否

每页返回的数据条数，输入值范围1~100，不传本参数

，输入值默认为40，使用举例单击这里

页号page_noint10否不传值默认从0页开始
单据类别order_typeint4否

单据类别 1采购入库  2调拨入库  4盘盈入库  5生产入库

 6其他入库  9委外入库  11直发入库  15纠错入库  16预入库

入库单状态statusint4否

入库单状态

(10, "待审核"),
(85, "已入库"),
(101, "已取消"),

仓库编号warehouse_novarchar40否

代表仓库所有属性的唯一编码，用于仓库区分，

ERP内支持自定义（ERP仓库界面设置），

用于获取指定仓库单据信息(不支持一次推送多个仓库编号)
上层单据编号src_order_novarchar40否上层单据编号，传该字段可以不传开始时间和结束时间
入库单号stockin_novarchar40否入库单号，传该字段可以不传开始时间和结束时间
外部API单号
outer_novarchar40否

外部系统入库单的唯一单据编号，传该字段可以不传开始时间和结束时

间（创建入库单时所传outer_no字段）

最后修改时间

modify_time_start 

datetime
是最后修改开始时间，格式：yyyy-MM-dd HH:mm:ss

最后修改时间

modify_time_end 

datetime
是最后修改结束时间，格式：yyyy-MM-dd HH:mm:ss

4.响应参数

   4.1 公共响应参数

名称字段类型长度必须描述
错误码codeint40是状态码:0表示成功,其他表示失败
错误描述messagevarchar255是错误描述
数据条数total_countint10否符合条件的数据条数，用来分页 当page_no = 0时返回
入库单列表节点stockin_listdata
否

响应参数的1级数据节点，包含当前页的入库单属性信息的数据节点

，节点下数据字段详见下述“stockin_list”列表

   4.2 业务响应参数

   stockin_list

名称字段类型长度必须描述
入库单主键ididint11是入库单主键id
入库单号stockin_novarchar40是系统入库单号，默认为RK开头
仓库IDwarehouse_idsmallint6是代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
入库类型src_order_typetinyint4是

1采购入库  2调拨入库  4盘盈入库  5生产入库

 6其他入库  9委外入库  11直发入库  15纠错入库  16预入库

入库idsrc_order_idint11是入库id
其他入库原因stockin_reasonint11是其他入库原因
物流公司logistics_idint11是物流公司
邮费分摊类型post_share_typeint11是邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊
经办人IDcreate_byint11是经办人id
最后修改时间modify_datedatetime

最后修改时间
仓库名称warehouse_namevarchar40是ERP内系统仓库名称
状态statustinyint4是

入库单状态

(10, "待审核"),
(85, "已入库"),
(101, "已取消"),

入库时间stockin_datedatetimedatetime是

入库时间，格式：YYYY-MM-DD HH:MM:SS  

 同modified含义相同，如需入库时间可取check_time字段值

创建时间create_datedatetimedatetime是创建时间，格式：yyyy-MM-dd HH:mm:ss
备注remarkvarchar255是备注
货品种类sku_type_countsmallint6是货品种类
入库原因stockin_reasonvarchar32是入库原因
货品数量sku_countdecimal(19,4)是货品数量
货款总额goods_amountdecimal(19,4)是货款总额
邮费post_amountdecimal(19,4)是邮费
源单号src_order_novarchar40是

上层单据编号，如果是采购入库就是采购单号，调拨入库就是调拨号，

以此类推

外部单号outer_novarchar40是外部单号
物流单号logistics_novarchar40否物流单号,
货品列表节点stock_in_order_detail_listdata[ ]
是

响应参数的2级数据节点，包含单个入库单所有货品属性信息的数据节点，

节点下数据字段详见下述“stockin_list”列表
最后修改人

modify_by

String

修改人

入库原因名称

stockin_reason_name

String

stockin_reason对应的名称

含税总货款goods_amount_taxdecimal

(实际含税单价*入库数量)

入库正品总数量  quality_sku_count   decimal

入库正品总数量
状态名称  status_name varchar

status名称

入库类型名称src_order_type_name varchar

src_order_type对应的名称

供应商名称provider_name varchar

供应商名称

采购单状态prepare_status int

5, "待审核"

7, "待财审"

10, "已审核"

11, "待推送"

12, "推送失败"

13, "已推送"

20, "部分入库"

30, "已入库"

99, "已取消"

正品数量 quality_numBigDeciml

正品数量
次品数量defect_numBigDeciml

次品数量
系统售后单号refund_no varchar

系统售后单号
售后类型refund_typeint


售后类型
售后原因refund_reason int

售后原因
快递公司  refund_logistics_namevarchar

快递公司  
快递单号refund_logistics_no varchar

快递单号

stock_in_order_detail_list

名称字段类型长度必须描述
入库单主键idstockin_idint11是入库单主键id
主键idint11是主键（与业务无关）
上层单据明细主键src_order_detail_idint11是上层单据明细主键
入库类型src_order_typetinyint4是

1采购入库, 2调拨入库, 4盘盈入库, 5生产入库, 6其他入库,

 7保修入库, 8纠错入库, 9初始化入库，10 预入库 11 JIT退货入库 

12 委外入库 

来源单idsrc_order_idint11
是来源单id
来源单号src_order_novarchar40是

上层单据编号，如果是采购入库就是采购单号，调拨入库就是调拨号，以此类推

条形码barcode
varchar

条形码
货品类别spu_typevarchar

货品类别
规格IDsku_idint11是规格ID
批次batch_idint11是批次
货位IDlocation_id


该字段值和stockin_position_id值一致
货位IDstockin_position_idint11是货位ID，入库时默认ID，后来做货位调拨不再修改
货区IDzone_id Long

货区ID
货区名称zone_namevarchar

货区名称
实际入库数量real_numdecimal(19,4)是入库数量
辅助单位unit_idsmallint6是辅助单位
预期入库数量numdecimal(19,4)是预期入库数量（基本单位数量，显示可自动转换成辅助单位）
含税单价purchase_pricedecimal(19,4)是原价
税率tariffdecimal

税率
采购发票是否为增值税发票is_vatint

默认为否 - 0
分摊邮费share_post_amountdecimal(19,4)
分摊邮费
SN数量sn_numint

SN数量
标签ID列表goods_labels data[]

标签ID列表
sn列表sn_listdata[]

sn列表
是否包含已经打印快递单的数据

print_flag

tinyint

0：未删除 1：已删除
创建时间create_datedatetime
是创建时间
商家编码sku_novarchar40是代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
参考成本价ref_cost_pricedecimal(19,4)是参考成本价
生产日期production_datedatetime
是生产日期，格式：yyyy-MM-dd HH:mm:ss
有效期天数validity_daysint11是有效期天数
有效期expire_datedatetime
是有效期，格式：yyyy-MM-dd HH:mm:ss
入库单价stockin_pricedecimal(19,4)是入库单价
入库金额stockin_amountdecimal(19,4)是入库金额
备注remarkvarchar255是入库单明细备注
货品名称spu_namevarchar255是货品名称
货品简称spu_short_name varchar

货品简称
货品编号spu_novarchar40是代表货品(spu)所有属性的编号，SPU概念介绍,单击这里
货品idspu_id int11
货品id
规格简称sku_short_name varchar

规格简称
规格名称sku_namevarchar100是规格名称
批次号batch_novarchar20是批次号
货位编号location_namevarchar40是货位编号
供应商名称provider_namevarchar
否供应商名称，默认不返回该字段，当order_type传为1返回
供应商编码provider_novarchar
否供应商编码，默认不返回该字段，当order_type传为1返回
供应商主键IDprovider_idvarchar
否供应商主键ID，默认不返回该字段，当order_type传为1返回
自定义属性1prop1varchar
是自定义属性1

自定义属性2

prop2varchar
是

自定义属性2

自定义属性3

prop3varchar
是

自定义属性3

自定义属性4prop4varchar
是自定义属性4
自定义属性5prop5varchar
是自定义属性5
自定义属性6prop6varchar
是自定义属性6
自定义金额batch_prop7decimal(19,4)
自定义金额
库存属性stock_typeint

库存属性
库存属性名称stock_type_textvarchar

库存属性名称
箱规box_sku_numdecimal(19,4)
箱规
重量weightdecimal(19,4)
重量
单位名称unit_namevarchar

单位名称
sku零售价pricedecimal (19,4)
sku零售价
sku批发价wholesale_pricedecimal(19,4)
sku批发价
sku图片image_urlvarchar

sku图片
spu图片spu_img_urlvarchar

spu图片
goods_labels 




标签主键

idLong

标签主键
标签名称

label_name

varchar

标签名称
标签类型 

label_type

varchar

标签类型 
商品ID goods_idLong

商品ID 

5.请求示例

PHP
<?php
	require_once '../WdtClient.php';
	$c = new WdtClient();
	$c->sid = '';
	$c->appkey = ''; 
	$c->appsecret = ''; 
	$c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/stockin_order_query.php';

	$c->putApiParam('start_time', '2026-03-22 16:00:40');
	$c->putApiParam('end_time', '2026-03-31 16:00:40');
	$c->putApiParam('order_type', 1); 
	$c->putApiParam('page_no', 0);
	$c->putApiParam('page_size', 1);
	
	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "total_count": 15,
    "stockin_list": [
        {
            "stock_in_order_detail_list": [
                {
                    "prop7": "",
                    "prop8": "",
                    "prop9": "",
                    "prop10": "",
                    "sku_id": "2774335886379188249",
                    "warehouse_id": 0,
                    "sku_sort_name": "",
                    "sku_no": "6920585703278",
                    "sku_name": "XXX",
                    "sku_short_name": "",
                    "barcode": "6920585703278",
                    "spu_id": "2774335886035255321",
                    "spu_name": "XXX",
                    "spu_short_name": "",
                    "spu_no": "1017050003",
                    "spu_modify_date": "2025-12-17 17:00:19",
                    "plat_spu_no": "",
                    "plat_sku_no": "",
                    "image_url": "",
                    "spu_img_url": "",
                    "outer_sku_no": "",
                    "ref_cost_price": "0",
                    "price": "0",
                    "retail_price": "0",
                    "wholesale_price": "0",
                    "validity_days": 0,
                    "unit_id": "0",
                    "unit_name": "",
                    "weight": "0",
                    "box_sku_num": 0,
                    "sku_remark": "",
                    "sku_delete_flag": false,
                    "brand_id": "0",
                    "brand_name": "",
                    "goods_category_id": "0",
                    "approval_number": "",
                    "prop1": "",
                    "prop2": "",
                    "prop3": "",
                    "prop4": "",
                    "prop5": "",
                    "prop6": "",
                    "stock_num": 0,
                    "quality_num": "2500",
                    "defect_num": "0",
                    "default_position_name": "",
                    "location_name": "",
                    "location_id": 0,
                    "stock_type": 1,
                    "stock_type_text": "正品",
                    "batch_id": 0,
                    "batch_no": "wzz0331001",
                    "production_date": "2026-01-07 00:00:00",
                    "expire_date": "2028-01-07 00:00:00",
                    "id": "2811999816073084949",
                    "stockin_id": "2811999816068890645",
                    "src_order_type": 0,
                    "src_order_id": 0,
                    "src_order_no": "",
                    "src_order_detail_id": "2811999564943327253",
                    "operate_type": 0,
                    "provider_id": "2001217658216296450",
                    "provider_name": "0100001-XXX公司",
                    "provider_no": "0100001",
                    "warehouse_no": "",
                    "spu_type": "",
                    "stockin_position_id": 0,
                    "zone_id": 0,
                    "zone_name": "",
                    "real_num": "2500",
                    "num": "2500",
                    "purchase_price": "0",
                    "stockin_price": "25",
                    "tariff": "0",
                    "is_vat": 0,
                    "remark": "",
                    "share_post_amount": "0",
                    "stockin_amount": "62500",
                    "sn_num": 0,
                    "goods_labels": null,
                    "sn_list": null,
                    "print_flag": 0,
                    "create_date": "",
                    "batch_prop7": 0
                }
            ],
            "id": "2811999816068890645",
            "stockin_no": "RK2603310004",
            "src_order_type": 1,
            "src_order_sub_type": "0",
            "src_order_sub_type_name": "",
            "src_order_id": "2811999563940888597",
            "src_order_no": "CG2603310501",
            "src_order_type_name": "采购入库",
            "outer_no": "",
            "status": 85,
            "status_name": "已入库",
            "sku_count": "2500",
            "quality_sku_count": "2500",
            "sku_type_count": 1,
            "goods_amount_tax": "0",
            "goods_amount": "62500",
            "warehouse_id": "227",
            "warehouse_name": "100501002-XXX仓库",
            "remark": "",
            "stockin_date": "2026-03-31 15:23:21",
            "stockin_reason": "0",
            "stockin_reason_name": "",
            "create_by": "4252",
            "create_date": "2026-03-31 15:23:21",
            "modify_by": "4252",
            "modify_date": "2026-03-31 15:23:28",
            "provider_name": "0100001-XXX公司",
            "prepare_status": 30,
            "logistics_no": "",
            "logistics_id": 0,
            "quality_num": 0,
            "defect_num": 0,
            "refund_no": "",
            "refund_type": 0,
            "refund_reason": 0,
            "refund_logistics_name": "",
            "refund_logistics_no": "",
            "post_amount": "0",
            "post_share_type": 0
        }
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 1020,
    "message": "系统异常，请稍后再试！",
    "total_count": null,
    "stockin_list": null
}






常用工具