当前位置： API文档

stock_inout_sn_query.php（查询出入库序列号）

¥基础   ¥增值  ¥定制

1.接口说明

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

2.调用场景

2.1 举例说明：SAP、线下ERP、SRM、SCM等系统对接

3.请求参数说明

   3.1 请求地址

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

名称字段类型长度
必须描述
出入库单号order_novarchar
否出入库单号
出入库类型 order_typeint
否0 出库单 1 入库单，默认0
出入库单号批量查询order_no_listString[]
否根据出入库单号批量查询，批量查询单号时，必须指定出入库类型
分页大小page_sizeint
否每页返回条数
页号page_noint
否不传值默认从0页开始
业务单类型src_order_typeint
否

类型参照 -- 

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: 移位下架|

序列号snvarchar
否序列号
规格编码spec_novarchar
否商家编码

4.响应参数

   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint
是状态码:0表示成功,其他表示失败
错误描述messagevarchar
否错误描述
查询总数total_countint
否分页查询总数
数据dataList<StockSnSrcDetailVO>
否分页查询结果

  4.2 业务响应参数

       StockSnSrcDetailVO

名称字段类型长度
必须描述
出入库单号 order_novarchar40是出入库单号 
出入库明细idstock_inout_detail_idlong
是出入库明细主键id
业务单类型 src_order_typeint 11 是 源单号类型
类型参照 --
入库单：
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: 移位下架|
业务单号 src_order_novarchar40是源单号 
序列号 snvarchar40是序列号 
商家编码 spec_novarchar40是商家编码 
创建时间 createddatetime 
是 创建时间，格式：yyyy-MM-dd HH:mm:ss

5.请求示例

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

	$c->putApiParam('order_no', 'RK2603180008');
	$c->putApiParam('order_type', 1); //0 出库单 1 入库单，默认0
	$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": 1,
    "data": [
        {
            "id": "2807210582220996610",
            "sn": "SN2603180012",
            "sku_id": "2769302345274621977",
            "spec_no": "c9901244441229c1",
            "create_date": "2026-03-18T10:12:38",
            "order_id": "2807210481729667074",
            "order_no": "RK2603180008",
            "src_order_no": "00002603090002",
            "src_order_type": 6,
            "stock_inout_detail_id": "2807210481729668098"
        }
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 2220,
    "message": "page_size为正整数，请检查page_size是否为有效值"
}





常用工具