导入企业用户

支持接口批量导入企业员工信息到绿色公务企业管理后台,导入后台的企业员工在后台关联企业用车规则后,支持使用绿色公务APP叫车。

请求地址: /v2/common/importCompanyMembers

服务协议: HTTP/POST

Content-Type: application/x-www-form-urlencoded

请求参数:

参数名 类型 必选 说明
client_id string Y 申请的client_id
timestamp long Y 时间戳
sign string Y 参数签名
members string Y 员工信息数组的json串, 数量限制, 暂定50, 例如:[{"phone":"123","name":"abc"},{"phone":"456","name":"efg"}]

响应data参数:

参数名称 类型 必有 说明
successMembers string Y 导入成功的员工手机号列表
failMembers string Y 导入失败的员工手机号列表

结果示例:

​{
  "code": 200,
  "success": true,
  "data": 
        {
          "successMembers": ["1861111111","1861111111"],
          "failMembers": ["1861111111","1861111111"]
         }
}

批量导入企业用户

批量新增或更新员工信息/用车规则,该接口适用于支使用绿色公务APP叫车、免登企业H5叫车,单次最多处理50个员工 绿色公务APP叫车以phone为唯一标识 免登企业H5叫车以extUserId为唯一标识(API+H5用车进行员工创建时必传该字段)

请求地址: /v2/common/importCompanyMembersV2

服务协议: HTTP/POST

Content-Type: application/x-www-form-urlencoded

请求参数:

参数名 类型 必选 说明
client_id string Y 申请的client_id
timestamp long Y 时间戳
sign string Y 参数签名
member_list string Y 员工信息json列表,参数格式见下表

导入员工信息(member)参数

参数名称 类型 必选 说明
name string Y 姓名
phone string N 手机号(曹操企业版app使用方必传),如果 extUserId与phone都传入,以extUserId为准
extUserId string N 第三方用户ID(h5接入时必传),如果 extUserId与phone都传入,以extUserId为准
outEmpId string N 员工ID
deptName string N 部门名
cityCode string N 常驻城市(从2.1城市开通服务查询获取城市code),支持多个,最多5个 ,英文逗号分隔
ruleIds string N 规则ID:支持多个,同规则场景只支持传入1个规则 ,英文逗号分隔

响应data参数:

参数名称 类型 必有 说明
successMembers.phone string N 导入成功员工手机号
successMembers.extUserId string N 导入成功员工第三方用户Id
failMembers.phone string N 导入失败员工手机号
failMembers.extUserId string N 导入失败员工第三方用户Id
failMembers.failReason string N 导入失败原因

结果示例:

{
  "code": 200,
  "data": {
    "failMembers": [
      {
        "phone": "131abcdefgh",
        "extUserId": "",
        "failReason": "手机号格式不对!"
      }
    ],
    "successMembers": [
      {
        "phone": "138XXXXXXXX",
        "extUserId": "ext_user_0"
      }
    ]
  },
  "message": "成功",
}