單一窗口駁船艙單通知接口說明v1.2

廣州國際貿(mào)易“單一窗口” 碼頭駁船艙單報文接口說明廣州國際貿(mào)易“單一窗口”駁船艙單接口說明2016年5月

修訂歷史日期版本描述作者2016-05-041.0初稿

目錄1. 概述 41.1. 編寫目的 41.2. 背景 41.3. 閱讀對象 41.4. 定義 42. 數(shù)據(jù)接口說明 42.1. 駁船艙單報文接口 42.1.1. 接口功能描述 42.1.2. 接口使用前提條件 42.1.3. 接口規(guī)范 4概述編寫目的本文檔主要描述監(jiān)管場所（碼頭）如對接“單一窗口”的駁船艙單功能，包含接口的使用說明、接入流程，以及相關使用的約束等，可作為接口開發(fā)人員實現(xiàn)接口功能設計的參考。背景“單一窗口”平臺為企業(yè)建立“一站式”通關服務,企業(yè)通過“單一窗口”平臺一點接入一個信息平臺、實現(xiàn)一次性遞交滿足監(jiān)管部門要求的標準化單證和電子信息，監(jiān)管部門處理狀態(tài)（結果）通過單一平臺反饋給申報人?！皢我淮翱凇笨商峁┻M出口企業(yè)、船代、監(jiān)管場所等企業(yè)直接通過接口對接的方式，實現(xiàn)企業(yè)自身的生產(chǎn)系統(tǒng)與單一窗口的直接對接。閱讀對象本文檔的閱讀對象為系統(tǒng)設計、開發(fā)人員、軟件測試人員、技術評審人員、技術管理人員等。定義數(shù)據(jù)接口：本文檔涉及的數(shù)據(jù)接口涵蓋基于文件形式的數(shù)據(jù)報文接口、數(shù)據(jù)導入接口，以及基于http協(xié)議的Web口。數(shù)據(jù)接口說明駁船艙單報文接口接口功能描述單一窗口平臺接收海關審批回執(zhí)，并把駁船艙單數(shù)據(jù)通過數(shù)據(jù)接口發(fā)送給碼頭，碼頭可憑此通知書確定下一步的計劃。接口使用前提條件需向單一窗口此接口功能，單一窗口授權并開通對應的數(shù)據(jù)通道才可使用。接口規(guī)范接口傳輸方式單一窗口駁船艙單報文接口采用XML格式的文件作為數(shù)據(jù)交換的內(nèi)容。報文使用UTF-8編碼。單一窗口為碼頭開設數(shù)據(jù)傳輸通道，并將xml報文發(fā)送至碼頭對應的位置，碼頭在相應的位置獲取該報文，并進行解釋入庫等操作。進口報文結構說明進口報文節(jié)點說明報文頭Head報文頭標簽，不循環(huán)。報文頭標簽中含有的標簽標簽標簽內(nèi)容格式要求可空MessageID報文編號報文唯一編號，最大50字符NMessageType報文類型固定為SWSHIP400NSender報文發(fā)送者標識最大10字符，固定為“GZSW”NReceiver報文接收人標識最大10字符,單一窗口分配NSendTime發(fā)送時間格式：YYYYMMDDHHMISSZZZNVersion版本號最大10字符，默認為1.0N報文體（業(yè)務節(jié)點描述）節(jié)點名稱節(jié)點含義節(jié)點定義循環(huán)次數(shù)備注Body報文體Declaration業(yè)務根節(jié)點，不循環(huán)ShipInfo船舶信息節(jié)點，不循環(huán)ShipName船名VARCHAR2(64)1必填CustomsTranCode海關運輸編號VARCHAR2(32)1必填Voyages航次VARCHAR2(32)1必填VTotalUnits每船總柜數(shù)自動生成無需填寫LdBs裝卸船標識VARCHAR2(2)1必填CustomNo關區(qū)號VARCHAR2(4)1必填YjArrivalDate預計到港時間DATE1必填BillInfo提單信息，此節(jié)點可循環(huán)（1…N）BillNo提單號VARCHAR2(36)1必填BookingNo訂艙號VARCHAR2(32)1非必填Pol裝貨港VARCHAR2(32)1必填Pod卸貨港VARCHAR2(32)1必填Fpod最終目的港VARCHAR2(32)1非必填Drawee付款人VARCHAR2(36)1必填Consignor發(fā)貨人VARCHAR2(36)1非必填Consignee收貨人VARCHAR2(36)1必填BerthFee停泊費VARCHAR2(32)1非必填LoadFee裝卸費VARCHAR2(32)1非必填BTotalUnits每單總柜數(shù)自動生成無需填寫WateGate水閘標識VARCHAR2(1)1必填FdestFDESTVARCHAR2(5)1非必填ContaInfoList集裝箱列表信息,不循環(huán)ContaInfo集裝箱信息，此節(jié)點可循環(huán)（1…N）IeFlag進出口標識VARCHAR2(32)1必填Cntr集裝箱號VARCHAR2(32)1必填Seal鉛封VARCHAR2(32)1必填ContaSize箱型VARCHAR2(32)1必填ContaGenera箱屬VARCHAR2(32)1必填FeF/E(空/重)VARCHAR2(32)1必填Weight重量（貨重+柜重）VARCHAR2(32)1必填StorageTemp冷藏溫度VARCHAR2(32)1非必填DangerrCargo危品類別VARCHAR2(32)1非必填PoolPOOL位VARCHAR2(16)1非必填UnnoUNNOVARCHAR2(32)1非必填SecondImo二程船IMO號VARCHAR2(32)1非必填SecondShipNameEn二程船船名(英)VARCHAR2(32)1非必填SecondShipName二程船船名VARCHAR2(64)1非必填SecondVoy二程船航次VARCHAR2(12)1非必填HeightSize貨物超高尺寸VARCHAR2(32)1非必填LWidthSize貨物左超寬尺寸VARCHAR2(32)1非必填RWidthSize貨物右超寬尺寸VARCHAR2(32)1非必填GoodsName貨名VARCHAR2(32)1必填DamageInfo殘損信息VARCHAR2(64)1非必填OutOrder出柜順序VARCHAR2(32)1非必填CustomType關區(qū)類型(標注全關通，一關通標識)VARCHAR2(128)1非必填Remark備注VARCHAR2(128)1非必填出口報文結構說明出口報文節(jié)點說明報文頭Head報文頭標簽，不循環(huán)。報文頭標簽中含有的標簽標簽標簽內(nèi)容格式要求可空MessageID報文編號報文唯一編號，最大50字符NMessageType報文類型固定為SWSHIP400NSender報文發(fā)送者標識最大10字符，固定為“GZEPORT”NReceiver報文接收人標識最大10字符,單一窗口分配NSendTime發(fā)送時間格式：YYYYMMDDHHMISSZZZNVersion版本號最大10字符，默認為1.0N報文體（業(yè)務節(jié)點描述）節(jié)點名稱節(jié)點含義節(jié)點定義循環(huán)次數(shù)備注Body報文體Declaration業(yè)務根節(jié)點，不循環(huán)ShipInfo船舶信息節(jié)點，不循環(huán)ShipName船名VARCHAR2(64)1必填CustomsTranCode海關運輸編號VARCHAR2(32)1必填Voyages航次VARCHAR2(32)1必填VTotalUnits每船總柜數(shù)自動生成無需填寫LdBs裝卸船標識VARCHAR2(2)1必填CustomNo關區(qū)號VARCHAR2(4)1必填YjArrivalDate預計到港時間DATE1必填BillInfo提單信息，此節(jié)點可循環(huán)（1…N）BillNo提單號VARCHAR2(36)1非必填BookingNo訂艙號VARCHAR2(32)1必填Pol裝貨港VARCHAR2(32)1必填Pod卸貨港VARCHAR2(32)1必填Fpod最終目的港VARCHAR2(32)1非必填Drawee付款人VARCHAR2(36)1必填Consignor發(fā)貨人VARCHAR2(36)1必填Consignee收貨人VARCHAR2(36)1非必填BerthFee停泊費VARCHAR2(32)1非必填LoadFee裝卸費VARCHAR2(32)1非必填BTotalUnits每單總柜數(shù)自動生成無需填寫WateGate水閘標識VARCHAR2(1)1必填FdestFDESTVARCHAR2(5)1非必填ContaInfoList集裝箱列表信息,不循環(huán)ContaInfo集裝箱信息，此節(jié)點可循環(huán)（1…N）IeFlag進出口標識VARCHAR2(32)1必填Cntr集裝箱號VARCHAR2(32)1必填Seal鉛封VARCHAR2(32)1必填ContaSize箱型VARCHAR2(32)1必填ContaGenera箱屬VARCHAR2(32)1必填FeF/E(空/重)VARCHAR2(32)1必填Weight重量（貨重+柜重）VARCHAR2(32)1必填StorageTemp冷藏溫度VARCHAR2(32)1非必填DangerrCargo危品類別VARCHAR2(32)1非必填PoolPOOL位VARCHAR2(16)1非必填UnnoUNNOVARCHAR2(32)1非必填SecondImo二程船IMO號VARCHAR2(32)1非必填SecondShipNameEn二程船船名(英)VARCHAR2(32)1非必填SecondShipName二程船船名VARCHAR2(64)1非必填SecondVoy二程船航次VARCHAR2(12)1非必填HeightSize貨物超高尺寸VARCHAR2(32)1非必填LWidthSize貨物左超寬尺寸VARCHAR2(32)1非必填RWidthSize貨物右超寬尺寸VARCHAR2(32)1非必填GoodsName貨名VARCHAR2(32)1必填DamageInfo殘損信息VARCHAR2(64)1非必填OutOrder出柜順序VARCHAR2(32)1非必填CustomType關區(qū)類型(標注全關通，一關通標識)VARCHAR2(128)1非必填Remark備注VARCHAR2(128)1非必填中轉報文結構說明中轉報文節(jié)點說明報文頭Head報文頭標簽，不循環(huán)。報文頭標簽中含有的標簽標簽標簽內(nèi)容格式要求可空MessageID報文編號報文唯一編號，最大50字符NMessageType報文類型固定為SWSHIP400NSender報文發(fā)送者標識最大10字符，固定為“GZEPORT”NReceiver報文接收人標識最大10字符,單一窗口分配NSendTime發(fā)送時間格式：YYYYMMDDHHMISSZZZNVersion版本號最大10字符，默認為1.0N報文體（業(yè)務節(jié)點描述）節(jié)點名稱節(jié)點含義節(jié)點定義循環(huán)次數(shù)備注Body報文體Declaration業(yè)務根節(jié)點，不循環(huán)ShipInfo船舶信息節(jié)點，不循環(huán)ShipName船名VARCHAR2(64)1必填CustomsTranCode海關運輸編號VARCHAR2(32)1必填Voyages航次VARCHAR2(32)1必填VTotalUnits每船總柜數(shù)自動生成無需填寫LdBs裝卸船標識VARCHAR2(2)1必填CustomNo關區(qū)號VARCHAR2(4)1必填YjArrivalDate預計到港時間DATE1必填BillInfo提單信息，此節(jié)點可循環(huán)（1…N）BillNo提單號VARCHAR2(36)1非必填BookingNo訂艙號VARCHAR2(32)1必填Pol裝貨港VARCHAR2(32)1必填Pod卸貨港VARCHAR2(32)1必填Fpod最終目的港VARCHAR2(32)1必填Drawee付款人VARCHAR2(36)1必填Consignor發(fā)貨人VARCHAR2(36)1非必填Consignee收貨人VARCHAR2(36)1非必填BerthFee停泊費VARCHAR2(32)1非必填LoadFee裝卸費VARCHAR2(32)1非必填BTotalUnits每單總柜數(shù)自動生成無需填寫WateGate水閘標識VARCHAR2(1)1必填FdestFDESTVARCHAR2(5)1必填ContaInfoList集裝箱列表信息,不循環(huán)ContaInfo集裝箱信息，此節(jié)點可循環(huán)（1…N）IeFlag進出口標識VARCHAR2(32)1必填Cntr集裝箱號VARCHAR2(32)1必填Seal鉛封VARCHAR2(32)1必填ContaSize箱型VARCHAR2(32)1必填ContaGenera箱屬VARCHAR2(32)1必填FeF/E(空/重)VARCHAR2(32)1必填Weight重量（貨重+柜重）VARCHAR2(32)1必填StorageTemp冷藏溫度VARCHAR2(32)1非必填DangerrCargo危品類別VARCHAR2(32)1非必填PoolPOOL位VARCHAR2(16)1非必填UnnoUNNOVARCHAR2(32)1非必填SecondImo二程船IMO號VARCHAR2(32)1必填SecondShipNameEn二程船船名(英)VARCHAR2(32)1必填SecondShipName二程船船名VARCHAR2(64)1必填SecondVoy二程船航次VARCHAR2(12)1必填HeightSize貨物超高尺寸VARCHAR2(32)1非必填LWidthSize貨物左超寬尺寸VARCHAR2(32)1非必填RWidthSize貨物右超寬尺寸VARCHAR2(32)1非必填GoodsName貨名VARCHAR2(32)1必填DamageInfo殘損信息VARCHAR2(64)1非必填OutOrder出柜順序VARCHAR2(32)1非必填CustomType關區(qū)類型(標注全關通，一關通標識)VARCHAR2(128)1非必填Remark備注VARCHAR2(128)1非必填報文示例<?xmlversion="1.0"encoding="UTF-8"?><Message><Head><MessageID>bf16ad9c-6652-4a5f-836e-da80c8b7db5c</MessageID><MessageType>SWSHIP400</MessageType><Sender>GZPORT</Sender><Receiver>5201001</Receiver><SendTime>20160617114558298</SendTime><Version>1.0</Version></Head><Body><Declaration><ShipInfo><ShipName>振東139</ShipName><CustomsTranCode>5200500419</CustomsTranCode><Voyages>160329A</Voyages><VTotalUnits>1</VTotalUnits><LdBs>D</LdBs><CustomNo>5166</CustomNo><YjArrivalDate>2016-05-1720:10:52.0</YjArrivalDate></ShipInfo><BillInfoList><BillInfo><BillNo>96783113</BillNo><BookingNo>CNPRD031667</BookingNo><Pol>test1</Pol><Pod>CNNSA</Pod><Fpod>FRFOS</Fpod><Drawee>test2</Drawee><Consignor>佛山市順德區(qū)合捷電器實業(yè)有限公司</Consignor><Consignee>test1</Consignee><BerthFee>13.243</BerthFee><LoadFee>121.23</LoadFee><Fdest></Fdest><BTotalUnits>1</BTotalUnits><WateGate>N</WateGate><ContaInfoList><ContaInfo><IeFlag>I</IeFlag><Cntr>HLBU1752970</Cntr><Seal>HLB2357662</Seal><ContaSize>40'HQ</ContaSize><ContaGenera>HLC</ContaGenera>