国内水路运输许可证书管理系统数据接口方案

1附件：系统数据接口服务说明（V1.0）1概述1.1应用对象本数据接口服务适用于省级水路运输管理部门已建成应用且已全省联网应用的国内水路运输管理类信息系统（以下简称省级系统）。省级系统按照数据接口服务经过必要改造后，可实现本省水路运输行政许可证书相关信息上报和证书打印，最终形成全国统一规范的水路运输证书信息数据库。1.2编制依据（1）《交通信息基础数据元第5部分：船舶信息基础数据元》；（2）《交通信息基础数据元第6部分：船员信息基础数据元》；（3）《交通信息基础数据元第8部分：水路运输信息基础数据元》；（4）《关于征求国内水路运输行政许可证书网上办理系统技术方案意见的通知》。1.3主要内容本数据接口服务为省级系统提供两类服务：（1）省市级水路运输管理部门负责核发的水路运输企业经营许可证、船舶营业运输证以及船舶管理业经营许可证相关信息的数据上报接口服务；2（2）省市级水路运输管理部门负责核发的水路运输企业经营许可证、船舶营业运输证以及船舶管理业经营许可证的证书打印服务。1.4使用条件为增强信息安全性，本数据接口服务将采用Ukey和账户密码等手段进行身份验证。针对数据上报接口，省级系统需申请一组账号和密码，具体申请方式请发送邮件至[e-mail]，注明申请单位、联系人、联系电话。针对证书打印服务，各省市级负责水路运输管理的部门可根据审批业务量自行决定UKey配置数量；原则上，具有审批权限的水路运输管理部门只能配置一个UKey，UKey购置与使用方案另行规定。2接口描述2.1访问地址2.1.1数据上报接口数据上报接口访问地址格式如下：注：具体地址如变动会另行通知。2.1.2证书打印接口证书打印接口访问地址如下：3注：打印接口地址需要传递参数，具体见接口说明部分。2.2调用方式2.2.1数据上报接口省级系统按照本接口规范所约定的XML格式进行数据填充，主动调用部级系统提供的相关WebService服务，部级系统按照约定对该XML文本进行验证，通过验证后将该数据导入到部级系统，否则部级系统将不予接收，并反馈相关信息。接口调用流程如下图所示：42.2.2证书打印接口直接调用http链接传递参数打印。3接口说明3.1数据上报接口本接口规范目前提供“获取信息”、“更新信息”两个接口服务。更新信息服务uploadData对外提供如下接口方法：handleXml(StringxmlContent),该方法通过规定和解析不同的xmlContent格式内容，完成航运企业运输许可证、船舶管理业运输许可证及船舶营运证信息的上报和更新操作。其中xmlContent参数为一个XML格式的字符串。获取信息服务对外提供如下接口方法：getLicenseTitle(StringorganName,StringlogInName,Stringpassword,Stringtype)，获取所在机构可用的证书头信息。参数分别为：用户所在机构名称，用户接口验证登录用户名，用户接口验证登录密码，证书头类型。getLicenseNo(StringorganName,StringlogInName,Stringpassword,Stringid,Stringbusiness)，获取证书编号。参数分别为：organName，机构名称；logInName，登录用户名；password，登录密码；business，业务名称，含ENT_LICENSE、SERVICE_ENT_LICENSE、SHIP_LICENSE。getServiceEnt(StringorganName,StringlogInName,Stringpassword)，获取所有船舶管理业企业列表。参数分别为：用户所在机构名称，用户接口验证登录用户名，用户接口验证登录密码。以省级系统数据上报为例，本接口调用步骤如下：（1）组织并填充符合规范的XML格式的字符串；5（2）调用统一接口方法：publicintuploadData(StringxmlContent)；（3）根据返回值判断上传是否成功，0为成功，非0为失败；获取证书接口调用成功返回证书编号字符串；（4）完成数据上报操作。3.1.1调用时机uploadData接口方法的调用时机包括：（1）水路运输经营许可证新增；（2）水路运输经营许可证变更；（3）水路运输经营许可证注销；（4）船舶管理业务经营许可证新增；（5）船舶管理业务经营许可证变更；（6）船舶管理业务经营许可证注销；（7）船舶营运证新增；（8）船舶营运证变更；（9）船舶营运证注销。getLicenseNo接口方法：（1）企业及船舶管理业信息提交成功后，打印水路运输经营许可证、船舶管理业经营许可证及船舶管理业务经营许可证之前；6（2）船舶信息提交成功后，打印船舶营运证之前。getLicenseTitle接口方法：在数据上报之前，如需重新产生证书证件编号，则需要先调用本方法获取可用证书头信息。getServiceEnt接口方法：在申请船舶营运证时，需调用本方法获取船舶管理业企业信息。3.1.2数据格式3.1.3XML数据格式XML数据格式如下所示：datainfo!--operate、user、userkey的具体值根据服务使用者情况而定--titleorganName=''logInName=''password=''/title!--企业信息--datadataType=''operate=''pk=''colname=''colType='String'![CDATA[]]/col„„!--证书核发信息，不含证书号，证书号头需选择：根据其机构开放不同的证书头--/data„„/datainfoXML数据格式说明如下表所示：标记名称标记说明属性名称属性说明datainfo非空XML根标记，只能有一个此标记无无title非空标记，XML证书头信息organName填报人机构名称7标记名称标记说明属性名称属性说明logInName填报人用户名password填报人密码（明文）data非空标记，视业务不同可以有多个此标记dataType指定上传何种数据，与业务数据相对应，共7种，对应关系见下表：“dataType值与水路运政业务数据对照表”operate指定对上传数据的操作。共3种：新增、修改、删除，对应值为：ADD,UPDATE,DELETEpk按照“1.4”申请用户和密码dataType值与水路运政业务数据对应关系如下表所示：序号数据内容代码数据内容描述1ENT水路运输企业2ENT_LICENSE企业运输许可证3ENT_LICENSE_BIZ_SCOPE企业经营范围4ENT_MANAGER专职管理人员5ENT_INVESTOR投资单位6ENT_CAPACITY运力总规模7SHIP船舶信息8SHIP_LICENSE船舶营运证9SHIP_LICENSE_BIZ_SCOPE船舶经营范围10SERVICE_ENT_INFO水路运输服务企业档案11SERVICE_ENT_LICENSE水路运输服务企业经营许可证12SERVICE_ENT_LICENSE_BIZ_SCOPE水路运输服务企业经营许可证业务范围13SERVICE_ENT_MANAGER水路运输服务企业档案专职管理人员14SERVICE_ENT_INVESTOR水路运输服务企业档案股东15SERVICE_ENT_COMPLIANCE_DOC船舶管理业国内符合证明3.1.4数据字段说明每个XML格式文件有多个col标记，每个col标记为一个数据字段。8对这些数据字段的相关描述以下表形式进行说明：字段名字段描述数据类型是否非空备注ID主键StringPK字段名：数据字段的名称；字段描述：对此字段用途的简单描述；数据类型：此字段的数据类型（参见3.2.3）；长度：此字段的最大长度；是否非空：如果此字段为主键，则以PK表示，并且不能为空；其他字段默认情况下允许为空，除非在“是否非空”中以“√”标识；对于允许为空的字段，其值应当填写“”，而不能是“null”或其他；备注数据字典说明及示例数据说明；主键主键字段的值可由省级系统作为服务使用者根据自身系统情况而定，如可采用UUID等，但通过该主键必须保证数据记录的唯一性；相关数据之间主键要保持关联，如“投资单位”与“航运企业”，每个投资单位都属于某个特定的航运企业，因此，投资单位数据表中存在所在航运企业的主键字段，以实现两者的关联。93.1.5数据类型说明字符串型：以“String”表示，中文一个字符占2个长度，其他占1个长度。例如：“港口”其长度为4，“gk”其长度为2。日期型：以“Date”表示，日期格式必须是“年-月-日”。例如：2011年7月4日，必须表示为“2011-07-04”。数字型：以“Number”表示，其长度表示数字的位数。例如：整型：长度10，则其最大位数为10，即10亿；浮点型：长度10,2，则其最大整数位数为8，小数为2，总长度为10。3.1.6数据内容总览3.1.6.1企业信息【ENT】字段名字段描述数据类型是否非空备注ID对象IDSTRING(32)√ENT_NAME企业名称STRING(255)√ENT_TYPE企业类型STRING(1)√非部审批发证企业请填写“0”REGION_CODE行政区划STRING(10)√行政区划（GBT2260-2007）；TRANSPORT_AREA_TYPE省际省内标识STRING(1)√企业运输范围：0：省际；1省内【含市内】IF_INDIVIDUAL_ENT是否个体STRING(1)√0：企业；1个体ENT_ADDRESS注册地址STRING(1024)√PRINCIPAL_NAME法定代表人STRING(100)√ID_CARD_NO身份证号STRING(30)√法定代表人的身份证号ECONOMIC_FORM经济类型STRING(3)√数据字典：经济类型BIZ_REG_NO工商营业执照号STRING(30)√FUND_CURRENCY资金币种STRING(4)√数据字典：货币种类FUND_TOTAL_AMOUNT注册资本NUMBER(18,2)√10字段名字段描述数据类型是否非空备注TELEPHONE电话号码STRING(50)√FAX传真STRING(50)REMARK备注STRING(4000)3.1.6.2企业运输许可证【ENT_LICENSE】字段名字段描述数据类型是否非空备注ID对象IDSTRING(32)√LICENSE_TITLE证书头STRING(32)√证书头ID，按获取证书头接口获取，把ID信息传入XML文件OPERATE_SCOPE_PASSENGER经营范围（旅客运输）STRING(1024)√OPERATE_SCOPE_CARGO经营范围（货物运输）STRING(1024)√VALID_ACCOUNT经营期限NUMBER√VALID_FROM开始时间Date√VALID_UNTIL结束日期Date√APPROVAL_DOC_NO文号STRING(255)√APPROVAL_ORG批准机关String√DATE_OF_ISSUE发证日期Date√3.1.6.3企业经营范围【ENT_LICENSE_BIZ_SCOPE】字段名字段描述数据类型是否非空备注ID对象IDSTRING(32)√ENT_LICENSE_ID企业许可证IDSTRING(32)√BIZ_TYPE业务类型STRING(1)√0：客运；1：货运；11字段名字段描述数据类型是否非空备注TRANSPORT_AREA_TYPE经营范围String√0：省际；1：省内【含市内】；数据字典：运输范围TRANSPORT_AREA经营区域String√0：国内沿海；1：内河；数据字典：沿海/内河各省内企业请默认选择1；SHIPPIN