附件1
考勤设备数据对接标准接口文档
2022年06月
版本修改记录
版本 | 修改记录 | 日期 | 修改人 |
V_1.0 | 基础版本 | 2022-06 | 陈石杨 |
2.数据流程
注：所有命令的数字类型都为低位在前。同一台设备不能多线程并发
长度 | 内容说明 | 标记 | 类型 | 备注 |
1 | 开始标记 | Header | Byte | 0x01 |
4 | 长度 LEN | Length | Uint | 内容的长度 |
4 | 分包顺序索引 | PartIndex | Uint | 0x00 |
4 | 分包总数 | PartCount | Uint | 0x00 |
1 | 版本 | Version | Byte | 默认0x01 |
2 | 命令 | Command | Ushort | 0x10 |
16 | 会话标识 | SessionID | Byte[16] | 通讯唯一标识 |
LEN | 内容 | Content | Byte[LEN] | 数据包内容 |
1 | 状态 | Flag | Byte | 0x0为成功，0x01为失败 |
1 | 结束标记 | Tail | Byte | 0x01 |
方括号里面的数字为通讯命令，为十进制数字。发送和返回命令都为数据包里的Content内容
名称 | 字节数 | 格式 | 说明 |
厂家识别码 | 32 | ASCII | 32位厂家识别码，所有设备一样 |
设备的唯一标识码 | 32 | ASCII | 每台设备的唯一标识 |
校验和 | 1 | HEX | Xor校验运算（计算包的内容） |
返回值：
成功：flag = 0，验证成功；
失败：flag = 1，Content=用于设备显示的错误提示,UTF-8编码。
设备通讯的其他命令必须在本命令执行成功后，才可以使用。
Content：空
返回的内容为空。
名称 | 字节数 | 格式 | 说明 |
设备的唯一标识码 | 32 | ASCII | 每台设备的唯一标示 |
身份证 | 18 | ASCII | 身份证 |
校验和 | 1 | HEX | Xor校验运算 |
返回值：
名称 | 字节数 | 格式 | 说明 |
工人编号 | 4 | Uint | 工人编号 |
姓名 | 30 | UTF-8 | 姓名 |
身份证号码 | 18 | ASCII | 身份证号码 |
民族 | 1 | HEX | 代号 |
性别 | 2 | ASCII | 1：男：0：女 |
身份证地址 | 140 | UTF8 | 身份证地址 |
出生年月日 | 16 | ASCII | yyyyMMdd(20170409) |
发证机关 | 60 | UTF8 | 发证机关 |
有效期 | 64 | UTF8 | 有效期 |
采集照片长度（GL） | 4 | Uint | 采集照片长度 |
采集照片 | GL | HEX | 采集照片 |
身份证照片长度（PL） | 4 | Uint | 身份证照片长度 |
身份证照片 | PL | HEX | 身份证照片 |
红外照片长度（HL） | 4 | Uint | 红外照片长度（可为0） |
红外照片 | HL | HEX | 红外照片 |
校验和 | 1 | HEX | Xor校验运算 |
Content：
名称 | 字节数 | 格式 | 说明 |
工人编号 | 4 | Uint | 低位在前 |
刷卡时间 | 7 | HEX | BCD码，年占2字节，月、日、时、分、秒各占一个字节 |
刷卡模式 | 1 | HEX | 6，代表人脸 |
照片长度(PL) | 4 | Uint | 低位在前 |
照片信息 | PL | HEX | 考勤照片的字节数组（图片流，尽量保持10kb，不能超过50kb） |
校验和 | 1 | HEX | Xor校验运算 |
返回值：
成功：flag = 0，服务端已成功记录此次刷卡操作；
失败：flag = 1，Content=用于机器显示的错误提示,UTF-8编码。
Content：
位置 | 名称 | 字节数 | 格式 | 说明 |
0-1 | 白名单人数 | 2 | HEX | 白名单人数 |
2-5 | 数据长度累加值 | 4 | HEX | 采集照片长度累加的值 |
6 | 校验和 | 1 | HEX | Xor校验运算 |
返回值：
位置 | 名称 | 字节数 | 格式 | 说明 |
0-3 | 项目编号 | 4 | HEX | 低位在前 |
4-103 | 项目名称 | 100 | UTF-8 | 用于机器显示用 |
数据记录 | 数据记录可以为多条记录 | |||
校验和 | 1 | HEX |
成功：flag = 0，服务端已成功；返回的内容如下
数据记录:
位置 | 名称 | 字节数 | 格式 | 说明 |
工人编号 | 4 | HEX | 刷卡成功上传时需要用到 | |
工人姓名 | 10 | UTF-8 | ||
身份证号码 | 18 | ASCII | ||
采集照片长度（FL） | 4 | Hex | ||
保留字节 | 5 |
失败：flag = 1，Content=用于卡机显示的错误提示,UTF-8编码。
代号 | 民族 |
01 | 汉族 |
02 | 蒙古族 |
03 | 回族 |
04 | 藏族 |
05 | 维吾尔族 |
06 | 苗族 |
07 | 彝族 |
08 | 壮族 |
09 | 布依族 |
10 | 朝鲜族 |
11 | 满族 |
12 | 侗族 |
13 | 瑶族 |
14 | 土家族 |
15 | 白族 |
16 | 哈尼族 |
17 | 哈萨克族 |
18 | 傣族 |
19 | 黎族 |
20 | 傈傈族 |
21 | 佤族 |
22 | 畲族 |
23 | 高山族 |
24 | 拉祜族 |
25 | 水族 |
26 | 东乡族 |
27 | 纳西族 |
28 | 景颇族 |
29 | 柯尔克孜族 |
30 | 土族 |
31 | 达斡尔族 |
32 | 仫佬族 |
33 | 羌族 |
34 | 布朗族 |
35 | 撒拉族 |
36 | 毛难族 |
37 | 仡佬族 |
38 | 锡伯族 |
39 | 阿昌族 |
40 | 普米族 |
41 | 塔吉克族 |
42 | 怒族 |
43 | 乌孜别克族 |
44 | 俄罗斯族 |
45 | 鄂温克族 |
46 | 崩龙族 |
47 | 保安族 |
48 | 裕固族 |
49 | 京族 |
50 | 塔塔尔族 |
51 | 独龙族 |
52 | 鄂伦春族 |
53 | 赫哲族 |
54 | 门巴族 |
55 | 珞巴族 |
56 | 基诺族 |
57 | 其他 |
58 | 外国血统 |
2. 数据流程
数据流程：843（登录）->65535（定时发送心跳）->849（定时获取全量白名单）->845（获取人脸特征）->848（上传考勤）
部分内容由用户投稿或者来源于网络，如有侵权，请联系底部邮箱进行删除！非常感谢您的支持！
