API接口目录
suning.hopurch.account.get 单笔员工信息查询
¥免费

通过此接口可查询员工的员工编号、姓名、手机号、组织、角色相关信息。1.查询类型,必填,1表示用员工编码(工号)进行查询,2表示用子账户会员编码(苏宁易购会员编码)进行查询,3表示用手机号进行查询;2.员工编码(工号),必填其一;3.子账户会员编码,必填其一;4.手机号,必填其一;5.返回的信息包括:查询执行结果、查询执行结果说明、员工会员编码、账户名称、姓名、手机号、员工状态编码、在线状态编码、角色列表、角色ID、角色名称、组织列表、组织编码、组织名称、组织层级、父组织编码;6.子账户会员编码可在登录后通过passport获取当前用户的易购会员编码信息。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
paramsTypeStringY2查询类型,必填,1表示用员工编码(工号)进行查询,2表示用子账户会员编码(苏宁易购会员编码)进行查询,3表示用手机号进行查询
userAccountNoStringN80000001员工编码(工号),必填其一
memberNoStringN6108613553子账户会员编码,必填其一
响应参数
名称 类型 示例值 描述
memberNoString6108613553员工会员编码
custAccountNoStringYHWY_80000001_fasx账户名称
userNameString张三姓名
phoneNumString18651662345手机号
accountStatusString1员工状态编码
onlineStatusString2在线状态编码
roleListString
roleCodeString201607070001角色编码
roleNameString项目客服管家角色名称
orgInfoListString
orgCodeString2016072114224440000组织编码
orgNameString南京区域组织名称
orgLayerString2组织层级
parentOrgCodeString2016072114224440000父组织编码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <getAccount>
      <paramsType>2</paramsType>
      <userAccountNo>80000001</userAccountNo>
      <memberNo>6108613553</memberNo>
    </getAccount>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "getAccount": {
        "paramsType": "2",
        "userAccountNo": "80000001",
        "memberNo": "6108613553"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <getAccount>
      <roleList>
        <roleCode>201607070001</roleCode>
        <roleName>项目客服管家</roleName>
      </roleList>
      <orgInfoList>
        <orgCode>2016072114224440000</orgCode>
        <orgLayer>2</orgLayer>
        <parentOrgCode>2016072114224440000</parentOrgCode>
        <orgName>南京区域</orgName>
      </orgInfoList>
      <phoneNum>18651662345</phoneNum>
      <accountStatus>1</accountStatus>
      <userName>张三</userName>
      <custAccountNo>YHWY_80000001_fasx</custAccountNo>
      <onlineStatus>2</onlineStatus>
      <memberNo>6108613553</memberNo>
    </getAccount>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "getAccount": {
        "roleList": {
          "roleCode": "201607070001",
          "roleName": "项目客服管家"
        },
        "orgInfoList": {
          "orgCode": "2016072114224440000",
          "orgLayer": "2",
          "parentOrgCode": "2016072114224440000",
          "orgName": "南京区域"
        },
        "phoneNum": "18651662345",
        "accountStatus": "1",
        "userName": "张三",
        "custAccountNo": "YHWY_80000001_fasx",
        "onlineStatus": "2",
        "memberNo": "6108613553"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.hopurch.getaccount.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
isp.sys.service.unavailable.pop 服务不可用(系统异常) 请联系苏宁技术人员。
biz.hopurch.getaccount.invalid-biz:100 请求参数为空 检查必填项
biz.hopurch.getaccount.invalid-biz:101 请求参数格式错误 检查输入参数格式
biz.hopurch.getaccount.invalid-biz:102 请求编码参数值不存在 检查请求编码参数值
biz.hopurch.getaccount.invalid-biz:103 查询结果为空 核对数据
biz.hopurch.getaccount.invalid-biz:104 接口服务网络异常 请稍后再试
公共异常码
API工具
FAQ