企業與單一窗口貨物申報系統接口說明2016年04月

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

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

2.3.32出口報文結構描述文檔XSD.進口海關數據項[Customs]父節點子節點節點名稱填寫說明字段類型必填其它約束CustomsDecIHead（海關基本數據信息）[DecIPort]申報口岸代碼String(4)Y參見海關關區代碼[ContractNo]合同協議號String(32)Y[BillNo]提運單號String(32)Y[TrafName]運輸工具名稱String(26)Y[VoyageNo]航次號String(32)Y[IEPort]進口口岸代碼String(4)Y參見海關關區代碼[ManualNo]備案號String(12)N[IEDate]進口日期DateNYYYY-MM-DD[TradeCo]經營單位代碼String(10)Y[TradeName]經營單位名稱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

子節點節點名稱填寫說明字段類型必填其它約束0)[AgentName]申報單位名稱String(70)Y[CutMode]征免性質代碼String(3)Y參見海關征免性質代碼表[PaymentMark]納稅單位String(3)N001:經營單位002:收貨單位003:申報單位[TradeMode]監管方式代碼String(4)Y參見海關監管方式代碼表[License]許可證號String(20)N[TradeCountry]啟運國（地區）代碼String(3)Y參見國家代碼表[DestinationPort]裝貨港代碼String(4)Y參見港口代碼表[DestinationCode]境內目的地代碼String(5)Y參見海關境內目的地代碼表[PackNo]件數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參見幣制代碼表報關單類型代碼String(1)（0）有紙報關；（W）無紙報關；（L）有紙帶清單父節點

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