海运舱单集中申报系统技术规范WebService接口V1.01天津电子口岸发展有限公司2009年6月天津电子口岸船情系统技术规范2文件制/修订履历修订版次修订日期修订说明作者备注1.02009/7/10初次發行1.012009/8/201、海运舱单申报舱单数据接口增加参数“报文名称”2、修改舱单数据填制条件陈罡1.022009/11/17增加webservices接口的参数,用于表示“客户请求要将报文发送的执法机关”陈罡1.032009/11/24增加“确认回执是否收取成功”的方法陈罡天津电子口岸船情系统技术规范3目录1编制说明.................................................................................................................41.1目的..........................................................................................................................41.2解释权......................................................................................................................41.3参考标准和文献......................................................................................................42名词术语.................................................................................................................53接入功能及流程.....................................................................................................63.1概述..........................................................................................................................63.2网络结构..................................................................................................................63.3认证服务..................................................................................................................73.3.1认证的介绍................................................................................................73.3.2流程描述....................................................................................................74接口..........................................................................................................................84.1认证服务接口..........................................................................................................84.1.1获取服务器端随机数................................................................................84.2舱单申报服务接口..................................................................................................84.2.1海运舱单申报舱单数据............................................................................94.2.2海运舱单获取审批回执..........................................................................104.2.3确认回执是否收取成功...........................................................................115舱单数据填制条件...............................................................................................12天津电子口岸船情系统技术规范41编制说明1.1目的为了指导天津电子口岸海运舱单集中申报系统客户端开发商的开发,特制定本规范。本规范为天津电子口岸发展有限公司企业规范,规定天津电子口岸提供给海运舱单集中申报系统客户端的Web服务接口。1.2解释权本规范由天津电子口岸发展有限公司起草。本规范的解释权属于天津电子口岸发展有限公司。1.3参考标准和文献下列标准所包含的条文,通过本标准的引用而构成本标准的条文。在标准出版时,所示版本均为有效。所有标准都会被修改,使用本标准的各方应探讨使用下列标准最新版本的可能性。RFC1738统一资源定位器(URL)RFC2068超文本传输协议HTTP/1.1RFC1521BASE64算法RFC18513DES算法RFC1852SHA算法天津电子口岸船情系统技术规范52名词术语服务器端随机数:由电子口岸舱单信息服务平台产生的8位随机数,供客户端与服务器端进行对碰使用。算法变量:在客户端与服务器端通过对8位随机数进行相关算法函数计算,得出的结果称为算法变量,供客户端与服务器端认证使用。海关备案号:用户企业在地方海关进行业务备案时,由地方海关定义指定的企业唯一编号。电子口岸注册号:用户企业在天津电子口岸进行注册时,提供给企业的唯一编号。天津电子口岸船情系统技术规范63接入功能及流程3.1概述海运舱单集中申报系统提供了如下WebService接口认证服务:提供登录认证的接口,可供海运舱单集中申报系统外的其他业务系统使用海运舱单申报服务;海运舱单删除申报服务;海运舱单获取审批回执服务;参数查询:提供海运舱单集中申报系统中各种参数字典的查询服务(当前版本不包含此项服务)3.2网络结构舱单集中申报系统客户端通过Internet与舱单集中申报系统的各服务连接,网络结构示意图如下:Internet舱单集中申报客户端认证服务参数服务舱单申报服务获取回执服务其他业务服务图3-1网络结构示意图天津电子口岸船情系统技术规范73.3认证服务3.3.1认证的介绍由于业务的特殊性,海运舱单集中申报系统的用户必须使用认证Ukey发送业务数据,因此要求客户端需要安装识别Ukey的驱动程序,用户需要在天津电子口岸注册为合法用户后领取认证Ukey,方能正常使用海运舱单集中申报系统的认证服务。3.3.2流程描述中心交换平台认证模块IBM用户终端1.请求随机数2.返回随机数3.将随机数传给加密狗得到变量4.提交随机数和变量6.返回对碰结果5.根据随机数进行校验并返回校验信息7.提交随机数和舱单对象图3-2登录流程示意图1)客户端向服务器端请求获取服务器端随机数。2)服务器端返回给客户端随机数。3)客户端将服务器端随机数传递给本地加密锁的算法,以便生成算法变量。4)客户端向服务器端提交服务器端随机数和算法变量。5)服务器端将根据随机数客户端算法变量进行校验,并返回校验信息。6)服务器端将校验信息返回给用户。7)客户端进行业务申报时,将服务器端随机数同业务数据一同提交给服务器端。8)登录完毕。天津电子口岸船情系统技术规范84接口4.1认证服务接口在提交和获取业务数据前,都要进行取得服务端随机数,并依赖于此进行业务操作。获取服务器端随机数接口方法为:GetServerRandom参数信息如下名称说明数据类型备注organ_code用户注册号String返回值信息返回值类型返回值说明备注String首先判断用户注册号是否存在,若不存在则返回错误信息,“用户不存在”;若存在,则继续判断用户是否有效,若为无效或冻结,则返回错误信息,“用户无效或冻结”;若用户有效则返回10位随机数说明:用户得到服务端随机数后,调用动态链接库(CDLL5.DLL)的Lock32_Function(String)方法,获得算法变量,作为验证数据。4.2舱单申报服务接口接收用户申报的进口原始舱单数据、出口预配舱单数据和装载舱单数据。天津电子口岸船情系统技术规范94.2.1海运舱单申报舱单数据接口方法为:p_SeaManifestDeclare参数信息如下名称说明数据类型备注ct客户端类型String必填user_code企业用户注册号String必填random10位随机数String必填ciphertext通过加密锁得到的算法变量String必填messagetype报文类型String必填messagefile报文名称(包括文件后缀)String必填content舱单申报报文内容byte[]必填enforcement客户请求要将报文发送的执法机关String必填返回值信息返回值类型返回值说明备注String如果企业注册号验证失败,则不进行其它数据的验证返回失败信息“企业验证失败”;否则,验证其它数据的有效性,如一个或多个数据验证失败,则将所有错误数据的详细信息返回;如数据验证成功,则返回成功信息“数据验证成功”;注:1、舱单申报的报文内容包括:1)原始舱单:一次申报、二次申报、变更、删除2)预配舱单:一次申报、二次申报、变更、删除3)装载舱单:增加、删除2、在填写存储原始舱单数据、获取预配舱单数据或获取装载舱单数据时,请参考“5.舱单数据填制条件”天津电子口岸船情系统技术规范103、客户请求要将报文发送的执法机关编号:0-海关,1-检验检疫局,2-天津港集团,3-海事局,4-边检如果要向多个执法机关发送报文,请以逗号分隔;例如:0,1,3表示要向海关、检验检疫局和海事局发送报文4.2.2海运舱单获取审批回执4.2.2.1接口方法为:p_GetReceiptString参数信息如下名称说明数据类型备注Random10位随机数String必填ciphertext通过加密锁得到的算法变量String必填enforcement客户要获取那个执法机关的回执String必填user_code用户注册号String必填bit_journeyid