四川省建筑工人管理服务平台数据接口标准V20.docx
《四川省建筑工人管理服务平台数据接口标准V20.docx》由会员分享,可在线阅读,更多相关《四川省建筑工人管理服务平台数据接口标准V20.docx(56页珍藏版)》请在冰豆网上搜索。
![四川省建筑工人管理服务平台数据接口标准V20.docx](https://file1.bdocx.com/fileroot1/2023-1/3/7a21c040-6225-4cf7-bf35-860650cacddb/7a21c040-6225-4cf7-bf35-860650cacddb1.gif)
四川省建筑工人管理服务平台数据接口标准V20
附件1:
四川省建筑工人管理服务平台数据接口标准(V2.0)
1前言1
2术语1
2.1数据结构1
2.2交换方式1
3编码规则1
3.1项目编码1
3.2工资单编码2
4数据结构2
4.1工程项目信息2
4.1.1项目基本信息(表名:
ProjectInfo)2
4.1.2项目状态信息(表名:
ProjectStatusInfo)3
4.1.3施工许可证信息(表名:
ProjectBuilderLicense)4
4.1.4竣工验收信息(表名:
TBProjectFinishCheckInfo)4
4.2项目参建单位及管理人员信息4
4.2.1参建单位信息(表名:
ProjectCorpInfo)4
4.2.2参建单位进出场信息(表名:
ProjectCorpInoutInfo)5
4.2.3管理人员信息(表名:
ProjectPMInfo)5
4.3建筑工人信息6
4.3.1项目班组信息(表名:
TeamMasterInfo)6
4.3.2班组进出场信息(表名:
TeamInoutInfo)7
4.3.3建筑工人信息(表名:
ProjectWorkerInfo)7
4.3.4建筑工人进出场信息(表名:
ProjectWorkerInoutInfo)9
4.3.5劳动合同信息(表名:
WorkerContractInfo)9
4.3.6考勤信息(表名:
WorkerAttendanceInfo)10
4.4农民工专用帐户管理信息11
4.4.1农民工工资专用账户信息(表名:
SpecialAccountInfo)11
4.4.2农民工工资专用账户到帐信息(表名:
SpecialAccountSumInfo)11
4.4.3农民工工资卡信息(表名:
ProjectWorkerCardInfo)12
4.4.4农民工工资应发信息(表名:
PayrollInfo)13
4.4.5农民工工资实发信息(表名:
RealPayrollInfo)14
4.5建筑工人培训信息14
4.5.1培训基本信息(表名:
TrainingInfo)14
4.5.2培训详情信息(表名:
TrainingDetailInfo)15
4.6施工现场机械信息16
4.6.1施工现场机械基本信息(表名:
DeviceInfo)16
4.6.2施工现场机械使用信息(表名:
DeviceUseInfo)16
4.6.3用油管理信息(表名:
OilUseInfo)17
4.7附件数据表(表名:
AttInfo)18
4.8数据字典表18
4.8.1项目类别字典表18
4.8.2建设性质字典表18
4.8.3投资类型字典表18
4.8.4项目状态字典表18
4.8.5行政区划字典表19
4.8.6参建类型字典表19
4.8.7人员类型字典表19
4.8.8证件类型字典表21
4.8.9工人工种字典表21
4.8.10银行代码字典表21
4.8.11合同期限类型字典表27
4.8.12计量单位字典表27
4.8.13通行方式字典表28
4.8.14项目培训类型字典表28
4.8.15机械类型字典表28
4.8.16民族字典表30
4.8.17政治面貌字典表30
4.8.18文化程度字典表30
5交换方案31
5.1接口说明31
5.2接口方式31
5.2.1REST风格31
5.2.2公共参数31
5.2.3访问控制32
5.2.4数据加密33
5.3接口流程33
5.4接口API34
5.4.1安全会话接口34
5.4.2编码获取接口36
5.4.3实名制数据上报接口37
5.4.4项目数据下载接口40
5.5接口内容41
5.5.1数据上传接口数据内容41
5.5.2项目数据下载接口数据内容43
5.6前置机方案44
5.6.1类型44
5.6.2条件44
5.6.3要求44
1前言
根据住房和城乡建设部2020年10月发布的《全国建筑工人管理服务信息平台数据对接方案》(V1.1)要求,本标准对原《四川省建筑工人管理服务平台数据接口标准》进行了修订,形成了《四川省建筑工人管理服务平台数据接口标准(V2.0)》,本次修订主要增加了各方责任主体管理人员到岗信息、项目数据下载等内容。
2术语
2.1数据结构
(1)表名:
数据库建表的名称;
(2)字段名称:
数据项的中文含义;
(3)字段代码:
数据库中数据项建表的字段名;
(4)字段类型:
数据库中数据项建表的字段类型,具体包括:
●CHAR:
固定长度字符串;
●NVARCHAR:
可变长度字符串,有总长度限制;
●DECIMAL:
数值型,有小数位数限制;
●INT:
整数型;
●DATE:
日期型;
●DATETIME:
日期+时间型;
●TEXT:
文本型
(5)是否必填:
数据库中数据项是否容许为空,M:
不能为空,必填;O:
可以为空,选填。
2.2交换方式
(1)开放式服务接口:
标准的Web服务;
(2)前置机:
安装交换数据库的服务器;
(3)数据库端口:
网络访问数据库的操作系统特殊端口。
3编码规则
3.1项目编码
项目编码按照《全国建筑市场监管公共服务平台工程项目信息数据标准》要求生存,第三方系统应与四川省建筑工人管理服务平台对接时由平台返回该编码。
项目编号是工程项目在信息系统中判断唯一性的标识编码。
项目编号由16位数字组成,其结构定义如下:
具体规则:
(1)工程项目所在行政区划代码为6位,应符合现行国家标准GB/T2260的规定。
(2)工程项目日期代码,格式为YYMMDD,长度为6位,由属于该工程项目下的第一条信息资源产生的日期(建议采用工程项目报建立项日期)确定。
如2014年5月1日,代码为140501。
(3)工程项目序列码为4位,依据工程项目日期代码确定,同一日期内,不同工程项目由“0001”开始依次往后编码,如:
0001、0002、0003……。
3.2工资单编码
通过四川省建筑工人管理服务信息平台中创建,可直接生成工资单编号;如果是第三方系统需按照如下规则生成该编码。
其结构定义如下:
P+yyyyMMddHHmm(上传时间)+yyyyMM(工资发放月份)+3位序列号
如:
*0930********。
4数据结构
4.1工程项目信息
4.1.1项目基本信息(表名:
ProjectInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
参考编码规则:
项目编码
项目名称
Name
NVARCHAR(512)
M
项目代码
PrjCode
NVARCHAR(512)
O
投资项目在线审批监管平台统一编码
项目简介
Description
NVARCHAR(1000)
O
项目类别
Category
INT
M
详见数据字典表项目类别
建设性质
ConstructType
INT
M
详见数据字典表建设性质
投资类型
InvestType
INT
M
详见数据字典表投资类型
项目所在地
AreaCode
NVARCHAR(6)
M
详见数据字典表行政区划
建设地址
Address
NVARCHAR(200)
M
总面积
BuildingArea
DECIMAL(18,2)
M
单位:
平方米
总长度
BuildingLength
DECIMAL(18,2)
O
单位:
米
总投资
Invest
DECIMAL(18,4)
M
单位:
万元
项目规模
Scale
NVARCHAR(200)
M
开工日期
StartDate
DATE
M
精确到天,格式:
yyyy-MM-dd
经度
Lng
DECIMAL(18,15)
O
WGS84经度
纬度
Lat
DECIMAL(18,15)
O
WGS84纬度
第三方项目编码
ThirdPartyProjectCode
NVARCHAR(50)
O
第三方系统为项目创建的编码,同一个系统不能重复编码
4.1.2项目状态信息(表名:
ProjectStatusInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
项目状态
PrjStatus
INT
M
详见数据字典表项目状态
项目状态变更时间
StatusChangeDate
DATE
M
精确到天,格式:
yyyy-MM-dd
4.1.3施工许可证信息(表名:
ProjectBuilderLicense)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
工程名称
PrjName
NVARCHAR(200)
M
安监备案号
SafetyNo
NVARCHAR(40)
M
施工许可证号
BuilderLicenseNum
NVARCHAR(50)
M
发证机关
OrganName
NVARCHAR(50)
M
发证日期
OrganDATE
DATE
M
4.1.4竣工验收信息(表名:
TBProjectFinishCheckInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
工程名称
PrjName
NVARCHAR(200)
M
竣工验收编号
PrjFinishCheckNum
NVARCHAR(50)
M
竣工验收日期
EDate
DATE
M
4.2项目参建单位及管理人员信息
4.2.1参建单位信息(表名:
ProjectCorpInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
企业名称
CorpName
NVARCHAR(200)
M
企业注册地区
AreaCode
NVARCHAR(6)
M
详见数据字典表行政区划
统一社会信用代码
CorpCode
VARCHAR(18)
M
注册日期
RegisterDate
DATE
M
参建类型
CorpType
INT
M
详见数据字典表参建类型
4.2.2参建单位进出场信息(表名:
ProjectCorpInoutInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
企业名称
CorpName
NVARCHAR(200)
M
统一社会信用代码
CorpCode
VARCHAR(18)
M
进出场类型
InOut
Int
M
1=进
2=出
发生时间
OccurTime
DATETIME
M
4.2.3管理人员信息(表名:
ProjectPMInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
所属企业
CorpName
NVARCHAR(200)
M
企业统一社会信用代码
CorpCode
VARCHAR(18)
M
参建类型
CorpType
INT
M
详见数据字典表参建类型
人员类型
PType
INT
M
详见数据字典表人员类型
姓名
PMName
NVARCHAR(50)
M
证件类型
PMIDCardType
INT
M
详见数据字典表证件类型
证件号码
PMIDCardNumber
VARCHAR(18)
M
AES
发证机关
GrantOrg
NVARCHAR(100)
M
民族
Nation
NVARCHAR(3)
M
详见数据字典表民族
政治面貌
PoliticsType
INT
M
详见数据字典表政治面貌
文化程度
CultureLevelType
INT
M
详见数据字典表文化程度
住址
Address
NVARCHAR(200)
M
头像
headImage
NVARCHAR(50)
M
关联附件数据表
电话号码
PMPhone
NVARCHAR(50)
M
4.3建筑工人信息
4.3.1项目班组信息(表名:
TeamMasterInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
班组编号
TeamSysNo
INT
M
本项目唯一编号
班组所在企业统一社会信用代码
CorpCode
VARCHAR(18)
M
班组所在企业名称
CorpName
NVARCHAR(200)
M
班组名称
TeamName
NVARCHAR(100)
M
同一个项目上的班组名称不能重复
班组长姓名
TeamLeaderName
NVARCHAR(50)
M
班组长联系电话
TeamLeaderPhone
NVARCHAR(50)
M
备注
Remark
NVARCHAR(200)
O
4.3.2班组进出场信息(表名:
TeamInoutInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
班组编号
TeamSysNo
INT
M
关联项目班组信息
进出场类型
InOut
Int
M
1=进
2=出
发生时间
OccurTime
DATETIME
M
附件
AttInfo
NVARCHAR(50)
O
关联附件数据表
4.3.3建筑工人信息(表名:
ProjectWorkerInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
企业统一社会信用代码
CorpCode
VARCHAR(18)
M
班组所在所属企业统一社会信用代码
企业名称
CorpName
NVARCHAR(200)
M
班组所在企业名称
班组编号
TeamSysNo
INT
M
关联项目班组信息表
班组名称
TeamName
NVARCHAR(100)
M
姓名
WorkerName
NVARCHAR(50)
M
是否班组长
IsTeamLeader
NVARCHAR
(1)
M
是、否
证件类型
IDCardType
INT
M
详见数据字典表证件类型
证件号码
IDCardNumber
VARCHAR(18)
M
AES
年龄
Age
INT
M
性别
Gender
NVARCHAR
(1)
M
男、女
民族
Nation
NVARCHAR(3)
M
详见数据字典表民族
住址
Address
NVARCHAR(200)
M
头像
headImage
NVARCHAR(50)
M
关联附件数据表
政治面貌
PoliticsType
INT
M
详见数据字典表政治面貌
文化程度
CultureLevelType
INT
M
详见数据字典表文化程度
发证机关
GrantOrg
NVARCHAR(100)
M
工种名称
WorkType
NVARCHAR(3)
M
详见数据字典表工人工种
籍贯
NativePlace
NVARCHAR(50)
M
手机号码
Mobile
NVARCHAR(11)
M
照片
IssueCardPicUrl
NVARCHAR(50)
O
关联附件数据表
是否有劳动合同
HasContract
NVARCHAR
(1)
M
是、否
是否购买工伤或意外伤害保险
HasBuyInsurance
NVARCHAR
(1)
O
是、否
备注
Remark
NVARCHAR(1000)
O
4.3.4建筑工人进出场信息(表名:
ProjectWorkerInoutInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
证件号码
IDCardNumber
VARCHAR(18)
M
关联建筑工人信息,AES
进出场类型
InOut
Int
M
1=进
2=出
发生时间
OccurTime
DATETIME
M
4.3.5劳动合同信息(表名:
WorkerContractInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
企业统一社会信用代码
CorpCode
VARCHAR(18)
M
班组所在企业统一社会信用代码
企业名称
CorpName
NVARCHAR(200)
M
班组所在企业名称
姓名
WorkerName
NVARCHAR(50)
M
证件类型
IDCardType
INT
M
证件号码
IDCardNumber
VARCHAR(18)
M
AES
合同编号
ContractCode
NVARCHAR(50)
M
合同期限类型
ContractPeriodType
INT
M
详见数据字典表合同期限类型
签订日期
SignDate
DATE
M
开始日期
StartDate
DATE
M
结束时期
EndDate
DATE
M
计量单位
Unit
INT
O
详见数据字典表计量单位
计量单价
UnitPrice
DECIMAL(18,2)
O
合同附件
ContractAtt
NVARCHAR(50)
O
关联附件数据表
4.3.6考勤信息(表名:
WorkerAttendanceInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
班组编号
TeamSysNo
INT
M
关联项目班组信息(如果是管理人员固定-100)
班组名称
TeamName
NVARCHAR(100)
M
如果是管理人员固定为“管理班组”
姓名
WorkerName
NVARCHAR(50)
M
证件类型
IDCardType
INT
M
证件号码
IDCardNumber
VARCHAR(18)
M
AES
考勤时间
Date
DATETIME
M
格式yyyyMMddHHmmss
进出方向
Direction
INT
M
1=进
2=出
体温检测数据
Temperature
DECIMAL(5,1)
O
考勤近照
ImageURL
NVARCHAR(50)
O
关联附件数据表
通行方式
AttendType
INT
O
详见数据字典表通行方式
经度
Lng
DECIMAL(18,15)
O
WGS84经度
纬度
Lat
DECIMAL(18,15)
O
WGS84纬度
4.4农民工专用帐户管理信息
4.4.1农民工工资专用账户信息(表名:
SpecialAccountInfo)
字段名称
字符代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
施工总承包单位名称
CorpName
NVARCHAR(200)
M
施工总承包单位统一社会信用代码
CorpCode
VARCHAR(18)
M
农民工工资专用账户名称
SpecialAccount
NVARCHAR(50)
M
农民工工资专用账户开户行名称
BankName
NVARCHAR(50)
M
农民工工资专用账户开户行银行代码
PayBankCode
NVARCHAR(4)
M
详见数据字典表银行代码
农民工工资专用账户账号
SpecialAccountNo.
NVARCHAR(50)
M
AES
4.4.2农民工工资专用账户到帐信息(表名:
SpecialAccountSumInfo)
字段名称
字符代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
施工总承包单位名称
CorpName
NVARCHAR(200)
M
施工总承包单位统一社会信用代码
CorpCode
VARCHAR(18)
M
农民工工资专用账户名称
SpecialAccount
NVARCHAR(50)
M
农民工工资专用账户开户行名称
BankName
NVARCHAR(50)
M
农民工工资专用账户开户行银行代码
PayBankCode
NVARCHAR(4)
M
详见数据字典表银行代码
农民工工资专用账户账号
SpecialAccountNo
NVARCHAR(50)
M
AES
建设单位拨款到帐金额(元)
AccountSum
DECIMAL(14,0)
M
建设单位拨款到帐时间
AccountTime
DATETIME
M
农民工工资专用账户余额(元)
AccountBalance
DECIMAL(14,0)
M
4.4.3农民工工资卡信息(表名:
ProjectWorkerCardInfo)
字段名称
字段代码
字段类型
是否必填
备注
项目编码
Code
NVARCHAR(40)
M
关联项目基本信息
姓名
WorkerName
NVARCHAR(50)
M
证件类型
IDCardType
INT
M
详见数据字典表证件类型
证件号码
IDCardNumber
VARCHAR(18)
M
AES
工资卡开户行名称
PayRollBankName
NVARCHAR(300)
M
工人工资卡银行代码
PayRollBankCode
NVARCHAR(20)
M
详见数据字典表银