海运舱单集中申报系统-天津电子口岸.docVIP

海运舱单集中申报系统 技术规范 WebService接口V1.01 天津电子口岸发展有限公司 2009年6月 文件制/修订履历 修订版次 修订日期 修订说明 作者 备注 1.0 2009/7/10 初次發行 1.01 2009/8/20 海运舱单申报舱单数据接口增加参数“报文名称” 修改舱单数据填制条件 陈罡 1.02 2009/11/17 增加webservices接口的参数，用于表示“客户请求要将报文发送的执法机关 1.03 2009/11/24 增加“确认回执是否收取成功”的方法 陈罡 目 录 1 编制说明 4 1.1 目的 4 1.2 解释权 4 1.3 参考标准和文献 4 2 名词术语 5 3 接入功能及流程 6 3.1 概述 6 3.2 网络结构 6 3.3 认证服务 7 3.3.1 认证的介绍 7 3.3.2 流程描述 7 4 接口 8 4.1 认证服务接口 8 4.1.1 获取服务器端随机数 8 4.2 舱单申报服务接口 8 4.2.1 海运舱单申报舱单数据 9 4.2.2 海运舱单获取审批回执 10 4.2.3 确认回执是否收取成功 11 5 舱单数据填制条件 12 编制说明 目的 为了指导天津电子口岸海运舱单集中申报系统客户端开发商的开发，特制定本规范。本规范为天津电子口岸发展有限公司企业规范，规定天津电子口岸提供给海运舱单集中申报系统客户端的Web服务接口。 解释权 本规范由天津电子口岸发展有限公司起草。本规范的解释权属于天津电子口岸发展有限公司。 参考标准和文献 下列标准所包含的条文，通过本标准的引用而构成本标准的条文。在标准出版时，所示版本均为有效。所有标准都会被修改，使用本标准的各方应探讨使用下列标准最新版本的可能性。 RFC1738 统一资源定位器（URL） RFC 2068超文本传输协议 HTTP/1.1 RFC 1521 BASE64算法 RFC 1851 3DES算法 RFC 1852 SHA算法 名词术语 服务器端随机数：由电子口岸舱单信息服务平台产生的8位随机数，供客户端与服务器端进行对碰使用。 算法变量：在客户端与服务器端通过对8位随机数进行相关算法函数计算，得出的结果称为算法变量，供客户端与服务器端认证使用。 海关备案号：用户企业在地方海关进行业务备案时，由地方海关定义指定的企业唯一编号。 电子口岸注册号：用户企业在天津电子口岸进行注册时，提供给企业的唯一编号。 接入功能及流程 概述 海运舱单集中申报系统提供了如下WebService接口 认证服务：提供登录认证的接口，可供海运舱单集中申报系统外的其他业务系统使用 海运舱单申报服务； 海运舱单删除申报服务； 海运舱单获取审批回执服务； 参数查询：提供海运舱单集中申报系统中各种参数字典的查询服务（当前版本不包含此项服务） 网络结构 舱单集中申报系统客户端通过Internet与舱单集中申报系统的各服务连接，网络结构示意图如下： 图3-1 网络结构示意图 认证服务 认证的介绍 由于业务的特殊性，海运舱单集中申报系统的用户必须使用认证Ukey发送业务数据，因此要求客户端需要安装识别Ukey的驱动程序，用户需要在天津电子口岸注册为合法用户后领取认证Ukey，方能正常使用海运舱单集中申报系统的认证服务。 流程描述 图3－2登录流程示意图 客户端向服务器端请求获取服务器端随机数。 服务器端返回给客户端随机数。 客户端将服务器端随机数传递给本地加密锁的算法，以便生成算法变量。 客户端向服务器端提交服务器端随机数和算法变量。 服务器端将根据随机数客户端算法变量进行校验，并返回校验信息。 服务器端将校验信息返回给用户。 客户端进行业务申报时，将服务器端随机数同业务数据一同提交给服务器端。 登录完毕。 接口 认证服务接口 在提交和获取业务数据前，都要进行取得服务端随机数，并依赖于此进行业务操作。 http:// 4:10000/SeaManifestDeclaration/services/DeclareService?wsdl 获取服务器端随机数 接口方法为：GetServerRandom 说明 数据类型 备注 organ_code 用户注册号 String 返回值信息 返回值类型 返回值说明 备注 String 首先判断用户注册号是否存在，若不存在则返回错误信息，“用户不存在”；若存在，则继续判断用户是否有效，若为无效或冻结，则返回错误信息，“用户无效或冻结”；若用户有效则返回10位随机数 说明：用户得到服务端随机数后，调用动态链接库（CDLL5.DLL）的Lock32_Function（String）方法，获得算法变量，作为验证数据。 舱单申报服务接口 接收用户申报的进