海运舱单集中申报系统.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