当前位置： API文档

shop.php（查询店铺）

    奇门接口url：wdt.shop.query

¥标准

1.接口说明

   1.1 接口描述：批量获取旺店通ERP内店铺档案信息
   1.2 适用版本：网页版
   1.3 全量获取：该接口是全量获取数据或按照shop_id获取，无法按照时间段增量获取数据。                 

2.调用场景

  2.1 暂无

3.请求参数说明

   3.1 请求地址

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

名称字段类型长度必须描述
店铺idshop_idint10否代表店铺所有属性的唯一id，用于店铺区分，在旺店通ERP【绑定店铺】界面查看
平台IDplatform_idsmallint6否平台ID详情介绍单击这里
平台ID（批量）platform_idsvarchar
否批量指定平台ID获取（多个平台ID之间用英文逗号隔开）
分页大小page_sizeint10否每页返回的数据条数，输入值范围1~100，不传本参数输入值默认为30，使用举例单击这里
页号page_noint10否不传值默认从0页开始
是否停用 is_disabledvarchar 
否 0未停用 1停用  不传默认为0

 4.响应参数


   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint40是状态码:0表示成功,其他表示失败
店铺列表节点shoplistdata[ ]
是店铺详情数据节点

   4.2 业务响应参数

shoplist

名称字段类型长度 必须描述
平台IDplatform_idsmallint6是平台ID详情介绍单击这里
子平台IDsub_platform_idtinyint4是子平台ID
店铺IDshop_idsmallint6是店铺列表主键，代表店铺所有属性的唯一id，用于店铺区分，在旺店通ERP【绑定店铺】界面查看
店铺编号shop_novarchar50是店铺的唯一编码，用于店铺区分，在旺店通ERP【绑定店铺】界面查看
店铺名称shop_namevarchar128是ERP店铺界面的店铺名称
平台授权账号IDaccount_idvarchar40是平台授权账号ID（所有平台返回为空值）
平台账号account_nickvarchar128是平台授权账号昵称（所有平台返回为空值）
授权状态 auth_statevarchar40 是授权状态，0未授权 1已授权 2授权失效  3授权停用 
是否启用推送 push_rds_idvarchar40 是是否启用推送 0不推送 其它值对应RDS服务器 
邮件emailvarchar 64 是邮件
最后修改时间modifieddatetime 11 是最后修改时间    格式：yyyy-MM-dd HH:mm:ss
创建时间 created datetime 11 是创建时间    格式：yyyy-MM-dd HH:mm:ss
店铺简称shop_short_namevarchar128否
是否停用 is_disabledbool1是false 否 true 是 true 标识已经停用了
主店铺IDmain_shop_idint
否只有小时达门店会有主店铺ID ，如果是小时达平台例如抖音小时达，有主店铺ID代表是子店铺
平台门店IDplatform_store_idvarchar64否只有小时达店铺会有， 表示平台的门店id，例如抖音小时达后台的门店Id
平台店铺名称platform_shop_namevarchar100否平台店铺名称
业务员

employee_name

varchar
否业务员


5.请求示例

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

	$c->putApiParam('shop_id', 332);
	$c->putApiParam('platform_id', 127);
	$c->putApiParam('is_disabled', 0); //0未停用 1停用。默认为0
	$c->putApiParam('page_no', 0);
	$c->putApiParam('page_size', 20);

	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "shoplist": [
        {
            "fenxiaoNickNo": "",
            "shop_id": "332",
            "shop_no": "2598ad47a5400000",
            "platform_id": 127,
            "sub_platform_id": 0,
            "shop_name": "renmaolin-test",
            "shop_short_name": "33",
            "pay_account_id": null,
            "auth_state": 1,
            "push_rds_id": null,
            "pay_auth_state": null,
            "account_id": "",
            "account_nick": "",
            "refresh_token": null,
            "auth_time": "2025-06-20 16:58:51",
            "expire_time": null,
            "re_expire_time": null,
            "contact": null,
            "country": null,
            "province": null,
            "city": null,
            "district": null,
            "address": null,
            "telno": null,
            "mobile": null,
            "zip": null,
            "email": null,
            "remark": null,
            "website": null,
            "prop1": "",
            "prop2": "",
            "group_id": null,
            "is_disabled": false,
            "delete_flag": false,
            "shop_priority": null,
            "modified": "2026-03-17 14:12:43",
            "created": "2025-06-20 16:58:51",
            "main_shop_id": null,
            "platform_store_id": null,
            "sort": 2,
            "platform_shop_name": "",
            "employee_name": null
        }
    ],
    "total_count": 1
}

   6.2 异常响应示例

JSON
{
    "code": 1020,
    "message": "系统异常"
}




常用工具