ICS35.240CCSL773502Part3:InterfaceofcustomsclearanceservicesIDB3502/T117.3—2023前言 12規(guī)范性引用文件 13術語和定義 14縮略語 15基本要求 16數(shù)據(jù)對接方式 27服務接口設計基本規(guī)定 28業(yè)務服務接口 4 附錄B（資料性）通關字典 DB3502/T117.3—2023本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件是DB3502/T117《國際貿(mào)易“單一窗口”數(shù)據(jù)服務》的第3部分。DB3502/T117已經(jīng)發(fā)布了——第1部分：總體技術要求；——第2部分：報關業(yè)務數(shù)據(jù)元；——第3部分：報關服務接口。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔識別專利的責任。本文件由中國(福建)自由貿(mào)易試驗區(qū)廈門片區(qū)管理委員會信息化服務中心提出。本文件由中國(福建)自由貿(mào)易試驗區(qū)廈門片區(qū)管理委員會歸口。本文件起草單位：中國(福建)自由貿(mào)易試驗區(qū)廈門片區(qū)管理委員會信息化服務中心、北京國研數(shù)通軟件技術有限公司、廈門市標準化研究院、廈門自貿(mào)試驗區(qū)電子口岸有限公司、中國廈門外輪代理有限公司、廈門市人民政府口岸工作辦公室、廈門海事局、廈門出入境邊防檢查總站本文件主要起草人：吳志強、李童、王李強、鄭建欣、林華、李倩文、劉裴寰、葉少鵬、楊晨、嚴偉榮、吳永馨、周印亮、李紅、徐鋒、趙健、謝曉芳、胡流輝、李健、鄭巍偉、陳瑀、李釗茜、詹永祥、張建財、郭曉晨、張穎慧、陳劭彧DB3502/T117.3—2023國際貿(mào)易“單一窗口”數(shù)據(jù)服務開放平臺的建設，可以充分發(fā)掘數(shù)據(jù)資產(chǎn)價值，提升廈門“單一窗口”創(chuàng)新服務效率，優(yōu)化廈門市營商環(huán)境，積極服務“單一窗口”相關企業(yè)。DB3502/T117旨在確立數(shù)據(jù)服務開放平臺總體架構(gòu)、技術架構(gòu)、開放過程等的技術標準，為數(shù)據(jù)服務開放平臺的建設提供基礎規(guī)范，擬由十七個部分組成。——第1部分：總體技術要求；——第2部分：報關業(yè)務數(shù)據(jù)元；——第3部分：報關服務接口；——第4部分：快件業(yè)務數(shù)據(jù)元；——第5部分：快件業(yè)務服務接口；——第6部分：運輸工具數(shù)據(jù)元；——第7部分：運輸工具服務接口；——第8部分：艙單業(yè)務數(shù)據(jù)元；——第9部分：艙單業(yè)務服務接口；——第10部分：跨境電商數(shù)據(jù)元；——第11部分：跨境電商服務接口；——第12部分：保稅業(yè)務數(shù)據(jù)元；——第13部分：保稅業(yè)務服務接口；——第14部分：服務目錄；——第15部分：安全管理要求；——第16部分：數(shù)據(jù)服務流程；——第17部分：運維服務要求。報關服務接口用于規(guī)范報關業(yè)務領域內(nèi)接口設計、數(shù)據(jù)傳遞方式、參數(shù)格式、交互流程等內(nèi)容，支持不同系統(tǒng)之間的集成和互操作性，確保數(shù)據(jù)傳遞的一致性和準確性，提高工作效率，降低維護成本，支持業(yè)務流程自動化等，為特定業(yè)務領域內(nèi)的系統(tǒng)交互提供了標準化的框架，促進了業(yè)務流程的順暢進行和信息交換的高效實現(xiàn)。DB3502/T117.3—20231國際貿(mào)易"單一窗口"數(shù)據(jù)服務第3部分：報關服務接口本文件規(guī)定了“單一窗口”數(shù)據(jù)服務開放平臺提供的數(shù)據(jù)開放服務中報關服務相關接口。本文件適用于相關企業(yè)業(yè)務系統(tǒng)調(diào)用開放的服務接口進行進出口報關申報。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。DB3502/T117.1國際貿(mào)易“單一窗口”數(shù)據(jù)服務第1部分：總體技術要求DB3502/T117.2國際貿(mào)易“單一窗口”數(shù)據(jù)服務第2部分：報關業(yè)務數(shù)據(jù)元3術語和定義本文件沒有需要界定的術語和定義。4縮略語下列縮略語適用于本文件。AES：高級加密標準（AdvancedEncryptionStandard)API：應用程序編程接口（ApplicationProgrammingInterface）CA：證書認證機構(gòu)(CertificateAuthority)HTTP：超文本傳輸協(xié)議（HypertextTransferProtocol)HTTPS：超文本傳輸安全協(xié)議（HypertextTransferProtocoloverSecureSocketLayer）JSON：JavaScript對象標記(JavaScriptObjectNotation)JWT：一種用于身份驗證和授權的開放標準（JSONWebToken）SM系列算法：國家商用密碼算法5基本要求數(shù)據(jù)服務開放平臺的接口應滿足以下基本要求：——實用性:能與不同企業(yè)報關進行業(yè)務對接、完成數(shù)據(jù)交換；——安全性:數(shù)據(jù)交換過程中保護國家秘密、商業(yè)秘密和個人隱私；——時效性:能實時完成數(shù)據(jù)交換。DB3502/T117.3—202326數(shù)據(jù)對接方式數(shù)據(jù)對接方式包括：——專線+HTTPS；——HTTPS+身份認證。7服務接口設計基本規(guī)定7.1服務接口命名規(guī)定服務接口的名稱應采用廈門“單一窗口”業(yè)務的中文描述進行命名，服務接口業(yè)務描述為服務接口所屬領域以及業(yè)務含義描述。7.2服務接口編碼規(guī)定服務接口編碼結(jié)構(gòu)如圖1所示，其中：——服務版本：默認版本為V1，新版本則為V2，依次類推；——業(yè)務分類：根據(jù)服務劃分的類別以英文字母進行命名，保證每個業(yè)務分類唯一；——業(yè)務服務名稱：數(shù)字和字母組成的文本，保證服務接口提供方內(nèi)唯一。Https://{域名}/api/v1/{bizName}/{ser圖1服務接口編碼結(jié)構(gòu)示例：https://{域名}/api/v17.3接口通訊協(xié)議規(guī)定傳輸協(xié)議應使用HTTP1.0/1.1標準或者HTTPS標準兩種方式。采用HTTPS協(xié)議時，服務方應提供接口調(diào)用需要的數(shù)字證書文件，證書文件應為“單一窗口”數(shù)據(jù)服務開放平臺統(tǒng)一頒發(fā)的數(shù)字證書。7,4上下行服務接口說明企業(yè)需要上報到數(shù)據(jù)服務開放平臺的數(shù)據(jù)，調(diào)用數(shù)據(jù)服務開放平臺相關的上行服務接口，數(shù)據(jù)服務開放平臺需要提供給各企業(yè)的數(shù)據(jù)，由企業(yè)從下行服務接口中調(diào)用相應的查詢接口獲取。其中，上行服務接口以數(shù)據(jù)服務開放平臺作為數(shù)據(jù)接收方對應的接口，下行服務接口以數(shù)據(jù)服務開放平臺作為數(shù)據(jù)提供方對應的接口。7.5接口技術類型服務接口技術類型采用REST接口，使用GET或POST方法，返回報文數(shù)據(jù)格式為JSON格式。7.6交換數(shù)據(jù)類型數(shù)據(jù)類型說明見DB3502/T117.2中數(shù)據(jù)元表示方法。7.7服務接口安全要求DB3502/T117.3—20233服務接口安全采用基于JWT開放標準（RFC7519）的簽名設計方式實現(xiàn)，本文中所有的服務接口在傳輸過程中，均采用國密SM2、SM3等國產(chǎn)算法進行加密，通過使用支持國產(chǎn)加密算法的工具庫或框架來實現(xiàn)對JWT的加密操作，在持久化存儲至數(shù)據(jù)庫過程中，則采用國產(chǎn)解密算法。7.8請求參數(shù)數(shù)據(jù)結(jié)構(gòu)請求頭參數(shù)數(shù)據(jù)結(jié)構(gòu)見表1，請求參數(shù)數(shù)據(jù)結(jié)構(gòu)見表2，示例見附錄A.1。表1請求頭參數(shù)數(shù)據(jù)結(jié)構(gòu)是是是—表2請求參數(shù)數(shù)據(jù)結(jié)構(gòu)是是是—否—否—否—否否—是—是—是—7.9響應數(shù)據(jù)結(jié)構(gòu)響應數(shù)據(jù)結(jié)構(gòu)見表3，示例見附錄A.2。表3響應數(shù)據(jù)結(jié)構(gòu)是—是—4表3響應數(shù)據(jù)結(jié)構(gòu)（續(xù)）是—是—否—否—否—7.10數(shù)據(jù)結(jié)構(gòu)擴展字段定義擴展字段（“FieldExtend”）內(nèi)容通過JSON文本進行定義，基礎數(shù)據(jù)結(jié)構(gòu)擴展字段定義見表4，示例見附錄A.3。表4擴展字段定義是—是—否—是—否否—8業(yè)務服務接口8.1業(yè)務流程描述報關行報關流程見圖2。貨主/貨代報關流程見圖3。DB3502/T117.3—20235圖2報關行報關流程圖3貨主/貨代報關流程8.2通用接口8.2.1開放平臺認證服務數(shù)據(jù)服務開放平臺采用Token認證，通過Token認證通用請求。請求方式為POST，請求參數(shù)說明見表5，返回結(jié)果說明見表6，示例見附錄A.4.1.1，其中：——Header：Content-Type:application/json;charset=UTF-8DB3502/T117.3—20236——接口地址：https://{域名}/api/v1/auth/tokens表5請求參數(shù)說明1是—2是表6返回結(jié)果說明1是—2是3是—4是用戶Token，計算的方式為使用簽名秘鑰對請求者身份標識、服務調(diào)用時間進行MD5加密獲5是8.2.2用戶授權接口對用戶訪問的數(shù)據(jù)服務進行服務權限的鑒定，判斷其是否有權限訪問該服務。請求方式為POST，請求參數(shù)說明見表7，返回參數(shù)說明見表8，示例見附錄A.4.1.2，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/access/accessList表7請求參數(shù)說明1是—2是—3是—4是—5否—表8返回參數(shù)說明1是—2是3是—4是—5是—6否—78.2.3服務申請企業(yè)在ERP或企業(yè)第三方應用調(diào)用需要的服務接口時需要發(fā)送服務申請到開放平臺。請求方式為請求方式為POST，請求參數(shù)說明見表9，返回結(jié)果說明見表10，示例見附錄A.4.1.3，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/Serv/ServiceApply表9請求參數(shù)說明1是—2是3是表10返回結(jié)果說明1是—2是3是—4限否—5否—8.2.4數(shù)據(jù)申請數(shù)據(jù)使用企業(yè)需要其他企業(yè)的數(shù)據(jù)，首先需要向其他企業(yè)進行申請使用，說明申請使用的用途、使用期限、次數(shù)、范圍等，請求方式為POST，請求參數(shù)說明見表11，返回結(jié)果說明見表12，示例見附錄A.4.1.4，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/Serv/dataApply表11請求參數(shù)說明1是—2是3是表12返回結(jié)果說明1是—DB3502/T117.3—20238表12返回結(jié)果說明（續(xù)）2是3否—4否—5是—6是—7否8.2.5數(shù)據(jù)授權企業(yè)對本企業(yè)數(shù)據(jù)授權給申請數(shù)據(jù)的企業(yè)進行授權服務，請求方式為POST，請求參數(shù)說明見表13，返回結(jié)果說明見表14，示例見附錄A.4.1.5，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/Serv/dataAccess表13請求參數(shù)說明1是2是3是表14返回結(jié)果說明1是—2是—3限否—4否—5是—6否7是—8.3下行服務接口8.3.1通關參數(shù)查詢企業(yè)通過服務接口獲得通關相關的參數(shù)數(shù)據(jù)。企業(yè)輸入查詢參數(shù)、字典名稱。接口接收企業(yè)查詢通過參數(shù)信息，并返回是否查詢成功，如成功能則返回該數(shù)據(jù)字典結(jié)果包；如不成功則返回原因。請求方式為POST，詳細請求參數(shù)見表15，返回結(jié)果說明見表16，示例見附錄A.4.2.1，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/dictype/DicControllerDB3502/T117.3—20239表15請求參數(shù)說明1是2是—3否—表16返回結(jié)果說明1是—2是—3是4否—5否—6否—7否8否9否—8.3.2報關數(shù)據(jù)查詢檢驗檢疫編碼查詢企業(yè)通過服務接口獲得進出口商品的檢驗檢疫編碼。企業(yè)輸入商品編碼或名稱查詢檢驗檢疫編碼。接口接收參數(shù)信息，并返回是否查詢成功，如成功能則返回該類商品的檢驗檢疫編碼；如不成功則返回原因。請求方式為POST，詳細請求參數(shù)見表17，返回結(jié)果說明見表18，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/dataQuery/HSCIQController表17請求參數(shù)說明1是 2否 3是 4否 表18返回結(jié)果說明1否 2否 3是 4是 DB3502/T117.3—2023表18返回結(jié)果說明（續(xù)）5否 6否 艙單通關狀態(tài)查詢企業(yè)使用該服務接口查詢進出口艙單通關狀態(tài)信息。支持輸入進口/出口，提運單號、集裝箱號、報關單號、運輸工具、航班航次號等查詢條件調(diào)用服務接口進行查詢，如果失敗，返回失敗原因，如果成功，則返回運輸工具、艙單、報關單、物流狀態(tài)等信息。請求方式為POST，詳細請求參數(shù)見表19，返回結(jié)果說明見表20，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/dataQuery/BillStatusController表19請求參數(shù)說明1否—2否3否—4否—5是—6否—7是8否—表20返回結(jié)果說明1碼是—2碼是3稱是—4否5是—6否7否—表20返回結(jié)果說明（續(xù)）8是—9否—否否—志是報關單單據(jù)類型:是—是）：否—否—進出口稅率查詢企業(yè)使用該服務接口查詢進出口稅率信息。支持輸入稅號、商品名稱調(diào)用接口進行查詢，如果失敗，返回失敗原因，如果成功，則返回進出口稅率信息。請求方式為POST，詳細請求參數(shù)見表21，返回結(jié)果說明見表22，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/dataQuery/TaxController表21請求參數(shù)說明1是 2否3否—4是—5否—表22返回結(jié)果說明1是—2否—3是—4是5否—6否—7否—第一二計量單位查詢企業(yè)使用該服務接口查詢進出口商品第一二計量單位信息。輸入商品名稱、商品HS編碼、許可證代碼，調(diào)用服務接口，查詢進出口商品第一計量單位、第二計量單位，如果失敗，返回失敗原因，如果成功，則返回進出口商品第一二單位信息。請求方式為POST，請求參數(shù)說明見表23，返回結(jié)果說明見表24，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/report/UnitController表23請求參數(shù)說明1是—2否—3否4是—5否—表24返回結(jié)果說明1是—2是—3是—4是—5稱是—6是—7稱是—8是—9否—進出口商品查詢企業(yè)使用該服務接口查詢進出口商品信息。輸入商品分類、商品HS編碼、許可證代碼，調(diào)用服務接口，查詢進出口商品，如果失敗，返回失敗原因，如果成功，則返回進出口商品信息。請求方式為POST，請求參數(shù)說明見表25，返回結(jié)果說明見表26，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/report/HSGoodsController表25請求參數(shù)說明1是—2是—表25請求參數(shù)說明（續(xù)）3否4是—5否—表26返回結(jié)果說明1是—2是—3是—4是—5稱是—6是—7稱是—8是9否—報關單狀態(tài)查詢企業(yè)通過服務接口實時查詢本企業(yè)報關單狀態(tài)結(jié)果信息。企業(yè)用戶輸入報關單號，查詢本企業(yè)的報關單狀態(tài)結(jié)果。輸入報關單號和本企業(yè)統(tǒng)一社會信用代碼或海關編碼，申報單位統(tǒng)一社會信用代碼或海關編碼，可以查詢報關單狀態(tài)信息。如果查詢成功，則返回報關單狀態(tài)結(jié)果。請求方式為POST，請求參數(shù)說明見表27，返回結(jié)果說明見表28，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/report/RepStatusController表27請求參數(shù)說明1是—2是3否—4是5否—表28返回結(jié)果說明1是2是—3是—4否—報關單明細查詢企業(yè)通過服務接口實時查詢本企業(yè)一段時間周期內(nèi)報關單結(jié)果信息。企業(yè)用戶輸入報關單號，企業(yè)統(tǒng)一社會信用代碼或海關注冊碼，收發(fā)貨人代碼、報關時間段開始時間和結(jié)束時間，查詢本企業(yè)報關單信息。請求方式為POST，請求參數(shù)說明見表29，返回結(jié)果說明見表30-48，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/report/RepController表29請求參數(shù)說明1否—2是—3否—4是5碼否—6是—7是—8否—9是—否—表30進口/出口報關單表頭1否—2碼是—3是—4碼是—5稱是—表30進口/出口報關單表頭（續(xù)）6否—7售單位（出口）是—8售單位（出口）是9售單位（出口）是—否是否—否—是—是否否是—是是—否是否—否—否—是—是—表30進口/出口報關單表頭（續(xù)）是是—是—否—否—否否—否—否否—否—否否否否否志是否否否否否—是—是）：是是—是—否—表30進口/出口報關單表頭（續(xù)）是否是—是是否關否—否否否—否—否否—否是—關是表30進口/出口報關單表頭（續(xù)）否—否否—碼否—是—否否—否—諾否否—否—表31進口/出口報關單表體1否2是—3否4是5是6是—7否—8否—9子否—是—是—是—表31進口/出口報關單表體（續(xù)）是是是是—是否—是是—否—否是否否否否—否否否—否—否—否—否—否—稱否否—否格否—否—否—表31進口/出口報關單表體（續(xù)）否否—是否否否否—否表32報關單集裝箱1是—2是3是4否—5否—6否—表33隨附單證1否—2是—3是4是—5否—表34報關單隨附單據(jù)關系1否—2號是—3碼是4是5否—表34報關單隨附單據(jù)關系（續(xù)）6是7否—8稱否—9是是否表35報關單其他包裝1否—2是—3是—4否—表36原產(chǎn)地對應關系1否—2是—3是—4是5是—6是7是8是—9否—表37報關單商品許可證信息1否2是—3是—4是—5是—6否7否—8否—9否—否—表38報關單商品許可證VIN信息1否2是—3是—4是—5是6是—7否—8否9否號否—否—否—否否否—否—否—否—否—表39企業(yè)資質(zhì)信息1否2號是—3是—4碼否—5稱否6是7否—表40進口/出口報關單使用人信息1否—2是—3否4話否—5否—表41標記號碼附件信息1否—2是—3否4否—5小是6是7否—表42報稅單表頭1否—2期否3否表42報稅單表頭（續(xù)）4是5否—表43報稅單表體1是2否—3否—4否—5否—6否7否—8否—9否—否否否—否—否—表44稅費計征結(jié)果1是—2號是—3是—4是—5否—表45轉(zhuǎn)關單表頭1否—2否—3否—4是）：5否—6鎖否表45轉(zhuǎn)關單表頭（續(xù)）7否可選擇，其余轉(zhuǎn)關類型可以在進口或出口提前8否9是—號是—稱否—否—否—否—碼否稱否—否否—否否—否—否—否—表46轉(zhuǎn)關單表體(提單)1否—2是—DB3502/T117.3—2023表46轉(zhuǎn)關單表體(提單)（續(xù)）3否4否—5否—6否—7否—8否9否—否—表47進口/出口提運單集裝箱表1否—2是—3是—4否5否6否—7否—8稱否—9量否—否—否—表48進口/出口提運單集裝箱商品裝配表1否—2是—3是4是5否—6否—7否—8否出口箱碼頭放行查詢企業(yè)通過服務接口獲得出口報關單所關聯(lián)出口提運單號的碼頭放行信息。企業(yè)輸入報關單號或出口提運單號查詢碼頭放行信息。接口接收參數(shù)信息，并返回是否查詢成功，如成功能則返回下列參數(shù)；DB3502/T117.3—2023如不成功則返回原因。數(shù)據(jù)來源為地方碼頭網(wǎng)站及遠海碼頭網(wǎng)站。請求方式為POST，請求參數(shù)說明見表49，返回結(jié)果說明見表50，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/feedback/DockReleaseController表49請求參數(shù)說明1否—2是—3是—表50返回結(jié)果說明1是—2是—3間是—4是—5是—6是—7是8是—9否—進口箱海關放行查詢企業(yè)通過服務接口獲得進口報關單所關聯(lián)出口提運單號的碼頭放行信息。企業(yè)輸入報關單號或進口提運單號查詢碼頭放行信息。接口接收參數(shù)信息，并返回是否查詢成功，如成功能則返回下列參數(shù)；如不成功則返回原因。數(shù)據(jù)來源為地方碼頭網(wǎng)站及遠海碼頭網(wǎng)站。請求方式為POST，請求參數(shù)說明見表51，返回結(jié)果說明見表52，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/feedback/CustomerReleaseController表51請求參數(shù)說明1否2否—3是—4否—表52返回結(jié)果說明1是—DB3502/T117.3—2023表52返回結(jié)果說明（續(xù)）2是3是—4是—5是—6是—7是8是—9否—0查驗箱移箱/歸位信息查詢企業(yè)通過服務接口通過箱號利用碼頭網(wǎng)站查詢場位信息。企業(yè)輸入箱號或輸入報關單號、查驗提運單號提取出關聯(lián)的箱號查詢箱號對應的場位信息。接口接收參數(shù)信息，并返回是否查詢成功，如成功能則返回場位；如不成功則返回原因。請求方式為POST，請求參數(shù)說明見表53，返回結(jié)果說明見表54，示例見附錄A.0，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/feedback/BoxCheckController表53請求參數(shù)說明1否—2否3是—4是—表54返回結(jié)果說明1是—2是—3否—1進箱/截箱時間查詢企業(yè)通過服務接口通過船名、航次查詢的船舶信息。企業(yè)輸入船信息查詢碼頭預泊時間、可進場時間、截箱時間、截單時間信息。接口接收參數(shù)信息，并返回是否查詢成功，如成功能則返回該類商品的檢驗檢疫編碼；如不成功則返回原因。請求方式為POST，請求參數(shù)說明見表55，返回結(jié)果說明見表56，示例見附錄A.1，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/feedback/AnchorkControllerDB3502/T117.3—2023表55請求參數(shù)說明1船名是2航次是—3是—表56返回結(jié)果說明1是—2是—3是—4是—5是6否—8.3.3反饋回執(zhí)報關回執(zhí)單企業(yè)使用該服務接口獲得該申報單位報關單回執(zhí)信息。輸入申報單位名稱、境內(nèi)收發(fā)貨人代碼、申報日期、提單號、航次號等查詢條件，調(diào)用服務接口，查詢申報單位報關單回執(zhí)情況，如果失敗，返回失敗原因，如果成功，則返回報關單回執(zhí)信息。請求方式為POST，請求參數(shù)說明見表57，返回結(jié)果說明見表58，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/feedback/RepBackController表57請求參數(shù)說明1是—2是—3碼是—4是5是—6是—7是8否表58返回結(jié)果說明1碼是—2是—表58返回結(jié)果說明（續(xù)）3是）：）：）：4是—5是—6是—7是—8是9是—是—是—是—表58返回結(jié)果說明（續(xù)）是是—是—否—艙單運抵報告狀態(tài)企業(yè)查詢運抵報告狀態(tài)信息接口用于企業(yè)ERP系統(tǒng)對接“單一窗口”平臺，實現(xiàn)企業(yè)查詢運抵報告狀態(tài)信息查詢服務。請求方式為POST，請求參數(shù)說明見表59，返回結(jié)果說明見表60-61，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/feedback/BorderQueryController表59請求參數(shù)說明1是—2是—3否—4否5是—6否表60艙單運抵業(yè)務報文體（提單）1是—2否3是4否—5是—6是7述是8否—表61艙單運抵業(yè)務報文體（集裝箱）1是表61艙單運抵業(yè)務報文體（集裝箱續(xù)）2否3是—4是5是6述是—7否—8.3.4企業(yè)信息查詢企業(yè)通過服務接口獲得企業(yè)信息相關的編碼，包含企業(yè)名稱、企業(yè)統(tǒng)一代碼、企業(yè)海關編號、海關信用等級、經(jīng)營類別。企業(yè)輸入企業(yè)名稱時查詢企業(yè)統(tǒng)一代碼、企業(yè)海關編號、海關信用等級、經(jīng)營類別。接口接收參數(shù)信息，并返回是否查詢成功，如成功能則返回該企業(yè)的上述相關信息；如不成功則返回原因。請求方式為POST，請求參數(shù)說明見表62，返回結(jié)果說明見表63，示例見附錄A.4.2.4，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/feedback/EntCodeController表62請求參數(shù)說明1是—2否—3否4是表63返回結(jié)果說明1是—2是—3是—4是—5是—6否8.4上行服務接口8.4.1進出口報關申報進出口貨物申報接口用于企業(yè)ERP系統(tǒng)對接“單一窗口”平臺，實現(xiàn)貨物電子數(shù)據(jù)報關申報服務。請求方式為POST，請求參數(shù)說明見表64-79，返回結(jié)果說明見表80，示例見附錄A.4.3.1，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{域名}/api/v1/dataUpload/TradeReportController表64報關單表頭信息1是2否—3是—4是—5否6否—7否—8否—9否否—否—否—否—否否—否—否—否否否—是—否—否否—否—否—否—否—否—否—否—否—否—否—否—否—表64報關單表頭信息（續(xù)）否是是是—是是—否—否—是—用是否否碼是稱是—否—碼否—用單位單位統(tǒng)一否—碼否—否—否—否—否—否否—否否否—表64報關單表頭信息（續(xù)）否否—是—是—是—否關否否否—否否—否—否—否否關否—否—否否—址否—否—否—表64報關單表頭信息（續(xù)）否—否—否—否—否—否否否0/空：一般報關單否否否否否—是—否—表65報關單表體信息1是—2是—3否4否—5否—6否—7否8否9否—否—否—表65報關單表體信息（續(xù)）否否—否—否—否—否否—否—否—否—否—否—否—否—否否—否—否—否—否否—否—否—否稱否—否—否—格否—否—否—否—否否否—否—表65報關單表體信息（續(xù)）否否—表66箱子信息1是2是—3是—4是—5是—6否表67單證信息1是—2否3是4否—表68原產(chǎn)地證序號1是—2是—3是—4是—5否—表69申請單證信息1是—2否—3否—4否—表70許可證信息1是—2是—表70許可證信息（續(xù)）3是4否—5否—6否—1是—2是3否4否—5否—6號否—7否—8否—9否—否—否—否—否—否—表72其他包裝信息1是2是—3否—表73企業(yè)資質(zhì)信息1是—2碼是3否—表74使用人信息1是2話是—3否—表75標記號碼附件1是—2否—3是Convert.ToBase64Str4否—表76轉(zhuǎn)關單表頭1否—2號否—3稱否—4次否5是6否—7否—8否9是是否—表77轉(zhuǎn)關單箱信息1否2否—3否—4否—5否—6否—表78轉(zhuǎn)關單箱貨關系1是—2是3否4否—5否6否—7稱否8否—表79轉(zhuǎn)關單箱貨關系1是—2是—3是—4是—5是6否—表80返回結(jié)果說明1是2是—3AN..18否—4否—5否6否7否—8否—表80返回結(jié)果說明（續(xù)）9否否—否—DB3502/T117.3—2023接口示例A.1請求參數(shù)數(shù)據(jù)示例{"EntId":"1234567802","EntType":"01","Signature":"fsfsdfdsfdsf","EncryptName":"AES256","EncryptKey":"fddde323231245","EntAccessTime":"2021-10-10:12:12:23","Format":"JSON","MessageId":"123456789PIPAL202111111111110001","AccountName":"123456789","IcCardNo":"123456789","ParamData":"XXXXXXXXXXXXXXXXXXXXXXXXXX",}A.2響應數(shù)據(jù)示例A.2.1請求成功返回示例{"RetCode":"200","RetMsg":"請求成功","RetTime":"2021-10-1012:23:24","Signature":"fsdfafadsf==","EncryptName":"AES256","EncryptKey":asdasdasdasdsgsd==","RetData":"JSON"}A.2.2請求失敗返回示例{"RetCode":"910001","RetMsg":"系統(tǒng)繁忙，請稍后重試","RetTime":"2022-01-0113:24:54","Signature":"","EncryptName":"","EncryptKey":"","TetData":""}A.3數(shù)據(jù)結(jié)構(gòu)擴展字段示例{fieldCode:"hscode",fieldname:"HS編碼",fieldLength:"5",fieldType:"String",fieldRequired:"1",{fieldCode:"hsversion",fieldname:"HS版本號",fieldLength:"10",fieldType:"String",fieldRequired:"0",]}A.4服務接口示例A.4.1通用接口示例A.4.1.1開放平臺認證服務示例{"RetCode":"200","RetTime":"2021-10-1012:34:22","RetData":{"UserID":"Admin@12345","UserToken":"ZVHG4duTbeUDwvwJGqFzMI4fM5IE+vJ+/px7OcAU5q+6WfT1CagBhpa\r\n761xg8er45wBYyPJXnP1vj","ExpireTime":"7200"}}A.4.1.2用戶授權接口示例{"RetCode":"200","retData":{"UserID":"Admin@12345","UserName":"外代公司","ServiceApp":"customsDeclarationBusiness","ServiceList":"v1/dataQuery/HSCIQController;v1/dataQuery/BillStatusController;v1/dataQuery/TaxController;v1/report/UnitController","IPAddress":"50",}}A.4.1.3服務申請示例{"RetCode":"200","retData":{"ServAccess":"ALL","ServiceList":"v1/dataQuery/HSCIQController;v1/dataQuery/BillStatusController;v1/dataQuery/TaxController;v1/report/UnitController","SerTimeLimit":"86400000","SerSumLimit":"20",}}A.4.1.4數(shù)據(jù)申請示例{"RetCode":"200","retData":{"dataUsing":"本企業(yè)數(shù)據(jù)回流","SerTimeLimit":"86400000","SerSumLimit":"20","DataUnit":"91310230MA1AAAAAA4","DataPUnit":"91310230MA1AAAAAA4","ServiceData":{"CodeTs":"0101210010","CName":"種用玉米","LicenceNo":"XK1098839843","FirstUnit":"12","FirstUnitCN":"千克","SecondUnit":"11","SecondUnitCN":"袋","GType":"999"}}A.4.1.5數(shù)據(jù)授權示例{"RetCode":"200","retData":{"dataTimeLimit":"86400000","dataSumLimit":"20","accessFile":"A-CUSTOMERS-SERVICE-20230909","dataAccess":"91310230MA1AAAAAA4","ServiceData":{"CodeTs":"0101210010","CName":"種用玉米","LicenceNo":"XK1098839843","FirstUnit":"12","FirstUnitCN":"千克","SecondUnit":"11","SecondUnitCN":"袋","GType":"999"}}A.4.2下行服務接口示例A.4.2.1通關參數(shù)查詢示例{"RetCode":"200","RetData":{"DicName":"企業(yè)產(chǎn)品許可類別代碼表","DicItemCode":"101","DicItemName":"檢疫處理單位審批","DicItemShortName":"","DicItemExtField":"A","DicItemExtField2":"99","DicName":"企業(yè)產(chǎn)品許可類別代碼表","DicItemCode":"304","DicItemName":"出境水生動物養(yǎng)殖場/包轉(zhuǎn)場檢驗檢疫注冊登記","DicItemShortName":"","DicItemExtField":"A","DicItemExtField2":"99",}}A.4.2.2報關數(shù)據(jù)查詢示例A.檢驗檢疫編碼查詢示例{"RetCode":"200","retData":{"CodeTS":"0101210010","GName":"改良種用瀕危野馬","CIQCode":"0101210010999","CIQName":"改良種用瀕危野馬","CIQType":"PQ",}}A.艙單通關狀態(tài)查詢示例{"RetCode":"200","retData":{"TradeCoScc":"TCNYY0007892"，"AgentCode":"JK233S/233S"，"AgentName":"海順豐船務有限公司"，"AgentScc":"45454xxx9999333"，"CustomMaster":"廈門海關","BillNo":"Ex98228392382","IEDate":"2021-12-15","TrafMode":"海運","TrafName":"海豐9號","VoyNo":"JK233S","ManualNo":"TCNYY0007892","DeclTrnRel":"1","TradeName":"永豐船運","IEFlag":"I","PassStatus":"11",}}A.進出口稅率查詢示例{"RetCode":"200","retData":{"TaxNo":"6307901010","GName":"醫(yī)療或外科口罩","ETaxRate":"6%","ETaxCurrRate":"92%","ETaxTempRate":"98%","ITaxRate":"9%",}}A.第一二計量單位查詢示例{"RetCode":"200","retData":{"CodeTS":"0101210010","GName":"種用玉米","LicenceNo":"XK1098839843","FirstUnit":"12","FirstUnitCN":"千克","SecondUnit":"11","SecondUnitCN":"袋","GModel":"袋裝",}}A.進出口商品查詢示例{"RetCode":"200","retData":{"CodeTs":"0101210010","CName":"種用玉米","LicenceNo":"XK1098839843","FirstUnit":"12","FirstUnitCN":"千克","SecondUnit":"11","SecondUnitCN":"袋","GType":"999",}}A.報關單狀態(tài)查詢示例{"RetCode":"200","retData":{"statusCode":"1","StatusName":"已保存","StatusDesc":"已處理，等候?qū)徟?,}}A.報關單明細查詢示例{"RetCode":"200","retData":{"DecMessage":{"CusCiqNo":"統(tǒng)一編號","TradeCoScc":"63078701018","RcvgdTradeScc":"境內(nèi)收發(fā)貨人社會信用代碼","AgentCode":"098434833","AgentName":"海順豐船務有限公司","AgentScc":"45454xxx9999333","OwnerCode":"消費使用單位（進口）/生產(chǎn)銷售單位（出口）代碼","OwnerName":"消費使用單位（進口）/生產(chǎn)銷售單位（出口）名稱","OwnerCodeScc":"消費使用單位","CoOwner":"企業(yè)性質(zhì)代碼","CustomMaster":"申報地海關代碼","BillNo":"AUT29390239223","IEDate":"2021-10-18","DistinatePort":"經(jīng)停港","TrafMode":"A","TrafName":"海豐9號","VoyNo":"JK233S","TradeAreaCode":"貿(mào)易國（地區(qū)）代碼（海關）","TradeCountry":"啟運國","IEPort":"進出境關別代碼","ContrNo":"合同協(xié)議號（海關）","TradeMode":"0110","CutMode":"征免性質(zhì)代碼","ManualNo":"TCNYY0007892","LicenseNo":"許可證號","WrapType":"包裝種類","PackNo":"3500","GrossWet":"500","NetWt":"凈重","TransMode":"成交方式代碼","RellId":"AUT29390239223","RelmanNo":"關聯(lián)備案號","BonNo":"監(jiān)管倉號","CusFie":"0093874","FeeCurr":"110","FeeMark":"運費標記","FeeRate":"運費／率","OtherCurr":"雜費幣制","OtherMark":"雜費標記","OtherRate":"雜費／率","InsurCurr":"保險費幣制","InsurMark":"保險費標記","InsurRate":"保險費／率","DeclTrnRel":"1","InRatio":"內(nèi)銷比率","ApprNo":"批準文號","PreEntryId":"預錄入編號","PromiseItems":"承諾事項","NoteS":"備注","TradeName":"境內(nèi)收發(fā)貨人名稱","IEFlag":"I","BillType":"備案清單類型","CusRemark":"報關單類型標記","CopNo":"企業(yè)內(nèi)部編號","DecBpId":"報關員編號","DecBpNo":"報關員聯(lián)系方式","MarkNo":"標記嘜碼","DespPortCode":"啟運港代碼","EntyPortCode":"入境口岸","GoodsPlace":"貨物存放地點","BLNo":"B/L號","InspOrgCode":"口岸檢驗檢疫機關","SpecDeclFlag":"特種業(yè)務標識","PurpOrgCode":"目的地檢驗檢疫機關","DespDate":"2022-10-19","CmplDschrgDt":"2022-10-19","CorrelationReasonFlag":"關聯(lián)理由","VsaOrgCode":"領證機關","OrigBoxFlag":"原集裝箱標識","DeclareName":"張豐","OrgCode":"檢驗檢疫受理機關","DomesticConsigneeEname":"境內(nèi)收發(fā)貨人名稱","OverseasConsignorAddr":"美國紐約","OverseasConsignorCname":"john","OverseasConsignorCode":"境外收發(fā)貨人代碼","OverseasConsignorEname":"境外收發(fā)貨人名稱","CorrelationNo":"關聯(lián)號碼","OwnerCiqCode":"消費使用/生產(chǎn)銷售單位檢驗檢疫編碼","DeclCiqCode":"申報單位檢驗檢疫編碼","IsCopPromise":"是否勾選企業(yè)承諾","TradeCiqCode":"境內(nèi)收發(fā)貨人檢驗檢疫編碼","FieldExtend":"擴展字段""DecBody":{"ClassMark":"歸類標志","CodeTS":"0101210010","ContrItem":"備案序號","DeclPrice":"10.0","DeclTotal":"100000.0","DutyMode":"1","ExgNo":"貨號","ExgVersion":"版本號","Factor":"申報計量單位與法定單位比例因子","FirstUnit":"千克","FirstQty":"第一法定數(shù)量","GUnit":"KG","GModel":"袋裝","GName":"改良種用瀕危野馬","GNo":"商品序號","GQty":"成交數(shù)量","OriginCountry":"原產(chǎn)國","SecondUnit":"第二計量單位","SecondQty":"第二法定數(shù)量","TradeCurr":"成交幣制","UseTo":"用途/生產(chǎn)廠家","WorkUsd":"工繳費","DestinationCountry":"最終目的國（地區(qū)）","CIQCode":"檢驗檢疫編碼","DeclGoodsEname":"商品英文名稱","OrigPlaceCode":"0101210010999","Purpose":"用途代碼","ProdValidDt":"產(chǎn)品有效期","ProdQgp":"產(chǎn)品保質(zhì)期","GoodsAttr":"貨物屬性代碼","Stuff":"成份/原料/組份","Uncode":"UN編碼","DangName":"危險貨物名稱","DangPackType":"危包類別","DangPackSpec":"危包規(guī)格","EngManEntCnm":"境外生產(chǎn)企業(yè)名稱","NoDangFlag":"非危險化學品","DestCode":"目的地代碼","GoodsSpec":"檢驗檢疫貨物規(guī)格","GoodsModel":"貨物型號","GoodsBrand":"貨物品牌","ProduceDate":"2022-01-09","ProdBatchNo":"生產(chǎn)批號","DistrictCode":"境內(nèi)目的地/境內(nèi)貨源地","CiqName":"改良種用瀕危野馬","MnufctrRegno":"生產(chǎn)單位注冊號","MnufctrRegName":"生產(chǎn)單位名稱","RcepOrigPlaceCode":"優(yōu)惠貿(mào)易協(xié)定項下原產(chǎn)地","FieldExtend":"擴展字段""Container":{"ContaNo":"集裝箱號","ContainerMd":"集裝箱規(guī)格","GoodsNo":"商品項號","LclFlag":"拼箱標識","GoodsContaWt":"箱貨重量","FieldExtend":"擴展字段""Document":{"CusCiqNo":"統(tǒng)一編號","FormSeqNo":"隨附單證序號","AcmpFormCode":"隨附單證代碼","AcmpFormNo":"隨附單證編號","FieldExtend":"擴展字段""CusCiqNo":"統(tǒng)一編號","AttSeqNo":"隨附單據(jù)信息序號","AttTypeCode":"隨附單據(jù)類別代碼","AttFmtTypeCode":"隨附單據(jù)格式類型代碼","AttEdocNo":"隨附單據(jù)編號","OpNote":"操作說明（重傳原因）","EntOrigFileName":"企業(yè)原始文件名稱","BizTypeCode":"申報業(yè)務類型","UploadOpTypeCode":"上傳操作類型","CertNo":"單據(jù)證書編號","FieldExtend":"擴展字段""CusCiqNo":"統(tǒng)一編號","WrapType":"包裝種類","PackQty":"10000","FieldExtend":"擴展字段""CusCiqNo":"統(tǒng)一編號","FormSeqNo":"隨附單證序號","EcoRelSeqNo":"原產(chǎn)地對應關系序號","IEFlag":"進出口標識(海關)","CertType":"單證類型","CertNO":"原產(chǎn)證書編號","GoodsNo":"貨物序號","EcoGNo":"對應原產(chǎn)地貨物項號","FieldExtend":"擴展字段""BizRelNo":"業(yè)務關聯(lián)號","CusCiqNo":"統(tǒng)一編號","GoodsNo":"貨物序號","GoodsLimitSeqNo":"許可證信息序號","LicenceNo":"許可證編號","LicTypeCode":"許可證類別代碼","LicTypeName":"許可證類別名稱","LicWrtofDetailNo":"許可證核銷明細序號","LicWrtofQty":"許可證核銷數(shù)量","LicWrtofQtyUnit":"許可證核銷數(shù)量單位","FieldExtend":"擴展字段""GoodsLiceneVIN":[{"CusCiqNo":"統(tǒng)一編號","GoodsNo":"貨物序號","GoodsLimitSeqNo":"許可證信息序號","GoodsLimitVinSeqNo":"許可證VIN信息序號","LicenceNo":"許可證編號","LicTypeCode":"許可證類別代碼","VinNo":"VIN序號","BillLadDate":"提/運單日期","QualityQgp":"質(zhì)量保質(zhì)期","MotorNo":"發(fā)動機號或電機號","VinCode":"車輛識別代碼（VIN）","ChassisNo":"底盤(車架)號","InvoiceNum":"發(fā)票所列數(shù)量","ProdCnnm":"品名（中文名稱）","ProdEnnm":"品名（英文名稱）","ModelEn":"型號（英文）","PricePerUnit":"單價","InvoiceNo":"發(fā)票號","FieldExtend":"擴展字段""CusCiqNo":"統(tǒng)一編號","EntQualifSeqNo":"企業(yè)資質(zhì)信息序號","EntQualifNo":"企業(yè)資質(zhì)編號","EntQualifTypeCode":"企業(yè)資質(zhì)類別代碼","EntQualifTypeName":"企業(yè)資質(zhì)類別名稱","BizType":"業(yè)務類型","FieldExtend":"擴展字段""CusCiqNo":"統(tǒng)一編號","ConsumerUsrSeqNo":"使用人信息序號","UseOrgPersonCode":"使用單位聯(lián)系人","UseOrgPersonTel":"使用單位聯(lián)系電話","FieldExtend":"擴展字段""MarkLobSeqNo":[{"CusCiqNo":"統(tǒng)一編號","MarkLobSeqNo":"標記號碼附件信息序號","AttachType":"附件類型","AttachName":"附件名稱","EdocSize":"隨附單據(jù)文件大小","Attachment":"附件文件","FieldExtend":"擴展字段""CusCiqNo":"統(tǒng)一編號","FirIDate":"料件首次進口日期","GuidNo":"計稅調(diào)用編號","TaxNo":"海關計稅服務號","FieldExtend":"擴展字段""GoodsNo":"貨物序號","AgreementId":"協(xié)定編號","Antidumping":"反傾銷涉案","Antisubsidy":"反補貼涉案","DutyValue":"特案完稅價格","DutyRate":"關稅從價稅率","QtyDutyRate":"關稅從量稅率","RegRate":"消費稅從價稅率","QtyRegRate":"消費稅從量稅率","TaxRate":"增值稅率","AntidumpingRate":"反傾銷稅率","AntisubsidyRate":"反補貼稅率","TrashfundRate":"廢棄基金稅率","FieldExtend":"擴展字段""GoodsNo":"貨物序號","DetailSeqNo":"稅費計征明細序號","TaxType":"稅種","RealTax":"計稅金額","FieldExtend":"擴展字段""TransformNo":"轉(zhuǎn)關單編號","TrnPreId":"轉(zhuǎn)關單統(tǒng)一編號","TurnNo":"轉(zhuǎn)關申報單編號","IEFlag":"進出口標識（海關）","TransNo":"載貨清單號","ESealFlag":"Y","TransFlag":"轉(zhuǎn)關類型","TransType":"轉(zhuǎn)關申報類型","NativeTrafMode":"境內(nèi)運輸方式","TrafCustomsNo":"境內(nèi)運輸工具編號","NativeShipName":"境內(nèi)運輸工具名稱","NativeVoyageNo":"境內(nèi)運輸工具航次編號","ContractorName":"承運單位名稱","ContractorCode":"承運單位組織機構(gòu)代碼","TransApplCode":"轉(zhuǎn)關申報單位代碼","TransApplName":"轉(zhuǎn)關申報單位名稱","TransApplScc":"轉(zhuǎn)關申報單位社會信用代碼","ContaCount":"集裝箱數(shù)量","ContaIniCount":"集裝箱標箱數(shù)量","ContaEmptyCount":"集裝箱空箱數(shù)量","ValidDate":"預計抵運日期","Note":"備注信息","FieldExtend":"擴展字段""TransformNo":"轉(zhuǎn)關單編號","BillSeqNo":"提運單序號","TrafMode":"A","ShipId":"運輸工具編號","ShipNameEn":"船舶名稱","VoyNo":"JK233S","BillNo":"AUT29390239223","ContaCount":"集裝箱數(shù)量","IEDate":"2021-10-18","FieldExtend":"擴展字段""TransformNo":"轉(zhuǎn)關單編號","BillSeqNo":"提運單序號","ContaSn":"集裝箱序號","ContaNo":"集裝箱號","ContainerMdCode":"集裝箱規(guī)格代碼","SealNo":"電子關鎖號","SealNum":"封志個數(shù)","NativeShipName":"境內(nèi)運輸工具名稱","TransWeight":"運輸工具實際重量","SealQty":"關鎖個數(shù)","FieldExtend":"擴展字段""BillContaGoodsForm":"TransformNo":"轉(zhuǎn)關單編號","BillSeqNo":"提運單序號","GoodsNo":"貨物序號","ContaSn":"集裝箱序號","ContaNo":"集裝箱號","ContaGoodsCount":"商品件數(shù)","ContaGoodsWeight":"商品重量","FieldExtend":"擴展字段"}}}A.出口箱碼頭放行查詢示例{"RetCode":"200","retData":{"EntranceFlag":"1",