文档中心 商家授权 商家同步授权企业的员工

商家同步授权企业的员工

1.使用场景

商家授权的企业员工变动信息,需要同步到商家

2.时序图

调用首次无需传递sync_key,后续增量同步员工时需要使用上次同步的sync_key,所以建议调用方保存好每次调用返回的sync_key。

同步数据

3.接口调用说明

请求URL

https://openapi.guanaitong.tech/seller/employee/sync

HTTP请求方式

POST

输入参数说明

(1)私有参数

参数名称 是否必须 参数类型 长度限制 描述
enterprise_open_id string 32 商家授权的企业id
sync_key string - 首次同步无需传递,后面增量同步必传
请求示例
GET /seller/employee/sync HTTP/1.1
Host: openapi.guanaitong.tech

enterprise_open_id=1100w23042374828djffe8wfewef00032&sync_key=7c222fb2927d828af22f592134e8932480637c0d
返回参数说明
参数名称 参数类型 描述
corp_code string 员工工号
name string 员工姓名
gender string 性别 1男2女
email string 邮箱
mobile_area string 手机区号
mobile string 手机号
dept_code string 部门编码
dept_name string 部门名称
birth_day string 生日
entry_day string 入职日期
正确返回示例
{
    "code": 0,
    "data": {
        "sync_key": "7c222fb2927d828af22f592134e8932480637c0d",
        "has_more":true,
        "data_list": [{
            "corp_code":"A002",
            "name":"李四",
            "gender":1,
            "email":"xxx@yyy.zzz",
            "dept_code":"D001",
            "dept_name":"销售部",
            "mobile_area":86,
            "mobile":"13022222222",
            "birth_day":"1980-02-14",
            "entry_day":"2010-01-01"
        },{
            "corp_code":"A001",
            "name":"张三",
            "gender":2,
            "email":"ttt@yyy.zzz",
            "dept_code":"D001",
            "dept_name":"销售部",
            "mobile_area":86,
            "mobile":"13011111111",
            "birth_day":"1980-02-15",
            "entry_day":"2010-01-02"
        },{},...{}]
    },
    "msg": "OK"
}
错误返回示例
{
    "code":1000210017,
    "data":null,
    "msg":"redirect url not found!"
}