企業(yè)與單一窗口貨物申報系統(tǒng)接口說明

企業(yè)與單一窗口貨物申報系統(tǒng)接口說明2016年04月

修訂歷史日期版本描述作者2015-11-021.1初稿謝安2016-04-051.2依據(jù)報關(guān)單調(diào)整內(nèi)容修訂徐飛躍目錄TOC\o"1-5"\h\z文檔說明 -4-文檔描述 -4-\o"CurrentDocument"閱讀對象 -4-\o"CurrentDocument"報文傳輸說明 -4-\o"CurrentDocument"交換說明 -4-數(shù)據(jù)接口定義 -5-訪問地址及參數(shù) -5-\o"CurrentDocument"報文編碼 -5-\o"CurrentDocument"報文節(jié)點說明 -6-\o"CurrentDocument"報文節(jié)點概要 -6-\o"CurrentDocument"消息頭定義 -6-\o"CurrentDocument"消息體定義 -7-返回報文定義 -26 -上傳結(jié)果示例 -26-例文 -27-進口報關(guān)例文 -27-進口報檢例文 -27-進口關(guān)檢聯(lián)合例文 -27-出口報關(guān)例文 -27-出口報檢例文 -27-出口關(guān)檢聯(lián)合例文 -27-附件 -27-調(diào)用實例 -28-Java語言調(diào)用 -28-文檔說明文檔描述為減少各企業(yè)在多套系統(tǒng)中重復填寫進出口貨物數(shù)據(jù)，實現(xiàn)企業(yè)應(yīng)用系統(tǒng)將進出口貨物數(shù)據(jù)直接上傳到“廣州國際貿(mào)易單一窗口貨物申報系統(tǒng)”（以下簡稱貨物申報系統(tǒng)），對應(yīng)“貨物申報系統(tǒng)”中“暫存”功能，制定相應(yīng)的數(shù)據(jù)交換平臺和數(shù)據(jù)格式。閱讀對象數(shù)據(jù)交換平臺接口開發(fā)人員、維護人員。報文傳輸說明使用HTTP方式傳輸數(shù)據(jù)，應(yīng)用RestFul方式交換數(shù)據(jù)，業(yè)務(wù)數(shù)據(jù)和處理結(jié)果采用 XML格式進行封裝，用戶名、密碼等信息單獨傳輸。交換說明1、 企業(yè)必須先在單一窗口中進行統(tǒng)一認證，然后通過接口方式上傳相應(yīng)的報關(guān)、報檢或關(guān)檢聯(lián)合數(shù)據(jù)。2、 對于同一記錄，每次視為新增，即首次提交數(shù)據(jù)，如需刪除多余上傳數(shù)據(jù)，需在“貨物申報系統(tǒng)”中執(zhí)行“刪除”操作。3、所有項目內(nèi)備注為“必填”指的是要求必填該項，但沒有填入也可以上傳（注：申報口岸、經(jīng)營單位、申報單位必須填寫，如為空則不接收上傳數(shù)據(jù) ），當前主要是便于企業(yè)上載數(shù)據(jù)，企業(yè)實際盡可能按實際業(yè)務(wù)要求填寫對應(yīng)的數(shù)據(jù)，后續(xù)根據(jù)業(yè)務(wù)需要，對“必填”項執(zhí)行相應(yīng)的校驗。4、“暫存”指企業(yè)系統(tǒng)數(shù)據(jù)按指定格式上傳到貨物申報系統(tǒng)， “申報”指在企業(yè)系統(tǒng)中實現(xiàn)上載到QP系統(tǒng)或CIQ2000系統(tǒng)并申報（暫未實現(xiàn)），本期主要是實現(xiàn)“暫存”5、數(shù)據(jù)上傳到“貨物申報系統(tǒng)”中，原有的“ 上載”、“報關(guān)申報”、“報檢申報”等操作仍在“貨物申報系統(tǒng)”中。數(shù)據(jù)接口定義訪問地址及參數(shù)地址：http://ip:port/CargoDeclaration/restful/operatorCompany/import/指定參數(shù)：userName單點登錄賬號；passWord單點登錄密碼；ioFlag進出口標示0/進口1/出口；report報文內(nèi)容，即具體的上傳數(shù)據(jù)。具體訪問實例請參見“4調(diào)用實例”Report由消息頭(Head)和消息體(Body)兩部分組成，報文具體定義如下：報文編碼報文編碼統(tǒng)一采用UTF-8格式。23報文節(jié)點說明231.報文節(jié)點概要NesAaceTypeFujictionCodeReceiverSeujTiniiegessagef] (23報文節(jié)點說明231.報文節(jié)點概要NesAaceTypeFujictionCodeReceiverSeujTiniiegessagef] (...VersionBodyr-Castonscig由GotfdsListffl一:ContainerListpH圖2-1消息頭定義消息頭［Head］只涉及基礎(chǔ)信息說明，不涉及具體業(yè)務(wù)內(nèi)容，消息頭 （Head）定義如下表:節(jié)點節(jié)點名稱描述[Messageld]報文唯編號組成規(guī)則：[MessageType]」Sender][SendTime]+[4位流水號］

[MessageType]報文類型當前固定為“SWCARGO001[FunctionCode]報文類型定義暫存或者申報，1：暫存；2:申報。（相關(guān)說明見1.4父換說明）[Sender]發(fā)送萬代碼彳企業(yè)在電子口岸開戶的公司編碼[Receiver]接收方代碼電子口岸代碼，固定為“GZS”[SendTime]發(fā)送時間格式y(tǒng)yyyMMddhhmmss時區(qū)為北京（東八區(qū)），如:201506101736301[Version]報文版本號報文格式版本號，默認是1.0”表格2-1233.消息體定義進出口業(yè)務(wù)信息［Body］均由以下主要節(jié)點組成，如下:節(jié)點節(jié)點名稱描述校驗規(guī)則[Customs]海關(guān)數(shù)據(jù)項詳細的海關(guān)數(shù)據(jù)描述，不含商品信息出現(xiàn)0次，至多1次[CIQ]國檢數(shù)據(jù)項詳細的國檢數(shù)據(jù)描述，不含商品信息出現(xiàn)0次，至多1次[GoodsList]商品貨物信息詳細的商品貨物信息數(shù)據(jù)描述。此節(jié)點下面分為海關(guān)商品貨物信息［Customs］和國檢商品貨物信息［CIQ］，［Customs］和［CIQ］既可以單獨出現(xiàn)，也可以同時出現(xiàn)，分別表示報關(guān)、報檢或者聯(lián)合關(guān)檢僅出現(xiàn)1次[ContainerList]集裝箱信息詳細的集裝箱數(shù)據(jù)描述出現(xiàn)0次，至多N次表格2-2實際上傳數(shù)據(jù)時，根據(jù)業(yè)務(wù)需要，對上述節(jié)點進行組合， 實現(xiàn)單獨的報關(guān)、報檢或者聯(lián)合關(guān)檢。如I單獨報關(guān)則需［Customs］、［GoodsList］，［ContainerList］（可選擇），單獨報檢則需［CIQ］、［GoodsList］， ［ContainerList］ （可選擇），聯(lián)合關(guān)檢則需［Customs］、［CIQ］、[GoodsList[GoodsList]，[ContainerList].進口報文結(jié)構(gòu)描述文檔XSDSiriglcWinrlrwGnodsluWithoulSameFie1

2.3.32出口報文結(jié)構(gòu)描述文檔XSD.進口海關(guān)數(shù)據(jù)項[Customs]父節(jié)點子節(jié)點節(jié)點名稱填寫說明字段類型必填其它約束CustomsDecIHead（海關(guān)基本數(shù)據(jù)信息）[DecIPort]申報口岸代碼String(4)Y參見海關(guān)關(guān)區(qū)代碼[ContractNo]合同協(xié)議號String(32)Y[BillNo]提運單號String(32)Y[TrafName]運輸工具名稱String(26)Y[VoyageNo]航次號String(32)Y[IEPort]進口口岸代碼String(4)Y參見海關(guān)關(guān)區(qū)代碼[ManualNo]備案號String(12)N[IEDate]進口日期DateNYYYY-MM-DD[TradeCo]經(jīng)營單位代碼String(10)Y[TradeName]經(jīng)營單位名稱String(70)Y[TrafMode]運輸工具代碼String(2)Y20船舶29海運集裝箱31火車32汽車39陸運集裝箱50飛機59空運集裝箱99其他[OwnerCode]收貨單位編碼String(10)Y[OwnerName]收貨單位名稱String(70)Y[AgentCode]申報單位編碼String(1Y

子節(jié)點節(jié)點名稱填寫說明字段類型必填其它約束0)[AgentName]申報單位名稱String(70)Y[CutMode]征免性質(zhì)代碼String(3)Y參見海關(guān)征免性質(zhì)代碼表[PaymentMark]納稅單位String(3)N001:經(jīng)營單位002:收貨單位003:申報單位[TradeMode]監(jiān)管方式代碼String(4)Y參見海關(guān)監(jiān)管方式代碼表[License]許可證號String(20)N[TradeCountry]啟運國（地區(qū)）代碼String(3)Y參見國家代碼表[DestinationPort]裝貨港代碼String(4)Y參見港口代碼表[DestinationCode]境內(nèi)目的地代碼String(5)Y參見海關(guān)境內(nèi)目的地代碼表[PackNo]件數(shù)decimalY[WrapType]包裝種類代碼String(1)Y參見包裝種類代碼表[GrossWt]毛重decimalY[NetWt]凈重decimalY[FeeMark]運費標記String(1)N（1:率2:單價3總價）[FeeRate]運費/率decimalN[FeeCurr]運費幣制代碼String(3)N參見幣制代碼表[InsurMark]保費標記String(1)N（1:率3:總價）[InsurRate]保費/率 ：decimalN[InsurCurr]保費幣制代碼String(3)N參見幣制代碼表[OtherMark]雜費標記String(1)N（1:率3:總價）[OtherRate]雜費/率decimalN[OtherCurr]雜費幣制代碼String(3)N參見幣制代碼表報關(guān)單類型代碼String(1)（0）有紙報關(guān)；（W）無紙報關(guān)；（L）有紙帶清單父節(jié)點

子節(jié)點節(jié)點名稱填寫說明字段類型必填其它約束[EntryType]Y報關(guān)；(D)無紙帶清單報關(guān)；(M)無紙化通關(guān)[TransMode]成交方式代碼String(1)YCIFC&FFOBC&I市場價墊倉[ApprNo]批準文號String(30)N[NoteS]報關(guān)備注String(255)N[Relativeld]關(guān)聯(lián)報關(guān)單號