API文档

employee_query.php（员工查询）

¥标准

1.接口说明

1.1 接口描述：获取ERP的员工页面信息

1.2 适用版本：网页版

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

2.调用场景

2.1 举例说明：自研商城、SCM、SRM、财务系统、SAP等系统的对接

3.请求参数说明

3.1 请求地址

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

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	卖家账号, 由旺店通分配
接口账号	appkey	String	是	由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
时间戳	timestamp	int	是	北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值, 旺店通网页版API服务端允许请求最大时间误差为5min， date.timezone = Asia/Shanghai。
签名	sign	String	是	API输入参数签名结果，签名算法介绍单击这里

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
分页大小	page_size	int	10	否	每页返回的数据条数，输入值范围1~100，不传本参数输入值默认为30，使用举例单击这里
页号	page_no	int	10	否	不传值默认从0页开始
员工ID	employee_id			否
员工简称	shortname			否

4.响应参数

4.1公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	40	是	状态码:0表示成功,其他表示失败
分页大小	page_size	int	10	否	每页返回的数据条数，输入值范围1~1000，不传本参数输入值默认为1000，使用举例单击这里
页号	page_no	int	10	否	不传值默认从0页开始
员工列表节点	userlist	data[ ]		是	员工详情数据节点

4.2业务响应参数

userlist

名称	字段	类型	长度	必须	描述	Y枚举	是否必须	默认值	是否可变更
员工id	employee_id	bigint(20)	20				是		否
员工编号	employee_no	string	64				是		是
状态	status	int			0：使用中 1：已停用 2：已删除		是	0	是
是否删除	deleted	int(1)	1		是否删除，0：否；1：是		是		是
最后修改时间	modified	datetime			YYYY-MM-dd HH:mm:ss 例如2024-01-01 12:00:00		是		是
创建时间	created	datetime			YYYY-MM-dd HH:mm:ss 例如2024-01-01 12:00:00		是		是

5.请求示例

PHP	<?php require_once '../WdtClient.php'; $c = new WdtClient(); $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/employee_query.php'; $c->putApiParam('employee_id', 1976); $c->putApiParam('shortname', 'admin'); $c->putApiParam('page_no', 0); $c->putApiParam('page_size', 10); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "",
    "userlist": [
        {
            "employee_id": "1976",
            "shortname": "admin",
            "fullname": "admin",
            "mobile_no": "176****1947",
            "deleted": false,
            "modified": "2025-04-25 11:53:02",
            "created": "2024-03-07 11:45:27",
            "status": 0,
            "user_no": ""
        }
    ],
    "total_count": 1
}

6.2 异常响应示例

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