DB3502T 117.3-2023國際貿(mào)易“單一窗口”數(shù)據(jù)服務(wù) 第3部分：報(bào)關(guān)服務(wù)接口

3502DataservicesforinternationaltraPart3:Interfaceofcustomsclearanceservices 請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。本文件由中國(福建)自由貿(mào)易試驗(yàn)區(qū)廈門片區(qū)管理委員國際貿(mào)易"單一窗口"數(shù)據(jù)服務(wù)第3部分：報(bào)關(guān)服務(wù)接口DB3502/T117.1國際貿(mào)易“單一窗口”數(shù)據(jù)服務(wù)第1部DB3502/T117.2國際貿(mào)易“單一窗口”數(shù)據(jù)服務(wù)第2部分4縮略語AES：高級(jí)加密標(biāo)準(zhǔn)（AdvancedEncryptionStandard)API：應(yīng)用程序編程接口（ApplicationProgrammingInterface）CA：證書認(rèn)證機(jī)構(gòu)(CertificateAuthoHTTP：超文本傳輸協(xié)議（HypertextTransferProtocHTTPS：超文本傳輸安全協(xié)議（HypertextTransferProtocoloverSecJSON：JavaScript對象標(biāo)記(JavaScriptObjectNotatJWT：一種用于身份驗(yàn)證和授權(quán)的開放標(biāo)準(zhǔn)（JSONWeb 傳輸協(xié)議應(yīng)使用HTTP1.0/1.1標(biāo)準(zhǔn)或者HTTPS標(biāo)準(zhǔn)兩種方式。采用HTTPS協(xié)議時(shí)，服務(wù)方應(yīng)提供接口務(wù)接口以數(shù)據(jù)服務(wù)開放平臺(tái)作為數(shù)據(jù)接收方對應(yīng)的接口，下行服務(wù)接口以數(shù)據(jù)服務(wù)開放平臺(tái)作為數(shù)據(jù)請求頭參數(shù)數(shù)據(jù)結(jié)構(gòu)見表1,請求參數(shù)數(shù)據(jù)結(jié)構(gòu)見表2,示例見附錄A.1。是內(nèi)容類型為JSON,編碼類型為UTF-8application/json;char是是是是數(shù)據(jù)服務(wù)調(diào)用者類型是數(shù)據(jù)服務(wù)調(diào)用時(shí)間否數(shù)據(jù)服務(wù)調(diào)用者身份標(biāo)識(shí)、服務(wù)標(biāo)識(shí)、否要加密時(shí)填寫否否IC卡卡號(hào)，需要業(yè)務(wù)簽名的接口必須填否是是實(shí)際業(yè)務(wù)方單一窗口登錄賬號(hào)是請求參數(shù)json字符串響應(yīng)數(shù)據(jù)結(jié)構(gòu)見表3,示例見附錄A.2。是是返回時(shí)間表3響應(yīng)數(shù)據(jù)結(jié)構(gòu)(續(xù))是是返回消息否數(shù)據(jù)服務(wù)調(diào)用者身份標(biāo)識(shí)、服務(wù)標(biāo)識(shí)、否對稱加密算法，支持：AES256、SM4,需要加密時(shí)填寫否擴(kuò)展字段(“FieldExtend”)內(nèi)容通過JSON文本進(jìn)行定義，基礎(chǔ)數(shù)據(jù)結(jié)構(gòu)擴(kuò)展字段定義見表4,示說明是是否是否否8企業(yè)資質(zhì)報(bào)關(guān)數(shù)據(jù)查詢查詢查詢通關(guān)參數(shù)通關(guān)參數(shù)查詢檢驗(yàn)檢疫編碼查詢時(shí)間公告第一二計(jì)量單位查詢報(bào)關(guān)數(shù)據(jù)查詢進(jìn)出口報(bào)關(guān)報(bào)關(guān)單狀態(tài)查詢進(jìn)口箱碼頭放行查詢檢驗(yàn)箱移箱/歸位查詢進(jìn)出口稅率查詢放行查詢艙單通關(guān)狀態(tài)查詢進(jìn)出口商品查詢8貨主報(bào)關(guān)查詢8.2通用接口 Header:Content-Type:application/ison;ch1A..255是 2A..256是 1是—2是 3A.255是 4A..255是5N..255是 求參數(shù)說明見表7，返回參數(shù)說明見表8，示例見附錄A.——Header：Content-Type:application/json;charset=UTF-81AN..32是—2AN..50是—3AN..32是—4AN..50是—5否—1AN..32是 2AN..50是 3AN..32是—4是—5AN..50是—6否—企業(yè)在ERP或企業(yè)第三方應(yīng)用調(diào)用需要的服務(wù)接口時(shí)需要發(fā)送服務(wù)申請到開放平臺(tái)。請求方式為請——Header：Content-Type:application/json;charset=UTF-81AN..36是—2N14是3是1AN..10是 2A..60是 3AN..120是—4限AN..120否—5否 用期限、次數(shù)、范圍等，請求方式為POST，請求參數(shù)說明見表11，返回結(jié)果說明見表12，示例見附錄A.4.1.4，其中：——Header：Content-Type:application/json;charset=UTF-81AN..36是 2N14是3AN32是1AN...120是—2A..60是 3AN..120否 4AN..120否 5AN..120是 6AN..120是 7否 返回結(jié)果說明見表14，示例見附錄A.4.1——Header：Content-Type:application/json;charset=UTF-81AN..36是 2N14是3AN32是1AN...120是 2A..60是 3限AN..120否 4AN..120否 5AN..120是 6否 7AN...120是———Header：Content-Type:application/json;charset=UTF-81A..255是2A..255是 3否 1A..255是—2A..255是—3A..255是 4A..255否 5A..500否 6A..500否 7A..500否 8A..500否 9否—原因。請求方式為POST，詳細(xì)請求參數(shù)見表17，返回結(jié)果說明見表18，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-81A10是—2A..512否—3A..255是—4否—1A10否—2A..512否—3AN..20是—4A..50是—5A..50否—6否—回結(jié)果說明見表20，示例見附錄A.，——Header：Content-Type:application/json;charset=UTF-81A..32否—2否 3A..32否 4A..32否 5N18是 6A..32否 7A..255是 8否—1碼A..10是—2AgentCode碼A..18是 3AgentName稱A..70是 4AgentSccA..18否 5AN..14是—6A..32否 7否—8是—9A..50否—A..32否ManualNoA..12否—志是報(bào)關(guān)單單據(jù)類型:A..70是 是否—否———Header：Content-Type:application/json;charset=UTF-81N10是 2A..10否 3A..255否—4A..255是—5否—1A..10是 2A..255否 3N..12,2是 4N..12,2是 5N..12,2否—6N..12,2否—7否———Header：Content-Type:application/json;charset=UTF-81AN10是—2AN..512否—3A..20否 4A..255是 5否 1A10是—2A..512是—3A..20是—4是—5稱A..50是—6是—7稱A..50是—8A..255是—9否—請求參數(shù)說明見表25，返回結(jié)果說明見表26，示例見附錄A.，其——Header：Content-Type:application/json;charset=UTF-81AN..512是 2A10是 3A..20否 4A..255是 5否 1A10是—2A..512是—3A..20是—4是—5稱A..50是—6是—7稱A..50是—8是 9否—數(shù)說明見表27，返回結(jié)果說明見表28，示例見附錄A.4.2.2——Header：Content-Type:application/json;charset=UTF-81N18是—2A..18是 3AgentCodeA..18否 4A..256是5否—1是 2A..50是 3A..512是 4否 ——Header：Content-Type:application/json;charset=UTF-81N18否—2A..18是 3A..18否 4A..256是5碼A..10否—6是—7是—8A..32否—9A..255是—否 1A..18否 2碼A..10是 3A..18是—4AgentCode碼A..10是—5AgentName稱A..70是 6AgentSccA..18否—7售單位（出口）A..18是 8售單位（出口）A..70是 9售單位（出口）A..18是—否 A..1是 A..32否—否 A..6是—是 A..50否 A..32否A..3是 A..3是 A..6是—A..32否 是 A..3否—ManualNoA..12否—A..20否—WrapTypeA..2是—AN..9是—N..19,5是 NetWtN..19,5是 是 N18否 A..12否 A..32否 A..255否—A..3否—否N..16,4否—A..3否 否N..16,4否A..3否否N..16,4否志是AN..2否 ApprNoA..32否 A..18否A..32否NoteSA..255否 A..70是 是是A..40是 A..10是 A..13否 A..64是MarkNoA..400否 A..8是—A..8是 A..100是 A..50否 關(guān)A..10否 A..10否A..10否 否—否 A..2否 A..10否—否A..10是—關(guān)A..10是 A..400否—A..500否 A..255否 碼A..50否—A..400是—A..500否 A..10否 A..10否—諾否A..10否 否 1否 2A..10是—3AN..19否4N..19,5是5N..19,5是6是—7A..30否 8AN..8否 9子N..11,3否—A..3是 N..19,5是 A..3是 A..255是A..255是AN..19是N..19,5是 A..3是A..3否—N..19,5是 A..3是 A..2否 WorkUsdN..19,4否A..3是A..20否 A..100否 A..50否A..1否 A..20否A..20否 A..20否—A..400否—A..20否—A..80否—A..1否—A..24否 稱A..100否 NoDangFlag否—A..8否 格A..2000否—A..2000否—A..2000否—否A..2000否—A..5是A..50否MnufctrRegnoA..20否A..150否A..3否—否 1A..32是—2A..32是 3A..255是4否 5N..19,5否 6否 1A..18否—2AN..10是—3AcmpFormCode是 4AcmpFormNoA..32是 5否 1A..18否—2AttSeqNo號(hào)AN..10是—3AttTypeCode碼A..8是4A..2是5否—6AttEdocNoA..17是7A..255否—8稱A..500否—9A..8是DECEDOC：報(bào)關(guān)單；DECMOD：修A..2是A..50否1A..18否—2WrapTypeA..2是—3N..19,5是—4否—1A..18否 2AN..10是 3AN..10是 4是 5A..3是—6A..64是 7AN..10是 8AN..19是—9否—1A..18否 2AN..10是 3AN..10是 4A..20是 5A..5是 6A..50否 7A..2否 8N..19,5否 9A..3否 否 1A..18否 2AN..10是—3AN..10是—4AN..10是—5A..20是 6A..5是—7A..100否—8否9A..100否 MotorNo號(hào)A..100否—A..20否—A..20否 N..19,5否 A..500否 A..500否 ModelEnA..500否 A..20否 A..30否 否 1A..18否 2號(hào)AN..10是—3A..20是—4碼A..5否—5稱A..200否 6A..10是7否 1A..18否—2AN..10是—3A..20否 4話A..20否—5否—1A..18否 2MarkLobSeqNoAN..10是 3AttachTypeA..2否 4AttachNameA..80否 5小A..12是 6AttachmentA..100000是7否—1A..18否 2期否3A..36否4A..18是5否 1AN..10是 2AgreementIdA..3否—3Antidumping否—4Antisubsidy否—5N..21,7否—6N..21,7否 7N..21,7否 8N..21,7否 9N..21,7否 N..21,7否 N..21,7否 N..21,7否—N..21,7否—否—1AN..10是 2號(hào)AN..10是 3是 4N..17,2是 5否 1A..18否—2A..18否—3A..18否—4是5A..16否—6鎖否7A..2否其中“1P”的轉(zhuǎn)關(guān)類型只在出口提前轉(zhuǎn)關(guān)單時(shí)可選擇，其余轉(zhuǎn)關(guān)類型可以在進(jìn)口或出口提前8A..2否9是 號(hào)A..13是 稱A..100否—A..32否—A..100否 A..9否 碼A..10否 稱A..255否—A..18否 AN..6否 AN..6否 AN..6否—否—NoteA..800否—否—1A..18否 2AN..10是 3否 4A..32否 5A..255否 6A..32否 7A..32否 8AN..6否 9否—否—1A..18否 2AN..10是 3AN..10是 4A..100否 5否 6A..128否—7AN..6否—8稱A..100否—9量N..14,4否 A..4否 否 1A..18否—2AN..10是—3AN..10是 4AN..10是 5A..32否 6AN..9否 7N..14,4否 8否 企業(yè)通過服務(wù)接口獲得出口報(bào)關(guān)單所關(guān)聯(lián)出口提運(yùn)單號(hào)的碼頭放行信息。企業(yè)輸入報(bào)關(guān)單號(hào)或出——Header：Content-Type:application/json;charset=UTF-81N18否 2A..32是 3A..255是 1是—2是—3間是—4是—5是—6是—7是 8是 9否 企業(yè)通過服務(wù)接口獲得進(jìn)口報(bào)關(guān)單所關(guān)聯(lián)出口提運(yùn)單號(hào)的碼頭放行信息。企業(yè)輸入報(bào)關(guān)單號(hào)或進(jìn)——Header：Content-Type:application/json;charset=UTF-81N18否 2A..32否—3A..255是—4否—1是 2是 3是 4是 5是 6是 7是 8是—9否———Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/feedback/BoxCheckController1N18否—2A..32否 3A..11是 4A..255是 1是—2A..10是—3否———Header：Content-Type:application/json;charset=UTF-81A..30是 2A..32是 3A..255是 1是—2是—3是—4是—5是 6否 見表58，示例見附錄A.——Header：Content-Type:application/json;charset=UTF-81AgentNameA..70是—2AgentCodeA..18是—3碼A..18是—4是5A..32是—6A..32是—7A..255是 8否 1碼A..18是 2NoticeDate是 3是）：）：4NoteA..800是—5A..4是—6AgentNameA..70是—7A..32是—8A..8是 9A..32是 是 AN..9是 A..32是 是 A..32是 是 否 企業(yè)查詢運(yùn)抵報(bào)告狀態(tài)信息接口用于企業(yè)ERP系統(tǒng)對接“單一窗口”平臺(tái)，實(shí)現(xiàn)企業(yè)查詢運(yùn)抵報(bào)告狀態(tài)信息查詢服務(wù)。請求方式為POST，請求參數(shù)說明見表59，返回結(jié)果說明見表60-61，示例見附錄——Header：Content-Type:application/json;charset=UTF-81是—2AN..32是 3A..32否 4A..35否 5A..255是—6否 1A..17是 2A..35否3A..35是 4A..35否 5A..64是 6A..5是7述A..512是 8否—1A..17是 表61艙單運(yùn)抵業(yè)務(wù)報(bào)文體（集裝箱續(xù)）2A..35否3A..17是—4A..64是 5A..5是6述A..512是—7否 回原因。請求方式為POST，請求參數(shù)說明見表62，返回結(jié)果說明見表63，示例見附錄A.4.2.4，其——Header：Content-Type:application/json;charset=UTF-81A..100是—2AN..18否—3A..20否 4A..255是 1A..100是 2AN..18是—3A..20是—4是—5是—6否 進(jìn)出口貨物申報(bào)接口用于企業(yè)ERP系統(tǒng)對接請求方式為POST，請求參數(shù)說明見表64——Header：Content-Type:application/json;charset=UTF-81AN..50是2AN..50否—3A..100是—4A..512是—5A..18否 6AN1否 7AN..36否 8A..5否 9A..32否 ManualNoA..12否 ApprNoA..32否 A..29否 A..26否 A..32否 A.32否—WrapType否—否—否 A..4否 否 是 N..9否 NetWtN..19,5否 N..19,5否—否—N..19,5否—否—否—N..19,5否 否 否 N..19,5否 否 否 N..21,7否 否 NoteA..255否 A..10是A..10是AgentCodeA..18是—AgentNameA..70是 是—A..6否—否—A..18是—用A..60是 否 N..21,7否碼A..10是 稱A..60是—AN..18否 AgentCodeScc碼AN..18否 用單位單位統(tǒng)一AN..18否—碼AN..18否 AN..32否 否 N18否 AN..12否 AN..32否 AN..8否—否否否—否 MarkNoA..400否 A..8是 A..8是 A..100是 A..50否關(guān)A..10否A..10否AN..10否—否 否—AN..2否—AN..10否—否NoOtherPack否關(guān)A..10否 A..50否 AN..150否 AN..100否—址AN..100否 AN..50否 AN..400否 AN..400否 A..500否 A..10否—AN..10否 AN..10否 AN1否AN1否AN1否AN1否AN1否AN1否AN1否AN..50否—A..255是—否—1N..9是 2N10是 3MaterialNoA..30否 4AN..255否—5AN..255否—6N..5否—7N..19,4否 8否 9N..15,4否 N..17,2否 否 N..19,4否 否 N..19,4否 否 AN3否 AN2否 否—N..17,2否—N..8否—AN1否—N..9否 否—AN..20否—AN..100否—AN..50否 AN..4否 AN..20否 N..20否 AN..20否 AN..400否 AN..20否—AN..80否—AN..4否—AN..24否 稱AN..100否—NoDangFlagAN..1否—AN..8否—格AN..200否—AN..200否—N..2000否—N..2000否—AN..200否 AN..5否AN..50否—MnufctrRegnoAN..20否—AN..150否 否 1A..100是 2AN..18是—3A..20是—4是—5是—6否 1AN1是 2AN..100否 3AN..32是4否—1AN1是 2AN..32是 3N..2是 4N..9是 5否 1AppCertCodeAN..50是—2ApplOriAN..50否—3ApplCopyQuanAN..50否—4否—1N..9是 2AN..5是 3AN..40是 4AN..2否—5AN..20否—6否—1AN..20是 2AN..5是 3AN..100否 4否—5AN..100否—6MotorNo號(hào)AN..100否—7AN..20否 8AN..20否 9N..19,5否 AN..500否 AN..500否—ModeEnAN..500否—AN..20否—否 1N..19,5是2AN..20是—3否—1AN..40是 2碼AN..5是 3否—1AN..20是 2話AN..20是—3否—1AttachNameAN..80是 2AttachTypeAN..2否 3AttachmentAN..max是4否 1AN..1否—2號(hào)AN..13否—3稱AN..30否 4次AN..32否 5AN..1是6AN..10否—7AN..70否—8AN..8否9AN..1是AN..2是AA:出口二次轉(zhuǎn)關(guān)否—1AN..32否 2AN..255否 3AN..32否 4AN..32否 5否 6否—1N..9是 2AN..32是 3AN..128否 4N..4否—5N..9,4否 6AN..4否 7稱A..30否 8否 1N..9是—2AN..32是—3N..19是—4是—5N..19,5是 6否 1是 2是—3否—4N18否—5否 6否 7A..200否 8NoticeDate否 9否 NoteSAN..255否 否 A.1請求參數(shù)數(shù)據(jù)示例{"EntAccessTime":"2021-10-"MessageId":"123456789PIPAL20211"ParamData":"XXXXXXXXXXXXXXX}A.2.1請求成功返回示例{"EncryptKey":asdasda}A.2.2請求失敗返回示例{}A.3數(shù)據(jù)結(jié)構(gòu)擴(kuò)展字段示例{{]}A.4服務(wù)接口示例A.4.1通用接口示例A.4.1.1開放平臺(tái)認(rèn)證服務(wù)示例{"RetTime":"2021-10"ZVHG4duTbeUDwvwJGqFzMI4fM5IE+vJ+/px7OcAU5q+6WfT1CagBhpa\r\n761xg8er4}}A.4.1.2用戶授權(quán)接口示例{"ServiceApp":"customsDeclarat"v1/dataQuery/HSCIQController;v1/dataQuery/BillStatusController;v1/dataQu}}A.4.1.3服務(wù)申請示例{"v1/dataQuery/HSCIQController;v1/dataQuery/BillStatusController;v1/dataQu}}A.4.1.4數(shù)據(jù)申請示例{"DataUnit":"9131023"DataPUnit":"9131023}}A.4.1.5數(shù)據(jù)授權(quán)示例{"accessFile":"A-CUSTOMERS-SERVIC"dataAccess":"9131023}}A.4.2下行服務(wù)接口示例A.4.2.1通關(guān)參數(shù)查詢示例{"DicItemName":"出境水生動(dòng)物養(yǎng)殖場/包轉(zhuǎn)場}}A.4.2.2報(bào)關(guān)數(shù)據(jù)查詢示例A.檢驗(yàn)檢疫編碼查詢示例{}}A.艙單通關(guān)狀態(tài)查詢示例{}}A.進(jìn)出口稅率查詢示例{}}A.第一二計(jì)量單位查詢示例{}}A.進(jìn)出口商品查詢示例{}}A.報(bào)關(guān)單狀態(tài)查詢示例{}}A.報(bào)關(guān)單明細(xì)查詢示例{"RcvgdTradeScc":"境內(nèi)收"CmplDschrgDt":"2022"CorrelationReasonF"DomesticConsigneeEname""OverseasConsignorA"OverseasConsignorCn"OverseasConsignorCode""OverseasConsignorEname""OwnerCiqCode":"消費(fèi)使用/生"FieldExtend":"擴(kuò)展字段""OrigPlaceCode":"01"RcepOrigPlaceCode":""FieldExtend":"擴(kuò)展字段""FieldExte