海运舱单集中申报系统

海运舱单集中申报系统
技术规范WebService接口V1.01
天津电子口岸发展有限公司
2009年6月
文件制/修订履历
目录
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)
1编制说明
1.1 目的
为了指导天津电子口岸海运舱单集中申报系统客户端开发商的开发，特制定本规范。

本规范为天津电子口岸发展有限公司企业规范，规定天津电子口岸提供给海运舱单集中申报系统客户端的Web服务接口。

1.2 解释权
本规范由天津电子口岸发展有限公司起草。

本规范的解释权属于天津电子口岸发展有限公司。

1.3 参考标准和文献
下列标准所包含的条文，通过本标准的引用而构成本标准的条文。

在标准出版时，所示版本均为有效。

所有标准都会被修改，使用本标准的各方应探讨使用下列标准最新版本的可能性。

●RFC1738 统一资源定位器（URL）
●RFC 2068超文本传输协议HTTP/1.1
●RFC 1521 BASE64算法
●RFC 1851 3DES算法
●RFC 1852 SHA算法
2名词术语
服务器端随机数：由电子口岸舱单信息服务平台产生的8位随机数，供客户端与服务器端进行对碰使用。

算法变量：在客户端与服务器端通过对8位随机数进行相关算法函数计算，得出的结果称为算法变量，供客户端与服务器端认证使用。

海关备案号：用户企业在地方海关进行业务备案时，由地方海关定义指定的企业唯一编号。

电子口岸注册号：用户企业在天津电子口岸进行注册时，提供给企业的唯一编号。

3接入功能及流程
3.1 概述
海运舱单集中申报系统提供了如下WebService接口
●认证服务：提供登录认证的接口，可供海运舱单集中申报系统外的其他业务
系统使用
●海运舱单申报服务；
●海运舱单删除申报服务；
●海运舱单获取审批回执服务；
●参数查询：提供海运舱单集中申报系统中各种参数字典的查询服务（当前版
本不包含此项服务）
3.2 网络结构
舱单集中申报系统客户端通过Internet与舱单集中申报系统的各服务连接，网络结构示意图如下：
参数服务
图3-1 网络结构示意图
3.3 认证服务 3.3.1 认证的介绍
由于业务的特殊性，海运舱单集中申报系统的用户必须使用认证Ukey 发送业务数据，因此要求客户端需要安装识别Ukey 的驱动程序，用户需要在天津电子口岸注册为合法用户后领取认证Ukey ，方能正常使用海运舱单集中申报系统的认证服务。

3.3.2 流程描述
中心交换平台认证模块
用户终端
3.得到变量
5.根据随机数进行校验并返回校验信息
图3－2登录流程示意图
1) 客户端向服务器端请求获取服务器端随机数。

2) 服务器端返回给客户端随机数。

3) 客户端将服务器端随机数传递给本地加密锁的算法，以便生成算法变量。

4) 客户端向服务器端提交服务器端随机数和算法变量。

5) 服务器端将根据随机数客户端算法变量进行校验，并返回校验信息。

6) 服务器端将校验信息返回给用户。

7) 客户端进行业务申报时，将服务器端随机数同业务数据一同提交给服务器端。

8) 登录完毕。

4接口
4.1 认证服务接口
在提交和获取业务数据前，都要进行取得服务端随机数，并依赖于此进行业务操作。

http:// 218.69.249.74:10000/SeaManifestDeclaration/services/DeclareService?wsdl
4.1.1获取服务器端随机数
接口方法为：GetServerRandom
参数信息如下
返回值信息
说明：用户得到服务端随机数后，调用动态链接库（CDLL5.DLL）的Lock32_Function （String）方法，获得算法变量，作为验证数据。

4.2 舱单申报服务接口
接收用户申报的进口原始舱单数据、出口预配舱单数据和装载舱单数据。

http:// 218.69.249.74:10000/SeaManifestDeclaration/services/DeclareService?wsdl
4.2.1海运舱单申报舱单数据
接口方法为：p_SeaManifestDeclare
参数信息如下
返回值信息
注：
1、舱单申报的报文内容包括：
1）原始舱单：一次申报、二次申报、变更、删除
2）预配舱单：一次申报、二次申报、变更、删除
3）装载舱单：增加、删除
2、在填写存储原始舱单数据、获取预配舱单数据或获取装载舱单数据时，请参考“5.舱单数据填制条件”
3、客户请求要将报文发送的执法机关
编号：0-海关，1-检验检疫局，2-天津港集团，3-海事局，4-边检如果要向多个执法机关发送报文，请以逗号分隔；
例如：0，1，3
表示要向海关、检验检疫局和海事局发送报文
4.2.2海运舱单获取审批回执
4.2.2.1接口方法为：p_GetReceiptString
参数信息如下
返回值信息
注：客户要获取那个执法机关的回执
编号：0-海关，1-检验检疫局，2-天津港集团，3-海事局，4-边检客户在获取回执的时候，一次只能获取一家执法机关的回执
4.2.3确认回执是否收取成功
4.2.3.1接口方法为：p_UpdateState
参数信息如下
返回值信息
方法说明：
1、用户在收到回执后调用此方法，根据用户提供的messageid修改报文状态，以确认回执收取成功；回执收取成功后，则不能再重复收取。

2、此方法支持多回执确认，如果用户想输入多个messageid的话，请将message id组合成字符串，以逗号(,)分隔
3、此方法只允许客户输入一个执法机关的编号。

注：客户要获取那个执法机关的回执
编号：0-海关，1-检验检疫局，2-天津港集团，3-海事局，4-边检
5 舱单数据填制条件原始舱单数据填制条件：
预配舱单数据项填制条件：
装载舱单数据项包括：
注：
１、“必填”：为必须填报；
２、“选填”：为可以填报；
３、“条件”：为根据是否符合要求填报；
４、“－－”：为可以不填报；
５、“*”：为可以根据对应的其他数据相关栏目的填报要求，在主要数据项填报时一并提前填报。