API文档

warehouse_query.php（查询仓库）

¥标准

1.接口说明

1.1 接口描述：批量获取旺店通ERP内仓库档案信息

1.2 适用版本：网页版

1.3 全量获取：该接口是全量获取数据或按照warehouse_no获取，无法按照时间段增量获取数据。

2.调用场景

2.1 暂无

3.请求参数说明

3.1 请求地址

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

名称	字段	类型	长度	必须	描述
仓库id	warehouse_id	bigint		否	代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看(不支持一次推送多个仓库编码)
仓库类型	warehouse_type	int		否	0普通仓库 2分销仓 3委外仓库4自流转仓
分页大小	page_size	int	10	否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里
页号	page_no	int	10	否	不传值默认从0页开始
是否停用	is_disabled	tinyint		否	0未停用 1停用默认为0 返回未停用仓库

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	40	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
数据条数	total_count	int	10	否	只有page_no = 0 时，才返回的符合条件的数据总条数，用来分页
仓库详情数据节点	warehouses	data[ ]		是	仓库详情数据节点

4.2 业务响应参数

名称	字段	类型	长度	必须	描述
仓库id	warehouse_id	bigint(20)	20	是	代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
仓库编号	warehouse_no	varchar	40		跟warehouse_id相同的值
仓库名称	name	varchar	128	是
仓库类型	warehouse_type	int		是	0普通仓库 2分销仓 3委外仓库4自流转仓
仓库地址（省市区详细地址）	address	varchar	256
联系人名称	contact	varchar	128
联系人手机号	mobile	varchar	56
联系人固定电话	telno	varchar	56
备注	remark	varchar	512	否
省名称	province	varchar	40
市名称	city	varchar	40
区名称	district	varchar	40
是否停用	is_disabled	tinyint		是	0否 1是
最后修改时间	modified	timestemp		是	最后修改时间格式：yyyy-MM-dd HH:mm:ss
创建时间	created	timestemp		是	创建时间格式：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/warehouse_query.php'; $c->putApiParam('warehouse_id', 38); $c->putApiParam('page_no', 0); $c->putApiParam('page_size', 100); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "",
    "warehouses": [
        {
            "warehouse_id": "38",
            "warehouse_no": "38",
            "name": "滑雪场器材仓库1",
            "warehouse_type": 0,
            "address": "河北省秦皇岛市",
            "contact": "lily",
            "mobile": "17300000066",
            "telno": "000068",
            "remark": "五",
            "province": "河北省",
            "city": "秦皇岛市",
            "district": "北戴河区",
            "is_disabled": 0,
            "modified": "2026-03-16 17:13:10",
            "created": "2025-07-01 09:33:03"
        }
    ],
    "total_count": 1
}

6.2 异常响应示例

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

常用工具