当前位置： API文档

stock_detail_report_query.php（查询出入库明细表）

¥标准

1.接口说明

1.1 接口描述：获取旺店通ERP各种业务类型的出入库明细报表
1.2 适用版本：网页版


2.调用场景

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


3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/stock_detail_report_query.php.php
正式环境https://openapi.huice.com/openapi/stock_detail_report_query.php.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_timedata
是
按最后出入库时间增量获取数据,start_time作为开始时间，格式： YYYY-MM-DD HH:MM:SS
结束时间end_timedata
是
按最后出入库时间增量获取数据,end_time作为结束时间，格式： YYYY-MM-DD HH:MM:SS
分页大小page_sizeint
否
每页返回的数据条数
页号page_noint
否
不传值默认从0页开始
出入库类型列表inout_type_listint[]
否示例: [1,2,3] 类型参照 -- 1: 采购入库|2: 调拨入库|3: 退货入库|4: 盘盈入库|5: 生产入库|6: 其他入库|8: 委外仓入库|9: 委外入库|10: 委外盘盈入库|11: 直发入库|15: 纠错入库|16: 预入库|20: 移位上架|-1: 销售订单|-2: 调拨出库|-3: 采购退货出库|-4: 盘亏出库|-5: 生产出库|-6: 现款销售出库|-7: 其他出库|-8: 委外仓出库|-9: 委外出库|-10: 委外盘亏出库|-15: 纠错出库|-20: 移位下架|

4.响应参数


   4.1 公共响应参数


名称字段类型长度
必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误描述messagevarchar255否错误描述
数据条数total_countint11否只有page_no = 0 时才返回的符合条件的数据总条数，用来分页
数据dataList<StockReportVO>
否响应参数的1级数据节点，包含当前页的StockReportVO的数据节点,节点下数据字段详见下文

   4.2 业务响应参数

       StockReportVO

名称字段类型长度
必须描述
仓库idwarehouse_idLong
是代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
仓库名称warehouse_nameLong
是

货品名称spu_nameLong
是
货品简称spu_short_nameLong
是
货品编码spu_novarchar
是
规格名称sku_namevarchar
是
规格简称sku_short_namevarchar
是
商家编码（新）sku_novarchar
是
出入库类型in_out_typevarchar
是
源单IDsrc_idLong
是出入库主单ID
源单明细IDsrc_detail_idLong
是出入库明细ID
入库单号stockin_novarchar
是stockin_no和stockout_no只会有一个
出库单号stockout_novarchar
是stockin_no和stockout_no只会有一个
单号src_order_novarchar
是统一的单号
入库数量in_numdecimal(19,4)是in_num和out_num只会有一个
出库数量out_numdecimal(19,4)是in_num和out_num只会有一个
数量numdecimal(19,4)是统一的数量
出入库时间create_datedatetime
是
操作人create_byvarchar
是
成本价cost_pricedecimal
是
批次batch_novarchar
是
生产日期production_datedatetime
是
有效期expire_datedatetime
是
货位IDposition_idLong
是
货位编号position_novarchar
是
SKUIDsku_idLong
是
SPUIDspu_idLong
是
库存属性stock_typeint
是
业务单类型src_order_typeint11是源单号类型
类型参照 -- 
入库单：
1: 采购入库|2: 调拨入库|3: 退货入库|4: 盘盈入库|5: 生产入库|6: 其他入库|8: 委外仓入库|9: 委外入库|10: 委外盘盈入库|11: 直发入库|15: 纠错入库|16: 预入库|20: 移位上架

出库单：
1,98,99: 销售订单|2: 调拨出库|3: 采购退货出库|4: 盘亏出库|5: 生产出库|6: 现款销售出库|7: 其他出库|8: 委外仓出库|9: 委外出库|10: 委外盘亏出库|15: 纠错出库|20: 移位下架|


5.请求示例

PHP
<?php
	require_once("../WdtClient.php");
	$client = new WdtClient;
	$client->sid = '';
	$client->appkey = '';
	$client->appsecret = "";
	$client->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/stock_detail_report_query.php';
	 
	$client->putApiParam('start_time', '2026-03-22 10:00:00'); 
	$client->putApiParam('end_time', '2026-03-26 10:59:59');
	$client->putApiParam('page_no', 0);
	$client->putApiParam('page_size', 1);
	$client->putApiParam('inout_type_list', '[3]');  
   
 
	$response = $client->wdtOpenApi();
	var_dump($response);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "total_count": -1,
    "data": [
        {
            "prop1": "",
            "prop2": "",
            "prop3": "",
            "prop4": "",
            "prop5": "",
            "prop6": "",
            "prop7": "",
            "prop8": "",
            "prop9": "",
            "prop10": "",
            "sku_id": "2809736617546219530",
            "warehouse_id": "107",
            "sku_sort_name": "",
            "sku_no": "202603250930110001",
            "sku_name": "api-洋葱规格值",
            "sku_short_name": "",
            "barcode": "260325003",
            "spu_id": "2802198152277393421",
            "spu_name": "api-洋葱商品-勿动-复制",
            "spu_short_name": "",
            "spu_no": "2029034896470814722",
            "spu_modify_date": "2026-03-26 17:00:12",
            "plat_spu_no": "2029034896470814722",
            "plat_sku_no": "",
            "image_url": "",
            "spu_img_url": "",
            "outer_sku_no": "",
            "ref_cost_price": "1450",
            "price": "0.01",
            "retail_price": "0.01",
            "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": "",
            "warehouse_name": "01",
            "log_type": 1,
            "stock_type": 1,
            "src_order_type": 3,
            "in_out_type": "退货入库",
            "src_id": "2810112388194369541",
            "src_detail_id": "2810112388194370565",
            "src_order_no": "RK2603260001",
            "stockin_no": "RK2603260001",
            "stockout_no": null,
            "num": "2",
            "in_num": "2",
            "out_num": null,
            "create_date": "2026-03-26 10:23:22",
            "create_by": "3689",
            "create_name": "renmaolin-test",
            "expire_date": "9999-12-01T00:00:00",
            "production_date": "9999-12-01T00:00:00",
            "batch_no": "",
            "position_id": null,
            "position_no": "",
            "cost_price": "1450"
        }
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 1020,
    "message": "单独筛选出入库时间，时间跨度不可超过一个月",
    "total_count": 0,
    "data": null
}





常用工具