员工同步 - 在途商旅

功能描述：此接口用于同步企业的员工数据至在途系统中，此接口通过员工编号或邮箱来作为员工的唯一标识。

注意：调用此接口时，如果员工的状态值小于0，则只会更新状态字段，不会更新其他字段的数据。
入参数据量不能大于100条，大小不能超过10M

限流说明：同一时刻最多处理100个用户的同步(如果单次请求携带100个用户数据，则只能并发1个请求；如果单次请求携带1个用户数据，则最多并发100个请求)，超过返回错误码：RATE_LIMITED

请求参数

Query 参数

access_token

string

必需

示例值:

Body 参数application/json

array of:

orgId

string

员工主属部门编码

必需

empCode

string

必需

员工编码，主键，企业内应保证唯一

<= 30 字符

status

enum<string>

必需

员工状态：1：正常；-10:冻结；-99：删除

<= 1 字符

枚举值:

1-10-99

fullname

string

姓名(全名)

可选

<= 50 字符

gender

string

可选

性别 0：男 1：女

<= 1 字符

title

string

职位/头衔名称

可选

<= 50 字符

rank

string

在途职级编码

可选

<= 50 字符

string

可选

邮箱，企业内应保证唯一

<= 50 字符

mobile

string

可选

手机号码，企业内应保证唯一；手机号所属国家编码表：https://apifox.com/apidoc/shared-dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-4740718

<= 11 字符

country

string

可选

国籍空值默认：中国大陆

<= 20 字符

lastName

string

英文姓

可选

<= 50 字符

firstName

string

英文名

可选

<= 50 字符

birthDay

string

可选

出生日期，格式:1998-05-01

orgs

object

可选

员工所属组织单位；非一人多岗时，不要传此对象

orgId

string

组织单位编码

必需

title

string

职位信息

可选

<= 50 字符

orgExpand

string

可选

员工编码，企业内应保证唯一

<= 30 字符

userCert

array [object {3}]

员工证件信息

可选

idType

string

必需

证件类型编码

{
"idType":"IDENTITY",
"idTypeName":"身份证"
},
{
"idType":"PASSPORT",
"idTypeName":"护照"
},
{
"idType":"SERVICE_PASSPORT",
"idTypeName":"因公护照"
},
{
"idType":"GANGAO",
"idTypeName":"港澳通行证"
},
{
"idType":"TAIWAN",
"idTypeName":"台湾通行证"
},
{
"idType":"JUNDUI",
"idTypeName":"军队证件"
},
{
"idType":"HAIYUAN",
"idTypeName":"海员证"
},
{
"idType":"TAIBAO",
"idTypeName":"台胞证"
},
{
"idType":"HUIXIANG",
"idTypeName":"回乡证"
}

idNumber

string

证件号码

必需

validDate

string

可选

有效期，示例:2018-05-01，类型为身份证(IDENTITY)时可不传。

extend1

string

可选

扩展字段，json 格式

corpCode

string

可选

法人信息：纳税人识别号或法人名称
在开启了法人信息来源于员工时数据方可同步到系统中

<= 50 字符

userExtension

object

可选

人员扩展字段信息
注意：不传该扩展信息为删除原来扩展信息

column1

string

扩展字段1

可选

column2

string

扩展字段2

可选

column3

string

扩展字段3

可选

column4

string

扩展字段4

可选

column5

string

扩展字段5

可选

column6

string

扩展字段6

可选

column7

string

扩展字段7

可选

column8

string

扩展字段8

可选

示例

[
  {
    "empCode": "DD101001010",
    "fullname": "袁小文",
    "gender": "0",
    "orgId": "6EA6BAB719F9CAABF2E60EE377702E86",
    "title": "经理",
    "email": "yuanzw@grgtest.com",
    "mobile": "13816199999",
    "status": "1"
  },
  {
    "empCode": "DD101001020",
    "fullname": "陈晨",
    "gender": "0",
    "orgId": "6EA6BAB719F9CAABF2E60EE377702E86",
    "title": "经理",
    "status": "1"
  }
]

返回响应

🟢200成功

application/json

Body

error

string

必需

状态码，0表示正确，其他值表示错误

示例值:

error_description

string

错误信息描述

可选

示例值:

同步成功

data

string

返回的业务数据

可选

示例

{
  "error": "0",
  "error_description": "同步成功",
  "data": "string"
}