文档中心 > API类目 > 子账号管理

taobao.subuser.fullinfo.get (获取指定账户子账号的详细信息)

获取指定账户子账号的详细信息,其中包括子账号的账号信息以及员工、部门、职务信息(只能通过主账号登陆并查询属于该主账号下的某个子账号详细信息)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sub_nick String 可选 商家测试账号:测试01 子账号用户名(传参中sub_id和sub_nick至少需要其中一个,若sub_id与sub_nick同时传入并且合法,那么sub_nick优先,以sub_nick查询子账号)
sub_id Number 可选 123456 子账号ID(传参中sub_id和sub_nick至少需要其中一个,若sub_id与sub_nick同时传入并且合法,那么sub_nick优先,以sub_nick查询子账号)
fields String 可选 subuser_email,user_email 传入所需要的参数信息(若不需要获取子账号或主账号的企业邮箱地址,则无需传入该参数;若需要获取子账号或主账号的企业邮箱地址,则需要传入fields;可选参数值为subuser_email和user_email,传入其他参数值均无效;两个参数都需要则以逗号隔开传入即可,例如:subuser_email,user_email)

响应参数

名称 类型 示例值 描述
sub_fullinfo SubUserFullInfo 子账号详细信息,其中包括账号基本信息、员工信息和部门职务信息
  • └ work_location
  • String
  • 杭州大厦
  • 工作地点
  • └ sex
  • Number
  • 1
  • 员工性别 1:男; 2:女
  • └ sub_id
  • Number
  • 123456
  • 子账号Id
  • └ employee_nickname
  • String
  • 小红
  • 员工花名
  • └ sub_status
  • Number
  • 1
  • 子账号当前状态:1正常,2卖家停用,3处罚冻结
  • └ department_id
  • Number
  • 2222222
  • 部门Id
  • └ duty_level
  • Number
  • 3
  • 职务等级
  • └ sub_dispatch_status
  • Boolean
  • true
  • 子账号是否参与分流 true:参与分流 false:未参与分流
  • └ user_email
  • String
  • xiaowang@tmall.com
  • 主账号企业邮箱
  • └ sub_owed_status
  • Boolean
  • true
  • 子账号是否已欠费 true:已欠费 false:未欠费
  • └ duty_name
  • String
  • 总裁
  • 职务名称
  • └ employee_name
  • String
  • 小张
  • 员工姓名
  • └ leader_id
  • Number
  • 123456
  • 直接上级的员工ID
  • └ employee_num
  • String
  • 111
  • 入职员工工号
  • └ parent_department
  • Number
  • 3333333
  • 父部门Id
  • └ duty_id
  • Number
  • 44444444
  • 职务Id
  • └ entry_date
  • Date
  • 2000-01-01 00:00:00
  • 员工入职时间
  • └ user_id
  • Number
  • 654321
  • 主账号Id
  • └ department_name
  • String
  • 运营部
  • 部门名称
  • └ employee_id
  • Number
  • 123456
  • 员工ID
  • └ sub_nick
  • String
  • zhangsan:no1
  • 子账号用户名
  • └ user_nick
  • String
  • zhangsan
  • 主账号用户名
  • └ office_phone
  • String
  • 0571-11234567
  • 办公电话
  • └ subuser_email
  • String
  • zhangsan@tmall.com
  • 子账号企业邮箱

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SubuserFullinfoGetRequest req = new SubuserFullinfoGetRequest();
req.setSubNick("商家测试账号:测试01");
req.setSubId(123456L);
req.setFields("subuser_email,user_email");
SubuserFullinfoGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<subuser_fullinfo_get_response>
    <sub_fullinfo>
        <work_location>杭州大厦</work_location>
        <sex>1</sex>
        <sub_id>123456</sub_id>
        <employee_nickname>小红</employee_nickname>
        <sub_status>1</sub_status>
        <department_id>2222222</department_id>
        <duty_level>3</duty_level>
        <sub_dispatch_status>true</sub_dispatch_status>
        <user_email>xiaowang@tmall.com</user_email>
        <sub_owed_status>true</sub_owed_status>
        <duty_name>总裁</duty_name>
        <employee_name>小张</employee_name>
        <leader_id>123456</leader_id>
        <employee_num>111</employee_num>
        <parent_department>3333333</parent_department>
        <duty_id>44444444</duty_id>
        <entry_date>2000-01-01 00:00:00</entry_date>
        <user_id>654321</user_id>
        <department_name>运营部</department_name>
        <employee_id>123456</employee_id>
        <sub_nick>zhangsan:no1</sub_nick>
        <user_nick>zhangsan</user_nick>
        <office_phone>0571-11234567</office_phone>
        <subuser_email>zhangsan@tmall.com</subuser_email>
    </sub_fullinfo>
</subuser_fullinfo_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.missing-parmeter:sub_nick or sub_id 参数sub_nick,sub_id必须传一个 请传入参数sub_nick或sub_id
isv.sub-id-not-exist:sub_user_do 提供的昵称不合法或系统中不存在该昵称的子账户 请传入正确的子账号id或子账号nick
isv.invalid-parameter:fileds 传入参数fileds包含非法字段 请传入正确的fields参数
isv.invalid-permission:no_permission 您无权查询或操作此用户或者您没有权限管理的权限 用对应的有权限管理的账号登陆
isv.mmp-query-subusers-service-error:system_error 系统异常 联系淘宝小二

API工具

如何获得此API

FAQ

返回
顶部