四川省建筑工人管理服务平台数据接口标准V20.docx

1、四川省建筑工人管理服务平台数据接口标准V20附件1： 四川省建筑工人管理服务平台数据接口标准（V2.0）1 前言 12 术语 12.1 数据结构 12.2 交换方式 13 编码规则 13.1 项目编码 13.2 工资单编码 24 数据结构 24.1 工程项目信息 24.1.1 项目基本信息（表名：ProjectInfo） 24.1.2 项目状态信息（表名：ProjectStatusInfo） 34.1.3 施工许可证信息（表名：ProjectBuilderLicense） 44.1.4 竣工验收信息（表名：TBProjectFinishCheckInfo） 44.2 项目参建单位及管理人员信息

2、 44.2.1 参建单位信息（表名：ProjectCorpInfo） 44.2.2 参建单位进出场信息（表名：ProjectCorpInoutInfo） 54.2.3 管理人员信息（表名：ProjectPMInfo） 54.3 建筑工人信息 64.3.1 项目班组信息（表名：TeamMasterInfo） 64.3.2 班组进出场信息（表名：TeamInoutInfo） 74.3.3 建筑工人信息（表名：ProjectWorkerInfo） 74.3.4 建筑工人进出场信息（表名：ProjectWorkerInoutInfo） 94.3.5 劳动合同信息（表名：WorkerContractIn

3、fo） 94.3.6 考勤信息（表名：WorkerAttendanceInfo） 104.4 农民工专用帐户管理信息 114.4.1 农民工工资专用账户信息（表名：SpecialAccountInfo） 114.4.2 农民工工资专用账户到帐信息（表名：SpecialAccountSumInfo） 114.4.3 农民工工资卡信息（表名：ProjectWorkerCardInfo） 124.4.4 农民工工资应发信息（表名：PayrollInfo） 134.4.5 农民工工资实发信息（表名：RealPayrollInfo） 144.5 建筑工人培训信息 144.5.1 培训基本信息（表名：Tr

4、ainingInfo） 144.5.2 培训详情信息（表名：TrainingDetailInfo） 154.6 施工现场机械信息 164.6.1 施工现场机械基本信息(表名：DeviceInfo) 164.6.2 施工现场机械使用信息(表名：DeviceUseInfo) 164.6.3 用油管理信息(表名：OilUseInfo) 174.7 附件数据表(表名：AttInfo) 184.8 数据字典表 184.8.1 项目类别字典表 184.8.2 建设性质字典表 184.8.3 投资类型字典表 184.8.4 项目状态字典表 184.8.5 行政区划字典表 194.8.6 参建类型字典表 19

5、4.8.7 人员类型字典表 194.8.8 证件类型字典表 214.8.9 工人工种字典表 214.8.10 银行代码字典表 214.8.11 合同期限类型字典表 274.8.12 计量单位字典表 274.8.13 通行方式字典表 284.8.14 项目培训类型字典表 284.8.15 机械类型字典表 284.8.16 民族字典表 304.8.17 政治面貌字典表 304.8.18 文化程度字典表 305 交换方案 315.1 接口说明 315.2 接口方式 315.2.1 REST风格 315.2.2 公共参数 315.2.3 访问控制 325.2.4 数据加密 335.3 接口流程 335

6、.4 接口API 345.4.1 安全会话接口 345.4.2 编码获取接口 365.4.3 实名制数据上报接口 375.4.4 项目数据下载接口 405.5 接口内容 415.5.1 数据上传接口数据内容 415.5.2 项目数据下载接口数据内容 435.6 前置机方案 445.6.1 类型 445.6.2 条件 445.6.3 要求 441前言根据住房和城乡建设部2020年10月发布的全国建筑工人管理服务信息平台数据对接方案(V1.1)要求，本标准对原四川省建筑工人管理服务平台数据接口标准进行了修订，形成了四川省建筑工人管理服务平台数据接口标准(V2.0)，本次修订主要增加了各方责任主体管

7、理人员到岗信息、项目数据下载等内容。2术语2.1数据结构(1)表名：数据库建表的名称；(2)字段名称：数据项的中文含义；(3)字段代码：数据库中数据项建表的字段名；(4)字段类型：数据库中数据项建表的字段类型，具体包括：CHAR：固定长度字符串；NVARCHAR：可变长度字符串，有总长度限制；DECIMAL：数值型，有小数位数限制；INT：整数型；DATE：日期型；DATETIME：日期+时间型；TEXT：文本型(5)是否必填：数据库中数据项是否容许为空，M：不能为空，必填；O：可以为空，选填。2.2交换方式(1)开放式服务接口：标准的Web服务；(2)前置机：安装交换数据库的服务器；(3)数

8、据库端口：网络访问数据库的操作系统特殊端口。3编码规则3.1项目编码项目编码按照全国建筑市场监管公共服务平台工程项目信息数据标准要求生存，第三方系统应与四川省建筑工人管理服务平台对接时由平台返回该编码。项目编号是工程项目在信息系统中判断唯一性的标识编码。项目编号由16位数字组成，其结构定义如下：具体规则：（1）工程项目所在行政区划代码为6位，应符合现行国家标准GB/T2260的规定。（2）工程项目日期代码，格式为YYMMDD，长度为6位，由属于该工程项目下的第一条信息资源产生的日期（建议采用工程项目报建立项日期）确定。如2014年5月1日，代码为140501。（3）工程项目序列码为4位，依据工

9、程项目日期代码确定，同一日期内，不同工程项目由“0001”开始依次往后编码，如：0001、0002、0003。3.2工资单编码通过四川省建筑工人管理服务信息平台中创建，可直接生成工资单编号；如果是第三方系统需按照如下规则生成该编码。其结构定义如下：P+yyyyMMddHHmm（上传时间）+yyyyMM（工资发放月份）+3位序列号如：*0930*。4数据结构4.1工程项目信息4.1.1项目基本信息（表名：ProjectInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M参考编码规则：项目编码项目名称NameNVARCHAR(512)M项目代码PrjCodeNV

10、ARCHAR(512)O投资项目在线审批监管平台统一编码项目简介DescriptionNVARCHAR(1000)O项目类别CategoryINTM详见数据字典表项目类别建设性质ConstructTypeINTM详见数据字典表建设性质投资类型InvestTypeINTM详见数据字典表投资类型项目所在地AreaCodeNVARCHAR(6)M详见数据字典表行政区划建设地址AddressNVARCHAR(200)M总面积BuildingAreaDECIMAL(18,2)M单位：平方米总长度BuildingLengthDECIMAL(18,2)O单位：米总投资InvestDECIMAL(18,4)M

11、单位：万元项目规模ScaleNVARCHAR(200)M开工日期StartDateDATEM精确到天,格式：yyyy-MM-dd经度LngDECIMAL(18,15)OWGS84经度纬度LatDECIMAL(18,15)OWGS84纬度第三方项目编码ThirdPartyProjectCodeNVARCHAR(50)O第三方系统为项目创建的编码，同一个系统不能重复编码4.1.2项目状态信息（表名：ProjectStatusInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息项目状态PrjStatusINTM详见数据字典表项目状态项目状态变更时间

12、StatusChangeDateDATEM精确到天,格式：yyyy-MM-dd4.1.3施工许可证信息（表名：ProjectBuilderLicense）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息工程名称PrjNameNVARCHAR(200)M安监备案号SafetyNoNVARCHAR(40)M施工许可证号BuilderLicenseNumNVARCHAR(50)M发证机关OrganNameNVARCHAR(50)M发证日期OrganDATEDATEM4.1.4竣工验收信息（表名：TBProjectFinishCheckInfo）字段名称字

13、段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息工程名称PrjNameNVARCHAR(200)M竣工验收编号PrjFinishCheckNumNVARCHAR(50)M竣工验收日期EDateDATEM4.2项目参建单位及管理人员信息4.2.1参建单位信息（表名：ProjectCorpInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息企业名称CorpNameNVARCHAR(200)M企业注册地区AreaCodeNVARCHAR(6)M详见数据字典表行政区划统一社会信用代码CorpCodeVARCHAR(

14、18)M注册日期RegisterDateDATEM参建类型CorpTypeINTM详见数据字典表参建类型4.2.2参建单位进出场信息（表名：ProjectCorpInoutInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息企业名称CorpNameNVARCHAR(200)M统一社会信用代码CorpCodeVARCHAR(18)M进出场类型InOutIntM1=进2=出发生时间OccurTimeDATETIMEM4.2.3管理人员信息（表名：ProjectPMInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40

15、)M关联项目基本信息所属企业CorpNameNVARCHAR(200)M企业统一社会信用代码CorpCodeVARCHAR(18)M参建类型CorpTypeINTM详见数据字典表参建类型人员类型PTypeINTM详见数据字典表人员类型姓名PMNameNVARCHAR(50)M证件类型PMIDCardTypeINTM详见数据字典表证件类型证件号码PMIDCardNumberVARCHAR(18)MAES发证机关GrantOrgNVARCHAR(100)M民族NationNVARCHAR(3)M详见数据字典表民族政治面貌PoliticsTypeINTM详见数据字典表政治面貌文化程度CultureL

16、evelTypeINTM详见数据字典表文化程度住址AddressNVARCHAR(200)M头像headImageNVARCHAR(50)M关联附件数据表电话号码PMPhoneNVARCHAR(50)M4.3建筑工人信息4.3.1项目班组信息（表名：TeamMasterInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息班组编号TeamSysNoINTM本项目唯一编号班组所在企业统一社会信用代码CorpCodeVARCHAR(18)M班组所在企业名称CorpNameNVARCHAR(200)M班组名称TeamNameNVARCHAR(100)

17、M同一个项目上的班组名称不能重复班组长姓名TeamLeaderNameNVARCHAR(50)M班组长联系电话TeamLeaderPhoneNVARCHAR(50)M备注RemarkNVARCHAR(200)O4.3.2班组进出场信息（表名：TeamInoutInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息班组编号TeamSysNoINTM关联项目班组信息进出场类型InOutIntM1=进2=出发生时间OccurTimeDATETIMEM附件AttInfoNVARCHAR(50)O关联附件数据表4.3.3建筑工人信息（表名：Project

18、WorkerInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息企业统一社会信用代码CorpCodeVARCHAR(18)M班组所在所属企业统一社会信用代码企业名称CorpNameNVARCHAR(200)M班组所在企业名称班组编号TeamSysNoINTM关联项目班组信息表班组名称TeamNameNVARCHAR(100)M姓名 WorkerNameNVARCHAR(50)M是否班组长IsTeamLeaderNVARCHAR(1)M是、否证件类型IDCardTypeINTM详见数据字典表证件类型证件号码IDCardNumberVARCHAR

19、(18)MAES年龄AgeINTM性别GenderNVARCHAR(1)M男、女民族NationNVARCHAR(3)M详见数据字典表民族住址AddressNVARCHAR(200)M头像headImageNVARCHAR(50)M关联附件数据表政治面貌PoliticsTypeINTM详见数据字典表政治面貌文化程度CultureLevelTypeINTM详见数据字典表文化程度发证机关GrantOrgNVARCHAR(100)M工种名称WorkTypeNVARCHAR(3)M详见数据字典表工人工种籍贯NativePlaceNVARCHAR(50)M手机号码MobileNVARCHAR(11)M照

20、片IssueCardPicUrlNVARCHAR(50)O关联附件数据表是否有劳动合同HasContractNVARCHAR(1)M是、否是否购买工伤或意外伤害保险 HasBuyInsuranceNVARCHAR(1)O是、否备注RemarkNVARCHAR(1000)O4.3.4建筑工人进出场信息（表名：ProjectWorkerInoutInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息证件号码IDCardNumberVARCHAR(18)M关联建筑工人信息，AES进出场类型InOutIntM1=进2=出发生时间OccurTimeDAT

21、ETIMEM4.3.5劳动合同信息（表名：WorkerContractInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息企业统一社会信用代码CorpCodeVARCHAR(18)M班组所在企业统一社会信用代码企业名称CorpNameNVARCHAR(200)M班组所在企业名称姓名 WorkerNameNVARCHAR(50)M证件类型IDCardTypeINTM证件号码IDCardNumberVARCHAR(18)MAES合同编号ContractCodeNVARCHAR(50)M合同期限类型ContractPeriodTypeINTM详见数

22、据字典表合同期限类型签订日期SignDateDATEM开始日期StartDateDATEM结束时期EndDateDATEM计量单位UnitINTO详见数据字典表计量单位计量单价UnitPriceDECIMAL(18,2)O合同附件ContractAttNVARCHAR(50)O关联附件数据表4.3.6考勤信息（表名：WorkerAttendanceInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息班组编号TeamSysNo INTM关联项目班组信息(如果是管理人员固定-100)班组名称TeamNameNVARCHAR(100)M如果是管理人

23、员固定为“管理班组”姓名 WorkerNameNVARCHAR(50)M证件类型IDCardTypeINTM证件号码IDCardNumberVARCHAR(18)MAES考勤时间DateDATETIMEM格式yyyyMMddHHmmss进出方向DirectionINTM1=进2=出体温检测数据TemperatureDECIMAL(5,1)O考勤近照ImageURLNVARCHAR(50)O关联附件数据表通行方式AttendTypeINTO详见数据字典表通行方式经度LngDECIMAL(18,15)OWGS84经度纬度LatDECIMAL(18,15)OWGS84纬度4.4农民工专用帐户管理信息

24、4.4.1农民工工资专用账户信息（表名：SpecialAccountInfo）字段名称字符代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息施工总承包单位名称CorpNameNVARCHAR(200)M施工总承包单位统一社会信用代码CorpCodeVARCHAR(18)M农民工工资专用账户名称SpecialAccountNVARCHAR(50)M农民工工资专用账户开户行名称BankNameNVARCHAR(50)M农民工工资专用账户开户行银行代码PayBankCodeNVARCHAR(4)M详见数据字典表银行代码农民工工资专用账户账号SpecialAccount

25、No.NVARCHAR(50)MAES4.4.2农民工工资专用账户到帐信息（表名：SpecialAccountSumInfo）字段名称字符代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息施工总承包单位名称CorpNameNVARCHAR(200)M施工总承包单位统一社会信用代码CorpCodeVARCHAR(18)M农民工工资专用账户名称SpecialAccountNVARCHAR(50)M农民工工资专用账户开户行名称BankNameNVARCHAR(50)M农民工工资专用账户开户行银行代码PayBankCodeNVARCHAR(4)M详见数据字典表银行代码农

26、民工工资专用账户账号SpecialAccountNoNVARCHAR(50)MAES建设单位拨款到帐金额（元）AccountSumDECIMAL(14,0)M建设单位拨款到帐时间AccountTimeDATETIMEM农民工工资专用账户余额（元）AccountBalanceDECIMAL(14,0)M4.4.3农民工工资卡信息（表名：ProjectWorkerCardInfo）字段名称字段代码字段类型是否必填备注项目编码CodeNVARCHAR(40)M关联项目基本信息姓名 WorkerNameNVARCHAR(50)M证件类型IDCardTypeINTM详见数据字典表证件类型证件号码IDCardNumberVARCHAR(18)MAES工资卡开户行名称PayRollBankNameNVARCHAR(300)M工人工资卡银行代码PayRollBankCodeNVARCHAR(20)M详见数据字典表银