保险综合数据平台接口规范.doc

保险综合数据平台接口规范版本号：1.0.0目录1适用范围12规范性引用文件13术语与缩略语14接口定义说明14.1接口方式说明14.1.1CHCXP 消息处理机制24.2接口数据结构定义说明24.2.1Message Header34.2.2Service Content75平安云数据据同步接口定义75.1个人基本信息类135.1.1居民基本资料PERSON_INFO135.1.2居民联系人PERSON_CONTACT145.1.3居民地址PERSON_ADDR155.1.4儿童补充基本资料CHILDREN_BASIC_INFO165.1.5出生信息CHILDREN_BIRTH_INFO185.1.6居民传染病史PERSON_ID_HIS205.2门诊225.2.1门诊流水OUT_VISITORS225.2.2门诊诊断OUT_DIAGNOSIS235.2.3门诊用药-处方主表OUT_RP235.2.4门诊用药-处方明细OUT_RP_DETAIL245.2.5门诊处置治疗-申请单主表OUT_TREAT255.2.6诊处置治疗-申请单明细OUT_TREAT_DETAIL255.2.7门诊手术OUT_OPERATION265.2.8门诊收据记录OUT_INVOICE275.2.9门诊收据分类汇总OUT_INVOICE_CLASS285.2.10门诊收据医疗费用来源列表OUT_INVOICE_SOURCES285.2.11门诊收据结算方式列表OUT_INVOICE_CLEARING295.2.12门诊费用明细OUT_FEE_DETAIL295.2.13门诊检验登记OUT_LAB_REG305.2.14门诊常规检验结果明细 OUT_LAB_ROUTINE_RESULT325.2.15细菌培养结果LAB_MICRO_RESULT325.2.16门诊检查登记OUT_RIS_REG335.2.17门诊检查报告OUT_RIS_REPORT345.2.18门诊检查影像数据OUT_RIS_PACS_RESULT365.3住院365.3.1病案首页记录MRN_RECORD365.3.2病案首页记录-中医MRN_RECORD_CH_EXP395.3.3诊断（西医）MRN_DIAGNOSIS405.3.4诊断（中医）MRN_DIAGNOSIS_CH415.3.5手术MRN_OPERATION415.3.6转科MRN_TRANSFER425.3.7婴儿MRN_BABY435.3.8肿瘤卡MRN_TUMOR435.3.9化疗MRN_CHEMOTHERAPY455.3.10费用分类明细MRN_FEE_DETAIL465.3.11病案首页其它MRN_OTHER495.3.12住院登记IN_REG515.3.13住院诊断IN_DIAGNOSIS535.3.14住院医嘱IN_ORDER535.3.15住院手术IN_OPERATION555.3.16住院转科IN_TRANSFER555.3.17住院费用明细IN_FEE_DETAIL565.3.18住院费用分类汇总IN_INVOICE_CLASS575.3.19住院结算记录IN_INVOICE575.3.20住院收据结算方式列表IN_INVOICE_CLEARING585.3.21住院收据医疗费用来源列表IN_INVOICE_SOURCES595.3.22住院检验登记IN_LAB_REG595.3.23住院常规检验结果明细IN_LAB_ROUTINE_RESULT615.3.24住院细菌培养结果IN_LAB_MICRO_RESULT615.3.25住院检查登记IN_RIS_REG625.3.26住院检查报告IN_RIS_REPORT645.4体检655.4.1体检登记HCHK_REG655.4.2体检大项目登记HCHK_COMB665.4.3体检明细项目结果HCHK_ITEM_RESULT665.4.4体检费用结算主表HCHK_FEE_PAY675.4.5体检费用明细HCHK_FEE685.5死亡报告685.5.1死亡医学证明-信息登记DICO_MCOD_REG685.5.2死亡医学证明-死因与诊断DICO_MCOD_DIAG695.5.3居民既往疾病史PERSON_DISEASE_HIS705.5.4居民既往手术史PERSON_SURGICAL_HIS705.5.5居民既往外伤史PERSON_TRAUMA_HIS715.5.6居民既往输血史PERSON_TRANSFUSION_HIS715.5.7居民残疾PERSON_DISABILITY_HIS716统一编码726.1系统编码表726.2业务类型表726.3业务交易编码表746.4操作类型编码表746.5消息体类型编码表756.6错误编码表756.7系统应答编码表756.8系统错误应答编码表767编制历史77前 言本标准以区域数据中心的规划内容为指导，明确定义了保险综合数据平台与平安云服务器之间的接口，用于指导保险数据综合平台进行系统建设。本文档主要包括总体说明、平安云数据同步接口、平台数据查询接口定义及相关编码等。本标准由标准归口部门负责解释。本标准起草单位：深圳中科金证科技有限公司。本标准主要起草人：杨瑞军1 适用范围保险综合数据平台接口规范v1.0适用于指导保险综合数据平台接口的开发和测试，是保险综合数据平台与平安云服务器数据推送建设的主要依据。本规范规定了保险综合数据平台与平安云服务器互联的接口定义、统一编码等内容。2 规范性引用文件下列文件中的条款通过本规范的引用而成为本规范的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本规范，然而，鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本规范。序号文件类型文件名称来源1业务规范2业务规范3技术规范3 术语与缩略语下列缩略语适用于本规范：词语解释CISP保险综合数据平台PY平安云区域数据平台健康数据。4 接口定义说明4.1 接口方式说明保险综合数据平台与平安云存在以下业务接口：1. 平安云数据同步接口：平安云发送数据同步请求（须传送数据授权信息），CISP接到数据请求，处理请求，将整理好的数据加上数据签名同步到平安云服务器。a. 批量接口：平安发送请求，将授权数据按照定义的接口规范传输到综合数据平台，平台将属于授权名单的人员的医疗数据按照规定格式传送给平安，平安接收验证数据正确返回接收确认信息；b. 重传接口：有条件使用，如有需求要求或者数据错误；c. 增量接口：针对已经传送给平安的数据，如果医疗数据有更新将按照规定的时间定时推送给平安；4.1.1 CHCXP 消息处理机制整个接口处理机制采用公司CHCXP消息中间件进行数据处理，数据请求、接收都将由中科金证提供或者中科金证提供CHCXP的开发的API，程序由平安自行处理。4.2 接口数据结构定义说明CISP与平安云之间的接口无论消息方式还是文件方式，都采用相同的报文记录格式，同步的报文内容以JSON进行组织。消息方式的每条消息只包含最多1000条授权记录，而文件方式的每个同步文件可包含1到多条医疗数据记录。每批记录都有消息头部（Message Header）和消息体（Message Content）。消息头采用统一的定义，消息体按每类接口分业务各自描述。本文档以表格的形式表示XML格式；以下为表格中对元素约束（出现次数）的表示方法的描述：符号含义?0.1，可选项，表示可有可无,*0.n，可以没有，也可以有多项+1.n，至少有1项，也可以有多项1数字1，代表必须且只能填1项另外，报文格式中“F”指固定长度，“V”表示变长，对于长度的定义指的是字节数，如V20表示为可变长的20个字节的长度。格式中节点的含义是指它下面包含一个到多个元素。注意：对于可无指的是节点值可以为空，但对应的节点（KEY值）名称必须要存在。注意：接口中所有日期格式都为YYYYMMDDHHmmss4.2.1 Message Header根据JSON的定义，每条记录都需要有特定的KEY、VALUE相对应。接口内容传输到平台，平台判断授权文件正确性，如正确将符合授权文件内容的医疗数据按照接口规范生成JSON数据包和应答标志返回给平安云，如果在授权文件中有不符合的数据，平台将不符合的数据按照规定的接口规范返回给平安云并将部分符合的医疗数据一并返回。具体请求格式如下： messageHeader: origDomain: 发起方, homeDomain: 归属方, msgType: 0, bipVer: 业务流程版本号, procID: 业务流水号, processTime: 处理时间, syncType: 0, disclaimer: 免责, 测试标记: 1, count: 总记录条数, opType: 操作类型, RspType: 应答或错误类型, RspCode: 应答或错误代码, RspDesc: 应答或错误描述, TestFlag: 发起方填写，0：非测试数据，1：测试数据, pesron: certID: 投保人唯一标识证件号码, certType: 唯一标识类型, policyName: 姓名, IsAccredit: 是否授权, policyCode: 保单号码, disclaimer: 送请求时要附带免责声明, accreditBegV14: 授权开始日期, accreditEndV14: 授权结束日期, sStartV14: 服务开始日期, sEndV14: 服务结束日期 , certID: 投保人唯一标识证件号码, certType: 唯一标识类型, policyName: 姓名1, isAccredit: 是否授权, policyCode: 保单号码, disclaimer: 送请求时要附带免责声明, accreditBegV14: 授权开始日期, accreditEndV14: 授权结束日期, sStartV14: 服务开始日期, sEndV14: 服务结束日期 各个字段解释如下表：l 序号KEY值约束类型长度描述取值说明1.1.origDomain1StringF4发起方代码参见统一编码中的系统编码表1.2.HomeDomain1StringF4归属方代码参见统一编码中的系统编码表1.3.msgType1StringF1类型，请求还是应答消息接口中填。0：请求，1：应答1.4.bipVer1StringF4业务流程版本号消息接口中填。1000;对于同一交易应答与请求版本号始终一致1.5.procID1StringV30业务流水号发起方填写的包含此交易业务的流水号，消息应答方原样返回。1.6.processTime1StringF14处理时间发起方发起请求的时间，格式为：格式：YYYYMMDDHHmmss1.7.syncType1StringF1类型，同步数据请求还是实时查询请求消息接口中填。0：同步数据请求（默认），1：实时查询请求(特殊要求，数据暂不支持实时数据。1.8.policyCode1StringV32保单号码投保单的单号1.9.policyName1StringV32投保人员姓名要查询保单人员的姓名信息1.10.certType1StringV32唯一标识类型身份证、社保、护照等1.11.certID1StringV18投保人唯一标识证件号码要查询保单人员的身份证信息1.12.isAccredit1StirngV1是否授权是否有授权，如果是有授权，数据处理，返回数据，否则只给部分结果1.13.accreditBegV141StringV14授权开始日期授权开始日期 格式为：格式：YYYYMMDDHHmmss1.14.accreditEndV141StringV14授权结束日期授权结束日期 格式为：格式：YYYYMMDDHHmmss1.15.disclaimer?StringV512免责发送请求时要附带免责声明，如有纠纷与中科金证无关1.16.count?StringV3总记录条数总记录数，只在实时查询请求用到，应答原样返回1.17.opType?StringF3操作类型必填项，取值范围为：B：批量R：重复A：增量只在同步数据请求中用到，应答原样返回1.17.1.RspCode1StringF4应答/错误代码应答或错误代码，加载成功返回为DONE，加载错误的错误代码参见业务应答编码表1.17.2.RspDesc1StringV512应答/错误描述应答或错误描述，参见每类文件的检错标准1.18.TestFlag1StringF1测试标记发起方填写，0：非测试数据，1：测试数据；测试数据不做正式加载，只用来测试双方系统的请求应答是否正常，平安云返回测试数据的校验结果。非测试数据需自动校验加载，并返回结果。4.2.2 Service ContentService Content为交易请求以及应答的内容，以JSON格式存储并将数据生成zip包进行加密以及数据签名认再进行数据传输，在交易报文传输时与Message Header一起传输。格式为：消息头、消息体：分为4类参考消息类型编码表+医疗类型编码表+医疗数据5 平安云数据据同步接口定义返回已授权名单的数据内容格式举例如下： messageHeader: origDomain: 发起方, homeDomain: 归属方, msgType: 1, bipVer: 业务流程版本号, procID: 业务流水号, processTime: 处理时间, syncType: , disclaimer: 免责, 测试标记: 1, count: 2, opType: 操作类型, RspType: 应答或错误类型, RspCode: 应答或错误代码, RspDesc: 应答或错误描述, TestFlag: 1, pesron: certID: certType: 01, policyName: 张三, IsAccredit: Y, policyCode: 00001, disclaimer: 送请求时要附带免责声明, accreditBegDate: 2010-1-1, accreditEndDate: 2016-1-1, sStartDate: 2010-1-1, sEndDate: 2016-1-1 , certID: certType: 01, policyName: 李四, isAccredit: Y, policyCode: 00002, disclaimer: 送请求时要附带免责声明, accreditBegDate: 2010-1-1, accreditEndDate: 2016-1-1, sStartDate: 2010-1-1, sEndDate: 2016-1-1 , messageContent: 证件类型: 01, 体检: , 病案: , 门诊: 2013-10-05: 检查记录: , 项目检验结果: , 检验记录: , 门诊信息: VISITDATE: 2013-10-05, DEPNM: SKEKMZ-蛇口儿科门诊, DOCTNM: 胡健 , 清单分类: CLASSNM: 其他, SNO: 1587878, ORGCD: 455850255, CLASSCD: 卫生费用门诊费用分类代码表CV07.10.001, PAYNO: 3820166, CLASSNMINHOS: 材料费, CLASSAMOUNT: 1.48 , CLASSNM: 西药, SNO: 1587878, ORGCD: 455850255, CLASSCD: 卫生费用门诊费用分类代码表CV07.10.001, PAYNO: 3820166, CLASSNMINHOS: 西药费, CLASSAMOUNT: 120.96 , CLASSNM: 其他, SNO: 1587878, ORGCD: 455850255, CLASSCD: 卫生费用门诊费用分类代码表CV07.10.001, PAYNO: 3820166, CLASSNMINHOS: 治疗费, CLASSAMOUNT: 11.4 , 收据清单: COSTALL: 133.84, INVOICETIME: 2013-10-05, SNO: 1587878, PAIDAMOUNT: 133.84, ORGCD: 455850255, SELFCOST: 77.21, INVOICESNO: JC59322207, PAYNO: 3820166, INSCOST: 56.63 , 费用明细: , 检查报告: , 门诊诊断: DIAGNM: 支气管肺炎, DIAGTIME: 1900-01-01, DOCTNM: 2013-10-05 胡健 , 细菌检验结果: , 手术记录: DIAGNM: 支气管肺炎 , 住院: , 证件类型: 01, 体检: , 病案: , 门诊: 2014-03-31: 检查记录: , 项目检验结果: , 检验记录: , 门诊信息: VISITDATE: 2014-03-31 , 清单分类: , 收据清单: , 费用明细: , 检查报告: , 门诊诊断: , 细菌检验结果: , 手术记录: , 住院: 5.1 个人基本信息类5.1.1 居民基本资料PERSON_INFOKEY值中文含义长度可空说明orgCode组织机构-编码V50否与TM_DICT_ORG表的orgCode一致pIdCd个人ID号编码系统V50否同主表即居民基本资料pId个人ID号V50否同主表即居民基本资料businessType业务类型F50记录所传数据是什么业务下的数据,参见业务类型表name本人姓名V50否sexName性别-名称V100否V14OfBirth出生时间V14格式为：格式：YYYYMMDDHHmmssage年龄V50如：20Y、1Y4M、24D Y:表示岁M：表示月D：表示天。参考住院病案首页年龄格式deathV14死亡（确认）日期F14格式为：格式：YYYYMMDDHHmmsscitizenshipName国籍-名称V100中文名称nationName民族-名称V100maritalName婚姻状况-名称V100insuranceTypeName医疗保险类别-名称V100insuranceNo医疗证号V50填医保卡上的医疗证号computerNo电脑号V50填医保卡上的电脑号outNo门诊号V20人头概念，非流水号概念inNo住院号V20人头概念，非流水号概念mrNo病案号V20人头概念，非流水号概念disabilityCertificateNo残疾证V20nameWorkunit单位名称V200nativePlaceName籍贯-名称V255careerName职业类别-名称V255说明：1.家庭成员之间用FAMILY_CODE关联。5.1.2 居民联系人PERSON_CONTACTKEY值中文含义长度可空说明orgCode组织机构-编码V50否pIdCd个人ID号编码系统V50否同主表即居民基本资料pId个人ID号V50否同主表即居民基本资料businessType业务类型F50记录所传数据是什么业务下的数据,参见业务类型表refName联系人关系-名称V100否name联系人姓名V50否tel联系人的电话V50addr联系人的地址V2555.1.3 居民地址PERSON_ADDRKEY值中文含义长度可空说明orgCode组织机构-编码V50否pIdCd个人ID号编码系统V50否同主表即居民基本资料pId个人ID号V50否同主表即居民基本资料businessType业务类型F50记录所传数据是什么业务下的数据,参见业务类型表className地址类别-名称V100addr详细地址V255否provinceName地址-省（自治区、直辖市）名称V255cityName地址-市（地区）名称V255countyName地址-区（县）名称V255townName地址-乡（镇、街道办事处）名称V255roadName地址-村（街、路、弄等）名称V255houseNum地址-门牌号码V505.1.4 儿童补充基本资料CHILDREN_BASIC_INFOKEY值中文含义长度可空说明pIdCd个人ID号编码系统V50否同主表即居民基本资料pId个人ID号V50否同主表即居民基本资料businessType业务类型F50记录所传数据是什么业务下的数据,参见业务类型表mPIdCd母亲个人ID号编码系统V50同主表居民基本资料主键mPId母亲个人IDV50同主表居民基本资料主键mName母亲姓名V50mTel母亲电话号码V20mIdcardTypeName母亲身份证件类别-名称V255mIdcard母亲身份证件-号码V20mCitizenshipName母亲国籍-名称V100中文名称mNationName母亲民族-名称V100mEduLevelName母亲文化程度-名称V100mCareerName母亲职业类别-名称V255mUnitName母亲工作单位名称V100mAddr母亲户籍详细地址V255fPId父亲个人IDV50同主表居民基本资料主键fName父亲姓名V50fTel父亲电话号码V20fIdcardTypeName父亲身份证件类别-名称V255fIdcard父亲身份证件-号码V20fCitizenshipName父亲国籍-名称V100中文名称fNationName父亲民族-名称V100fCareerName父亲职业类别-名称V255fUnitName父亲工作单位名称V100fAddr父亲户籍详细地址V255gName监护人姓名V50gTel监护人电话号码V20gIdcardTypeName监护人身份证件类别-名称V255gIdcard监护人身份证件-号码V20gRelaName监护人与本人关系-名称V255备注：本表保存的儿童补充基本资料为儿童的最新信息，历史信息保存在有儿童有关的业务表中。5.1.5 出生信息CHILDREN_BIRTH_INFOKEY值中文含义长度可空说明orgCode组织机构-编码V50否pIdCd个人ID号编码系统V50否同主表即居民基本资料pId个人ID号V50否同主表即居民基本资料businessType业务类型F50记录所传数据是什么业务下的数据,参见业务类型表birthSno出生医学证明编号V50唯一标识一张出生证明mInNo母亲住院号V50与出生医疗机构所对应的住院号mPId母亲个人IDV50同主表居民基本资料主键mName母亲姓名V50否mV14OfBirth母亲出生日期V14格式为：格式：YYYYMMDDHHmmssmAge母亲年龄V30使用住院病案首页年龄格式。如：20Y、1Y4M、24D。Y:表示岁M：表示月D：表示天。mIdcardTypeName母亲身份证件类别-名称V255否mIdcard母亲身份证件-号码V20否mCitizenshipName母亲国籍-名称V100否中文名称mNationName母亲民族-名称V100否fPId父亲个人IDV50同主表居民基本资料主键fName父亲姓名V50否fAge父亲年龄V30使用住院病案首页年龄格式。如：20Y、1Y4M、24D。Y:表示岁M：表示月D：表示天。fV14OfBirth父亲出生日期V14格式为：格式：YYYYMMDDHHmmssfIdcardTypeName父亲身份证件类别-名称V255否fIdcard父亲身份证件-号码V20否fCitizenshipName父亲国籍-名称V100否中文名称fNationName父亲民族-名称V100否familyAddr家庭住址V255否biradressType_name出生地点类别-名称V255否birthAddr出生详细地址V255否healthStatusCode新生儿健康状况-代码F18否1.良好；2.一般；3.差healthStatusDesc新生儿健康状况-描述V255否newbInNo新生儿住院号V50与出生医疗机构所对应的新生儿住院号name新生儿姓名V50sexName性别-名称V100否V14OfBirth出生时间V14否新生儿出生时间birthWeeks出生孕周F18否单位:周birthOrder出生顺序F18单胎顺序为1，多胎按实际出生顺序,包括死胎、死产fetusNum胎数F18本次母亲分娩的胎儿数量,包括死胎、死产birthHeight出生身长NUMBER(18,1否新生儿出生后1h内身长的测量值,计量单位为cmbirthWeight出身体重NUMBER(18,1否新生儿出生后1h内体重的测量值,计量单位为gnurseName助产人员-姓名V100否nurseOrgName助产机构-名称V255否sendV14签发日期V14否sendName签发人-姓名V100否签发操作员姓名说明：1、本表适用于记录出生医学证明。5.1.6 居民传染病史PERSON_ID_HIS传染病英文INFECTIOUS DISEASE缩写为IDKEY值中文含义长度可空说明orgCode组织机构代码V50否pIdCd个人ID号编码系统V50否同主表即居民基本资料pId个人ID号V50否同主表即居民基本资料businessType业务类型F50记录所传数据是什么业务下的数据,参见业务类型表idTypeDesc传染病类别-描述V255idName传染病-名称V255否diagnoseV14传染病确诊日期V145.2 门诊5.2.1 门诊流水OUT_VISITORSKEY值中文含义长度可空说明orgCode组织机构-编码V50否pIdCd个人ID号编码系统V50否同主表即居民基本资料pId个人ID号V50否同主表即居民基本资料businessType业务类型F50记录所传数据是什么业务下的数据,参见业务类型表outSno门诊流水号V50否唯一标示一次门诊visitorV14门诊日期V14否填就