海运舱单集中申报系统.docx
《海运舱单集中申报系统.docx》由会员分享，可在线阅读，更多相关《海运舱单集中申报系统.docx（24页珍藏版）》请在冰豆网上搜索。
海运舱单集中申报系统
海运舱单集中申报系统
技术规范
WebService接口V1.01
天津电子口岸发展有限公司
2009年6月
文件制/修订履历
修订版次
修订日期
修订说明
作者
备注
1.0
2009/7/10
初次發行
1.01
2009/8/20
1、海运舱单申报舱单数据接口增加参数“报文名称”
2、修改舱单数据填制条件
陈罡
1.02
2009/11/17
增加webservices接口的参数，用于表示“客户请求要将报文发送的执法机关”
陈罡
1.03
2009/11/24
增加“确认回执是否收取成功”的方法
陈罡
1编制说明
1.1目的
为了指导天津电子口岸海运舱单集中申报系统客户端开发商的开发，特制定本规范。
本规范为天津电子口岸发展有限公司企业规范，规定天津电子口岸提供给海运舱单集中申报系统客户端的Web服务接口。
1.2解释权
本规范由天津电子口岸发展有限公司起草。
本规范的解释权属于天津电子口岸发展有限公司。
1.3参考标准和文献
下列标准所包含的条文，通过本标准的引用而构成本标准的条文。
在标准出版时，所示版本均为有效。
所有标准都会被修改，使用本标准的各方应探讨使用下列标准最新版本的可能性。
●RFC1738统一资源定位器（URL）
●RFC2068超文本传输协议HTTP/1.1
●RFC1521BASE64算法
●RFC18513DES算法
●RFC1852SHA算法
2名词术语
服务器端随机数：
由电子口岸舱单信息服务平台产生的8位随机数，供客户端与服务器端进行对碰使用。
算法变量：
在客户端与服务器端通过对8位随机数进行相关算法函数计算，得出的结果称为算法变量，供客户端与服务器端认证使用。
海关备案号：
用户企业在地方海关进行业务备案时，由地方海关定义指定的企业唯一编号。
电子口岸注册号：
用户企业在天津电子口岸进行注册时，提供给企业的唯一编号。
3接入功能及流程
3.1概述
海运舱单集中申报系统提供了如下WebService接口
●认证服务：
提供登录认证的接口，可供海运舱单集中申报系统外的其他业务系统使用
●海运舱单申报服务；
●海运舱单删除申报服务；
●海运舱单获取审批回执服务；
●参数查询：
提供海运舱单集中申报系统中各种参数字典的查询服务（当前版本不包含此项服务）
3.2网络结构
舱单集中申报系统客户端通过Internet与舱单集中申报系统的各服务连接，网络结构示意图如下：
图3-1网络结构示意图
3.3认证服务
3.3.1认证的介绍
由于业务的特殊性，海运舱单集中申报系统的用户必须使用认证Ukey发送业务数据，因此要求客户端需要安装识别Ukey的驱动程序，用户需要在天津电子口岸注册为合法用户后领取认证Ukey，方能正常使用海运舱单集中申报系统的认证服务。
3.3.2流程描述
图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
参数信息如下
名称
说明
数据类型
备注
organ_code
用户注册号
String
返回值信息
返回值类型
返回值说明
备注
String
首先判断用户注册号是否存在，若不存在则返回错误信息，“用户不存在”；若存在，则继续判断用户是否有效，若为无效或冻结，则返回错误信息，“用户无效或冻结”；若用户有效则返回10位随机数
说明：
用户得到服务端随机数后，调用动态链接库（CDLL5.DLL）的Lock32_Function（String）方法，获得算法变量，作为验证数据。
4.2舱单申报服务接口
接收用户申报的进口原始舱单数据、出口预配舱单数据和装载舱单数据。
http:
//218.69.249.74:
10000/SeaManifestDeclaration/services/DeclareService?
wsdl
4.2.1海运舱单申报舱单数据
接口方法为：
p_SeaManifestDeclare
参数信息如下
名称
说明
数据类型
备注
ct
客户端类型
String
必填
user_code
企业用户注册号
String
必填
random
10位随机数
String
必填
ciphertext
通过加密锁得到的算法变量
String
必填
messagetype
报文类型
String
必填
messagefile
报文名称（包括文件后缀）
String
必填
content
舱单申报报文内容
byte[]
必填
enforcement
客户请求要将报文发送的执法机关
String
必填
返回值信息
返回值类型
返回值说明
备注
String
如果企业注册号验证失败，则不进行其它数据的验证返回失败信息“企业验证失败”；
否则，验证其它数据的有效性，如一个或多个数据验证失败，则将所有错误数据的详细信息返回；如数据验证成功，则返回成功信息“数据验证成功”；
注：
1、舱单申报的报文内容包括：
1）原始舱单：
一次申报、二次申报、变更、删除
2）预配舱单：
一次申报、二次申报、变更、删除
3）装载舱单：
增加、删除
2、在填写存储原始舱单数据、获取预配舱单数据或获取装载舱单数据时，请参考“5.舱单数据填制条件”
3、客户请求要将报文发送的执法机关
编号：
0-海关，1-检验检疫局，2-天津港集团，3-海事局，4-边检
如果要向多个执法机关发送报文，请以逗号分隔；
例如：
0，1，3
表示要向海关、检验检疫局和海事局发送报文
4.2.2海运舱单获取审批回执
4.2.2.1接口方法为：
p_GetReceiptString
参数信息如下
名称
说明
数据类型
备注
Random
10位随机数
String
必填
ciphertext
通过加密锁得到的算法变量
String
必填
enforcement
客户要获取那个执法机关的回执
String
必填
user_code
用户注册号
String
必填
bit_journeyid
航次航班代码
String
btm_id
运输工具代码
String
返回值信息
返回值类型
返回值说明
备注
String[]
返回该企业、航次航班和运输工具的审批回执报文信息；如只指定了企业，则返回该企业所属的所有审批回执报文信息
注：
客户要获取那个执法机关的回执
编号：
0-海关，1-检验检疫局，2-天津港集团，3-海事局，4-边检
客户在获取回执的时候，一次只能获取一家执法机关的回执
4.2.3确认回执是否收取成功
4.2.3.1接口方法为：
p_UpdateState
参数信息如下
名称
说明
数据类型
备注
Random
10位随机数
String
必填
ciphertext
通过加密锁得到的算法变量
String
必填
user_code
用户注册号
String
必填
messageid
Messageid
String
必填
status
执法机关编号
String
必填
返回值信息
返回值类型
返回值说明
备注
String
回执收取完毕
方法说明：
1、用户在收到回执后调用此方法，根据用户提供的messageid修改报文状态，以确认回执收取成功；回执收取成功后，则不能再重复收取。
2、此方法支持多回执确认，如果用户想输入多个messageid的话，请将messageid组合成字符串，以逗号（,）分隔
3、此方法只允许客户输入一个执法机关的编号。
注：
客户要获取那个执法机关的回执
编号：
0-海关，1-检验检疫局，2-天津港集团，3-海事局，4-边检
5舱单数据填制条件
原始舱单数据填制条件：
数据项
主要数据填制条件
其他数据
填制条件
备注
REPRSENTATIVE_PERSON
必填
必填
舱单传输人名称
EXIT_CUSTOMS_OFFICE
必填
--
运输工具离境地海关代码
AGENT_ID
条件
--
运输工具代理企业代码
CARRIER_ID
必填
--
承运人代码
BTM_JOUREYID
必填
必填
航次航班编号
BTM_TYPECode
必填
--
运输方式代码
BTM_ID
必填
必填
运输工具代码
BTM_NAME
必填
--
运输工具名称
LL_LOADING_DATE
必填
--
货物装载运输工具时间
BTM_FIRST_ARRIVAL_LOCATIONID
*
必填
运输工具抵达关境内第一个目的港代码
BTM_ARRIVAL_DATATIME
*
必填
运输工具抵达关境内第一个目的港的日期和时间
BTM_DEPARTURE_DATATIME
必填
--
运输工具启运日期和时间
TCD_ID
必填
必填
总提运单号
ASSOCIATED_TRANSPORT_DOC_ID
条件
条件
分提运单号
GROSS_VOLUME_MEASURE
*
选填
货物体积
VALUE_AMOUNT
*
选填
托运货物价值
CURRENCY_TYPE_CODE
*
选填
金额类型代码
ULL_ID
必填
--
卸货地代码
ULL_ARRIVAL_DATE
*
选填
到达卸货地日期
GRP_ID
*
选填
收货地点代码
GRP_Name
*
选填
收货地点名称
TL_ID
条件
--
中转地点代码
TSD_ID
*
条件
中转目的地代码
LL_ID
必填
必填
装货地代码
ROUTING_COUNTRY_CODE
*
必填
途经的国家代码
GCP_ID
*
必填
货物托运的地点或者国家代码
CHANGE_REASON_CODE
选填
必填
更改原因代码
CUSTOMS_STATUS_CODE
*
选填
货物海关状态代码
transport_split_indicator
--
--
承运人货物分批到/发货标识
FREIGHT_PAYMENT_CODE
必填
--
运费支付方法代码
CP_QUANTITY
必填
--
托运货物件数
CP_TYPE_CODE
必填
--
包装种类代码
TOTAL_GROSS_MASS_MEASURE
必填
--
货物总毛重
PCD_TYPE_ID
*
选填
前一海关单证类型代码
PCD_ID
*
选填
前一海关单证号
TCD_CONDITION_CODE
*
必填
运输条款代码
HANDLING_INSTRUCTIONS_CODE
*
选填
码头作业指令代码
ICM_ID
选填
选填
中间承运人标识
COMMUNICATION_ID
选填
选填
中间承运人联系号码
COMMUNICATION_TYPE_ID
选填
选填
通讯方式类别代码
CONSIGNEE_ID
*
选填
收货人代码
CONSIGNEE_Name
*
必填
收货人名称
RP_TYPE
*
必填
收货人地址（街道,邮箱）
CITY_NAME
*
选填
城市名称
COUNTRY_SUB_ENTITY_ID
*
选填
省份代码
COUNTRY_SUB_ENTITY_NAME
*
选填
省份名称
POST_CODE_ID
*
选填
邮政编码
COUNTRY_CODE
*
选填
国家代码
COMMUNICATION_ID
*
选填
收货人联系号码
COMMUNICATION_TYPE_ID
*
选填
通讯方式类别代码
CONTACT_NAME
选填
选填
收货人具体联系人名称
COMMUNICATION_ID
选填
选填
收货人具体联系人联系号码
COMMUNICATION_TYPE_ID
选填
选填
通讯方式类别代码
CONSIGNOR_ID
*
选填
发货人代码
CONSIGNOR_NAME
必填
--
发货人名称
RP_TYPE
*
必填
发货人地址（街道,邮箱）
CITY_NAME
*
选填
城市名称
COUNTRY_SUB_ENTITY_ID
*
选填
省份代码
COUNTRY_SUB_ENTITY_NAME
*
选填
省份名称
POST_CODE_ID
*
选填
邮政编码
COUNTRY_CODE
*
选填
国家代码
COMMUNICATION_ID
*
选填
发货人联系号码
COMMUNICATION_TYPE_ID
*
选填
通讯方式类别代码
TCD_DECONSOLIDATOR
*
条件
拆箱人代码
LINE
*
选填
货物交付目的地地址（街道,邮箱）
CITY_NAME
*
选填
城市名称
COUNTRY_SUB_ENTITY_ID
*
选填
省份代码
COUNTRY_SUB_ENTITY_NAME
*
选填
省份名称
POST_CODE_ID
*
选填
邮政编码
COUNTRY_CODE
*
选填
国家代码
NOTIFYPARTY_ID
*
选填
通知人代码
NOTIFYPARTY_NAME
*
条件
通知人名称
RP_TYPE
*
条件
通知人地址（街道,邮箱）
CITY_NAME
*
选填
城市名称
COUNTRY_SUB_ENTITY_ID
*
选填
省份代码
COUNTRY_SUB_ENTITY_NAME
*
选填
省份名称
POST_CODE_ID
*
选填
邮政编码
COUNTRY_CODE
*
选填
国家代码
COMMUNICATION_ID
*
选填
通知人联系号码
COMMUNICATION_TYPE_ID
*
选填
通讯方式类别代码
UNDG_CONTACT_NAME
选填
选填
危险品联系人姓名
COMMUNICATION_ID
选填
选填
危险品联系人联系号码
COMMUNICATION_TYPE_ID
选填
条件
通讯方式类别代码
EQUIPMENT_IDENTIFICATION_ID
条件
--
集装箱（器）编号
CHARACTERISTIC_CODE
条件
--
集装箱（器）尺寸和类型
SUPPLIER_PARTY_TYPE_CODE
*
条件
集装箱（器）来源代码
FULLNESS_CODE
*
条件
重箱或者空箱标识代码
SEALID
条件
--
封志号码，类型和施加封志人
SEQUENCE_NUMERIC
必填
必填
托运货物序号
CP_TYPE_CODE
必填
--
货物包装种类
CP_QUANTITY
必填
--
货物件数
CARGO_DESCRIPTION
必填
--
货物简要描述
CONTENT
*
选填
货物描述补充信息
GROSS_MASS_MEASURE
必填
--
货物毛重
UNDG_CODE
*
条件
危险品编号
MARKS_NUMBERS
*
必填
唛头
CURRENT_CODE
*
选填
海关手续代码
TARIFF_CLASSIFICATION_CODE
*
选填
海关税则编号（6位HSCODE）
ORIGIN_COUNTRY_CODE
*
选填
原产地代码
UCR_ID
*
选填
唯一托运编号
ADDIONAL_INFOUMATION
选填
选填
备注
预配舱单数据项填制条件：
数据项
主要数据
填制条件
其他数据
填制条件
备注
REPRESENTATIVE_PERSON
必填
--
舱单传输人名称
EXIT_CUSTOMS_OFFICE
必填
--
运输工具离境地海关代码
AGENT_ID
条件
--
运输工具代理企业代码
CARRIER_ID
必填
--
承运人代码
BTM_JOUREYID
必填
必填
航次航班编号
BTM_TYPECODE
必填
--
运输方式代码
BTM_ID
必填
必填
运输工具代码
BTM_NAME
必填
--
运输工具名称
LL_LOADING_DATE
必填
选填
货物装载运输工具时间
BTM_FIRST_ARRIVAL_LOCATIONID
*
选填
运输工具抵达关境外第一个停靠港代码
BTM_ARRIVAL_DATATIME
*
选填
运输工具抵达关境外第一个停靠港的日期和时间
BTM_DEPARTURE_DATATIME
*
选填
运输工具启运日期和时间
TCD_ID
必填
必填
总提运单号
ASSOCIATE_TRANSPORT_DOC_ID
条件
条件
分提运单号
GROSS_VOLUME_MEASURE
*
选填
货物体积
VALUE_AMOUNT
*
选填
托运货物价值
CURRENCY_TYPE_CODE
*
选填
金额类型代码
ULL_ID
*
选填
卸货地代码
ULL_ARRIVAL_DATE
*
选填
到达卸货地日期
GRP_ID
*
选填
收货地点代码
GRP_Name
*
选填
收货地点名称
TL_ID
*
条件
中转启运地点代码
TSD_ID
条件
--
中转目的地代码
LL_ID
必填
选填
装货地代码
ROUTING_COUNTRY_CODE
*
选填
途经的国家代码
GCP_ID
选填
--
货物托运的地点或者国家代码
CHANGE_REASON_CODE
选填
必填
更改原因代码
CUSTOMS_STATUS_CODE
选填
选填
货物海关状态代码
transport_split_indicator
--
--
承运人货物分批到/发货标识
FREIGHT_PAYMENT_CODE
必填
--
运费支付方法代码
CP_QUANTITY
必填
选填
托运货物件数
CP_TYPE_CODE
必填
选填
包装种类代码
TOTAL_GROSS_MASS_MEASURE
必填
--
货物总毛重
PCD_TYPE_ID
*
选填
前一海关单证类型代码
PCD_ID
*
选填
前一海关单证号
TCD_CONDITION_CODE
*
选填
运输条款代码
HANDLING_INSTRUCTIONS_CODE
*
选填
码头作业指令代码
ICM_ID
选填
选填
中间承运人标识
COMMUNICATION_ID
选填
选填
中间承运人联系号码
COMMUNICATION_TYPE_ID
选填
选填
通讯方式类别代码
CONSIGNEE_ID
*
选填
收货人代码
CONSIGNEE_NAME
*
必填
收货人名称
RP_TYPE
*
必填
收货人地址（街道,邮箱）
CITY_NAME
*
选填
城市名称
COUNTRY_SUB_ENTITY_ID
*
选填
省份代码
COUNTRY_SUB_ENTITY_NAME
*
选填
省份名称
POST_CODE_ID
*
选填
邮政编码
COUNTRY_CODE
*
选填
国家代码
COMMUNICATION_ID
*
选填
收货人联系号码
COMMUNICATION_TYPE_ID
*
选填
通讯方式类别代码
CONTACT_Name
选填
选填
收货人具体联系人名称
COMMUNICATION_ID
选填
选填
收货人具体联系人联系号码
COMMUNICATION_TYPE_ID
选填
选填
通讯方式类别代码
CONSIGNOR_ID
*
选填
发货人代码
CONSIGNOR_NAME
必填
--
发货人名称
RP_TYPE
必填
--
发货人地址（街道,邮箱）
CITY_NAME
*
选填
城市名称
COUNTRY_SUB_ENTITY_ID
*
选填
省份代码
COUNTRY_SUB_ENTITY_NAME
*
选填
省份名称
POST_CODE_ID
*
选填
邮政编码
COUNTRY_CODE
*
选填
国家代码
COMMUNICATION_ID
*
选填
发货人联系号码
COMMUNICATION_TYPE_ID
*
选填
通讯方式类别代码
TCD_CONSOLIDATOR
条件
--
拼箱人代码
LINE
*
选填
货物交付目的地地址（街道,邮箱）
CITY_NAME
*
选填
城市名称
COUNTRY_SUB_ENTITY_ID
*
选填
省份代码
COUNTRY_SUB_ENTITY_NAME
*
选填
省份名称
POST_CODE_ID
*
选填
邮政编码
COUNTRY_CODE
*
选填
国家代码
NOTIFYPARTY_ID
*
选填
通知人代码
NOTIFYPARTY_NAME
*
条件
通知人名称
RP_TYPE
*
条件
通知人地址（街道,邮箱）
CITY_NAME
*
选填
城市名称
COUNTRY_SUB_ENTITY_ID
*
选填
省份代码
COUNTRY_SUB_ENTITY_NAME
*
选填
省份名称
POST_CODE_ID
*
选填
邮政编码
COUNTRY_CODE
*
选填
国家代码
COMMUNICATION_ID
*
选填
通知人联系号码
COMMUNICATION_TYPE_ID
*
选填
通讯方式类别代码
UNDG_CONTACT_NAME
选填
选填
危险品联系人姓名
COMMUNICATIO
升级会员 