苏州市建筑业从业人员实名制管理信息平台
·6h
数据共享规范V2.2
文件状态: [ ]草稿 [ ]正在修改 [√]正式发布 | 当前版本: | 2.2 |
作 者: | ||
完成日期: | 2018.11.05 |
目 录
1文档介绍PAGEREF _Toc529196086 \h3
1.1 文档目的PAGEREF _Toc529196087 \h3
1.2 文档范围PAGEREF _Toc529196088 \h3
1.3 读者对象PAGEREF _Toc529196089 \h3
1.4 概念定义PAGEREF _Toc529196090 \h3
2共享目录及接入流程说明PAGEREF _Toc529196091 \h4
3数据标准及接口定义PAGEREF _Toc529196092 \h5
3.1项目基础信息(GB_ProjectInfo)PAGEREF _Toc529196093 \h5
3.2企业基础信息(GB_EnterpriseInfo)PAGEREF _Toc529196094 \h6
3.3人员基本信息(GB_Worker)PAGEREF _Toc529196095 \h8
3.4项目用工信息(GB_Prj_Worker)PAGEREF _Toc529196096 \h10
3.5人证比对(GB_PhotoComparison)PAGEREF _Toc529196097 \h12
3.6工人考勤信息(GB_Clocking-in)PAGEREF _Toc529196098 \h12
3.7工人现场考勤照片信息(GB_Clocking_Image)PAGEREF _Toc529196099 \h13
3.8工人现场考勤信息(GB_Kqxx)PAGEREF _Toc529196100 \h13
3.9获取工人现场考勤信息的有效性(GB_Kqxx)PAGEREF _Toc529196101 \h14
编写本文档的目的为苏州市建筑业从业人员实名制管理信息平台的数据交换与共享提供统一规范标准。
适用于苏州市建筑业从业人员实名制管理信息平台建设工作。
用户方业务人员、技术人员,系统设计人员、系统开发人员。
数据共享规范:指针对部分企业自行建立了工地现场考勤软件系统,需要接入苏州市建筑业从业人员实名制管理信息平台的信息内容与数据标准,主要涵盖从平台共享项目、企业、工人等基础信息,并向平台推送考勤信息。
数据交互示意图
序号 | 交换内容 | 表名 | 备注 |
1 | 项目基础信息 | GB_ProjectInfo | 从平台下载 |
2 | 企业基础信息 | GB_EnterpriseInfo | 从平台下载 |
3 | 工人基础信息 | GB_Worker | 从平台下载 |
4 | 项目用工信息 | GB_Prj_Worker | 从平台下载 |
5 | 工人考勤信息 | GB_Clocking-in | 向平台推送 |
数据接口地址:
http://218.4.84.171:8060/AppWebService/GHBackBone_DataDocking.asmx
施工企业自建考勤系统接入前,需要在市平台中进行项目初始信息登记并申请接入,系统自动生成项目数据指纹(DataNumber),通过数据指纹可完成与平台的信息下载和上传。
基础字段 | 描述 | 类型 | 附加说明 |
result | 接口响应 | Int | 1成功,0失败 |
success | 操作状态 | Boolean | true成功,false失败 |
datastate | 业务处理状态 | Int | 只针对success为true时生效 |
msg | 返回信息 | String | 接口返回的信息,通常是错误类型码的原因信息 |
(1) 表结构
字段名称 | 字段代码 | 字段 类型 | 字段 长度 | 小数 位数 | 约束 条件 | 备注 |
合同备案编号 | PrjNumber | varchar | 20 | M | 与省一体化监管平台合同备案编号一致 | |
项目名称 | PrjName | varchar | 600 | M | ||
项目所在区县 | County | varchar | 20 | M | 姑苏区、高新区、工业园区、吴中区、相城区、太湖度假区、昆山市、常熟市、太仓市、张家港市、吴江市 | |
项目属地 | Ssdq | varchar | 20 | O | 项目所属区县下的乡镇 | |
项目地址 | PrjAdress | varchar | 1000 | O | ||
建筑面积(平方米) | Jzmj | float | O | |||
工程造价(万元) | Gczj | numeric | 14 | 4 | O | |
建设单位名称 | Jsdw | varchar | 400 | M | ||
建设单位社会信用代码 | JsdwZzjgdm | varchar | 20 | O | ||
建设单位联系人 | Jdwlxr | varchar | 30 | O | ||
建设单位联系电话 | Jsdwlxdh | varchar | 30 | O |
(2) 方法名
GetProject(string dataNumber,string bagsBH)
参数说明:1、dataNumber项目数据指纹
2、bsgsBH 现场考勤系统提供商登记编号
(3)返回XML文档
<?xml version="1.0"?>
<DataTable>
<Projects>
<Project>
<PrjNumber>合同备案编号</PrjNumber>
<PrjName>项目名称</PrjName>
<County>项目所在区县</County>
<Ssdq>项目属地</Ssdq>
<PrjAdress>项目地址</PrjAdress>
<Jzmj>建筑面积(平方米)</Jzmj>
<Gczj>工程造价(万元)</Gczj>
<Jsdw>建设单位名称</Jsdw>
<JsdwZzjgdm>建设单位社会信用代码</JsdwZzjgdm>
<Jdwlxr>建设单位联系人</Jdwlxr>
<Jsdwlxdh>建设单位联系电话</Jsdwlxdh>
</Project>
</Projects>
</DataTable>
说明:如果查询结果为空,则返回的XML文档为空值
(1) 表结构
字段名称 | 字段代码 | 字段 类型 | 字段 长度 | 小数 位数 | 约束 条件 | 备注 |
企业名称 | Qymc | varchar | 400 | M | ||
统一社会信用代码 | Qyzzjgdm | Varchar | 100 | M | ||
合同备案编号 | PrjNumber | varchar | 20 | M | 与省一体化监管平台合同备案编号一致 | |
参建类型 | Cjlx | Varchar | 30 | M | 总承包、专业承包、专业分包、监理单位、建设单位 | |
企业联系人 | Qylxr | Varchar | 30 | O | ||
企业联系电话 | Qylxdh | Varchar | 30 | O |
(2) 方法名
GetEnterprises(string dataNumber, string bagsBH)
参数说明:1、dataNumber项目数据指纹
2、bsgsBH 现场考勤系统提供商登记编号
(3)返回XML文档
<?xml version="1.0"?>
<DataTable>
<Enterprises>
<Enterprise>
<Qymc>企业名称</Qymc>
<Qyzzjgdm>统一信用社会代码</Qyzzjgdm>
<PrjNumber>合同备案编号</PrjNumber>
<Cjlx>参建类型</Cjlx>
<Qylxr>企业联系人</Qylxr>
<Qylxdh>企业联系电话</Qylxdh>
</Enterprise>
<Enterprise>
<Qymc>企业名称</Qymc>
<Qyzzjgdm>统一信用社会代码</Qyzzjgdm>
<PrjNumber>合同备案编号</PrjNumber>
<Cjlx>参建类型</Cjlx>
<Qylxr>企业联系人</Qylxr>
<Qylxdh>企业联系电话</Qylxdh>
</Enterprise>
</Enterprises>
</DataTable>
说明:如果查询结果为空,则返回的XML文档为空值
(1) 表结构
字段名称 | 字段代码 | 字段 类型 | 字段 长度 | 小数 位数 | 约束 条件 | 备注 |
人员姓名 | WorkerName | nvarchar | 20 | M | ||
证件号码 | Zjhm | varchar | 20 | M | ||
性别 | Xb | nvarchar | 2 | M | ||
住址 | Zz | nvarchar | 100 | O | ||
出生日期 | Csrq | datetime | M | |||
身份证照片 | Image | Image | M | |||
民族 | Mz | nvarchar | 10 | M | ||
身份证有效起日期 | Sfzyxqrq | date | M | |||
身份证有效止日期 | Sfzyxzrq | date | M | |||
身份证发证机关 | SfzFzjg | varchar | 100 | O | ||
所属省份 | Province | nvarchar | 10 | M | ||
所属城市 | City | nvarchar | 10 | O | ||
所属区县 | County | nvarchar | 10 | O | ||
联系电话 | Lxdh | varchar | 20 | O |
(2) 方法名
GetWorkers(string dataNumber,string bagsBH)
GetWorkerImage(string zjhm, string dataNumber,string bagsBH)
参数说明:1、dataNumber项目数据指纹
2、bsgsBH 现场考勤系统提供商登记编号
(3)返回XML文档
<?xml version="1.0"?>
<DataTable>
<Workers>
<Worker>
<WorkerName>人员姓名</WorkerName>
<Zjhm>证件号码</Zjhm>
<Xb>性别</Xb>
<Zz>住址</Zz>
<Csrq>出生日期</Csrq>
<Mz>民族</Mz>
<Sfzyxqrq>身份证有效起日期</Sfzyxqrq>
<Sfzyxzrq>身份证有效止日期</Sfzyxzrq>
<SfzFzjg>身份证发证机关</SfzFzjg>
<Province>所属省份</Province>
<City>所属城市</City>
<County>所属区县</County>
<Lxdh>联系电话</Lxdh>
</Worker>
<Worker>
<WorkerName>人员姓名</WorkerName>
<Zjhm>证件号码</Zjhm>
<Xb>性别</Xb>
<Zz>住址</Zz>
<Csrq>出生日期</Csrq>
<Mz>民族</Mz>
<Sfzyxqrq>身份证有效起日期</Sfzyxqrq>
<Sfzyxzrq>身份证有效止日期</Sfzyxzrq>
<SfzFzjg>身份证发证机关</SfzFzjg>
<Province>所属省份</Province>
<City>所属城市</City>
<County>所属区县</County>
<Lxdh>联系电话</Lxdh>
</Worker>
</Workers>
</DataTable>
说明:如果查询结果为空,则返回的XML文档为空值
GetWorkerImage获取人员照片返回XML
<?xml version="1.0"?>
<DataTable>
<WorkerImages>
<WorkerImage>
<Image>二代证照片</Image>
</WorkerImage>
</WorkerImages>
</DataTable>
说明:如果查询结果为空,则返回的XML文档为空值
(1) 表结构
字段名称 | 字段代码 | 字段 类型 | 字段 长度 | 小数 位数 | 约束 条件 | 备注 |
证件号码 | Zjhm | varchar | 20 | M | 与GB_Worker一致 | |
合同备案编号 | PrjNumber | varchar | 20 | M | 与省一体化监管平台合同备案编号一致 | |
统一社会信用代码 | Qyzzjgdm | Varchar | 100 | M | ||
班组名称 | Bzmc | Varchar | 100 | M | ||
人员类型 | WorkerType | varchar | 20 | M | 管理人员,普通工人 | |
管理人员岗位类别 | Gwlb | varchar | 20 | O | ||
工种类别 | TPType | varchar | 50 | O | ||
工种名称 | TPCodeName | varchar | 50 | O | ||
计划开始用工日期 | BeginDate | datetime | M | |||
计划用工结束日期 | EndDate | datetime | M | |||
工号 | GH | int | M |
(2) 方法名
GetWorkerHmc(stringdataNumber,string bagsBH)
参数说明:1、dataNumber项目数据指纹
2、bsgsBH 现场考勤系统提供商登记编号
(3)返回XML文档
<?xml version="1.0"?>
<DataTable>
<WorkerHmcs>
<WorkerHmc>
<Zjhm>证件号码</Zjhm>
<PrjNumber>合同备案编号</PrjNumber>
<Qyzzjgdm>统一社会信用代码</Qyzzjgdm>
<Bzmc>班组名称</Bzmc>
<WorkerType>人员类型</WorkerType>
<Gwlb>管理人员岗位类别</Gwlb>
<TPType>工种类别</TPType>
<TPCodeName>工种名称</TPCodeName>
<BeginDate>计划开始用工日期</BeginDate>
<EndDate>计划用工结束日期</EndDate>
<GH>工号</GH>
</WorkerHmc>
<WorkerHmc>
<Zjhm>证件号码</Zjhm>
<PrjNumber>合同备案编号</PrjNumber>
<Qyzzjgdm>统一社会信用代码</Qyzzjgdm>
<Bzmc>班组名称</Bzmc>
<WorkerType>人员类型</WorkerType>
<Gwlb>管理人员岗位类别</Gwlb>
<TPType>工种类别</TPType>
<TPCodeName>工种名称</TPCodeName>
<BeginDate>计划开始用工日期</BeginDate>
<EndDate>计划用工结束日期</EndDate>
<GH>工号</GH>
</WorkerHmc>
</WorkerHmcs>
</DataTable>
说明:如果查询结果为空,则返回的XML文档为空值
(1) 表结构
字段名称 | 字段代码 | 字段 类型 | 字段 长度 | 小数 位数 | 约束 条件 | 备注 |
数据指纹 | dataNumber | varchar | 50 | M | ||
证件号码 | Zjhm | varchar | 20 | M | 保持与GB_Worker一致 | |
现场照片 | Image | varchar | Max | M | base64字符串 |
(2) 方法名
上传校验人证比对,返回人证比对结果1为成功 -1为失败
UploadPhotoComparison(stringdataNumber,string zjhm,string image,string bagsBH)
参数说明: 1、dataNumber项目数据指纹
2、bsgsBH 现场考勤系统提供商登记编号
获取人证比对结果信息,返回值1成功,-1失败
GetPhotoComparison(stringdataNumber,string zjhm, string bagsBH)
(1) 表结构
字段名称 | 字段代码 | 字段 类型 | 字段 长度 | 小数 位数 | 约束 条件 | 备注 |
合同备案编号 | PrjNumber | varchar | 20 | M | 与省一体化监管平台合同备案编号一致 | |
证件号码 | Zjhm | varchar | 20 | 保持与GB_Worker一致 | ||
考勤时间 | Kqsj | datetime | 格式为 yyyy-MM-dd HH:mm:ss | |||
进出标识 | KqFlag | Int | 1表示进门 2表示出门 |
(2) 方法名
InsertIntoKqxx(stringdataNumber,string zjhm,string kqsj,int kqFlag,string bagsBH)
参数说明: 1、dataNumber项目数据指纹
2、bsgsBH 现场考勤系统提供商登记编号
(3)返回值
1为上传成功 -1为上传失败
上传失败可能原因:1、参数【bsgsBH】没有上传权限
2、2018年11月1日之后申请对接的项目(使用接口3.8上传)
接口说明:本接口采用异步数据处理机制,即上传的考勤数据返回1的均代表数据上传已成功,然后数据的有效性是通过异步的形式处理,该考勤数据上传成功后需调用接口3.9获取考勤数据的有效性。
(1) 表结构
字段名称 | 字段代码 | 字段 类型 | 字段 长度 | 小数 位数 | 约束 条件 | 备注 |
合同备案编号 | PrjNumber | varchar | 20 | M | 与省一体化监管平台合同备案编号一致 | |
证件号码 | Zjhm | varchar | 20 | 保持与GB_Worker一致 | ||
考勤时间 | Kqsj | datetime | 格式为 yyyy-MM-dd HH:mm:ss | |||
现场考勤照片 | Image | varchar | Max | M | base64字符串 |
(2) 方法名
InsertIntoKqxxImage(stringdataNumber,string zjhm,string kqsj, string image,string bagsBH)
参数说明: 1、dataNumber项目数据指纹
2、bsgsBH 现场考勤系统提供商登记编号
(3)返回值
1为上传成功 -1为上传失败
接口说明:2018年11月1日之后申请对接的项目不需要使用该接口
(1) 表结构
字段名称 | 字段代码 | 字段 类型 | 字段 长度 | 小数 位数 | 约束 条件 | 备注 |
合同备案编号 | PrjNumber | varchar | 20 | M | 与省一体化监管平台合同备案编号一致 | |
证件号码 | Zjhm | varchar | 20 | 保持与GB_Worker一致 | ||
考勤时间 | Kqsj | datetime | 格式为 yyyy-MM-dd HH:mm:ss | |||
进出标识 | KqFlag | Int | 1表示进门 2表示出门 | |||
现场考勤照片 | Image | varchar | Max | M | base64字符串 |
(2) 方法名
UploadKqxx(stringdataNumber,string zjhm,string kqsj, int kqFlag,string image,string bagsBH)
参数说明: 1、dataNumber项目数据指纹
2、bsgsBH 现场考勤系统提供商登记编号
(3) 返回结果:{"result":1,"success":true,"msg":"具体结果信息"}
接口说明:本接口采用异步数据处理机制,即考勤数据上传成功后,其有效性均通过异步的形式处理。该考勤数据上传成功后需调用接口3.9获取考勤数据的有效性
上传失败可能原因:1、参数【bsgsBH】没有上传权限
2、参数【image】为空或不是有效的图片
(1) 表结构
字段名称 | 字段代码 | 字段 类型 | 字段 长度 | 小数 位数 | 约束 条件 | 备注 |
合同备案编号 | PrjNumber | varchar | 20 | M | 与省一体化监管平台合同备案编号一致 | |
证件号码 | Zjhm | varchar | 20 | 保持与GB_Worker一致 | ||
考勤时间 | Kqsj | datetime | 格式为 yyyy-MM-dd HH:mm:ss | |||
进出标识 | KqFlag | Int | 1表示进门 2表示出门 |
(2) 方法名
GetKqxx(stringdataNumber,string zjhm,string kqsj, int kqFlag, string bagsBH)
参数说明: 1、dataNumber项目数据指纹
2、bsgsBH 现场考勤系统提供商登记编号
(3) 返回结果:{"result":1,"success":true, " datastate ":1,"msg":"具体结果信息"}
其中datastate为1时代表该考勤数据为有效数据;为0时代表该考勤数据还未处理;为2时代表该考勤数据为无效的数据。
接口说明:本接口主要是获取考勤数据的有效性,即考勤数据上传成功后判定该考勤数据是否为有效的考勤数据。
无效的考勤原因:1、考勤的数据只针对10天内的考勤有效
2、需人证比对通过才可上传考勤数据
3、考勤时间需要在花名册有效日期内
部分内容由用户投稿或者来源于网络,如有侵权,请联系底部邮箱进行删除!非常感谢您的支持!