文档中心 商家授权 商家同步授权企业的部门

商家同步授权企业的部门

1.使用场景

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

2.时序图

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

同步数据

3.接口调用说明

请求URL

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

HTTP请求方式

POST

输入参数说明

(1)私有参数

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

enterprise_open_id=1100w23042374828djffe8wfewef00032&sync_key=8u37efb2927d828af22f592134e893248069u34d
返回参数说明
参数名称 参数类型 描述
name string 部门姓名
dept_code string 部门编码
parent_code string 父部门编码
正确返回示例
{
    "code": 0,
    "data": {
        "sync_key": "7c222fb2927d828af22f592134e8932480637c0d",
        "has_more": false,
        "data_list": [{
            "name":"销售部",
            "dept_code":"A001",
            "parent_code":"张三有限公司",
            "parent_name":"张三有限公司"
        },{
            "name":"张三有限公司",
            "dept_code":"张三有限公司",
            "parent_code":"0",
            "parent_name":"xxx",
        }]
    },
    "msg": "OK"
}
错误返回示例
{
    "code":1000210017,
    "data":null,
    "msg":"redirect url not found!"
}