混凝土质量监管数据接口标准.docx

混凝土质量监管数据接口标准混凝土生产监管系统与工程质量监管综合平台对接业务流程图局资源中心混凝土生产监管系统工程质量监管综合平台碘州-H膜唉定时同步定时同步定时同步定时同步定时同步定时同步定时同步定时同步工程数据生产设备、生产线信息生产信息试件信息自检自检数据拌台投料数据拌台投料数据运输单信息运输单信息运输单信息收货确认录入浇筑部位浇筑部位检测信息第三方检测数据选择工程录入市散办工程数据生产设备、生产线信息生产单位录入配合比信息录入生产信息递交生成“混凝土流水号”录入试件信息定时同步定时司步“success： true,“message ：生产信息数据接收成功,“code： 200,“result： null,timestamp: )2.L3.2.投料数据API接口2. 1. 3. 2. 1.接口名称接收外部推送的混凝土投料数据213.2.2. 接口概述 接收推送的混凝土投料数据2. 1.3.2.3. 接口地址 :/IP:port/concrete-external/hnt/foreign/hntdata/insertExternalData2. 1. 3. 2. 4. 接口参数序号名称类型是否必须例如值描述1datajsonString是如下无datajson是对象数组，字段具体说明如下：序号名称类型是否必须例如值描述1IDString是主键ID2HNTSEQIDString生产流水号3DTUIDString生产线4FACTORYSEQIDString盘号（批次号）5FACTORYENDDATEDate2021-10-01 10:00:00投料结束时间6FACTORYAMOUNTNumber生产方量7PROJECTNAMEString工程名称8DENGJIString设计强度等级9SENDSTATENumber发送状态10TASKNUMBERString任务单11SHENGCHANHAOString生产号12CHEPAIString车牌13GCNUMString工程监督号14INSERTDATEDate2021-10-01 10:00:00创立时间15UNIQUEKEYString唯一码16JZBWString拟浇筑部位17PBNUMString配合比编号18FACTORYSTARTDATEDate2021-10-01 10:00:00投料开始时间2. 1. 3. 2. 5.返回结果序号名称类型例如值描述1successBooleanTrue成功标识2messageString描述信息3codeNumber200状态码4timestampNumber时间毫秒5resultString结果2. 1. 3. 2. 6.参数例如(1)接收参数ID:testidl”,HNTSEQID ：”，DTUID :工FACTORYSEQID：，FACTORYENDDATE:2021-10-01 10:00:00，“FACTORYAMOUNT：10,PROJECTNAME:，DENGJI:，SENDSTATE：0,“TASKNUMBER：”，SHENGCHANHAO：，CHEPAI：，GCNUM :工INSERTDATE:2021-10-01 10:00:00，UNIQUEKEY：”，JZBW：，PBNUM：,FACTORYSTARTDATE:2021-10-01 10:00:00ID：testid2,“HNTSEQID：，DTUID:，“FACTORYSEQID ：”，“FACTORYENDDATE：2021-10-01 10:00:00,FACTORYAMOUN:10,PROJECTNAME:DENGJI:，“SENDSTATE：0,“TASKNUMBER：”，SHENGCHANHAO：，CHEPAI：，GCNUM：”，“INSERTDATE：2021-10-01 10:00:00，UNIQUEKEY：”，JZBW：，PBNUM：”，FACTORYSTARTDATE:2021-10-01 10:00:00)(2)返回信息( success : true,“message： 投料数据接收成功，code： 200,“result”: null,timestamp: 2.L3.3.投料明细数据API接口2. 1. 3. 3. 1.接口名称接收外部推送的混凝土投料明细数据2. 1. 3. 3. 2.接口概述接收推送的混凝土投料明细数据2.1. 3. 3. 3.接口地址 :/IP:port/concrete-external/hnt/foreign/hntdetail/insertExternalData2. L3.3.4. 接口参数序号名称类型是否必须例如值描述1datajsonString是如下无datajson是对象数组，字段具体说明如下：序号名称类型是否必须例如值描述1HNTSEQIDString生产流水号2FACT0RYSEQIDString生产单号3CRITERIONCODENumber材料编号4STUFFCODEString材料类型5STUFFNAMEString材料名称6THEORYAMOUNTNumber理论投料量7FACTAMOUNTNumber实际投料量8SENDSTATENumber发送状态9DTUIDString生产线10INSERTDATEDate2021-10-01 10:00:00上传时间11UNIQUEKEYStringUNIQUEKEY12STORAGEIDString排序ID2L3.3.5. 返回结果序号名称类型例如值描述1successBooleanTrue成功标识2messageString描述信息3codeNumber200状态码4timestampNumber时间毫秒5resultString结果2. 1. 3. 3. 6.参数例如(1)接收参数HNTSEQID：JYW202111170001, “FACTORYSEQID ：”，“CRITERIONCODE：0, “STUFFCODE：”， STUFFNAME：”， THEORYAMOUNTilO,“FACTAMOUNT：10, SENDSTATE：0,DTUID :“，INSERTDATE:2021-10-01 10:00:00, UNIQUEKEY：”，STORAGEID ：”HNTSEQID : JYW202H1170002,FACTORYSEQID：”，“CRITERIONCODE：0,“STUFFCODE：”，“STUFFNAME：”，THEORYAMOUNT”: 10,FACTAMOUNT:10,SENDSTATE：0,DTUID:，INSERTDATE:2021-10-01 10:00:00,UNIQUEKEY:，STORAGEID ：”)(2)返回信息-1“success”: true,“message ：投料明细数据接收成功,“code： 200,“result： null,timestamp: 2. 1. 3. 4.配合比信息API接口2L3.4.L 接口名称 接收外部推送的混凝土配合比信息数据2L34.2.接口概述接收推送的混凝土配合比信息数据2134.3.接口地址 :/IP:port/concrete-external/hnt/foreign/operat ionPh/insertExternalData2L3.4.4. 接口参数序号名称类型是否必须例如值描述1datajsonString是如下无datajson是对象数组，字段具体说明如下：序号名称类型是否必须例如值描述1IDString是主键2PHB_C0DEString配合比编号3SYS_ORGAN_IDString单位ID4SJQDDJString设计强度等级5WATERNumber用水量6SNDHString水泥代号7SNPZString水泥品种8CEMENTNumber水泥用量9SNQDString水泥强度等级10SHANumber砂用量11STONE1Number石1用量12ST0NE2Number石2用量13CHL_TYPE1String掺和料1种类14CHL1Number掺和料1用量15CHL_TYPE2String掺和料2种类16CHL2Number掺和料2用量17WJJ1Number外加剂1用量18WJJ2Number外加剂2用量19SCCJString生产厂家20CHLZLString掺和料种类21REC0RD_DATEDate2021-10-0110:00:00录入时间22NOTEString备注23STATEString状态24UPDATE_TIMEDate2021-10-01 10:00:00修改时间25ST0NE3Number石3用量2L3.45.返回结果序号名称类型例如值描述1successBooleanTrue成功标识2messageString描述信息3codeNumber200状态码4timestampNumber时间毫秒5resultString结果2. 1. 3. 4. 6.参数例如(1)接收参数ID：testidl”,PHB CODE:SYS_ORGAN_ID：SJQDDJ：z WATER:0, SNDH：,VNP7CEMENT：0, SNQD ：”，SHA：0, STONE1：O, ST0NE2:0, CHL_TYPE1： CHL1：O,CHL TYPE2:0,0,0,CHL2 WJJ1 WJJ2 SCCJCHLZL:RECORD DATE：2021-10-01 10:00:00,NOTE： STATE:/ZUPDATE_TIME/Z : 2021-10-01 10:00:00, ST0NE3：0ID:testid2, PHB CODE：”，SYS_ORGAN_ID：VNP7CEMENT:0, SNQD：，SHA ： 0,STONE1：O, ST0NE2：0,CHL_TYPE1: CHL1:O, CHL TYPE2:0,0,0,CHL2 WJJ1 WJJ2 SCCJCHLZL:REC0RD_DATE：2021-10-01 10:00:00,NOTE： STATE:/ZUPDATE_TIME/Z : 2021-10-01 10:00:00, ST0NE3：0(2)返回信息success : true,“message： 配合比信息数据接收成功,“code： 200,“result： null,timestamp: 2.L3.5.运输单信息API接口2.1. 3. 5. 1.接口名称接收外部推送的混凝土运输单信息数据213.5.2. 接口概述接收推送的混凝土运输单信息数据2.L3.5.3. 接口地址 :/IP:port/concrete-external/hnt/foreign/concreteDelivery/insertExternalData1.各阶段说明序号数据内容数据拥有方交互方式频率1工程信息工程质量监管综合平 台访问资源中心2监督员信息工程质量监管综合平 台访问资源中心3单位信息工程质量监管综合平 台访问资源中心4生产设备混凝土生产监管系统接口定时获取1天/次5生产线数据混凝土生产监管系统接口定时获取1天/次6生产单位混凝土生产监管系统接口定时获取1天/次7配合比信息混凝土生产监管系统接口定时推送1小时/次8生产信息混凝土生产监管系统接口定时推送1小时/次9试件信息混凝土生产监管系统接口定时推送1小时/次10自检数据混凝土生产监管系统接口定时推送1小时/次11拌台投料数据混凝土生产监管系统接口定时推送1天/次12拌台投料明细数据混凝土生产监管系统接口定时推送1天/次13运输单信息混凝土生产监管系统接口定时推送1小时/次14运输单明细数据混凝土生产监管系统接口定时推送1小时/次15运输单信息工程质量监管综合平 台接口定时推送1小时/次16浇筑部位工程质量监管综合平 台接口定时推送1小时/次17第三方检测数据工程质量监管综合平 台接口定时推送1小时/次交互方式说明(1) 访问资源中心工程质量监管综合平台将工程信息、监督员信息、单位信息共享到资源中心，通过给予混凝土生产监管系统访问权限让其自行获取(2) 接口定时获取数据拥有方提供外部接口，数据采集方定时调用获取相应数据(3) 接口定时推送数据采集方提供接口供数据拥有方定时推送数据2.L3.5.4. 接口参数序号名称类型是否必须例如值描述1datajsonString是如下无datajson是对象数组，字段具体说明如下：序号名称类型是否必须例如值描述1IDString是主键ID2YSD_SEQIDString是运输单编号3EX_YSDIDString转料前运输单ID4HNTSEQIDString混凝土流水号5PHB_C0DEString配合比编号6ORGANIDString企业编码7ORGANNAMEString企业名称8SG_NAMEString施工单位9GC_NUMString工程监督编号10GC_NAMEString工程名称11JZBWString浇筑部位12CHEQIString车次13CHEPAIString车牌号14DENGJIString强度等级15NOTEString其他技要求16DTUIDString设备编号17LINEString生产线编号18LINEGC_NAMEString生产线工程名称19FACTORYAMOUNTNumber供应方量20FACTORYENDDATEDate搅拌结束时间21RECORDDATEDate生产时间22PRINTSTATEString运输单状态23PRINTMETHODString打印方式24ISTRANFERString是否转料25TRANFERSTATEString转料状态26PRINTDATEDate打印时间27CREATEDATEDate创立时间28UPDATEDATEDate更新时间29RETURNDATEDate退货时间30RECEIPTDATEDate收货时间31RECEIPTMANString收货人32CURRENTCHECINumber当前车次33TOTALCHECINumber累计车次34TOTALVOLUMENumber累计总方量35PANSHUNumber本车供应盘数36EX_FACTORYAMOUNTNumber原运输单供应方量2L3.5.5. 返回结果序号名称类型例如值描述1successBooleanTrue成功标识2messageString描述信息3codeNumber200状态码4timestampNumber时间毫秒5resultString结果2. 1. 3. 5. 6.参数例如(1)接收参数ID:testidl”, YSD_SEQID：, EX YSDID：， HNTSEQID PHB_CODE “ORGANID: ORGANNAME：, SG_NAME：， GC_NUM:“， GC_NAME：， JZBW ：”，CHEQI: CHEPAI: DENGJI: “NOTE：”DTUID:, INE ：”，LINEGC_NAME:，FACTORYAMOUNT:10,FACTORYENDDATE：2021-10-01 10:00:00, RECORDDATE : 2021To-01 10:00:00, “PRINTSTATE：，“PRINTMETHOD： “ISTRANFER：,TRANFERSTATE：”，PRINTDATE:2021-10-01 10:00:00， CREATEDATE：2021-10-01 10:00:00， UPDATEDATE：2021-10-01 10:00:00， RETURNDATE:2021-10-01 10:00:00， “RECEIPTDATE：2021-10-01 10:00:00, “RECEIPTMAN：， CURRENTCHECI：O,TOTALCHECI：O, “TOTALVOLUME：0,PANSHU：O,EX_FACTORYAMOUNT：0, ID：testid2，YSD_SEQID：,EX_YSDID：”，HNTSEQID：”，PHB_CODE:，“ORGANID：”，ORGANNAME:，SG_NAME：”，GC_NUM:，GC_NAME：，JZBW ：”，CHEQI：,CHEPAI：，DENGJI:，“NOTE:，DTUID:“，INE :，LINEGC_NAME ：”，FACTORYAMOUNT:10,FACTORYENDDATE:2021-10-01 10:00:00,RECORDDATE:2021-10-01 10:00:00，PRINTSTATE ：”，“PRINTMETHOD ：”， “ISTRANFER ：”, TRANFERSTATE：， PRINTDATE:2021-10-01 10:00:00， CREATEDATE ： 2021To-01 10:00:00, UPDATEDATE：2021-10-01 10:00:00， RETURNDATE:2021-10-01 10:00:00， “RECEIPTDATE：2021-10-01 10:00:00, RECEIPTMAN：， CURRENTCHECI：O,TOTALCHECI：O, “TOTALVOLUME：0, “PANSHU：0,EX_FACTORYAMOUNT：0(2)返回信息 success : true,“message”: 运输单信息接收成功,“code： 200,“result： null,timestamp: 2. 1. 3. 6.运输单明细信息API接口2.L3.6. L 接口名称接收外部推送的混凝土运输单明细信息数据2. 1. 3. 6. 2. 接口概述接收推送的混凝土运输单明细信息数据2L36.3.接口地址 :/IP:port/concrete-ex ternal/hnt/f ore ign/concret eDei iveryDetail/ insertExternalData2.L3.6.4. 接口参数序号名称类型是否必须例如值描述1datajsonString是如下无datajson是对象数组，字段具体说明如下：序号名称类型是否必须例如值描述1IDString是主键ID2YSDIDString是运输单ID3HNTSEQIDString混凝土流水号4PROJECTNAMEString工程名称5DTUIDString设备编号6LINEString生产线7FACTORYSEQIDString生产盘号（批次号）8SHENGCHANHAOString生产号9CHEPAIString车牌10INSERTDATEDate录入时间11FACTORYENDDATEDate投料结束时间12FACTORYAMOUNTNumber生产方量13STATEString状态14JZBWString拟浇筑部位15PBNUMString配合比编号2.L3.6.5.返回结果序号名称类型例如值描述1successBooleanTrue成功标识2messageString描述信息3codeNumber200状态码4timestampNumber时间毫秒5resultString结果2. 1. 3. 6. 6.参数例如(1)接收参数ID:“testidl”, YSDID:， “HNTSEQID ：”， PROJECTNAME: DTUID:， LINE：，FACTORYSEQID:SHENGCHANHAO:CHEPAI：，INSERTDATE:2021-10-01 10:00:00，“FACTORYENDDATE：2021-10-01 10:00:00,FACTORYAMOUNT:0,“STATEJZBW：”，PBNUM：ID：testid2，YSDID :“， HNTSEQID ：”， PROJECTNAME:LINE:，FACTORYSEQID：，SHENGCHANHAO：”，CHEPAI：，INSERTDATE:2021-10-01 10:00:00，“FACTORYENDDATE：2021-10-01 10:00:00,FACTORYAMOUNT:0,STATE：,JZBW：”，PBNUM：(2)返回信息( success : true,“message： 运输单明细信息接收成功code： 200,“result： null,“timestamp： 2.L3.7.混凝土试件信息API接口2. 1. 3. 7. 1.接口名称接收外部推送的混凝土试件信息数据2. 1. 3. 7. 2.接口概述接收推送的混凝土试件信息数据2.1. 3. 7. 3.接口地址 :/IP:port/concrete-external/hnt/foreign/phNum/insertExternalData2. L3.7.4.接口参数序号名称类型是否必须例如值描述1datajsonString是如下无datajson是对象数组，字段具体说明如下：序号名称类型是否必须例如值描述10PERATI0N_FACT0RY _IDString是生产信息ID2PH_NUMString是试件编号3HNT_SEQIDString混凝土生产流水号4STATEString数据状态5RECORDDATEDate2021-10-01 10:00:00录入日期6REMARKString备注7GC_NUMString工程质量监督号2. 1. 3. 7. 5.返回结果序号名称类型例如值描述1successBooleanTrue成功标识2messageString描述信息3codeNumber200状态码4timestampNumber时间毫秒5resultString结果2. 1. 3. 7. 6.参数例如(1)接收参数 OPERATION_FACTORY_ID ： t e s t i d1，PH_NUM：testl，HNT_SEQID：,“STATE：，RECORDDATE : 2021To-01 10:00:00,“REMARK：，GC_NUM：”，z OPERAT I ON_FACTOR Y_ ID : testid2，PH_NUM：testl，HNT_SEQID：”，STATE ：”，RECORDDATE:2021-10-01 10:00:00,“REMARK：，GC_NUM:“(2)返回信息 . success : true,“message： 混凝土试件信息接收成功,“code： 200,“result”: null,timestamp: )3.相关数据说明(1) 工程质量监督号监督系统将工程数据同步到混凝土生产监管系统后，混凝土生产监管系统对工程质量 监督号进行处理，如工程质量监督号为ZJ20190406002的工程在混凝土生产监管系统中参 与业务时的工程质量监督号为SZZJ20190406002(2) 混凝土流水号生产信息在递交后生成混凝土流水号格式为“生产单位缩写+时间+序号”，各局部长度为“3 + 6 + 4共13位(3) 运输单信息运输单状态搅拌车到工地后有两个状态，收货和退货，如果是收货那么根据完成落货时间2.接口说明2.1. 工程质量监管综合平台1. 1.1.接口协议接口协议采用 /POST(application/json;charset=UTF-8)2. 1. 2. 接口地址环境地址请求头生产环境. gzcqs. com:9003/appld: testuser(*)地址替换下文的IP : port)2. 1. 3.接口详细说明 2. 1.3. 1.混凝土生产信息API接口2.1.3. 1.1.接口名称接收外部推送的混凝土生产信息2.1.3. 1.2.接口概述接收推送的混凝土生产信息，包含已保存、已递交、已打印的生产信息2.1.3. 1.3.接口地址 :/IP:port/concrete-external/hnt/foreign/operationFactory/insertExternalData2. 1. 3. 1. 4.接口参数序号名称类型是否必须例如值描述1datajsonString是如下无datajson是对象数组，字段具体说明如下：(DROP_GOODS_END_TIME)定义收货时间，如果是退货根据落货时间(DROP_GOODS_END_TIME)定义退货时间运输单信息主键运输单信息表主键ID字段是运输单信息明细表里的YSD_ID运输单信息明细主键运输单明细数据的主键ID就是拌台投料数据的主键ID(4)混凝土生产监管系统推送的时间字段混凝土生产监管系统推送数据到工程质量监管综合平台的JSON数据包含时间类型，时 间类型数据为时间戳格式，接收参数时需要进行转义。例：/Date序号名称类型是否必须例如值描述1IDString是Id2HNT_SEQIDString混凝土生产流水号3GC_NUMString工程监督受理号4SYS_0RGAN_IDString机构编码5PHB_C0DEString设计配合比编号6PHB_C0DE_RECString设计配合比编号记录7SJQDDJString设计强度等级8SJQDDJ_RECString设计强度等级记录9NJZBWString拟浇筑部位10PH_NUMString混凝土试件编号11WATERNumber水12WATER_RECNumber水记录13SNPZString水泥品种14SNPZ_RECString水泥品种记录15CEMENTNumber水泥16CEMENT_RECNumber水泥记录17SNDHString水泥代号18SNDH_RECString水泥代号记录19SNQDString强度等级20SNQD_RECString强度等级记录21REC0RD_DATEDate2021-10-01 10:00:00录入日期22SHANumber砂23SHA_RECNumber砂记录24STONE1Number石125STONE1_RECNumber石记录126ST0NE2Number石227ST0NE2_REC