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

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

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

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

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

子節(jié)點(diǎn)節(jié)點(diǎn)名稱填寫說明字段類型必填其它約束0)[AgentName]申報(bào)單位名稱String(70)Y[CutMode]征免性質(zhì)代碼String(3)Y參見海關(guān)征免性質(zhì)代碼表[PaymentMark]納稅單位String(3)N001:經(jīng)營(yíng)單位002:收貨單位003:申報(bào)單位[TradeMode]監(jiān)管方式代碼String(4)Y參見海關(guān)監(jiān)管方式代碼表[License]許可證號(hào)String(20)N[TradeCountry]啟運(yùn)國(guó)（地區(qū)）代碼String(3)Y參見國(guó)家代碼表[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]運(yùn)費(fèi)標(biāo)記String(1)N（1:率2:單價(jià)3總價(jià)）[FeeRate]運(yùn)費(fèi)/率decimalN[FeeCurr]運(yùn)費(fèi)幣制代碼String(3)N參見幣制代碼表[InsurMark]保費(fèi)標(biāo)記String(1)N（1:率3:總價(jià)）[InsurRate]保費(fèi)/率 ：decimalN[InsurCurr]保費(fèi)幣制代碼String(3)N參見幣制代碼表[OtherMark]雜費(fèi)標(biāo)記String(1)N（1:率3:總價(jià)）[OtherRate]雜費(fèi)/率decimalN[OtherCurr]雜費(fèi)幣制代碼String(3)N參見幣制代碼表報(bào)關(guān)單類型代碼String(1)（0）有紙報(bào)關(guān)；（W）無(wú)紙報(bào)關(guān)；（L）有紙帶清單父節(jié)點(diǎn)

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