贵州新版-建筑工程用工实名信息化监管系统接入标准1.3
目录
3.1.1新增班组PAGEREF _Toc10380 \h8
3.1.2修改班组PAGEREF _Toc3206 \h10
3.1.3查询班组PAGEREF _Toc21099 \h12
3.2.1添加工人实名制信息PAGEREF _Toc10158 \h14
3.2.2查询工人的实名制信息PAGEREF _Toc32189 \h16
3.3.1添加项目工人信息PAGEREF _Toc23034 \h18
3.3.2修改项目工人信息PAGEREF _Toc18996 \h22
3.3.3查询项目工人信息PAGEREF _Toc18978 \h25
3.4.1添加项目工人合同信息PAGEREF _Toc31283 \h29
3.4.2查询项目工人合同信息PAGEREF _Toc13667 \h30
3.5.1项目工人退场PAGEREF _Toc20699 \h32
3.6.1新增工人考勤PAGEREF _Toc18886 \h34
3.6.2查询工人考勤PAGEREF _Toc9663 \h35
3.7.1新增工资发放银行卡PAGEREF _Toc921 \h37
3.7.2修改工资发放银行卡PAGEREF _Toc746 \h39
3.7.3查询工资发放银行卡PAGEREF _Toc12236 \h40
3.8.1新增工资单PAGEREF _Toc2135 \h42
3.8.2查询工资单PAGEREF _Toc524 \h44
3.9.1新增项目参建单位(非五方主体)PAGEREF _Toc26653 \h47
3.9.2查询项目参建单位(所有)PAGEREF _Toc25805 \h48
4.2调用说明和示例PAGEREF _Toc1979 \h51
4.3接口参数和注意事项PAGEREF _Toc17350 \h53
5.1.1结果码对照表PAGEREF _Toc12036 \h53
5.2.1是否字典表PAGEREF _Toc5926 \h54
5.2.2民族字典表PAGEREF _Toc24160 \h54
5.2.3文化程度字典表PAGEREF _Toc11904 \h56
5.2.4政治面貌字典表PAGEREF _Toc7852 \h56
5.2.5婚姻状态字典表PAGEREF _Toc30385 \h57
5.2.6工种字典表PAGEREF _Toc22132 \h57
5.2.7人员类型字典表PAGEREF _Toc7011 \h59
5.2.8管理岗位类型字典表PAGEREF _Toc3297 \h59
5.2.9银行代码字典表PAGEREF _Toc28851 \h60
5.2.10合同期限类型字典表PAGEREF _Toc28878 \h65
5.2.11计量单位类型字典表PAGEREF _Toc12410 \h65
5.2.12工人考勤方向字典表PAGEREF _Toc10606 \h65
5.2.13工人通行方式字典表PAGEREF _Toc28378 \h65
5.2.14班组类型字典表PAGEREF _Toc17713 \h66
一、引言
1.1更新日志
1.3版本:
l 优化对接流程。
l 增加联调QQ群联系方式
1.2版本:
l 增加了“新增项目参建单位(非五方主体)”和“查询项目参建单位(所有)”,由于五方主体都是通过其他平台录入,所以数据公司不允许上传五方主体,而非五方主体的单位需由数据公司进行上传,在上传非五方主体的单位后可创建对应班组并将对应单位的人员录入到对应班组内,数据公司可通过查询项目参建单位知道项目的五方主体信息。
l 银行代码字典表新增加“贵州银行”,编码为ZDY_GZBANK
1.1版本:
l 新增班组、修改班组的班组进场日期与进场附件由必填更改为非必填
l 管理班组不允许修改
1.0版本:
Java版本-建筑工程用工实名信息化监管系统更新说明(与.net版本比较):
l 接口对接IP地址和端口号改变,以技术方实际给出为准
l 接口签名和参数加密方式改为32位MD5和AES全参数加密
l 所有请求参数新增闸机厂商code进行参数校验
l 所有接口业务逻辑有所更改,具体逻辑请看接口描述
l 所有的接口字段名和Json数据结构有所改动,进行了业务逻辑优化后删除了部分字段同时原有的字段名称有变更,请重新按照最新的文档进行对接
l 新增了网关限流,所有接口的调用不能并发请求,即同一个ip不能使用多线程调用同一个接口,否则会出报错。具体的限流数,并发数会根据实际情况进行调整
1.2编写目的
为加强贵州建筑工程用工实名信息化监管系统对工人实名信息、工人考勤数据、分账管理及工资发放信息等统一管理,解决已有用工实名信息化管理系统与监管系统对接问题,实现数据实时对接和交换,特编写本接入标准供施工企业相关技术人员对接。
1.3适用范围
本文档的适用对象为接入贵州建筑工程用工实名信息化监管系统的施工企业或信息科技公司的技术开发人员、日常维护人员。
1.4简称和术语
贵州建筑工程用工实名信息化监管系统:以下简称“监管系统”。
施工企业:指依法取得施工企业资质证书,在本市从事建设施工活动的施工总承包企业、专业承包企业和劳务分包企业。
信息科技公司:指有资质开发并承包商业化实名制管理系统的信息科技公司。
1.5通信时效
● 为实现数据实时对接和交换(参数要求:数据请求时效≤5min),建设主管部门将委托监管系统研发单位对各项目使用的实名管理系统进行检验,达到实时性要求。
1.6频率限制
平台对访问过于频繁等情况做了屏蔽处理,使用了网关限流,针对同一调用方(API Client)即同一IP地址访问同一方法这一级别可以做如下限制:访问时间间隔不能少于0.5秒,且不允许并发(即上一次访问还没有返回结果就开始下一次访问);需要调用方自行设置合理的线程休眠时间;具体访问限制参数可配置,会根据上线后实际业务数据量和访问频率做优化调整。
二、开发规范
2.1通信协议
● 采用HTTP(或HTTPS)协议进行请求和响应的处理。接口请求采用POST方式。接口响应返回JSON格式的数据。
● 由“监管系统”提供企业实名制、工资分账、考勤等功能的接口地址。
● 接口请求URL地址:详见接口说明。
● 接口未注明处均使用UTF-8编码。
● HTTP(或HTTPS)请求参数均为字符串。
● 接口请求需进行签名。
● 接口请求业务参数需要进行AES加密
2.2通信安全
为保证数据传输过程中的数据真实性,我们需要对数据进行数字签名,在接收签名数据之后进行签名校验。
“监管系统”会为施工企业的每个项目工程分配唯一的接入编号Token和接入密钥Key。
签名机制如下:
● 传参时,传入参数数据皆为Json格式数据。
● 传入参数中,需要传入token,date,code,sign,requestJson。token为项目唯一接入编号。date为请求时间戳,格式为“4位年+2位月+2位日+2位小时(24小时制)+2位分+2位秒”,简缩:YYYY-MM-DD HH:MM:SS。code为闸机厂商编号。 sign为签名后的字符串,sign=32MD5(token+key+code+date)转小写,签名规则:把token、key、code、date的字符串按顺序连接起来(token+key+code+date)再进行32位的MD5加密转小写。requestJson为具体业务接口请求操作的数据Data,requestJson里面的Data数据是Json格式的数据经过AES加密后的字符串。具体传参请参考文档后面的调用说明和示例。
● 接口中各项参数当标识是M时参数必选,为O时可选。
● 敏感信息如:请求签名sign需要加密传输,使用32位MD5加密,把token、key、code、date的字符串按顺序连接起来(token+key+code+date)再进行32位的MD5加密转小写;业务参数requestJson需要加密传输,使用AES加密,加密Key等于接入密钥。AES加解密测试网址:http://tool.chacuo.net/cryptdes。32位MD5加解密测试网址:https://www.qqxiuzi.cn/bianma/md5.htm。
● AES加解密算法说明:
编码=UTF8,
算法密钥=接入密钥key(共8位数)+token(前8位),
算法的初始化向量(IV)=接入密钥key(共8位数)+token(前8位),
加密模式(Mode)=CBC,
填充模式(PaddingMode)=PKCS7,
数据块大小(BlockSize)=128,
加密后的字节数组转为base64编码的字符串。
算法:密文=Base64(AES加密(data,key))
● 32为MD5加解密测试:例如,
Token = “9cb6eff3e44de93c316a21858ac4845a”
Key = “539D415A”
Code =“564rt56tee”
Date =“2021-10-11 09:13:19”
token+key+code+date = “9cb6eff3e44de93c316a21858ac4845a539D415A564rt56tee2021-10-11 09:13:19”
密文=32MD5(token+key+code+date)转小写 =“f98b11fc776f7db597ec47286fd882b0”
● AES加解密算法测试:例如,requestJson =
{
"corpCode": "45678912345678978U",
"teamName": "网关测试一班",
"responsiblePersonName": "网关路人01",
"responsiblePersonPhone": "13555555555",
"responsiblePersonIdNumber": "430621199509111234",
"remark": "",
"entryTime": "2021-10-09",
"entryAttachments": [{
"data": "",
"name": "图片001"
}],
"exitTime": "",
"exitAttachments": [{
"data": "",
"name": ""
}]
}
接入密钥Key:539D415A,
算法秘钥:539D415A9cb6eff3 (秘钥+token前8位)
算法的初始化向量(IV):539D415A9cb6eff3 (秘钥+token前8位)
则密文:k2bIxmo9i9JW7lfqS1NaveIn8iNrT/Zu6VqT+s4/B07IbGvyZ61NWuxL0NzwDEmj4Qip1WEv/+ilTYqSTJqXvlJ7BvVJkgS5uqyA+nFWBZZ2YBi2JtyW4oNJRx3wKZo54sgZ3YWB5BGnMRfONfRPZgO+GreZj4E6dMbKKQA2S7rl+te/qX9jib9US8nbd7a0MMQ8ET7Hz3AwXh0Th0NSGx0iH/E1ZMr+p4HcofgABKaayi8vHHiwuWwTEPOO77ricHxntLEfVwi4AhtOXj1JZk0LrGoa2klJc3D0dACkF7IQ7eV5ANFkHbXSNuVVp8hlPCqlkDVhm+sY5X+MSJprpYgYNThFudze5n9Qp49HS6s4k0A729KMSWkLGxhjOGG9Ds5vH/zz+2XrLLKCxcm0sv56NJHzeSvX4c0/NFkB5y1WTAGbzeci6iYGKjNNRLm+BbOlzKzRerTzLQapQ+ys9a8pcI/6dvucj+AKJuYhwN0JXi+hFYFniXEYmkveOpBAk/H088wZpBfhtKWkLJHiPQ==
最终请求Json
{
"token": "9cb6eff3e44de93c316a21858ac4845a",
"date": "2021-10-11 09:13:19",
"sign": "3007d2e2755949bc15d136fe9ba3f8f0",
"code": "564rt56tee",
"requestJson": "k2bIxmo9i9JW7lfqS1NaveIn8iNrT/Zu6VqT+s4/B07IbGvyZ61NWuxL0NzwDEmj4Qip1WEv/+ilTYqSTJqXvlJ7BvVJkgS5uqyA+nFWBZZ2YBi2JtyW4oNJRx3wKZo54sgZ3YWB5BGnMRfONfRPZgO+GreZj4E6dMbKKQA2S7rl+te/qX9jib9US8nbd7a0MMQ8ET7Hz3AwXh0Th0NSGx0iH/E1ZMr+p4HcofgABKaayi8vHHiwuWwTEPOO77ricHxntLEfVwi4AhtOXj1JZk0LrGoa2klJc3D0dACkF7IQ7eV5ANFkHbXSNuVVp8hlPCqlkDVhm+sY5X+MSJprpYgYNThFudze5n9Qp49HS6s4k0A729KMSWkLGxhjOGG9Ds5vH/zz+2XrLLKCxcm0sv56NJHzeSvX4c0/NFkB5y1WTAGbzeci6iYGKjNNRLm+BbOlzKzRerTzLQapQ+ys9a8pcI/6dvucj+AKJuYhwN0JXi+hFYFniXEYmkveOpBAk/H088wZpBfhtKWkLJHiPQ=="
}
三、接口说明
● 所有接口响应的返回信息均以JSON字符串形式返回,可以使用JSON工具包对其进行解析。
● 返回信息具体字段参照接口说明中的响应参数,以下以举例:
处理成功:
{"code":200,"message":"操作成功!","success":true,"timestamp":1633923841498,"result":null}
处理失败:
{"code":105,"message":"当前为非POST请求!","success":false,"timestamp":1633923841498"result":null}
● 返回结果码对照见参数表结果码对照表。
接口说明
接口描述 | 为系统添加普通班组信息。成功则返回班组编码teamNo 逻辑描述: 1、token必填,根据token关联查询项目信息 2、teamName必填且在同一个项目中必须唯一,会做唯一性校验 3、corpCode必填,根据corpCode查询企业相关信息 4、entryTime必填,且班组进场时间不能大于当前时间,不能选择未来时间 5、管理班组无法通过该接口录入,需要通过建数平台同步,根据查询接口获取管理班组信息 |
请求地址 | /openapi/projectTeamMaster/add |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/openapi/projectTeamMaster/add |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 班组新增信息Json字符串。需AES加密 |
requestJson班组新增信息参数
参数 | 限制 | 数据类型 | 备注 |
corpCode | M | string(18) | 班组所属公司的统一社会信用代码 |
teamName | M | string(100) | 班组名称.同一项目下不可重复 |
responsiblePersonName | M | string(50) | 班组所在企业负责人姓名 |
responsiblePersonPhone | M | string(50) | 班组所在企业负责人联系电话 |
responsiblePersonIdNumber | M | string(18) | 班组所在企业身份证号码。 |
remark | O | string(200) | 备注 |
entryTime | O | string(10) | 班组进场日期 格式yyyy-MM-dd |
entryAttachments | O | List<string> | 进场附件,有进场日期时, 此字段必填。List<string>集合。附 件总数不超过5个 |
entryAttachments数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
name | M | string(50) | 附件名称 |
data | M | string | 附件Base64字符串,不超过 1M |
响应参数
参数 | 限制 | 数据类型 | 备注 |
code | M | int | 返回结果码 |
success | O | boolean | 成功标识true/false |
result | O | string | teamNo 班组编号 |
message | O | string | 错误/成功信息描述 |
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 为系统修改普通班组信息,team_no和corp_code为定位字段 逻辑描述: 1、token必填,根据token关联查询项目信息 2、teamName在修改时如果和原来的名称不一样,会校验新修改的班组名唯一性 |
请求地址 | /openapi/projectTeamMaster/edit |
测试请求地址 | http://kakashi.ktpis.com:30030//ktp-core-openapi-start/openapi/projectTeamMaster/edit |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 班组修改信息Json字符串。需AES加密 |
requestJson班组修改信息参数
参数 | 限制 | 数据类型 | 备注 |
teamNo | M | string(36) | 班组编码 |
corpCode | M | string(18) | 班组所属公司的统一社会信用代码 |
teamName | M | string(100) | 班组名称.班组名称.同一项目下不可重复 |
responsiblePersonName | M | string(50) | 班组所在企业负责人姓名 |
responsiblePersonPhone | M | string(50) | 班组所在企业负责人联系电话 |
responsiblePersonIdNumber | M | string(18) | 班组所在企业负责人身份证号码。 |
remark | O | string(200) | 备注 |
entryTime | O | string(10) | 班组进场日期 格式yyyy-MM-dd |
entryAttachments | O | List<string> | 进场附件,有进场日期时, 此字段必填。List<string>。附 件总数不超过5个 |
entry_attachments数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
name | M | string(50) | 附件名称 |
data | M | string | 附件Base64字符串,不超过 1M |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | string | teamNo 班组编号 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 为系统查询班组信息 逻辑描述: 1、token必填,根据token关联查询项目信息 2、根据入参分页查询相关数据 |
请求地址 | /openapi/projectTeamMaster/list |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/ /openapi/projectTeamMaster/list |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 班组信息查询Json字符串。需AES加密 |
requestJson班组信息查询参数
参数 | 限制 | 数据类型 | 备注 |
teamNo | O | string(36) | 班组编码 |
teamType | O | int | 是否项目管理部,参考班组类型字典表字典(编号team_type,1-普通班组,2-管理班组) |
pageIndex | M | int | 指定页号,以1为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | 分页结果集 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
result内对象字段
参数 | 限制 | 数据类型 | 备注 |
totalCount | M | int | 记录总数 |
pageIndex | M | int | 指定页号,以1为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
rows | M | List<string> | 记录List<string>集合。Json数组 |
rows数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
teamNo | M | string(36) | 班组编码 |
corpCode | M | string(18) | 班组所属公司的统一社会信用代码 |
corpName | M | string(200) | 班组所属公司名称 |
teamName | M | string(100) | 班组名称 |
responsiblePersonName | M | string(50) | 班组所在企业负责人姓名 |
responsiblePersonPhone | M | string(50) | 班组所在企业负责人联系电话 |
responsiblePersonIdNumber | M | string(18) | 班组所在企业负责人身份证号码。 |
remark | O | string(200) | 备注 |
entryTime | M | string(10) | 班组进场日期 格式yyyy-MM-dd |
entryAttachments | O | List<string> | 班组进场图片有进场日期时,此字段必填。不超过5张800kb的图片base64字符串集合 |
exitTime | O | string(10) | 班组退场日期 格式yyyy-MM-dd |
exitAttachments | O | List<string> | 班组退场图片有进场日期时,此字段必填。不超过5张800kb的图片base64字符串集合 |
teamType | M | int | 是否项目管理部,参考是否字典表(编号team_type,1-普通班组,2-管理班组) |
接口说明
接口描述 | 往系统添加工人身份证基础信息,成功则返回workerNo 身份证号已存在则提示:已存在该人员的实名信息 |
请求地址 | /worker/workerBasicInfo/uploadWorkerInfo |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/worker/workerBasicInfo/uploadWorkerInfo |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 新增工人实名制信息Json字符串。需AES加密 |
requestJson新增工人实名制信息参数
参数 | 限制 | 数据类型 | 备注 |
workerName | M | string(50) | 工人姓名 |
idCardNumber | M | string(18) | 身份证号码 |
nation | M | string(10) | 身份证上民族,参考 民族字典表 |
address | M | string(200) | 身份证上的住址。 |
headImageUrl | M | string | 身份证头像图片 不超过50kb的图片base64字符串 |
grantOrg | M | string(20) | 身份证上发证机关 |
cultureLevelType | M | string(2) | 工人文化程度,参考 文化程度字典表字典编码EDUCATION_EVEL |
politicsType | M | string(2) | 工人政治面貌,参考 政治面貌字典表字典编码POLITICAL_STATUS_TYPE |
positiveIdCardImageUrl | O | string | 身份证正面图片 不超过500kb的图片base64字符串 |
negativeIdCardImageUrl | O | string | 身份证反面图片 不超过500kb的图片base64字符串 |
startDate | O | string(10) | 身份证生效日期 格式yyyy-MM-dd |
expiryDate | O | string(10) | 身份证失效日期 格式yyyy-MM-dd |
workDate | O | string(10) | 开始工作时间yyyy-MM-dd |
maritalStatus | O | string(2) | 婚姻状态 参考婚姻状态字典表字典编码MARITAL_STATUS_TYPE |
specialty | O | string(200) | 特长 |
isJoined | O | int | 是否加入工会 ,参考 是否字典表字典编码YES_NO_FLAG 1-是 0否 |
joinedTime | O | string(10) | 加入工会时间,格式yyyy-MM-dd |
hasBadMedicalHistory | O | int | 是否有重大病史,参考 是否字典表字典编码YES_NO_FLAG 1-是 0否 |
urgentLinkMan | O | string(50) | 紧急联系人姓名 |
urgentLinkManPhone | O | string(50) | 紧急联系电话 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | string | workerNo | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 查询系统下某个身份证号或工人编码的身份证基础信息 |
请求地址 | /worker/workerBasicInfo/queryWorkerBasicInfo |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/worker/workerBasicInfo/queryWorkerBasicInfo |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 工人实名制信息查询Json字符串。需AES加密 |
requestJson工人实名制信息查询参数
参数 | 限制 | 数据类型 | 备注 |
idCardNumber | O | string(18) | 工人身份证号 |
workerNo | O | string(36) | 工人编码,两个参数必填一个 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | 工人基础信息对象 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
result数据内对象字段
参数 | 限制 | 数据类型 | 备注 |
workerNo | M | string(36) | 工人编码 |
workerName | M | string(50) | 工人姓名 |
idCardNumber | M | string | 身份证号码 |
nation | M | string(10) | 身份证上民族,参考 民族字典表 |
address | M | string(200) | 身份证上的住址。 |
headImageUrl | M | string | 身份证头像图片 不超过50kb的图片base64字符串 |
grantOrg | M | string(20) | 身份证上发证机关 |
cultureLevelType | M | string(2) | 工人文化程度,参考 文化程度字典表字典编码EDUCATION_EVEL |
politicsType | M | string(2) | 工人政治面貌,参考 政治面貌字典表字典编码POLITICAL_STATUS_TYPE |
positiveIdCardImage_url | O | string | 身份证正面图片 不超过500kb的图片base64字符串 |
negativeIdCardImageUrl | O | string | 身份证反面图片 不超过500kb的图片base64字符串 |
startDate | O | string(10) | 身份证生效日期 格式yyyy-MM-dd |
expiryDate | O | string(10) | 身份证失效日期 格式yyyy-MM-dd |
workDate | O | string(10) | 开始工作时间yyyy-MM-dd |
maritalStatus | O | string(2) | 婚姻状态 参考婚姻状态字典表字典编码MARITAL_STATUS_TYPE |
specialty | O | string(200) | 特长 |
isJoined | O | int | 是否加入工会 ,参考 是否字典表字典编码YES_NO_FLAG 1-是 0否 |
joinedTime | O | string(10) | 加入工会时间,格式yyyy-MM-dd |
hasBadMedicalHistory | O | int | 是否有重大病史,参考 是否字典表字典编码YES_NO_FLAG 1-是 0否 |
urgentLinkMan | O | string(50) | 紧急联系人姓名 |
urgentLinkManPhone | O | string(50) | 紧急联系电话 |
接口说明
接口描述 | 把工人加入项目的班组,corp_code和team_no和id_card_number是定位字段 逻辑描述: 1、token必填,根据token关联查询项目信息 2、corpCode必填,根据corpCode查询企业相关信息 3、teamNo必填,根据teamNo查询班组信息 4、entryTime必填,项目工人进场时间不能大于当前时间,不能选择未来时间,如果有退场记录,则进场时间不能小于最后一次退场时间 5、根据teamNo和idCardNumber校验工人是否已经进场,不能重复提交数据 6、根据idCardNumber和projectId(token中获取)校验项目工人是否有实名制信息记录,如果查询不到实名制信息则不能进场 7、根据idCardNumber和projectId(token中获取)校验项目工人进退场记录,如果数据库中存在记录且入参teamNo和数据库中的teamNo不一致,则判断数据库中的工人是否已经退场,如果没有退场则提示用户先退场在进场,在同一个项目中一个工人不能同加入多个不同的班组,项目工人信息在项目中唯一 8、根据根据teamNo和workType校验当前项目工人加入的是普通班组还是管理班组,普通工人只能加入普通班组,管理人员只能加入管理班组 9、根据isTeamLeader判断当前工人是否是班组长,如果是则更新对应的班组表将班组长信息录入 10、工人进退场都会保存历史记录 |
请求地址 | /openapi/projectWorker/add |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/openapi/projectWorker/add |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 新增项目工人信息Json字符串。需AES加密 |
requestJson新增项目工人信息参数
参数 | 限制 | 数据类型 | 备注 |
corpCode | M | string(18) | 工人所属公司的统一社会信用代码 |
teamNo | M | string(36) | 班组编码。workerRole=10(管理人员)时班组编码必须为工人所属公司下的项目管理部班组的编码 |
idCardNumber | M | string | 身份证号码 |
isTeamLeader | M | int | 是否班组长,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) |
workType | M | string(4) | 工人工种,参考工种字典表,workerRole=10时工种类型必须为workType=900管理人员 (字典编码WORKER_TYPE) |
workerRole | M | int | 工人类型,workerRole=10时必填。参考工人类型字典表(字典编码WorkerRole ) |
managerType | O | string(10) | 工人管理岗位。workerRole=10管理工人时必填。工人所属公司参建类型不同,则管理岗位不同,具体参考工人管理岗位类型字典表 (字典编码manage_type) 1,监理单位。包含参建类型:监理,可选择的管理岗位为: 总监理工程师、副总监理工程师、总监理工程师代表、专业监理工程师、 监理工程师、监理员、安全监理工程师、监理安全员、其它 2,建设单位。包含参建类型:建设单位,可选择的管理岗位为: 项目总工程师、项目经理、工程经理、项目技术负责人、项目工程师 3,施工单位(总承包)。包含参建类型:总承包单位,可选择的管理岗位为: 项目经理、项目副经理、项目总监、项目工程师、项目管理员、施工员、 质量员、安全员、标准员、材料员、机械员、劳务员、资料员、测量员、 试验员、造价员、质量负责人、安全负责人、技术负责人 4,其它参建单位(除了上述三种参建类型之外的所有类型)。 可选择的管理岗位为: 项目经理、劳务员、安全员、生产经理、技术负责人、物资材料工程师、 其它 |
issueCardDate | O | string(10) | 发卡时间。格式:yyyy-MM-dd |
issueCardPicUrl | O | string | 办卡采集相片。不超过50kb的图片base64字符串 |
cardNumber | O | string(20) | 考勤卡号 |
phone | M | string(11) | 工人手机号 |
entryTime | M | string(10) | 工人进场时间。格式yyyy-MM-dd |
entryAttachmentUrl | O | string | 工人进场凭证图片不超过50kb的图片base64字符串 |
hasMedicalInsurance | M | int | 是否参加城乡居民医疗保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) |
hasAgeInsurance | M | int | 是否参加城乡居民养老保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) |
hasBuyInsuranceWork | M | int | 是否购买工伤保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) |
hasBuyInsuranceAccident | M | int | 是否购买意外伤害保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) |
hasContract | M | int | 是否签订劳动合同,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) |
payrollTopBankCode | M | Varchar(20) | 工资卡银行代码参考数据字典:银行代码字典表(字典编码BANK_CODE) |
payrollBankCardNumber | M | Varchar | 发放工资银行卡号 |
payrollBankName | M | Varchar(50) | 发放工资银行名称 |
bankLinkNumber | O | Varchar(30) | 工资卡银行联号 |
wageApprovedWay | M | Varchar(10) | 工种工资核定方式 。天|小时|月|件 |
wageCriterion | M | Decimal(18,2) | 工种工资核定标准(元)。浮点数,最大保留2位小数(无符号) |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | String | projectWorkerNo项目工人编号 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 修改工人加入项目的班组的信息,corp_code和team_no和id_card_number是定位字段 逻辑描述 1、token必填,根据token关联查询项目信息 2、corpCode必填,根据corpCode查询企业相关信息 3、teamNo必填,根据teamNo查询班组信息 4、根据teamNo和idCardNumber校验工人是否已经退场,退场的工人不能修改信息 5、根据idCardNumber和projectId(token中获取)校验项目工人是否存在,不存则无法修改,提示用户需要工人先进场 6、根据idCardNumber和projectId(token中获取)校验项目工人进退场记录,如果数据库中存在记录且入参teamNo和数据库中的teamNo不一致,则判断数据库中的工人是否已经退场,如果没有退场则提示用户先退场在进场,在同一个项目中一个工人不能同加入多个不同的班组,项目工人信息在项目中唯一 7、根据根据teamNo和workType校验当前项目工人加入的是普通班组还是管理班组,普通工人只能加入普通班组,管理人员只能加入管理班组 8、根据isTeamLeader判断当前工人是否是班组长,如果是则更新对应的班组表将班组长信息录入 |
请求地址 | /openapi/projectWorker/edit |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/ /openapi/projectWorker/edit |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 修改项目工人信息Json字符串。需AES加密 |
requestJson修改项目工人信息参数
参数 | 限制 | 数据类型 | 备注 | ||
corpCode | M | string(18) | 工人所属公司的统一社会信用代码 | ||
teamNo | M | string(36) | 班组编码。workerRole=10(管理人员)时班组编码必须为工人所属公司下的项目管理部班组的编码 | ||
idCardNumber | M | string | 身份证号码 | ||
isTeamLeader | M | int | 是否班组长,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | ||
workType | M | string(4) | 工人工种,参考工种字典表,workerRole=10时工种类型必须为workType=900管理人员 (字典编码WORKER_TYPE) | ||
workerRole | M | int | 工人类型,workerRole=10时必填。参考工人类型字典表(字典编码WorkerRole ) | ||
managerType | O | string(10) | 工人管理岗位。workerRole=10管理工人时必填。工人所属公司参建类型不同,则管理岗位不同,具体参考工人管理岗位类型字典表 (字典编码manage_type) 1,监理单位。包含参建类型:监理,可选择的管理岗位为: 总监理工程师、副总监理工程师、总监理工程师代表、专业监理工程师、 监理工程师、监理员、安全监理工程师、监理安全员、其它 2,建设单位。包含参建类型:建设单位,可选择的管理岗位为: 项目总工程师、项目经理、工程经理、项目技术负责人、项目工程师 3,施工单位(总承包)。包含参建类型:总承包单位,可选择的管理岗位为: 项目经理、项目副经理、项目总监、项目工程师、项目管理员、施工员、 质量员、安全员、标准员、材料员、机械员、劳务员、资料员、测量员、 试验员、造价员、质量负责人、安全负责人、技术负责人 4,其它参建单位(除了上述三种参建类型之外的所有类型)。 可选择的管理岗位为: 项目经理、劳务员、安全员、生产经理、技术负责人、物资材料工程师、 其它 | ||
issueCardDate | O | string(10) | 发卡时间。格式:yyyy-MM-dd | ||
issueCardPicUrl | O | string | 办卡采集相片。不超过50kb的图片base64字符串 | ||
cardNumber | O | string(20) | 考勤卡号 | ||
phone | M | string(11) | 工人手机号 | ||
hasMedicalInsurance | M | int | 是否参加城乡居民医疗保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | ||
hasAgeInsurance | M | int | 是否参加城乡居民养老保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | ||
hasBuyInsuranceWork | M | int | 是否购买工伤保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | ||
hasBuyInsuranceAccident | M | int | 是否购买意外伤害保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | ||
hasContract | M | int | 是否签订劳动合同,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | ||
payrollTopBankCode | M | string(20) | 工资卡银行代码参考数据字典:银行代码字典表(字典编码BANK_CODE) | ||
payrollBankCardNumber | M | string | 发放工资银行卡号 | ||
payrollBankName | M | string(50) | 发放工资银行名称 | ||
bankLinkNumber | O | string(30) | 工资卡银行联号 | ||
wageApprovedWay | M | string(10) | 工种工资核定方式 。天|小时|月|件 | ||
wageCriterion | M | Decimal(18,2) | 工种工资核定标准(元)。浮点数,最大保留2位小数(无符号) |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | ||
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 查询已加入项目的工人信息 逻辑描述: 1、token必填,根据token关联查询项目信息 2、根据入参分页查询相关数据 |
请求地址 | /openapi/projectWorker/list |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/ /openapi/projectWorker/list |
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 查询项目工人信息Json字符串。需AES加密 |
请求参数
requestJson查询项目工人信息参数
参数 | 限制 | 数据类型 | 备注 |
teamNo | O | string(36) | 班组编码 |
idCardNumber | O | string(18) | 身份证号码 |
pageIndex | M | Int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | Int | 每页记录数,默认20。最多不能超过50 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | 分页结果集 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
result内对象字段
参数 | 限制 | 数据类型 | 备注 |
totalCount | M | Int | 记录总数 |
pageIndex | M | Int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | Int | 每页记录数,默认20。最多不能超过50 |
rows | M | List<string> | 记录List<string>集合。JSON数组 |
rows数组内对象字段
参数 | 限制 | 数据类型 | 备注 | |||
corpCode | M | string(18) | 工人所属公司的统一社会信用代码 | |||
teamNo | M | string(36) | 班组编码。workerRole=10(管理人员)时班组编码必须为工人所属公司下的项目管理部班组的编码 | |||
idCardNumber | M | string | 身份证号码 | |||
isTeamLeader | M | int | 是否班组长,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | |||
workType | M | string(4) | 工人工种,参考工种字典表,workerRole=10时工种类型必须为workType=900管理人员 (字典编码WORKER_TYPE) | |||
workerRole | M | int | 工人类型,workerRole=10时必填。参考工人类型字典表(字典编码WorkerRole ) | |||
managerType | O | string(10) | 工人管理岗位。workerRole=10管理工人时必填。工人所属公司参建类型不同,则管理岗位不同,具体参考工人管理岗位类型字典表 (字典编码manage_type) 1,监理单位。包含参建类型:监理,可选择的管理岗位为: 总监理工程师、副总监理工程师、总监理工程师代表、专业监理工程师、 监理工程师、监理员、安全监理工程师、监理安全员、其它 2,建设单位。包含参建类型:建设单位,可选择的管理岗位为: 项目总工程师、项目经理、工程经理、项目技术负责人、项目工程师 3,施工单位(总承包)。包含参建类型:总承包单位,可选择的管理岗位为: 项目经理、项目副经理、项目总监、项目工程师、项目管理员、施工员、 质量员、安全员、标准员、材料员、机械员、劳务员、资料员、测量员、 试验员、造价员、质量负责人、安全负责人、技术负责人 4,其它参建单位(除了上述三种参建类型之外的所有类型)。 可选择的管理岗位为: 项目经理、劳务员、安全员、生产经理、技术负责人、物资材料工程师、 其它 | |||
issueCardDate | O | string(10) | 发卡时间。格式:yyyy-MM-dd | |||
issueCardPicUrl | O | string | 办卡采集相片。不超过50kb的图片base64字符串 | |||
cardNumber | O | string(20) | 考勤卡号 | |||
phone | M | string(11) | 工人手机号 | |||
entryTime | M | string(10) | 工人进场时间。格式yyyy-MM-dd | |||
entryAttachmentUrl | O | string | 工人进场凭证图片不超过50kb的图片base64字符串 | |||
hasMedicalInsurance | M | int | 是否参加城乡居民医疗保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | |||
hasAgeInsurance | M | int | 是否参加城乡居民养老保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | |||
hasBuyInsuranceWork | M | int | 是否购买工伤保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | |||
hasBuyInsuranceAccident | M | int | 是否购买意外伤害保险,参考是否字典表(字典编码YES_NO_FLAG 1-是 0否) | |||
payrollTopBankCode | M | string(20) | 工资卡银行代码参考数据字典:银行代码字典表(字典编码BANK_CODE) | |||
payrollBankCardNumber | M | string | 发放工资银行卡号 | |||
payrollBankName | M | string(50) | 发放工资银行名称 | |||
bankLinkNumber | O | string(30) | 工资卡银行联号 | |||
wageApprovedWay | M | string(10) | 工种工资核定方式 。天|小时|月|件 | |||
wageCriterion | M | Decimal(18,2) | 工种工资核定标准(元)。浮点数,最大保留2位小数(无符号) |
接口说明
接口描述 | 把已加入项目班组的工人信息上传合同信息,corp_code和id_card_number是定位字段,参建单位下工人合同信息只有一个,重复添加会报错 |
请求地址 | /openapi/projectWorkerContract/add |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/openapi/projectWorkerContract/add |
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 新增项目工人合同信息Json字符串。需AES加密 |
请求参数
requestJson新增项目工人合同信息参数
参数 | 限制 | 数据类型 | 备注 |
corpCode | M | string(18) | 工人所属公司的统一社会信用代码 |
idCardNumber | M | string | 身份证号码 |
contractPeriodType | M | int | 工人合同类型,参考工人合同期限类型字典表字典编码CONTRACT_TERM_TYPE |
startDate | M | string(10) | 工人合同生效日期 格式yyyy-MM-dd |
endDate | M | string(10) | 工人合同失效日期 格式yyyy-MM-dd |
attachments | M | List<string> | 合同附件 不超过2个文件 |
unit | O | int | 合同 计量单位。参考计量单位字典表 字典编码MEASURE_UNIT_TYPE |
unitPrice | O | Decimal(18,2) | 合同 计量单价。根据结算方式,对应的单价,单位:元 |
attachments数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
name | O | string(50) | 附件名称 |
data | O | string | 附件Base64字符串,不超过 1M |
响应参数
参数 | 限制 | 数据类型 | 备注 | ||
code | M | int | 返回结果码 | ||
success | O | boolean | 成功标识true/false | ||
result | O | String | |||
message | O | string | 错误/成功信息描述 | ||
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 查询已加入项目班组的工人合同信息 |
请求地址 | openapi/projectWorkerContract/list |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/ktp-core-openapi-start/openapi/projectWorkerContract/list |
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 查询项目工人合同信息Json字符串。需AES加密 |
请求参数
requestJson查询项目工人合同信息参数
参数 | 限制 | 数据类型 | 备注 |
corpCode | O | string(18) | 工人所属公司的统一社会信用代码 |
idCardNumber | O | string(18) | 身份证号码 |
pageIndex | M | int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | 分页结果集 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
result内对象字段
参数 | 限制 | 数据类型 | 备注 |
totalCount | M | int | 记录总数 |
pageIndex | M | int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
rows | M | List<string> | 记录List<string>集合。JSON数组 |
rows数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
corpCode | M | string(18) | 工人所属公司的统一社会信用代码 |
corpName | M | string(200) | 工人所属公司名称 |
idCardNumber | M | string | 身份证号码 |
workerName | M | string(50) | 工人姓名 |
contractPeriodType | M | int | 工人合同类型,参考工人合同期限类型字典表字典编码CONTRACT_TERM_TYPE |
startDate | M | string(10) | 工人合同生效日期 格式yyyy-MM-dd |
endDate | M | string(10) | 工人合同失效日期 格式yyyy-MM-dd |
attachments | M | List<string> | 合同附件 不超过2个文件 |
unit | O | int | 合同 计量单位。参考计量单位字典表字典编码MEASURE_UNIT_TYPE |
unitPrice | O | Decimal(18,2) | 合同 计量单价。根据结算方式,对应的单价,单位:元 |
attachments数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
name | M | string(50) | 附件名称 |
data | M | string | 附件Base64字符串,不超过 1M |
接口说明
接口描述 | 把已加入项目班组的工人进行退场,corp_code和team_no和id_card_number是定位字段 逻辑描述: 1、token必填,根据token关联查询项目信息 2、根据teamNo和idCardNumber校验工人是否已经退场,不能重复退场 3、exitTime必填,退场时间不能大于当前时间不能选择未来时间,同时退场时间不能小于最后一次进场时间 |
请求地址 | /openapi/projectWorker/exit |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/ /openapi/projectWorker/exit |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 项目工人退场信息Json字符串。需AES加密 |
requestJson项目工人退场信息参数
参数 | 限制 | 数据类型 | 备注 |
corpCode | M | string(18) | 工人所属公司的统一社会信用代码 |
teamNo | M | string(36) | 班组编码 |
idCardNumber | M | string | 身份证号码 |
exitTime | M | string(10) | 退场日期 格式yyyy-MM-dd |
exitAttachments | O | string | 退场图片。 不超过50kb的图片base64字符串 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | ||
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 新增班组工人考勤记录信息。 逻辑描述: 1、token必填,根据token关联查询项目信息 2、date必填,考勤时间不能小于工人进场时间 3、已完工或已停工的项目,不在接收考勤数据 |
请求地址 | /openapi/projectWorkerAttendance/add |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/openapi/projectWorkerAttendance/add |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 新增工人考勤信息Json字符串。需AES加密 |
requestJson新增工人考勤信息参数
参数 | 限制 | 数据类型 | 备注 |
teamNo | M | string(36) | 班组编码 |
idCardNumber | M | string | 身份证号码 |
direction | M | string(2) | 刷卡进出方向。参考工人考勤方向字典表(字典编号WORKER_ATTENDANCE_DIRECTION 0-出场 1-进场) |
date | M | string(19) | 刷卡时间,yyyy-MM-dd HH:mm:ss |
imageUrl | M | string | 刷卡近照。Base64字符串,不超 过50KB |
attendType | M | string(3) | 通行方式。参考工人通行方式字典表(字典编号 WORKER_ACCESS ) |
channel | O | string(50) | 通道的名称 |
lng | O | decimal(18,15) | WGS84经度 |
lat | O | decimal(18,15) | WGS84纬度 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | ||
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 查询班组工人考勤记录信息。 逻辑描述: 1、token必填,根据token关联查询项目信息 2、根据入参分页查询相关数据 |
请求地址 | /openapi/projectWorkerAttendance/list |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/openapi/projectWorkerAttendance/list |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 查询工人考勤信息Json字符串。需AES加密 |
requestJson查询工人考勤信息参数
参数 | 限制 | 数据类型 | 备注 |
date | M | string(10) | 考勤时间,yyyy-MM-dd |
teamNo | O | string(36) | 班组编码 |
idCardNumber | O | string | 身份证号码 |
pageIndex | M | int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | 分页结果集 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
result内对象字段
参数 | 限制 | 数据类型 | 备注 |
totalCount | M | Int | 记录总数 |
pageIndex | M | Int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | Int | 每页记录数,默认20。最多不能超过50 |
rows | M | List<string> | 记录集合。JSON数组 |
rows数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
teamNo | M | string(36) | 班组编码 |
idCardNumber | M | string | 身份证号码 |
type | M | string(2) | 刷卡进出方向。参考工人考勤方向字典表 |
checkDate | M | string(19) | 刷卡时间,yyyy-MM-dd HH:mm:ss |
image | M | string | 刷卡近照。Base64字符串,不超 过50KB |
attendType | M | string(3) | 通行方式。参考工人通行方式字典表 |
channel | O | string(50) | 通道的名称 |
lng | O | decimal(18,15) | WGS84经度 |
lat | O | decimal(18,15) | WGS84纬度 |
接口说明
接口描述 | 新增总包公司下的工资发放银行卡。成功返回银行卡bank_no 已存在该银行卡号则提示该银行卡已被添加 |
请求地址 | /corpBankInfo/projectCorpInfoBankInfos/addCorpInfoBankInfo |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/corpBankInfo/projectCorpInfoBankInfos/addCorpInfoBankInfo |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 新增工资发放银行卡信息Json字符串。需AES加密 |
requestJson新增工资发放银行卡信息参数
参数 | 限制 | 数据类型 | 备注 |
bankCode | M | string(20) | 银行代码。参考银行代码字典表字典表BANK_CODE |
bankName | M | string(50) | 银行支行名称 |
bankNumber | M | string | 银行卡号。 |
bankLinkNumber | O | string(30) | 银行联号 |
personName | O | string(50) | 专户联系人姓名 |
personPhone | O | string(50) | 专户联系人电话 |
响应参数
参数 | 限制 | 数据类型 | 备注 | ||
code | M | int | 返回结果码 | ||
success | O | boolean | 成功标识true/false | ||
result | O | data | bankNo | ||
message | O | string | 错误/成功信息描述 | ||
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 修改bank_no的工资发放银行卡信息。 |
请求地址 | /corpBankInfo/projectCorpInfoBankInfos/editCorpInfoBankInfo |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/corpBankInfo/projectCorpInfoBankInfos/editCorpInfoBankInfo |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 修改工资发放银行卡信息Json字符串。需AES加密 |
requestJson修改工资发放银行卡信息参数
参数 | 限制 | 数据类型 | 备注 |
bankNo | M | string(36) | 银行卡id |
bankCode | M | string(20) | 银行代码。参考银行代码字典表字典表BANK_CODE |
bankName | M | string(50) | 银行支行名称 |
bankNumber | M | string | 银行卡号。 |
bankLinkNumber | O | string(30) | 银行联号 |
personName | O | string(50) | 专户联系人姓名 |
personPhone | O | string(50) | 专户联系人电话 |
响应参数
参数 | 限制 | 数据类型 | 备注 | ||
code | M | int | 返回结果码 | ||
success | O | boolean | 成功标识true/false | ||
result | O | data | |||
message | O | string | 错误/成功信息描述 | ||
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 查询总包下的工资发放银行卡。 |
请求地址 | /corpBankInfo/projectCorpInfoBankInfos/queryPageList |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/corpBankInfo/projectCorpInfoBankInfos/queryPageList |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 查询工资发放银行卡信息Json字符串。需AES加密 |
requestJson查询工资发放银行卡信息参数
参数 | 限制 | 数据类型 | 备注 |
pageIndex | M | int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | 分页结果集 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
result内对象字段
参数 | 限制 | 数据类型 | 备注 |
totalCount | M | int | 记录总数 |
pageIndex | M | int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
rows | M | List<string> | 记录List<string>集合。JSON数组 |
rows数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
bankNo | M | Varchar(36) | 银行卡id |
bankCode | M | Varchar(20) | 银行代码。参考银行代码字典表字典表BANK_CODE |
bankName | M | Varchar(50) | 银行支行名称 |
bankNumber | M | Varchar | 银行卡号 |
bankLinkNumber | O | Varchar(30) | 银行联号 |
personName | O | Varchar(50) | 专户联系人姓名 |
personPhone | O | Varchar(50) | 专户联系人电话 |
接口说明
接口描述 | 新增工资单信息。成功则返回工资单编码pay_roll_no |
请求地址 | /openapi/projectPayroll/addProjectPayroll |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/openapi/projectPayroll/addProjectPayroll |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 新增工资单信息Json字符串。需AES加密 |
requestJson新增工资单信息参数
参数 | 限制 | 数据类型 | 备注 |
corpCode | M | string(18) | 工人所属公司的统一社会信用代码 |
bankNumber | M | string | 工资代发的银行卡号。 |
teamNo | M | string(36) | 班组编码 |
payMonth | M | string(7) | 发放工资的月份。格式yyyy-MM |
attachments | O | List<string> | 工资单附件。JSON数组,附件总 数不超过5个 |
detailList | M | List<string> | 工资单详情列表。 |
attachments数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
name | M | string(50) | 附件名称 |
data | M | string | 附件Base64字符串,不超过 1M |
detailList参数
参数 | 限制 | 数据类型 | 备注 |
idCardNumber | M | string | 工人身份证号 |
days | O | Int | 当月出勤天数,单位天 |
workHours | O | Decimal(5,2) | 当月总工时(单位,小时) |
payRollBankCardNumber | M | string | 工人工资卡号 |
payRollBankCode | M | string(20) | 工人工资卡银行代码,参考 银行代码字典表字典表BANK_CODE |
payRollBankName | M | string(50) | 工人工资卡开户行名称 |
totalPayAmount | M | Decimal(16,2) | 应发金额(元) |
actualAmount | M | Decimal(16,2) | 实发金额(元) |
isBackPay | M | int | 是否补发,参考是否字典表字典编码YES_NO_FLAG 1-是 0否 |
backPayMonth | O | string(7) | 补发年月;当补发时必填;格式yyyy-MM |
balanceDate | M | string(10) | 发放日期,格式yyyy-MM-dd |
响应参数
参数 | 限制 | 数据类型 | 备注 | ||
code | M | int | 返回结果码 | ||
success | O | Boolean | 成功标识true/false | ||
result | O | data | payRollNo | ||
message | O | string | 错误/成功信息描述 | ||
timestamp | O | BigInteger | 时间戳 |
接口说明
接口描述 | 查询工资单信息 |
请求地址 | /openapi/projectPayroll/list |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/openapi/projectPayroll/list |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 查询工资单信息Json字符串。需AES加密 |
requestJson查询工资单信息参数
参数 | 限制 | 数据类型 | 备注 |
payMonth | M | string(7) | 发放工资的月份。格式yyyy-MM |
corpCode | O | string(18) | 工人所属公司的统一社会信用代码 |
teamNo | O | string(36) | 班组编码 |
payRollNo | O | string(36) | 工资单编码 |
pageIndex | M | Int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | Int | 每页记录数,默认20。最多不能超过50 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | 分页结果集 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
result内对象字段
参数 | 限制 | 数据类型 | 备注 |
totalCount | M | int | 记录总数 |
pageIndex | M | int | 指定页号,以0为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
rows | M | List<string> | 记录集合。JSON数组 |
rows数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
payRollNo | M | string(36) | 工资单编码 |
corpCode | M | string(36) | 工人所属公司的统一社会信用代码 |
teamNo | M | string(7) | 班组编码 |
payMonth | M | string | 发放工资的月份。格式yyyy-MM |
attachments | O | List<string> | 工资单附件。JSON数组,附件总 数不超过5个 |
detailList | M | List<string> | 工资单详情列表。 |
attachments数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
name | O | string(50) | 附件名称 |
data | O | string | 附件Base64字符串,不超过 1M |
detailList数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
idCardNumber | M | string | 工人身份证号 |
days | O | int | 当月出勤天数,单位天 |
workHours | O | Decimal(5,2) | 当月总工时(单位,小时) |
payRollBankCardNumber | M | string | 工人工资卡号 |
payRollBankCode | M | string(20) | 工人工资卡银行代码,参考 银行代码字典表字典表BANK_CODE |
payRollBankName | M | string(50) | 工人工资卡开户行名称 |
totalPayAmount | M | Decimal(16,2) | 应发金额(元) |
actualAmount | M | Decimal(16,2) | 实发金额(元) |
isBackPay | M | int | 是否补发,参考是否字典表字典编码YES_NO_FLAG 1-是 0否 |
backPayMonth | O | string(7) | 补发年月;当补发时必填;格式yyyy-MM |
balanceDate | M | string(10) | 发放日期 |
接口说明
接口描述 | 为系统添加非五方主体单位的参建单位信息。(即,监理单位,总包单位,设计单位等五方单位无法通过该接口新增) |
请求地址 | /openapi/projectCorpInfo/add |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/openapi/projectCorpInfo/add |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 新增参建单位信息Json字符串。需AES加密 |
requestJson非五方主体参建单位新增信息参数
参数 | 限制 | 数据类型 | 备注 |
corpCode | M | string(18) | 参建单位统一社会信用代码 |
corpName | M | string(200) | 参建单位名称 |
corpType | M | string(3) | 参建单位类型: 001专业分包 002设备分包 003材料分包 004后勤服务 005特殊设备 006劳务分包 012其它 |
areaCode | M | string(10) | 参建单位所在区域编码 |
registerDate | M | string(10) | 注册日期 格式yyyy-MM-dd |
pmIdCardNumber | O | string(30) | 项目经理身份证号码 |
pmName | O | string(50) | 项目经理姓名 |
pmPhone | O | string(50) | 项目经理电话 |
响应参数
参数 | 限制 | 数据类型 | 备注 |
code | M | int | 返回结果码 |
success | O | boolean | 成功标识true/false |
result | O | string | Null |
message | O | string | 错误/成功信息描述 |
timestamp | O | bigInteger | 时间戳 |
接口说明
接口描述 | 可查询当前项目下所有的参建单位信息 |
请求地址 | /openapi/projectCorpInfo/list |
测试请求地址 | http://kakashi.ktpis.com:30030/ktp-core-openapi-start/openapi/projectCorpInfo/list |
请求参数
参数 | 限制 | 数据类型 | 备注 |
token | M | string | 项目编号token |
date | M | string | 当前接口请求时间日期 格式yyyy-MM-dd HH:mm:ss |
sign | M | string | 签名:sign=32MD5(token+key+code+date)转小写 |
code | M | string | 闸机厂商编码code |
requestJson | M | string | 查询参建单位信息Json字符串。需AES加密 |
requestJson 查询信息参数
参数 | 限制 | 数据类型 | 备注 |
corpCode | O | string(18) | 参建单位统一社会信用代码 |
corpType | O | string(3) | 参建单位类型: 001专业分包 002设备分包 003材料分包 004后勤服务 005特殊设备 006劳务分包 007监理 008建设单位 009总承包单位 010勘察 011设计单位 012其它 |
pageIndex | M | int | 指定页号,以1为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
响应参数
参数 | 限制 | 数据类型 | 备注 | |
code | M | int | 返回结果码 | |
success | O | boolean | 成功标识true/false | |
result | O | data | 分页结果集 | |
message | O | string | 错误/成功信息描述 | |
timestamp | O | bigInteger | 时间戳 |
result内对象字段
参数 | 限制 | 数据类型 | 备注 |
totalCount | M | int | 记录总数 |
pageIndex | M | int | 指定页号,以1为起始数字,表示第1页 |
pageSize | M | int | 每页记录数,默认20。最多不能超过50 |
rows | M | List<string> | 记录List<string>集合。Json数组 |
rows数组内对象字段
参数 | 限制 | 数据类型 | 备注 |
id | M | string(32) | id |
corpCode | M | string(18) | 参建单位统一社会信用代码 |
corpName | M | string(200) | 参建单位名称 |
corpType | M | string(3) | 参建单位类型: 001专业分包 002设备分包 003材料分包 004后勤服务 005特殊设备 006劳务分包 007监理 008建设单位 009总承包单位 010勘察 011设计单位 012其它 |
areaCode | M | string(10) | 参建单位所在区域编码 |
registerDate | M | string(10) | 注册日期 格式yyyy-MM-dd |
pmIdCardType | O | string(2) | 项目经理证件类型 |
pmIdCardNumber | O | string(30) | 项目经理身份证号码 |
pmName | O | string(50) | 项目经理姓名 |
pmPhone | O | string(50) | 项目经理电话 |
四、附录
1,数据公司需加入对接QQ群(972906588);
2,提供公司信息获取数据公司code及测试项目token+key;
3,根据接口文档内容在测试环境下对接接口;
4,测试环境对接接口没有问题后,即可获取正式环境地址,对正式数据进行对接。
1. 生成签名
Token = “9cb6eff3e44de93c316a21858ac4845a”
Key = “539D415A”
Code =“564rt56tee”
Date =“2021-10-11 09:13:19”
token+key+code+date = “9cb6eff3e44de93c316a21858ac4845a539D415A564rt56tee2021-10-11 09:13:19”
密文=32MD5(token+key+code+date)转小写 =“f98b11fc776f7db597ec47286fd882b0”
2. 请求参数AES加密
requestJson =
{
"corpCode": "45678912345678978U",
"teamName": "网关测试一班",
"responsiblePersonName": "网关路人01",
"responsiblePersonPhone": "13555555555",
"responsiblePersonIdNumber": "430621199509111234",
"remark": "",
"entryTime": "2021-10-09",
"entryAttachments": [{
"data": "",
"name": "图片001"
}],
"exitTime": "",
"exitAttachments": [{
"data": "",
"name": ""
}]
}
接入密钥Key:539D415A,
算法秘钥:539D415A9cb6eff3 (秘钥+token前8位)
算法的初始化向量(IV):539D415A9cb6eff3 (秘钥+token前8位)
则密文:k2bIxmo9i9JW7lfqS1NaveIn8iNrT/Zu6VqT+s4/B07IbGvyZ61NWuxL0NzwDEmj4Qip1WEv/+ilTYqSTJqXvlJ7BvVJkgS5uqyA+nFWBZZ2YBi2JtyW4oNJRx3wKZo54sgZ3YWB5BGnMRfONfRPZgO+GreZj4E6dMbKKQA2S7rl+te/qX9jib9US8nbd7a0MMQ8ET7Hz3AwXh0Th0NSGx0iH/E1ZMr+p4HcofgABKaayi8vHHiwuWwTEPOO77ricHxntLEfVwi4AhtOXj1JZk0LrGoa2klJc3D0dACkF7IQ7eV5ANFkHbXSNuVVp8hlPCqlkDVhm+sY5X+MSJprpYgYNThFudze5n9Qp49HS6s4k0A729KMSWkLGxhjOGG9Ds5vH/zz+2XrLLKCxcm0sv56NJHzeSvX4c0/NFkB5y1WTAGbzeci6iYGKjNNRLm+BbOlzKzRerTzLQapQ+ys9a8pcI/6dvucj+AKJuYhwN0JXi+hFYFniXEYmkveOpBAk/H088wZpBfhtKWkLJHiPQ==
最终请求Json
{
"token": "9cb6eff3e44de93c316a21858ac4845a",
"date": "2021-10-11 09:13:19",
"sign": "3007d2e2755949bc15d136fe9ba3f8f0",
"code": "564rt56tee",
"requestJson": "k2bIxmo9i9JW7lfqS1NaveIn8iNrT/Zu6VqT+s4/B07IbGvyZ61NWuxL0NzwDEmj4Qip1WEv/+ilTYqSTJqXvlJ7BvVJkgS5uqyA+nFWBZZ2YBi2JtyW4oNJRx3wKZo54sgZ3YWB5BGnMRfONfRPZgO+GreZj4E6dMbKKQA2S7rl+te/qX9jib9US8nbd7a0MMQ8ET7Hz3AwXh0Th0NSGx0iH/E1ZMr+p4HcofgABKaayi8vHHiwuWwTEPOO77ricHxntLEfVwi4AhtOXj1JZk0LrGoa2klJc3D0dACkF7IQ7eV5ANFkHbXSNuVVp8hlPCqlkDVhm+sY5X+MSJprpYgYNThFudze5n9Qp49HS6s4k0A729KMSWkLGxhjOGG9Ds5vH/zz+2XrLLKCxcm0sv56NJHzeSvX4c0/NFkB5y1WTAGbzeci6iYGKjNNRLm+BbOlzKzRerTzLQapQ+ys9a8pcI/6dvucj+AKJuYhwN0JXi+hFYFniXEYmkveOpBAk/H088wZpBfhtKWkLJHiPQ=="
}
3. 根据接口请求地址发送Post请求
注意:上诉参数仅供参考,请以实际数据为准
● 传输图片无特殊说明,均为图片转base64后的字符串。
● 接口说明中,若参数字体为红色,请仔细阅读备注说明。
● 请求返回结果码不为200时,则需要根据提示信息修改错误后再次提交;
● 图片上传支持的格式:".jpg", ".png", ".jpeg", ".bmp"
● 无特殊说明,则数据格式均为string类型。有数据格式说明的,则需要根据具体说明变动。
● 测试调试接口步骤。
(1),按照接口文档编写对接接口程序。
(2),联系对接人员,对接测试服务器的项目。
(3),测试服务器对接成功后,联系对接人员,转换token和key为正式服务器项目的参数即可。
五、参数表
返回码 | 返回码文本介绍 | 说明 |
200 | 请求成功/接收成功/操作成功 | 当且仅当返回码为200时,请求成功 |
101 | 签名验证失败 | 签名验证失败或找不到对应签名 |
102 | 参数错误 | 参数长度或数据类型错误或传参错误 |
103 | 接入编号token错误 | 接入编号token不存在 |
104 | 超时请求 | Date传参超时。5分钟内有效。 |
105 | 错误请求(非Post请求) | 请求方式均为Post。 |
107 | Code查询失败 | 闸机厂商code校验失败 |
-1 | 系统内部异常:[..],请稍候再试 | 系统内部异常,返回异常描述 |
编码 | 类型 |
1 | 是 |
0 | 否 |
编码 | 民族 |
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 | 哈萨克族 |
编码 | 文化程度类型 |
1 | 小学 |
2 | 初中 |
3 | 高中 |
4 | 中专 |
5 | 大专 |
6 | 本科 |
7 | 硕士 |
8 | 博士 |
99 | 其他 |
编码 | 政治面貌类型 |
1 | 中共党员 |
2 | 中共预备党员 |
3 | 共青团员 |
4 | 民革党员 |
5 | 民盟盟员 |
6 | 民建会员 |
7 | 民进会员 |
8 | 农工党党员 |
9 | 致公党党员 |
10 | 九三学社社员 |
11 | 台盟盟员 |
12 | 无党派人士 |
13 | 群众 |
编码 | 婚姻状态类型 |
1 | 未婚 |
2 | 已婚 |
3 | 离异 |
4 | 丧偶 |
编码 | 工种类型 |
10 | 砌筑工 |
20 | 钢筋工 |
30 | 架子工 |
40 | 混凝土工 |
50 | 模板工 |
60 | 机械设备安装工 |
70 | 通风工 |
80 | 安装起重工 |
90 | 安装钳工 |
100 | 电气设备安装调试工 |
110 | 管道工 |
120 | 变电安装工 |
130 | 建筑电工 |
140 | 司泵工 |
150 | 挖掘铲运和桩工机械司机 |
160 | 桩机操作工 |
170 | 起重信号工 |
180 | 建筑起重机械安装拆卸工 |
190 | 装饰装修工 |
200 | 室内成套设施安装工 |
210 | 建筑门窗幕墙安装工 |
220 | 幕墙制作工 |
230 | 防水工 |
240 | 木工 |
250 | 石工 |
270 | 电焊工 |
280 | 爆破工 |
290 | 除尘工 |
300 | 测量放线工 |
310 | 线路架设工 |
320 | 古建筑传统石工 |
330 | 古建筑传统瓦工 |
340 | 古建筑传统彩画工 |
350 | 古建筑传统木工 |
360 | 古建筑传统油工 |
380 | 金属工 |
390 | 杂工 |
900 | 管理人员 |
1000 | 其它 |
编码 | 人员类型 |
10 | 管理人员 |
20 | 建筑工人 |
编码 | 管理岗位 |
1001 | 总监理工程师 |
1002 | 副总监理工程师 |
1003 | 安全监理工程师 |
1004 | 专业监理工程师 |
1005 | 监理工程师 |
1006 | 监理员 |
1007 | 监理安全员 |
1008 | 项目总工程师 |
1009 | 项目经理 |
1010 | 工程经理 |
1011 | 项目技术负责人 |
1012 | 项目工程师 |
1013 | 项目管理员 |
1014 | 项目副经理 |
1015 | 项目总监 |
1016 | 施工员 |
1017 | 质量员 |
1018 | 安全员 |
1019 | 标准员 |
1020 | 材料员 |
1021 | 机械员 |
1022 | 劳务员 |
1023 | 资料员 |
1024 | 总监理工程师代表 |
1025 | 测量员 |
1026 | 试验员 |
1027 | 造价员 |
1028 | 质量负责人 |
1029 | 安全负责人 |
1030 | 技术负责人 |
1031 | 生产经理 |
1032 | 物资材料工程师 |
1099 | 其它 |
编码 | 类型 |
000 | 其他 |
100 | 中国邮政储蓄银行 |
102 | 中国工商银行 |
103 | 中国农业银行 |
104 | 中国银行 |
105 | 中国建设银行 |
201 | 国家开发银行 |
202 | 中国进出口银行 |
203 | 中国农业发展银行 |
301 | 交通银行 |
302 | 中信银行 |
303 | 中国光大银行 |
304 | 华夏银行 |
305 | 中国民生银行 |
306 | 广东发展银行 |
307 | 深圳发展银行 |
308 | 招商银行 |
309 | 兴业银行 |
310 | 上海浦东发展银行 |
311 | 上海银联商务/东莞商业银行 |
314 | 农村商业银行(江苏) |
315 | 恒丰银行 |
316 | 浙商银行 |
317 | 农村合作银行 |
318 | 渤海银行股份有限公司 |
319 | 徽商银行股份有限公司 |
320 | 镇银行有限责任公司 |
401 | 城市信用社 |
402 | 农村信用社(含北京农村商业银行)、东莞农信 |
403 | 中国邮政储蓄银行(代收付) |
501 | 汇丰银行 |
502 | 东亚银行 |
503 | 南洋商业银行 |
504 | 恒生银行(中国)有限公司 |
505 | 中国银行(香港)有限公司 |
507 | 创兴银行有限公司 |
509 | 星展银行(中国)有限公司 |
510 | 永亨银行(中国)有限公司 |
512 | 永隆银行 |
531 | 花旗银行(中国)有限公司 |
532 | 美国银行有限公司 |
533 | 摩根大通银行(中国)有限公司 |
561 | 三菱东京日联银行(中国)有限公司 |
563 | 日本三井住友银行股份有限公司 |
564 | 瑞穗实业银行(中国)有限公司 |
565 | 日本山口银行股份有限公司 |
591 | 韩国外换银行股份有限公司 |
593 | 友利银行(中国)有限公司 |
594 | 韩国产业银行 |
595 | 新韩银行(中国)有限公司 |
596 | 韩国中小企业银行有限公司 |
597 | 韩亚银行(中国)有限公司 |
621 | 华侨银行(中国)有限公司 |
622 | 大华银行(中国)有限公司 |
623 | 星展银行(中国)有限公司 |
631 | 泰国盘谷银行(大众有限公司) |
641 | 奥地利中央合作银行股份有限公司 |
651 | 比利时联合银行股份有限公司 |
652 | 比利时富通银行有限公司 |
661 | 荷兰银行 |
662 | 荷兰安智银行股份有限公司 |
671 | 渣打银行 |
672 | 英国苏格兰皇家银行公众有限公司 |
691 | 法国兴业银行(中国)有限公司 |
694 | 法国东方汇理银行股份有限公司 |
695 | 法国外贸银行股份有限公司 |
711 | 德国德累斯登银行股份公司 |
712 | 德意志银行(中国)有限公司 |
713 | 德国商业银行股份有限公司 |
714 | 德国西德银行股份有限公司 |
715 | 德国巴伐利亚州银行 |
716 | 德国北德意志州银行 |
732 | 意大利联合圣保罗银行股份有限公司 |
741 | 瑞士信贷银行股份有限公司 |
742 | 瑞士银行 |
751 | 加拿大丰业银行有限公司 |
752 | 加拿大蒙特利尔银行有限公司 |
761 | 澳大利亚和新西兰银行集团有限公司 |
771 | 摩根士丹利国际银行(中国)有限公司 |
775 | 联合银行(中国)有限公司 |
776 | 荷兰合作银行有限公司 |
781 | 厦门国际银行 |
782 | 法国巴黎银行(中国)有限公司 |
785 | 华商银行 |
787 | 华一银行 |
897 | 广东农村信用合作社(收单) |
898 | 银联商务(收单) |
969 | (澳门地区)银行 |
989 | (香港地区)银行 |
9997 | 支付宝 |
9998 | 浙江网商银行股份有限公司 |
ARCU | 安徽省农村信用社 |
ASCB | 鞍山银行 |
AYCB | 安阳银行 |
BANKWF | 潍坊银行 |
BGB | 广西北部湾银行 |
BHB | 河北银行 |
BJBANK | 北京银行 |
BJRCB | 北京农村商业银行 |
BOCD | 承德银行 |
BOCY | 朝阳银行 |
BOD | 东莞银行 |
BODD | 丹东银行 |
BOHAIB | 渤海银行 |
BOJZ | 锦州银行 |
BOP | 平顶山银行 |
BOQH | 青海银行 |
BOSZ | 苏州银行 |
BOYK | 营口银行 |
BOZK | 周口银行 |
BSB | 包商银行 |
BZMD | 驻马店银行 |
CBBQS | 城市商业银行资金清算中心 |
CBKF | 开封市商业银行 |
CCQTGB | 重庆三峡银行 |
CDCB | 成都银行 |
CDRCB | 成都农商银行 |
CGNB | 南充市商业银行 |
CQBANK | 重庆银行 |
CRCBANK | 重庆农村商业银行 |
CSCB | 长沙银行 |
CSRCB | 常熟农村商业银行 |
CZCB | 浙江稠州商业银行 |
CZRCB | 常州农村信用联社 |
DAQINGB | 龙江银行 |
DLB | 大连银行 |
DRCBCL | 东莞农村商业银行 |
DYCB | 德阳商业银行 |
DYCCB | 东营市商业银行 |
DZBANK | 德州银行 |
FDB | 富滇银行 |
FJHXBC | 福建海峡银行 |
FSCB | 抚顺银行 |
FXCB | 阜新银行 |
GCB | 广州银行 |
GDRCC | 广东省农村信用社联合社 |
GLBANK | 桂林银行 |
GRCB | 广州农商银行 |
GSRCU | 甘肃省农村信用 |
GXRCU | 广西省农村信用 |
GYCB | 贵阳市商业银行 |
GZB | 赣州银行 |
GZRCU | 贵州省农村信用社 |
H3CB | 内蒙古银行 |
HANABANK | 韩亚银行 |
HBC | 湖北银行 |
HBHSBANK | 湖北银行黄石分行 |
HBRCU | 河北省农村信用社 |
HBYCBANK | 湖北银行宜昌分行 |
HDBANK | 邯郸银行 |
HKB | 汉口银行 |
HNRCC | 湖南省农村信用社 |
HNRCU | 河南省农村信用 |
HRXJB | 华融湘江银行 |
HSBANK | 徽商银行 |
HSBK | 衡水银行 |
HURCB | 湖北省农村信用社 |
HZCB | 杭州银行 |
HZCCB | 湖州市商业银行 |
JHBANK | 金华银行 |
JINCHB | 晋城银行 |
JJBANK | 九江银行 |
JLBANK | 吉林银行 |
JLRCU | 吉林农信 |
JNBANK | 济宁银行 |
JRCB | 江苏江阴农村商业银行 |
JSB | 晋商银行 |
JSBANK | 江苏银行 |
JSRCU | 江苏省农村信用联合社 |
JXBANK | 嘉兴银行 |
JXRCU | 江西省农村信用 |
JZBANK | 晋中市商业银行 |
KLB | 昆仑银行 |
KORLABANK | 库尔勒市商业银行 |
KSRB | 昆山农村商业银行 |
LANGFB | 廊坊银行 |
LSBANK | 莱商银行 |
LSBC | 临商银行 |
LSCCB | 乐山市商业银行 |
LYBANK | 洛阳银行 |
LYCB | 辽阳市商业银行 |
LZYH | 兰州银行 |
MTBANK | 浙江民泰商业银行 |
NBBANK | 宁波银行 |
NBYZ | 鄞州银行 |
NCB | 南昌银行 |
NHB | 南海农村信用联社 |
NHQS | 农信银清算中心 |
NJCB | 南京银行 |
NXBANK | 宁夏银行 |
NXRCU | 宁夏黄河农村商业银行 |
NYNB | 广东南粤银行 |
ORBANK | 鄂尔多斯银行 |
PSBC | 中国邮政储蓄银行 |
QDCCB | 青岛银行 |
QLBANK | 齐鲁银行 |
SCCB | 三门峡银行 |
SCRCU | 四川省农村信用 |
SDEB | 顺德农商银行 |
SDRCU | 山东农信 |
SHBANK | 上海银行 |
SHRCB | 上海农村商业银行 |
SJBANK | 盛京银行 |
SPABANK | 平安银行 |
SRBANK | 上饶银行 |
SRCB | 深圳农村商业银行 |
SXCB | 绍兴银行 |
SXRCCU | 陕西信合 |
SZSBK | 石嘴山银行 |
TACCB | 泰安市商业银行 |
TCCB | 天津银行 |
TCRCB | 江苏太仓农村商业银行 |
TRCB | 天津农商银行 |
TZCB | 台州银行 |
URMQCCB | 乌鲁木齐市商业银行 |
WHCCB | 威海市商业银行 |
WHRCB | 武汉农村商业银行 |
WJRCB | 吴江农商银行 |
WRCB | 无锡农村商业银行 |
WZCB | 温州银行 |
XABANK | 西安银行 |
XCYH | 许昌银行 |
XLBANK | 中山小榄村镇银行 |
XTB | 邢台银行 |
XXBANK | 新乡银行 |
XYBANK | 信阳银行 |
YBCCB | 宜宾市商业银行 |
YDRCB | 尧都农商行 |
YNRCC | 云南省农村信用社 |
YQCCB | 阳泉银行 |
YXCCB | 玉溪市商业银行 |
ZBCB | 齐商银行 |
ZDY_GZBANK | 贵州银行 |
ZGCCB | 自贡市商业银行 |
ZJKCCB | 张家口市商业银行 |
ZJNX | 浙江省农村信用社联合社 |
ZJTLCB | 浙江泰隆商业银行 |
ZRCBANK | 张家港农村商业银行 |
ZYCBANK | 遵义市商业银行 |
ZZBANK | 郑州银行 |
编码 | 类型 |
0 | 固定期限合同 |
1 | 以完成一定工作为期限的合同 |
编码 | 计量单位类型 |
80 | 米 |
81 | 平方米 |
82 | 立方米 |
编码 | 类型 |
1 | 入场 |
0 | 出场 |
编码 | 工人通行方式类型 |
1 | 人脸识别 |
2 | 虹膜识别 |
3 | 指纹识别 |
4 | 掌纹识别 |
5 | 身份证识别 |
6 | 实名卡 |
7 | 异常清退(适用于人员没有通过闸机系统出工地而导致人员状态不一致的情况) |
8 | 一键开闸(需要与闸机交互) |
9 | 应急通道(不需要与闸机交互) |
10 | 二维码识别 |
11 | 其他方式 |
编码 | 班组类型 |
1 | 普通班组 |
2 | 项目管理部 |
六、联系方式
QQ群:贵州省智慧建管实名制设备对接群(972906588)
部分内容由用户投稿或者来源于网络,如有侵权,请联系底部邮箱进行删除!非常感谢您的支持!