获取打卡记录

获取员工的打卡记录包括(地理位置打卡,beacon打卡,wifi打卡,考勤机打卡,各种补签的打卡数据)

GET https://qy.bangongyi.com/attend/api/check/log?ticket=<ticket>

参数 类型  必须 说明
staff_id int 员工ID,获取某个员工的打卡记录
we_userid string 员工帐号,获取某个员工的打卡记录(无员工ID时有效)
check_id string 考勤机员工编号
start_time string 开始时间(2016-05-05 09:00:00)
end_time string 结束时间(2016-05-06 09:00:00)
device_id int 打卡方式ID,值0时打卡属于补签卡、外勤打卡或其他打卡方式
department_id int 部门ID,获取某个部门的打卡记录
page int 页数(默认:1)
next_id int 否       记录id(取大于id的记录,同时type参数失效)
type int  获取条件类型(默认:0;0:按照打卡时间获取,1:按照记录上传时间获取)
page_size int  每页数量,取值范围1-99(默认:50)
    {
        "next_id": "38004",
        "data": [
            {
                "id": "57342",
                "time": "1554772200",
                "verify": "fp",
                "staff_id": "10000",
                "from": "0",
                "device_id": "39",
                "device_type": "10",
                "create_time": "1554951494",
                "we_name": "克纯",
                "we_userid": "kechun",
                "department_id": "62224",
                "we_department": "240",
                "check_point": [],
                "device": {
                    "id": "39",
                    "type": "10",
                    "title": "FaceBS100",
                    "sn": "6415106546"
                }
            },
            {
                "id": "37992",
                "time": "1514272118",
                "verify": "打卡导入",
                "staff_id": "535368",
                "from": "2",
                "device_id": "0",
                "device_type": "-1",
                "we_name": "罗勇",
                "we_userid": "luoyong",
                "create_time": "1512445093",
                "check_point": [],
                "device": {}
            },
            {
                "id": "37993",
                "time": "1514356444",
                "verify": "40.04366268348354,116.31445129029761",
                "staff_id": "535368",
                "from": "0",
                "device_id": "0",
                "device_type": "-2",
                "we_name": "罗勇",
                "we_userid": "luoyong",
                "department_id": "61995",
                "we_department": "240",
                "create_time": "1512445093",
                "check_point": {
                    "point": "40.04366268348354,116.31445129029761",
                    "point_title": "金隅嘉华大厦",
                    "point_content": "北京市海淀上地三街9号(上地信息环岛西北角)",
                    "images": [
                        "/uploads/100/100/209/BQRs6NO-wNCvJMUKTaA-NfevKHKUirO1F3FoW0Uc-KZsN7M1skA4eChnlzEBiaHF.jpg"
                    ],
                    "description": "滚滚滚"
                },
                "device": {}
            }
        ],
        "errno": 0,
        "errmsg": ""
    }
参数 类型 说明
id string 唯一id
time string 打卡时间(unix时间戳)
create_time string 打卡上传时间(unix时间戳)
verify string 打卡方式(FP:指纹,CARD:卡,PASS:密码,FACE:人脸,39.2545111,90.26511:gps打卡百度坐标,14574:beacon打卡距离14574米,补签卡直接显示原因)
staff_id string 员工ID
from string 来源,0:正常打卡,1:管理员添加/补签,2:导入
device_id string 打卡方式ID
we_name string 员工姓名
we_userid string 员工帐号
device_type string 打卡方式类型 -2外勤打卡 -1补签打卡 0gps打卡 1wifi打卡 2蓝牙打卡 6二维码打卡 10考勤机打卡7路由器打卡
department_id string 办公逸平台部门ID 多部门“,”分割 例如 1,23
we_department string 企业微信平台部门ID 多部门“,”分割 例如 1,23
check_point array 外勤打卡数据
device array 打卡方式数据 当 device_id 大于0是有值
参数 类型 说明
point string 百度 纬度经度(“,”分割)
description string 打卡说明
point_title string 打卡地址信息
point_content string 打卡地址描述
images array 照片地址
参数 类型 说明
id string 打卡方式ID
type string 打卡方式类型 0gps打卡 1wifi打卡 2蓝牙打卡 6二维码打卡 10考勤机打卡7路由器打卡
title string 打卡方式名称
sn string 考勤机sn type 为10 有值

获取考勤日报

get https://qy.bangongyi.com/attend/api/check/day?ticket=<ticket>

参数 类型 必须 说明
ticket string 接口凭证
start_date string 查询开始日期 示例 2016-06-01
end_date string 查询结束日期 示例 2016-06-16
we_status int 员工状态 默认在职员工 1 为全部员工,-1为离职员工 -2为按离职时间查询员工
staff_id int 指定要查询的员工ID
we_userid string 员工帐号,获取指定员工的记录(无员工ID时有效)
department_id int 部门ID,获取某个部门的打卡记录 无staff_id参数时才有效
next_id int 获取更多时传的值从上次请求返回结果中获取

获取员工ID为524516的员工2016-06-12至2016-06-20的日报: https://qy.bangongyi.com/attend/api/check/day?ticket=8029cd1fe2a24eb47af278f7fb71f69b&start_date=2016-06-12&end_date=2016-06-20&staff_id=524516

参数 类型 说明
errno int 全局返回码
errmsg string 返回码描述
data - 返回数据
next_id int 获取更多时传的值
list array 报表结果数组
staff_id string 员工ID
we_userid string 员工账号
we_status string 员工状态 1=已关注,2=已离职,4=未关注,-1不在微信
we_name string 员工名
we_department array 员工所在部门
export_deps array 带层级的部门
we_position string 员工职位
date string 该条报表日期
week string 星期
shop string 是否巡店 (是/否)
iswork string 工作日或休息日
times_id string 班次ID
checkin string 班次上班时间
checkout string 班次下班时间
times_type string 排次类型
checkin_time string 实际有效签到打卡时间戳
checkout_time string 实际有效签退打卡时间戳
duration_work string 工作时长 单位为小时
duration_real string 记薪时长 单位为小时
absent string 旷工时长单位为秒
late string 总迟到时长单位为分钟
early string 总早退时长单位为分钟
late_times string 总迟到次数
early_times string 总早退次数
late_0 string 对应相应的迟到等级单位为分钟 如果有二级迟到则相应增加字段 early_1 以此类推
early_0 string 对应相应的早退等级单位为分钟 如果有二级早退则相应增加字段 early_1 以此类推
late_0_times string 对应相应的迟到次数 如果有二级早退则相应增加字段 early_1_times 以此类推
early_0_times string 对应相应的早退次数 如果有二级早退则相应增加字段 early_1_times 以此类推
approve array 请假申请
approve.id string 申请类型ID 获取审批类型 中的id
approve.type_id string 申请类型type_id 获取审批类型 中的type_id
approve.title string 申请类型
approve.duration string 申请时长 单位为秒
approve.times string 申请次数
approve.is_paid string 是否待薪 0为不带薪假 、1为带薪假 、-1预设值不是请假例如加班
    {
        "data": {
            "list": [
                {
                    "staff_id": "5380216",
                    "we_userid": "luoyong",
                    "we_status": "1",
                    "we_name": "罗勇",
                    "we_department": [
                        "研发中心"
                    ],
                    "export_deps": [
                        "办公逸/研发中心"
                    ],
                    "we_position": "PHP研发工程师",
                    "date": "2019-11-17",
                    "week": "日",
                    "times_id": "0",
                    "checkin_time": "1574038800",
                    "checkin": "0",
                    "checkout": "0",
                    "checkout_time": "1574038800",
                    "shop": "是",
                    "late": "0",
                    "early": "0",
                    "absent": "0",
                    "rule_type": "0",
                    "iswork": "0",
                    "approve": [
                        {
                            "id": "271466",
                            "title": "加班",
                            "type_id": "20",
                            "is_paid": "-1",
                            "duration": "25200",
                            "times": "1"
                        }
                    ]
                },
                {
                    "staff_id": "5380216",
                    "we_userid": "luoyong",
                    "we_status": "1",
                    "we_name": "罗勇",
                    "we_department": [
                        "研发中心"
                    ],
                    "export_deps": [
                        "办公逸/研发中心"
                    ],
                    "we_position": "PHP研发工程师",
                    "date": "2019-11-18",
                    "week": "一",
                    "times_id": "103571",
                    "checkin_time": "0",
                    "checkin": "11:00",
                    "checkout": "14:00",
                    "checkout_time": "0",
                    "late": "0",
                    "early": "0",
                    "absent": "10800",
                    "iswork": "工作日",
                    "title": "BB11",
                    "checkin_end": "0",
                    "checkout_start": "0",
                    "times_type": "固定",
                    "duration_real": "0",
                    "duration_work": "0",
                    "absent_times": "1"
                }
            ],
            "next_id": 5380216
        },
        "errno": 0,
        "errmsg": ""
    }

获取考勤月报

get https://qy.bangongyi.com/attend/api/check/month?ticket=<ticket>

参数 类型 必须 说明
ticket string 接口凭证
start_date string 查询开始日期 示例 2016-06-01
end_date string 查询结束日期 示例 2016-06-16
we_status int 员工状态 默认在职员工 1 为全部员工,-1为离职员工 -2为按离职时间查询员工
staff_id int 指定要查询的员工ID
we_userid string 员工帐号,获取指定员工的记录(无员工ID时有效)
department_id int 部门ID,获取某个部门的考勤月报 无staff_id参数时才有效
next_id int 获取更多时传的值从上次请求返回结果获取

获取2016-06-12至2016-06-20的月报: https://qy.bangongyi.com/attend/api/check/month?ticket=8029cd1fe2a24eb47af278f7fb71f69b&start_date=2016-06-12&end_date=2016-06-20

参数 类型 说明
errno int 全局返回码
errmsg string 返回码描述
data - 返回数据
next_id int 获取更多时传的值
list array 报表结果数组
staff_id int 员工ID
we_userid string 员工账号
we_status int 员工状态 1=已关注,2=已离职,4=未关注,-1不在微信
we_name string 员工名
we_department array 员工所在部门
export_deps array 带层级的部门
we_position string 员工职位
shop int 巡店天数
days float 应到天数
attend_days float 实到天数
duration_work int 工作时长 单位为秒
duration_real int 记薪时长 单位为秒
absent int 旷工时长单位为秒
absent_times int 旷工次数
late int 总迟到时长单位为分钟
early int 总早退时长单位为分钟
late_times int 总迟到次数
early_times int 总早退次数
late_0 int 对应相应的迟到等级单位为分钟 如果有二级迟到则相应增加字段 early_1 以此类推
early_0 int 对应相应的早退等级单位为分钟 如果有二级早退则相应增加字段 early_1 以此类推
late_0_times int 对应相应的迟到次数 如果有二级早退则相应增加字段 early_1_times 以此类推
early_0_times int 对应相应的早退次数 如果有二级早退则相应增加字段 early_1_times 以此类推
lieu_remain int 剩余调休 单位为秒
annual_remain int 剩余年假 单位为秒
approve array 请假申请
approve.id string 申请类型ID 获取审批类型 中的id
approve.type_id string 申请类型type_id 获取审批类型 中的type_id
approve.title string 申请类型
approve.duration int 申请时长 单位为秒
approve.times int 申请次数
approve.is_paid int 是否待薪 0为不带薪假 、1为带薪假 、-1预设值不是请假例如加班
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            "list": [
                {
                    "we_userid": "luoyong",
                    "we_status": 1,
                    "we_name": "罗勇",
                    "we_department": [
                        "运维部",
                        "研发部",
                        "财务部"
                    ],
                    "we_position": "php",
                    "staff_id": 524517,
                    "days": 23.625,
                    "duration_work": 112200,
                    "duration_real": 144000,
                    "absent": 543600,
                    "absent_times": 21,
                    "late": 135,
                    "early": 10,
                    "attend_days": 4,
                    "shop": 1,
                    "late_1_times": 1,
                    "late_1": 135,
                    "late_times": 1,
                    "early_0_times": 1,
                    "early_0": 10,
                    "early_times": 1,
                    "lieu_remain": 86400,
                    "annual_remain": 86400,
                    "approve": [
                        {
                            "id": "1088",
                            "title": "外出",
                            "type_id": "13",
                            "is_paid": 1,
                            "duration": 21600,
                            "times": 2
                        },
                        {
                            "id": "1090",
                            "title": "调休",
                            "type_id": "12",
                            "is_paid": 1,
                            "duration": 14400,
                            "times": 2
                        },
                        {
                            "id": "1091",
                            "is_paid": 0,
                            "title": "事假",
                            "type_id": "51",
                            "duration": 28800,
                            "times": 1
                        },
                        {
                            "id": "1089",
                            "is_paid": -1,
                            "title": "加班",
                            "type_id": "20",
                            "duration": 3600,
                            "times": 1
                        },
                        {
                            "id": "2101",
                            "title": "外出加班",
                            "type_id": "20",
                            "is_paid": -1,
                            "duration": 8100,
                            "times": 2
                        }
                    ],
                    "export_deps": [
                        "百会云计算/运维部",
                        "百会云计算/研发部",
                        "百会云计算/财务部"
                    ]
                },
                {
                    "we_userid": "15801123923",
                    "we_status": 4,
                    "we_name": "张雪",
                    "we_department": [
                        "百会云计算",
                        "研发部",
                        "测试",
                        "财务部",
                        "广研",
                        "运营部",
                        "测试部门",
                        "电商",
                        "自己人",
                        "张雪",
                        "l"
                    ],
                    "we_position": "测试工程师",
                    "staff_id": 524525,
                    "days": 26,
                    "duration_work": 34800,
                    "duration_real": 28800,
                    "absent": 720000,
                    "absent_times": 25,
                    "late": 0,
                    "early": 5,
                    "attend_days": 1,
                    "early_0_times": 1,
                    "early_0": 5,
                    "early_times": 1,
                    "lieu_remain": 0,
                    "annual_remain": 24,
                    "export_deps": [
                        "百会云计算",
                        "百会云计算/研发部",
                        "百会云计算/研发部/测试",
                        "百会云计算/财务部",
                        "百会云计算/广研",
                        "百会云计算/运营部",
                        "百会云计算/测试部门",
                        "百会云计算/电商",
                        "百会云计算/自己人",
                        "百会云计算/张雪",
                        "百会云计算/jk/l"
                    ]
                }
            ],
            "next_id": 524525
        }
    }

获取自由打卡月报

get https://qy.bangongyi.com/attend/api/check/free-month?ticket=<ticket>

参数 类型 必须 说明
ticket string 接口凭证
start_date string 查询开始日期 示例 2016-06-01
end_date string 查询结束日期 示例 2016-06-16
we_status int 员工状态 默认在职员工 1 为全部员工,-1为离职员工 -2为按离职时间查询员工
we_userid string 员工帐号,获取指定员工的记录(无员工ID时有效)
we_id int 企业微信部门ID,获取某个部门的考勤月报 无 we_userid 时有效
department_id int 部门ID,获取某个部门的考勤月报 无 we_userid 且无 we_id 时有效
next_id int 获取更多时传的值从上次请求返回结果获取

获取2016-06-12至2016-06-20的月报: https://qy.bangongyi.com/attend/api/check/free-month?ticket=8029cd1fe2a24eb47af278f7fb71f69b&start_date=2016-06-12&end_date=2016-06-20

参数 类型 说明
errno int 全局返回码
errmsg string 返回码描述
data - 返回数据
next_id int 获取更多时传的值
list array 报表结果数组
staff_id int 员工ID
we_userid string 员工账号
we_status int 员工状态 1=已关注,2=已离职,4=未关注,-1不在微信
we_name string 员工名
we_department array 员工所在部门
export_deps array 带层级的部门
we_position string 员工职位
shop int 巡店天数
totalTime float 月总工时 单位小时
checkNo_times int 漏刷次数
legalTime int 法定标准工时 单位小时
dayOff int 本月到期调休 单位小时
settlementTime int 结算工时 单位小时
prevTime int 上月缺勤 单位小时
lieu_remain int 剩余调休 单位为秒
annual_remain int 剩余年假 单位为秒
lieu_month int 当月剩余年假 单位为秒
annual_month int 当月剩余调休 单位为秒
approve array 请假申请
approve.id string 申请类型ID 获取审批类型 中的id
approve.type_id string 申请类型type_id 获取审批类型 中的type_id
approve.title string 申请类型
approve.duration int 申请时长 单位为秒
approve.times int 申请次数
approve.is_paid int 是否待薪 0为不带薪假 、1为带薪假 、-1预设值不是请假例如加班
    {
        "data": {
            "list": [
                {
                    "we_userid": "zhouwenbo",
                    "we_status": 1,
                    "we_name": "周文博",
                    "we_department": [
                        "新网测试"
                    ],
                    "we_position": "",
                    "staff_id": 5576258,
                    "legalCheck": 0,
                    "totalTime": 30,
                    "checkNo_times": 2,
                    "lieu_remain": 0,
                    "annual_remain": 0,
                    "lieu_month": 0,
                    "annual_month": 0,
                    "legalTime": 152,
                    "dayOff": 0,
                    "approve": [
                        {
                            "id": "1091",
                            "title": "事假",
                            "type_id": "51",
                            "is_paid": 0,
                            "duration": 28800,
                            "times": 1
                        },
                        {
                            "id": "4026",
                            "title": "外出",
                            "type_id": "13",
                            "is_paid": 1,
                            "duration": 28800,
                            "times": 1
                        }
                    ],
                    "export_deps": [
                        "办公逸/新网测试"
                    ],
                    "settlementTime": 0,
                    "prevTime": 0,
                    "shop": 0
                },
                {
                    "we_userid": "MaFei",
                    "we_status": 1,
                    "we_name": "马飞",
                    "we_department": [
                        "新网测试"
                    ],
                    "we_position": "",
                    "staff_id": 5576261,
                    "legalCheck": 0,
                    "totalTime": 22,
                    "shop": 1,
                    "checkNo_times": 1,
                    "lieu_remain": 0,
                    "annual_remain": 0,
                    "lieu_month": 0,
                    "annual_month": 0,
                    "legalTime": 152,
                    "dayOff": 0,
                    "export_deps": [
                        "办公逸/新网测试"
                    ],
                    "settlementTime": 0,
                    "prevTime": 0,
                    "approve": []
                }
            ],
            "next_id": 5576273
        },
        "errno": 0,
        "errmsg": ""
    }

获取考勤规则及考勤机信息

获取考勤规则及其考勤机信息

https://qy.bangongyi.com/attend/api/device/rule?ticket=<ticket>

GET

    {
        "data": [
            {
                "id": "163",
                "title": "考勤规则名称",
                "devices": [
                    {
                        "id": "16",
                        "sn": "0000000001",
                        "title": "打卡方式名称"
                    }
                ]
            },
            {
                "id": "168",
                "title": "考勤规则名称",
                "devices": [
                    {
                        "id": "16",
                        "sn": "0000000001",
                        "title": "打卡方式名称"
                    }
                ]
            }
        ],
        "errno": 0,
        "errmsg": ""
    }
参数 说明
errno 执行状态 0 成功 全局返回码
errmsg 执行结果说明
data 结果数组
sn 考勤机SN码
devices.id 考勤机关联id

获取考勤机信息

获取考勤机信息及在线状态

get https://qy.bangongyi.com/attend/api/device/info?ticket=<ticket>

参数 类型 必须 说明
sn string 考勤机sn 值为数组或','连接的SN字符串(不传值为获取所有考勤机信息)
{
    "data": [
        {
            "title": "641610092512",
            "sn": "641610092512",
            "firmware": "IFKL104OF0303_BS3_BGY V3.40",
            "online": 0,
            "last_time": "2017-06-22 16:01:01"
        }
    ],
    "errno": 0,
    "errmsg": "ok"
}
参数 说明
errno 执行状态 0 成功 全局返回码
errmsg 执行结果说明
data 结果数组
sn 考勤机SN码
title 打卡方式名称
firmware 考勤机固件版本
online 在线状态 0 为离线 1为在线
last_time 最后在线时间

获取考勤机对应的员工

获取考勤机对应的员工 一次最多获取1000条,获取更多传last_id

https://qy.bangongyi.com/attend/api/device/staff-list?ticket=<ticket>

GET

参数 类型  必须 说明
sn string 考勤机SN码 与 device_id 二选一
device_id int 考勤机关联id sn 二选一
last_id int 获取更多时使用,从上次结果中获取
we_userids string 筛选条件 员工帐号可多个 "hefei,luoyong"
check_ids string 筛选条件 考勤机员工编号可多个 "534564,55555" (we_userids 有值时该参数无效)
    {
        "errno": 0,
        "data": {
            "feature_type": [],
            "last_id": "5380216",
            "list": [
                {
                    "id": "5380199",
                    "we_avatar": "https://shp.qpic.cn/bizmp/HmtU0JT3A9hlia6SI7zq5rYPy1xZCzBTa4yNzwbibyj8fCsPDe6KZzbA/",
                    "we_department": "300,2,248",
                    "we_name": "何飞",
                    "we_position": "总监",
                    "we_userid": "hefei",
                    "attend_rule_id": "338",
                    "check_id": "534564",
                    "feature_type": [
                        "fp",
                        "pass"
                    ],
                    "card": ""
                },
                {
                    "id": "5380216",
                    "we_avatar": "https://p.qlogo.cn/bizmail/vLvUHlQUu8nlZApswA9ky0Tm5opy2gpgtsNwxuBv65AzzOiaawX3MDQ/0",
                    "we_department": "55",
                    "we_name": "罗勇",
                    "we_position": "PHP研发工程师",
                    "we_userid": "luoyong",
                    "attend_rule_id": "338",
                    "check_id": "55555",
                    "feature_type": [
                        "fp",
                        "pass",
                        "card"
                    ],
                    "card": "12344"
                }
            ]
        },
        "errmsg": ""
    }
参数 说明
errno 执行状态 0 成功 全局返回码
errmsg 执行结果说明
last_id 获取更多时使用
we_department 员工部门ID
we_avatar 员工头像
we_name 员工姓名
we_position 员工职位
we_userid 员工帐号
check_id 员工考勤机工号
feature_type 员工包涵特征值 fa 人脸 fp 指纹 pass 密码 card 卡
card 卡号

考勤机写入员工

把平台已有员工写人指定考勤机

https://qy.bangongyi.com/attend/api/device/staff?ticket=<ticket>

POST

参数 类型  必须 说明
sn string 考勤机SN码
check_ids string 考勤机工号 多个英文逗号隔开 例如(526559,526560,526561)
type string 写入信息 1 指纹 11 ID卡 12 人脸 写入信息用英文逗号拼接例如(1,12,11)
    {
        "errno": 0,
        "errmsg": "命令发送成功,请稍后查看结果。"
    }
参数 说明
errno 执行状态 0 成功 全局返回码
errmsg 执行结果说明

删除考勤机对应的员工

生成一条删除考勤机员工的命令,考勤机将根据该命令执行删除操作

https://qy.bangongyi.com/attend/api/device/staff-del?ticket=<ticket>

POST

参数 类型  必须 说明
sn string 考勤机SN码(若不传sn 则删除所有考勤机中该员工的数据)
check_id int 员工考勤机工号 与 we_userid 二选一
we_userid string 员工帐号 与 check_id 二选一
    {
        "errno": 0,
        "errmsg": "删除考勤机员工命令发送成功"
    }
参数 说明
errno 执行状态 0 成功 全局返回码
errmsg 执行结果说明

录入员工特征值

录入考勤机员工特征值

https://qy.bangongyi.com/attend/api/device/add-feature?ticket=<ticket>

POST

参数 类型  必须 说明
we_userid string 员工帐号 与 we_userid 二选一
check_id string 考勤机员工编号 we_userid 传值时该参数无效
value string 值为空时为删除特征值
type string 写入类型 默认 card,目前不支持其他类型
    {
        "errno": 0,
        "errmsg": "录入成功"
    }

考勤打卡补签

补签打卡记录可按部门或员工补签

POST https://qy.bangongyi.com/attend/api/approve/check?ticket=<ticket>

参数 类型 必须 说明
department_ids string or array 部门ID数组或','连接的部门ID字符串 例: 121,3222,4445 获取部门列表
we_userids string or array 员工帐号数组或','连接的员工帐号字符串 获取成员列表
staff_ids string or array 员工ID数组或','连接的员工ID字符串 获取成员列表
datetime string 补签打卡时间(2016-05-05 09:00:00)
reason string 补签原因
    {
        "errno": 0,
        "errmsg": "考勤补签成功"
    }

重启考勤机

参数 类型 必须 说明
sn string 考勤机编号
    {
        "errno": 0,
        "errmsg": "命令发送成功!"
    }

修改考勤机员工权限

参数 类型 必须 说明
sn string 考勤机编号
check_id string 考勤机员工编号与 we_userid 二选一
we_userid string 员工帐号与 check_id 二选一
user_privilege string 考勤机员工角色 USER,MANAGER
    {
        "errno": 0,
        "errmsg": "命令发送成功!"
    }

追加导入假期时间

追加导入剩余年假/剩余调休

POST https://qy.bangongyi.com/attend/api/approvelog?ticket=<ticket>

参数 类型 必须 说明
type string 假期类型 例如:年假或调休
we_userids string or array 员工帐号数组或','连接的员工帐号字符串 we_userids或staff_ids 必须传其中一个获取成员列表
staff_ids string or array 员工ID数组或','连接的员工ID字符串 获取成员列表
deadline int 10位的时间戳 不传默认永久有效
time int 导入假期时长 单位分钟
reason string 导入假期原因
    {
        "errno": 0,
        "errmsg": "导入成功"
    }

获取审批单列表

获取员工的审批单记录包括(请假,外出,出差,加班,调休,异常申请等)

GET https://qy.bangongyi.com/attend/api/approve/list?ticket=<ticket>

参数 类型  必须 说明
staff_id int 员工ID,获取某个员工的申请记录
we_userid string 员工帐号,传 staff_id 时该参数无效
start_time string 开始时间(2016-05-05 09:00:00)
end_time string 结束时间(2016-05-06 09:00:00)
get_type int 时间查询方式 0 按申请单的开始时间与结束时间查询 1 按申请单的创建时间查询(默认:0)
department_id int 部门ID,获取某个部门的申请记录
page int 页数(默认:1)
next_id int 申请id(默认:0)
time_type int 否       申请时间长类型(1:分钟,2:小时,3:天)
page_size int  每页数量,取值范围1-99(默认:50)
finish int  0为审批中的审批单 2为所有审批单 不传或1为已完成的审批单
type string 申请类型 (调休/外出/出差/事假/病假/年假/婚假/丧假/产假/工伤假/加班/陪产假)
    {
        "next_id": "1089",
        "data": [
            {
                "id": "1066",
                "staff_id": "535368",
                "approve_type_id": "1091",
                "start_time": "1509987600",
                "end_time": "1510048800",
                "duration": "480",
                "status": "1",
                "create_time": "1510639519",
                "we_name": "罗勇",
                "approve_type_name": "事假",
                "type_id": "51",
                "we_userid": "luoyong",
                "approve_time": "1578562868",
                "reason":"申请说明",
                "is_paid": 0,
                "approve_process": [
                    {
                        "approve_id": "1066",
                        "staff_id": "0",
                        "reason": "等待",
                        "approve_time": "1510639519",
                        "level": "0",
                        "status": "1",
                        "staff": {
                            "id": "0",
                            "we_name": "管理员",
                            "we_userid": ""
                        },
                        "cc_staff": []
                    }
                ]
            },

            {
                "id": "1069",
                "staff_id": "535368",
                "approve_type_id": "1093",
                "type_id": "53",
                "start_time": "1510675200",
                "end_time": "1510761600",
                "duration": "480",
                "status": "1",
                "create_time": "1510728183",
                "we_name": "罗勇",
                "approve_type_name": "年假",
                "we_userid": "luoyong",
                "approve_time": "1578562868",
                "reason":"申请说明",
                "is_paid": 1,
                "approve_process": [
                    {
                        "reason": "",
                        "approve_time": "1510730286",
                        "level": "1",
                        "status": "1",
                        "staff": {
                            "id": "534518",
                            "we_name": "刘凤悦",
                            "we_userid": "18513116558"
                        },
                        "cc_staff": [
                            {
                                "id": "534554",
                                "we_name": "张易",
                                "we_userid": "13488681243"
                            }
                        ]
                    },
                    {
                        "reason": "312",
                        "approve_time": "1510730391",
                        "level": "2",
                        "status": "1",
                        "staff": {
                            "id": "5338574",
                            "we_name": "奇异博士",
                            "we_userid": "ceshiwang1234"
                        },
                        "cc_staff": [
                            {
                                "id": "5338531",
                                "we_name": "刘岚测测本",
                                "we_userid": "13261674603"
                            }
                        ]
                    }
                ]
            }
        ],
        "errno": 0,
        "errmsg": ""
    }
参数 类型 说明
id string 审批唯一ID
staff_id string 员工id
we_userid string 员工账号
we_name string 员工姓名
start_time string 申请开始时间戳
end_time string 申请结束时间戳
create_time string 申请时间戳
approve_time string 审批通过时间戳。未通过时值为空字符串
duration string 时间长
reason string 申请说明
status string 申请状态 0为审批中,1为已同意, 2为已拒绝,3为已退回,4为工资核减
approve_type_name string 申请类型名称
approve_type_id string 申请类型ID 获取审批类型 中的 id
type_id string 申请类型type_id 获取审批类型 中的 type_id
is_paid int 是否待薪 0为不带薪假 、1为带薪假 、-1预设值不是请假例如加班
approve_process array 审批进程
参数 类型 说明
reason string 审批说明
approve_time string 审批时间
level string 审批级别
status string 审批状态 1已同意 2已拒绝,5 已转审
staff hash 审批人信息
cc_staff array 抄送人信息

根据时间段获取申请假期时长

参数 类型 必须 说明
we_useid string 员工账号
start string 开始时间(2016-05-05 09:00:00)
end string 结束时间(2016-05-05 18:00:00)
type string 申请类型 (调休/外出/出差/事假/病假/年假/婚假/丧假/产假/工伤假/加班/陪产假)
    {
        "errno": 0,
        "errmsg": "考勤登记成功",
        "data": {
            "duration": 8,
            "min": 1,
            "max": 8,
            "duration_day": 1,
            "min_day": 0.125,
            "max_day": 1
        }
    }
参数 类型 说明
data.duration float 申请时长 单位小时最多保留2位小数
data.min float 每次最小申请时长 单位小时最多保留2位小数 0为不限制
data.max float 每次最大申请时长 单位小时最多保留2位小数 0为不限制
data.duration_day float 申请时长 单位小时最多保留3位小数
data.min_day float 每次最小申请时长 单位天最多保留3位小数 0为不限制
data.max_day float 每次最大申请时长 单位天最多保留3位小数 0为不限制

获取可申请假期时长

参数 类型 必须 说明
we_userid string 员工账号
type string 申请类型 (调休/年假/)
start string 查询已使用假期开始时间(2016-05-05 09:00:00)
end string 查询已使用假期结束时间(2016-05-05 18:00:00)
    {
        "errno": 0,
        "errmsg": "ok",
        "data": {
            "hours": 8,
            "disabled": 8,
            "used": 24,
            "days": 1,
            "disabled_day": 1,
            "used_day": 3
        }
    }
参数 类型 说明
data.hours float 可使用的剩余时长 单位小时最多保留2位小数
data.disabled float 申请中冻结的假期时长 单位小时最多保留2位小数
data.used float 已使用假期时长 单位小时最多保留2位小数
data.days float 可使用的剩余时长 单位天最多保留3位小数
data.disabled_day float 申请中冻结的假期时长 单位天最多保留3位小数
data.used_day float 已使用假期时长 单位天最多保留3位小数

考勤申请登记

第三方平台直接提交已经审批通过的考勤申请(异常申请除外),提交成功后报表异常状态会产生变化

POST https://qy.bangongyi.com/attend/api/approve/apply?ticket=<ticket>

参数 类型 必须 说明
staff_id int 员工ID,登记某个员工的申请信息
we_userid string 员工账号 staff_id和we_useid二者至少填写一项
start_time string 开始时间(2016-05-05 09:00:00)
end_time string 结束时间(2016-05-05 18:00:00)
type string 申请类型 (异常/调休/外出/出差/事假/病假/年假/婚假/丧假/产假/工伤假/加班/陪产假)
transformation tinyint 加班转换:默认1(1:转换为调休,4转换为加班费)
reason string 登记原因
status string 申请审批单状态,默认登记状态,值为 apply 为申请状态 需要审批
approve_we_userid string 审批人帐号,当审批单为申请状态时需要传值
    {
        "errno": 0,
        "errmsg": "考勤登记成功",
        "data": {
            "id": 3421
        }
    }
参数 类型 说明
data.id int 申请审批单ID,需保存审批接口用到

审批假期单

参数 类型 必须 说明
id int 申请单ID [考勤申请登记接口]返回
reason string 审批说明
status string 审批状态,默认值 agree 通过(无下级审批人时审批流结束)、reject 驳回,审批流结束、cancel 撤销,审批流结束、 change 转审 必须有下级审批人
approve_we_userid string 下级审批人帐号,通过审批且不传值时完成审批单,通过审批且有下级审批时只当前级审批完成,提交给下级审批
    {
        "errno": 0,
        "errmsg": "审批成功"
    }

获取审批类型

获取企业的审批类型

GET https://qy.bangongyi.com/attend/api/approve/approve-type?ticket=<ticket>

参数 类型  必须 说明
status int 0为启用状态类型(默认值) 1为禁用状态类型 -1为已删除类型
    [
        {
            "id": "1091",
            "type_id": "51",
            "title": "事假",
            "desc": "事假说明"
        },
        {
            "id": "1052",
            "type_id": "2",
            "title": "异常",
            "desc": ""
        }
    ]
参数 类型 说明
id string 唯一id
type_id string 审批类型id
title string 类型名称
desc string 类型描述

上传员工巡店数据

post https://qy.bangongyi.com/attend/api/check/go-shop?ticket=<ticket>

参数 类型   是否必须 说明
ticket string 接口凭证
time int 发送时间
data array 巡店数据 最多50条记录
we_userid string 员工帐号
date string 巡店日期
is_go_shop int 是否巡店 1 巡店 0 为未巡店
iswork int 是否排班 1 为工作日 0为休息日 在办公逸排班的员工传0
    {
        "time": 1555307348, 
        "data": [
           {
              "we_userid":"B252019000153", 
              "date": "2020-04-24",
              "is_go_shop":0,
              "iswork":0
           },
           {
              "we_userid":"B252019000153", 
              "date": "2020-04-24",
              "is_go_shop":1,
              "iswork":1
           }
        ]
    }
    {
        "errno": 0, 
        "errmsg" : ""
    }
    {
        "errno": 0, 
        "errmsg" : "",
        "data": [
          {
              "we_userid":"B252019000153", 
              "msg" : "员工帐不存在"
          }
        ]
    }
参数 类型 说明
errno string 0
errmsg string
data array 同步失败的数据