广东智检口岸公共服务平台-口岸码头接口规范(FTP方式)

广东智检口岸公共服务平台口岸码头接口规范广州信天翁信息科技有限公司2015年7月

报文格式及命名报文格式采用XML作为报文格式，使用UTF-8作为报文文件的编码。文件命名企业对各自所发报文的命名约定按以下规则：报文类型（MessageType）+”_”+YYYY-MM-DDHH:MM:SS（日期时间）+XXX（三位数字流水号）.xml例如：WHARF_RZ_20140404141005001.xml报文交互说明由平台提供FTP地址、用户、密码以及上传FTP文件夹目录，码头将生成的XML文件直接上传到指定FTP文件夹，平台将回执和通知报文放在指定的FTP文件夹，码头自行读取报文类型说明数据交换报文报文类型及其说明，如下表：序号报文类型(MessageType)报文名称说明

报文规范入出闸报文报文结构图报文结构说明报文头Head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空MessageID报文编号报文唯一编号，最大50字符NMessageType报文类型固定为：WHARF_RZNSender报文发送者标识最大10字符NReceiver报文接收人标识最大10字符NSendTime发送时间格式：YYYY-MM-DDHH:MM:SSN报文体Body报文内容Record表标识,标识主表信息开始(父标签:Body),该标签可以有多个Passinfo入出闸信息(父标签:Record)入出闸信息标签标签内容格式要求可空relaid唯一标识最大32个字符Nstationbcode码头编码码头编码,平台提供Nchannelno通道号最大20字符码头自定义Npassflag进出卡口标志“I”表示进闸“O”表示退运出闸Npasstime进出卡口时间格式为：YYYY-MM-DDHH:MM:SSNnetweight地磅称重浮点数：

大于0Ytruckno拖运车辆车牌号码最大128个字符Ncarweight拖运车辆重量浮点数：

大于0YicnoIC卡号最大20个字符闸口登记关联Yinbuiltflag内装箱标识整型（0：非内装箱1：内装箱；默认为非内装箱）Y入出闸信息Pspenterinfos入出闸柜信息列表(父标签:Passinfo)Pspenterinfo入出闸柜信息(父标签:Pspenterinfos)，可循环入出闸柜信息标签标签内容格式要求可空blno提单号NVARCHAR(256)Ncontno集装箱号最大16个字符Nconsize尺寸“20”，“40”，“45”，“25”，“10”，Y（集装箱必填）contype集装箱箱型最大字符长度20柜型：B 超高柜A 普通箱C 冷藏D 罐式Ncontainerweight集装箱自重浮点数：

大于0Nremark备注Y货物信息Goodsinfos货物信息列表(父标签:Pspenterinfo)Goods货物信息(父标签:Goodsinfos)，可循环货物信息标签标签内容格式要求可空goods货物名称最大字符长度128N入仓报文报文结构图报文结构说明报文头Head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空MessageID报文编号报文唯一编号，最大50字符NMessageType报文类型固定为：WHARF_RCNSender报文发送者标识最大10字符NReceiver报文接收人标识最大10字符NSendTime发送时间格式：YYYY-MM-DDHH:MM:SSN报文体Body报文内容Record表标识,标识主表信息开始(父标签:Body),该标签可以有多个Pspenterinfo入仓信息(父标签:Record)入仓信息标签标签内容格式要求可空relaid唯一标识最大32个字符Nstationbcode码头编码码头编码,平台提供Nblno提单号NVARCHAR(256)NGoodsinfos货物信息列表(父标签:Pspenterinfo)Goods货物信息(父标签:Goodsinfos)，可循环货物信息标签标签内容格式要求可空goods货物品名最大128个字符Nkgs货物重量浮点数：

大于0单位为千克Nqty第一数量浮点数：

大于0Yremark备注Y装箱报文报文结构图报文结构说明报文头Head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空MessageID报文编号报文唯一编号，最大50字符NMessageType报文类型固定为:WHARF_ZXNSender报文发送者标识最大10字符NReceiver报文接收人标识最大10字符NSendTime发送时间格式：YYYY-MM-DDHH:MM:SSN报文体Body报文内容Record表标识,标识主表信息开始(父标签:Body),该标签可以有多个柜列表，Body的子节点Container装箱信息，(父标签:Record)装箱信息标签标签内容格式要求可空relaid唯一标识最大32个字符Nstationbcode码头编码码头编码,平台提供Ncontno集装箱号最大16个字符Y（集装箱必填）conttime装箱时间格式：YYYY-MM-DDHH:MM:SSY（集装箱必填）consize尺寸“20”，“40”，“45”，“25”，“10”，Y（集装箱必填）contype柜型B 超高柜A 普通箱C 冷藏D 罐式Y（集装箱必填）sealno封条号最大128个字符Y提单信息Blnosinfos提单信息列表(父标签:Container)Blno提单信息，(父标签:Blnosinfos)，可循环提单信息标签标签内容格式要求可空blno提单号最大256个字符Nblonstatus状态10：部分装箱完成20：全部装箱完成N货物清单信息Goodsinfos货物信息列表(父标签:Blno)Goods货物信息(父标签:Goodsinfos)，可循环货物信息标签标签内容格式要求可空goods货物名称最大字符长度128Npacktype包装方式最大字符长度20统一由平台提供对应码详见附录4.1Yqty第一数量浮点数：

大于0Nkgs毛重浮点数

大于0Nvolume体积浮点数

大于0单位：立方Nremark备注最大字符长度1000Y查验报文申报单查验报文报文结构图报文结构说明报文头Head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空MessageID报文编号报文唯一编号，最大50字符NMessageType报文类型固定为:WHARF_CYNSender报文发送者标识最大10字符NReceiver报文接收人标识最大10字符NSendTime发送时间格式：YYYY-MM-DDHH:MM:SSN报文体Body报文内容Record表标识,标识主表信息开始(父标签:Body),该标签可以有多个Pspenterinfo查验通知信息(父标签:Record)，可循环查验通知信息标签标签内容格式要求可空stationbcode码头编号VARCHAR(32)统一平台提供Ncheckopertime放行转查验时间存在放行转查验，此时间不为空Yrelaid唯一标识VARCHAR(32)关联入出闸报文或者入仓报文的relaidNcontno集装箱号VARCHAR(16)Y（整柜必填）companycode报检单位VARCHAR(128)申报单中的报检单位Ytranstype整柜/散货VARCHAR(20)10：整柜20：散货Nblno提单号NVARCHAR(256)N放行报文申报单放行报文报文结构图报文结构说明报文头Head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空MessageID报文编号报文唯一编号，最大50字符NMessageType报文类型固定为:WHARF_FXNSender报文发送者标识最大10字符NReceiver报文接收人标识最大10字符NSendTime发送时间格式：YYYY-MM-DDHH:MM:SSN报文体Body报文内容Record表标识,标识主表信息开始(父标签:Body),该标签可以有多个Enterinfo放行信息(父标签:Record)，可循环放行信息标签标签内容格式要求可空stationbcode码头编号VARCHAR(32)统一平台提供Nrelaid唯一标识VARCHAR(32)关联入出闸报文或者入仓报文的relaidNcontno集装箱号VARCHAR(16)Y（整柜必填）companycode报检单位VARCHAR(128)申报单中的报检单位Ytranstype整柜/散货VARCHAR(20)10：整柜20：散货Nblno提单号NVARCHAR(256)Nposttime放行时间格式：YYYY-MM-DDHH:MM:SS放行时间N报文接收回执报文结构图报文结构说明报文头Head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空MessageID报文编号报文唯一编号，最大50字符NMessageType报文类型固定值DOCRECNSender报文发送者标识最大10字符NReceiver报文接收人标识最大10字符NSendTime发送时间格式：YYYY-MM-DDHH:MM:SSNFunctionCode业务类型YVersion版本Y报文接收回执信息Declaration接收回执标签，不循环。报文接收回执信息标签标签内容格式要求可空OrgMessageID原始报文编号原发送报文中报文编号，最大50字符NOrgMessageType原报文类型最大20字符NOrgSenderID原报文发送者标识最大10字符NOrgReceiverID原报文接收人标识最大10字符NOrgRecTime原报文接收时间格式：YYYY-MM-DDHH:MM:SSNStatus状态状态，长度为1个字符，10：已接收20：报文错误NNotes反馈信息如解析失败，则返回错误信息。最大长度1000个字符。N附录包装方式编码包装方式名称1A1钢制不可拆装桶顶圆桶1A2钢制可拆装桶顶圆桶1B1铝制不可拆装桶顶圆桶1B2铝制可拆装桶顶圆桶1C木圆桶1D胶合板圆桶1G纤维圆桶1H塑料圆桶1H1塑料不可拆装桶顶圆桶1H2塑料可拆装桶顶圆桶2C1塞式木琵琶桶2C2非水密型木琵琶桶390其他罐3A1钢制不可拆装罐顶罐3A2钢制可拆装罐顶罐3B1铝制不可拆装罐顶罐3B2铝制可拆装罐顶罐3H1塑料制不可拆装罐顶罐3H2塑料制可拆装罐顶罐490其他箱4A钢箱4B铝箱4C11大木箱4C12中木箱4C13小木箱4C2箱壁防撤漏木箱4D胶合板箱4F再生木木箱4G纤维板箱4H塑料箱4H1膨胀的塑料箱4H2硬质的塑料箱4M纸箱4M1单瓦楞纸箱4M2双瓦楞纸箱590其他袋5991麻袋5992布袋/包5H塑料编织袋5H1塑料编织无内衬或涂层的袋5H2塑料编织防撤漏的袋5H3塑料编织防水的袋5H4塑料薄膜袋5H5无涂层或内衬的编织集装袋5H6带涂层的编织塑料集装袋5H7带内衬的编织塑料集装袋5H8带涂层和内衬的编织集装袋5H9集装袋5L1纺织品无内衬或涂层的袋5L2纺织品防撤漏的袋5L3纺织品防水的袋5M1多层的纸袋5M2多层防水纸袋5M91纸袋6HA1塑料容器在钢桶内复合包装6HA2塑料容器在钢条或钢皮箱内复合包装6HB1塑料容器在铝桶内复合包装6HB2塑料容器在铝条或铝皮箱内复合包装6HC塑料容器在木箱内复合包装6HD1塑料容器在胶合板桶内复合包装6HD2塑料容器在胶合板箱内复合包装6HG1塑料容器在纤维桶内复合包装6HG2塑料容器在纤维板箱内复合包装6HH1塑料容器在塑料桶内复合包装6HH2塑料容器在硬塑料箱内复合包装6PA1玻璃、陶瓷、粗陶器在钢桶内复合包装6PA2玻璃、陶瓷、粗陶器在钢条或钢皮箱内复合包装6PB1玻璃、陶瓷、粗陶器在铝桶内复合包装6PB2玻璃、陶瓷、粗陶器在铝条或铝皮箱内复合