ICS35.240

CCSL77

3502

福建省廈門市地方標準

DB3502/T117.3—2023

國際貿(mào)易"單一窗口"數(shù)據(jù)服務(wù)

第3部分：報關(guān)服務(wù)接口

DataservicesforinternationaltradeSingleWindow—

Part3:Interfaceofcustomsclearanceservices

2023-12-28發(fā)布2023-12-28實施

廈門市市場監(jiān)督管理局發(fā)布

DB3502/T117.3—2023

目次

前言.................................................................................II

引言................................................................................III

1范圍...............................................................................1

2規(guī)范性引用文件.....................................................................1

3術(shù)語和定義.........................................................................1

4縮略語.............................................................................1

5基本要求...........................................................................1

6數(shù)據(jù)對接方式.......................................................................2

7服務(wù)接口設(shè)計基本規(guī)定...............................................................2

8業(yè)務(wù)服務(wù)接口.......................................................................4

附錄A（資料性）接口示例............................................................43

附錄B（資料性）通關(guān)字典............................................................61

I

DB3502/T117.3—2023

前言

本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

本文件是DB3502/T117《國際貿(mào)易“單一窗口”數(shù)據(jù)服務(wù)》的第3部分。DB3502/T117已經(jīng)發(fā)布了

以下部分：

——第1部分：總體技術(shù)要求；

——第2部分：報關(guān)業(yè)務(wù)數(shù)據(jù)元；

——第3部分：報關(guān)服務(wù)接口。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔識別專利的責任。

本文件由中國(福建)自由貿(mào)易試驗區(qū)廈門片區(qū)管理委員會信息化服務(wù)中心提出。

本文件由中國(福建)自由貿(mào)易試驗區(qū)廈門片區(qū)管理委員會歸口。

本文件起草單位：中國(福建)自由貿(mào)易試驗區(qū)廈門片區(qū)管理委員會信息化服務(wù)中心、北京國研數(shù)通

軟件技術(shù)有限公司、廈門市標準化研究院、廈門自貿(mào)試驗區(qū)電子口岸有限公司、中國廈門外輪代理有限

公司、廈門市人民政府口岸工作辦公室、廈門海事局、廈門出入境邊防檢查總站

本文件主要起草人：吳志強、李童、王李強、鄭建欣、林華、李倩文、劉裴寰、葉少鵬、楊晨、嚴

偉榮、吳永馨、周印亮、李紅、徐鋒、趙健、謝曉芳、胡流輝、李健、鄭巍偉、陳瑀、李釗茜、詹永祥、

張建財、郭曉晨、張穎慧、陳劭彧

II

DB3502/T117.3—2023

引言

國際貿(mào)易“單一窗口”數(shù)據(jù)服務(wù)開放平臺的建設(shè)，可以充分發(fā)掘數(shù)據(jù)資產(chǎn)價值，提升廈門“單一窗

口”創(chuàng)新服務(wù)效率，優(yōu)化廈門市營商環(huán)境，積極服務(wù)“單一窗口”相關(guān)企業(yè)。DB3502/T117旨在確立數(shù)

據(jù)服務(wù)開放平臺總體架構(gòu)、技術(shù)架構(gòu)、開放過程等的技術(shù)標準，為數(shù)據(jù)服務(wù)開放平臺的建設(shè)提供基礎(chǔ)規(guī)

范，擬由十七個部分組成。

——第1部分：總體技術(shù)要求；

——第2部分：報關(guān)業(yè)務(wù)數(shù)據(jù)元；

——第3部分：報關(guān)服務(wù)接口；

——第4部分：快件業(yè)務(wù)數(shù)據(jù)元；

——第5部分：快件業(yè)務(wù)服務(wù)接口；

——第6部分：運輸工具數(shù)據(jù)元；

——第7部分：運輸工具服務(wù)接口；

——第8部分：艙單業(yè)務(wù)數(shù)據(jù)元；

——第9部分：艙單業(yè)務(wù)服務(wù)接口；

——第10部分：跨境電商數(shù)據(jù)元；

——第11部分：跨境電商服務(wù)接口；

——第12部分：保稅業(yè)務(wù)數(shù)據(jù)元；

——第13部分：保稅業(yè)務(wù)服務(wù)接口；

——第14部分：服務(wù)目錄；

——第15部分：安全管理要求；

——第16部分：數(shù)據(jù)服務(wù)流程；

——第17部分：運維服務(wù)要求。

報關(guān)服務(wù)接口用于規(guī)范報關(guān)業(yè)務(wù)領(lǐng)域內(nèi)接口設(shè)計、數(shù)據(jù)傳遞方式、參數(shù)格式、交互流程等內(nèi)容，支

持不同系統(tǒng)之間的集成和互操作性，確保數(shù)據(jù)傳遞的一致性和準確性，提高工作效率，降低維護成本，

支持業(yè)務(wù)流程自動化等，為特定業(yè)務(wù)領(lǐng)域內(nèi)的系統(tǒng)交互提供了標準化的框架，促進了業(yè)務(wù)流程的順暢進

行和信息交換的高效實現(xiàn)。

III

DB3502/T117.3—2023

國際貿(mào)易"單一窗口"數(shù)據(jù)服務(wù)

第3部分：報關(guān)服務(wù)接口

1范圍

本文件規(guī)定了“單一窗口”數(shù)據(jù)服務(wù)開放平臺提供的數(shù)據(jù)開放服務(wù)中報關(guān)服務(wù)相關(guān)接口。

本文件適用于相關(guān)企業(yè)業(yè)務(wù)系統(tǒng)調(diào)用開放的服務(wù)接口進行進出口報關(guān)申報。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

DB3502/T117.1國際貿(mào)易“單一窗口”數(shù)據(jù)服務(wù)第1部分：總體技術(shù)要求

DB3502/T117.2國際貿(mào)易“單一窗口”數(shù)據(jù)服務(wù)第2部分：報關(guān)業(yè)務(wù)數(shù)據(jù)元

3術(shù)語和定義

本文件沒有需要界定的術(shù)語和定義。

4縮略語

下列縮略語適用于本文件。

AES：高級加密標準（AdvancedEncryptionStandard)

API：應(yīng)用程序編程接口（ApplicationProgrammingInterface）

CA：證書認證機構(gòu)(CertificateAuthority)

HTTP：超文本傳輸協(xié)議（HypertextTransferProtocol)

HTTPS：超文本傳輸安全協(xié)議（HypertextTransferProtocoloverSecureSocketLayer）

JSON：JavaScript對象標記(JavaScriptObjectNotation)

JWT：一種用于身份驗證和授權(quán)的開放標準（JSONWebToken）

SM系列算法：國家商用密碼算法

5基本要求

數(shù)據(jù)服務(wù)開放平臺的接口應(yīng)滿足以下基本要求：

——實用性:能與不同企業(yè)報關(guān)進行業(yè)務(wù)對接、完成數(shù)據(jù)交換；

——安全性:數(shù)據(jù)交換過程中保護國家秘密、商業(yè)秘密和個人隱私；

——時效性:能實時完成數(shù)據(jù)交換。

1

DB3502/T117.3—2023

6數(shù)據(jù)對接方式

數(shù)據(jù)對接方式包括：

——專線+HTTPS；

——HTTPS+身份認證。

7服務(wù)接口設(shè)計基本規(guī)定

服務(wù)接口命名規(guī)定

服務(wù)接口的名稱應(yīng)采用廈門“單一窗口”業(yè)務(wù)的中文描述進行命名，服務(wù)接口業(yè)務(wù)描述為服務(wù)接口

所屬領(lǐng)域以及業(yè)務(wù)含義描述。

服務(wù)接口編碼規(guī)定

服務(wù)接口編碼結(jié)構(gòu)如圖1所示，其中：

——服務(wù)版本：默認版本為V1，新版本則為V2，依次類推；

——業(yè)務(wù)分類：根據(jù)服務(wù)劃分的類別以英文字母進行命名，保證每個業(yè)務(wù)分類唯一；

——業(yè)務(wù)服務(wù)名稱：數(shù)字和字母組成的文本，保證服務(wù)接口提供方內(nèi)唯一。

Https://{域名}/api/v1/{bizName}/{service}

服務(wù)版本業(yè)務(wù)分類業(yè)務(wù)服務(wù)名稱

圖1服務(wù)接口編碼結(jié)構(gòu)

示例：https://{域名}/api/v1/dataQuery/HSCIQController

傳輸協(xié)議應(yīng)使用HTTP1.0/1.1標準或者HTTPS標準兩種方式。采用HTTPS協(xié)議時，服務(wù)方應(yīng)提供接口

調(diào)用需要的數(shù)字證書文件，證書文件應(yīng)為“單一窗口”數(shù)據(jù)服務(wù)開放平臺統(tǒng)一頒發(fā)的數(shù)字證書。

上下行服務(wù)接口說明

企業(yè)需要上報到數(shù)據(jù)服務(wù)開放平臺的數(shù)據(jù)，調(diào)用數(shù)據(jù)服務(wù)開放平臺相關(guān)的上行服務(wù)接口，數(shù)據(jù)服務(wù)

開放平臺需要提供給各企業(yè)的數(shù)據(jù)，由企業(yè)從下行服務(wù)接口中調(diào)用相應(yīng)的查詢接口獲取。其中，上行服

務(wù)接口以數(shù)據(jù)服務(wù)開放平臺作為數(shù)據(jù)接收方對應(yīng)的接口，下行服務(wù)接口以數(shù)據(jù)服務(wù)開放平臺作為數(shù)據(jù)

提供方對應(yīng)的接口。

接口技術(shù)類型

服務(wù)接口技術(shù)類型采用REST接口，使用GET或POST方法，返回報文數(shù)據(jù)格式為JSON格式。

交換數(shù)據(jù)類型

數(shù)據(jù)類型說明見DB3502/T117.2中數(shù)據(jù)元表示方法。

服務(wù)接口安全要求

2

DB3502/T117.3—2023

服務(wù)接口安全采用基于JWT開放標準（RFC7519）的簽名設(shè)計方式實現(xiàn)，本文中所有的服務(wù)接口在

傳輸過程中，均采用國密SM2、SM3等國產(chǎn)算法進行加密，通過使用支持國產(chǎn)加密算法的工具庫或框架來

實現(xiàn)對JWT的加密操作，在持久化存儲至數(shù)據(jù)庫過程中，則采用國產(chǎn)解密算法。

請求參數(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)

代碼名稱類型是否必填描述示例值

ContentTypeJSON是內(nèi)容類型為JSON，編碼類型為UTF-8application/json;charset=utf-8

ServiceVersionA..5是調(diào)用的接口版本1.0

TokenA..256是通過token服務(wù)獲取token—

表2請求參數(shù)數(shù)據(jù)結(jié)構(gòu)

代碼名稱類型是否必填描述示例值

ClientIDA..10是數(shù)據(jù)服務(wù)調(diào)用者身份標識—

EntTypeA2是數(shù)據(jù)服務(wù)調(diào)用者類型01

EntAccessTimeDateTime是數(shù)據(jù)服務(wù)調(diào)用時間—

數(shù)據(jù)服務(wù)調(diào)用者身份標識、服務(wù)標識、

簽名秘鑰由“單一窗口”數(shù)據(jù)服務(wù)開放

平臺向企業(yè)下發(fā)。參數(shù)簽名信息的生成

SignatureA..500否—

需要使用簽名秘鑰計算，計算的方式為

使用簽名秘鑰對請求者身份標識、服務(wù)

調(diào)用時間進行MD5加密獲得

對稱加密算法，支持：AES256、SM4，需

EncryptNameA..10否—

要加密時填寫

EncryptKeyA..512否對稱秘鑰—

IC卡卡號，需要業(yè)務(wù)簽名的接口必須填

IcCardNoA32否—

做業(yè)務(wù)的IC卡卡號

FormatA..40否業(yè)務(wù)節(jié)點的數(shù)據(jù)類型：默認JSON—

報文唯一標識，命名規(guī)范：EntID+yyyy-

MessageIdA..44是—

MM-ddHHmmss+4位自定義流水號

AccountNameA..33是實際業(yè)務(wù)方單一窗口登錄賬號—

ParamDataJSON是請求參數(shù)json字符串—

響應(yīng)數(shù)據(jù)結(jié)構(gòu)

響應(yīng)數(shù)據(jù)結(jié)構(gòu)見表3，示例見附錄A.2。

表3響應(yīng)數(shù)據(jù)結(jié)構(gòu)

代碼名稱類型是否必填描述示例值

ClientIDA..10是返回代碼—

RetTimeDateTime是返回時間—

3

DB3502/T117.3—2023

表3響應(yīng)數(shù)據(jù)結(jié)構(gòu)（續(xù)）

代碼名稱類型是否必填描述示例值

RetDataJSON是返回數(shù)據(jù)—

RetMsgA..500是返回消息—

數(shù)據(jù)服務(wù)調(diào)用者身份標識、服務(wù)標識、

簽名秘鑰由“單一窗口”數(shù)據(jù)服務(wù)開放

平臺向企業(yè)下發(fā)。參數(shù)簽名信息的生成

SignatureA..50否—

需要使用簽名秘鑰計算，計算的方式為

使用簽名秘鑰對請求者身份標識、服務(wù)

調(diào)用時間進行MD5或sm3加密獲得

對稱加密算法，支持：AES256、SM4，

EncryptNameA..10否—

需要加密時填寫

EncryptKeyA..512否對稱秘鑰—

數(shù)據(jù)結(jié)構(gòu)擴展字段定義

擴展字段（“FieldExtend”）內(nèi)容通過JSON文本進行定義，基礎(chǔ)數(shù)據(jù)結(jié)構(gòu)擴展字段定義見表4，示

例見附錄A.3。

注：請求參數(shù)和返回結(jié)果由于自貿(mào)區(qū)業(yè)務(wù)存在持續(xù)改進，本文件僅定義基礎(chǔ)數(shù)據(jù)結(jié)構(gòu)。

表4擴展字段定義

代碼名稱類型是否必填描述說明

ClientIDA..255是字段編碼—

FieldnameA..255是字段名稱—

fieldLengthN..5否字段長度—

fieldTypeA..50是字段類型—

fieldRequiredA1否字段是否必填—

fieldValueA..500否字段值—

8業(yè)務(wù)服務(wù)接口

業(yè)務(wù)流程描述

報關(guān)行報關(guān)流程見圖2。貨主/貨代報關(guān)流程見圖3。

4

DB3502/T117.3—2023

圖2報關(guān)行報關(guān)流程

圖3貨主/貨代報關(guān)流程

通用接口

8.2.1開放平臺認證服務(wù)

數(shù)據(jù)服務(wù)開放平臺采用Token認證，通過Token認證通用請求。請求方式為POST，請求參數(shù)說明見表

5，返回結(jié)果說明見表6，示例見附錄A.4.1.1，其中：

——Header：Content-Type:application/json;charset=UTF-8

5

DB3502/T117.3—2023

——接口地址：https://{域名}/api/v1/auth/tokens

表5請求參數(shù)說明

序號代碼名稱中文名稱類型是否必填說明

1ClientID客戶端IDA..255是—

2ClientSecret客戶端密碼A..256是—

表6返回結(jié)果說明

序號代碼名稱中文名稱類型是否必填說明

1RetCode返回代碼A3是—

2RetTime返回時間DateTime是—

3UserId用戶IDA.255是—

用戶Token，計算的方式為使用簽名秘鑰對請

4UserToken用戶TokenA..255是求者身份標識、服務(wù)調(diào)用時間進行MD5加密獲

得。

5ExpireTimeToken過期時間N..255是—

8.2.2用戶授權(quán)接口

對用戶訪問的數(shù)據(jù)服務(wù)進行服務(wù)權(quán)限的鑒定，判斷其是否有權(quán)限訪問該服務(wù)。請求方式為POST，請

求參數(shù)說明見表7，返回參數(shù)說明見表8，示例見附錄A.4.1.2，其中：

——Header：Content-Type:application/json;charset=UTF-8

——接口地址：https://{域名}/api/v1/access/accessList

表7請求參數(shù)說明

序號代碼名稱中文名稱類型是否必填說明

1UserID用戶IDAN..32是—

2UserName用戶名稱AN..50是—

3ServiceApp應(yīng)用名稱AN..32是—

4IPAddress訪問IP地址AN..50是—

5FieldExtend擴展字段JSON否—

表8返回參數(shù)說明

序號代碼名稱中文名稱類型是否必填說明

1UserID用戶IDAN..32是—

2UserName用戶名稱AN..50是—

3ServiceApp應(yīng)用名稱AN..32是—

4ServiceList訪問服務(wù)列表JSON是—

5IPAddress訪問IP地址AN..50是—

6FieldExtend擴展字段JSON否—

6

DB3502/T117.3—2023

8.2.3服務(wù)申請

企業(yè)在ERP或企業(yè)第三方應(yīng)用調(diào)用需要的服務(wù)接口時需要發(fā)送服務(wù)申請到開放平臺。請求方式為請

求方式為POST，請求參數(shù)說明見表9，返回結(jié)果說明見表10，示例見附錄A.4.1.3，其中：

——Header：Content-Type:application/json;charset=UTF-8

——接口地址：https://{域名}/api/v1/Serv/ServiceApply

表9請求參數(shù)說明

序號代碼名稱中文名稱類型是否必填說明

1ChannelId通道IdAN..36是—

時間戳yyyyMMddhhmmss，當前時間前后10分

2TimeStamp時間戳N14是

鐘內(nèi)有效

MD5.encode(通道ID+密鑰+timestamp+

3HashSign簽名AN32是

請求參數(shù))

表10返回結(jié)果說明

序號代碼名稱中文名稱類型是否必填說明

1ServiceList申請服務(wù)列表AN..10是—

2ServAccess服務(wù)訪問權(quán)限A..60是—

3SerTimeLimit服務(wù)時間權(quán)限AN..120是—

服務(wù)訪問次數(shù)權(quán)

4SerSumLimitAN..120否—

限

5FieldExtend擴展字段JSON否—

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ù)說明

序號代碼名稱中文名稱類型是否必填說明

1ChannelId通道IdAN..36是—

時間戳yyyyMMddhhmmss，當前時間前后10分

2TimeStamp時間戳N14是

鐘內(nèi)有效

MD5.encode(通道ID+密鑰+timestamp+

3HashSign簽名AN32是

請求參數(shù))

表12返回結(jié)果說明

序號代碼名稱中文名稱類型是否必填說明

1ServiceData數(shù)據(jù)內(nèi)容AN...120是—

7

DB3502/T117.3—2023

表12返回結(jié)果說明（續(xù)）

序號代碼名稱中文名稱類型是否必填說明

2dataUsing數(shù)據(jù)使用用途A..60是—

3dataTimeLimit數(shù)據(jù)時間范圍AN..120否—

4dataSumLimit數(shù)據(jù)使用次數(shù)AN..120否—

5DataUnit申請企業(yè)AN..120是—

6DataPUnit授權(quán)企業(yè)AN..120是—

7FieldExtend擴展字段JSON否—

8.2.5數(shù)據(jù)授權(quán)

企業(yè)對本企業(yè)數(shù)據(jù)授權(quán)給申請數(shù)據(jù)的企業(yè)進行授權(quán)服務(wù)，請求方式為POST，請求參數(shù)說明見表13，

返回結(jié)果說明見表14，示例見附錄A.4.1.5，其中：

——Header：Content-Type:application/json;charset=UTF-8

——接口地址：https://{域名}/api/v1/Serv/dataAccess

表13請求參數(shù)說明

序號代碼名稱中文名稱類型是否必填說明

1ChannelId通道IdAN..36是—

時間戳yyyyMMddhhmmss，當前時間前后10分

2TimeStamp時間戳N14是

鐘內(nèi)有效

MD5.encode(通道ID+密鑰+timestamp+

3HashSign簽名AN32是

請求參數(shù))

表14返回結(jié)果說明

序號代碼名稱中文名稱類型是否必填說明

1ServiceData數(shù)據(jù)描述AN...120是—

2dataAccess數(shù)據(jù)訪問策略A..60是—

數(shù)據(jù)訪問時間權(quán)

3dataTimeLimitAN..120否—

限

4dataSumLimit訪問次數(shù)權(quán)限AN..120否—

5accessFile授權(quán)協(xié)議文件AN..120是—

6FieldExtend擴展字段JSON否—

7ServiceData數(shù)據(jù)描述AN...120是—

下行服務(wù)接口

8.3.1通關(guān)參數(shù)查詢

企業(yè)通過服務(wù)接口獲得通關(guān)相關(guān)的參數(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/DicController

8

DB3502/T117.3—2023

表15請求參數(shù)說明

序號代碼名稱中文名稱類型是否必填說明

1DicName字典名稱A..255是示例：Dic_type_001，通關(guān)字典見附錄B

2UserToken用戶TokenA..255是—

3FieldExtend擴展字段JSON否—

注：請求參數(shù)存放請求令牌信息和字典參數(shù)名稱，所有字段都必須有，“是否必填”指字段內(nèi)容是否必填，非必填

字段可以為空。

表16返回結(jié)果說明

序號代碼名稱中文名稱類型是否必填說明

1DicItemCode字典項代碼A..255是—

2DicName字典名稱A..255是—

3DicItemName字典項名稱A..255是—

4DicItemShortName字典項簡稱A..255否—

5DicItemExtField擴展字段A..500否—

6DicItemExtName擴展字段名稱A..500否—

7DicItemExtField2擴展字段2A..500否—

8DicItemExtName2擴展字段2名稱A..500否—

9FieldExtend擴展字段JSON否—

8.3.2報關(guān)數(shù)據(jù)查詢

檢驗檢疫編碼查詢

企業(yè)通過服務(wù)接口獲得進出口商品的檢驗檢疫編碼。企業(yè)輸入商品編碼或名稱查詢檢驗檢疫編碼。

接口接收參數(shù)信息，并返回是否查詢成功，如成功能則返回該類商品的檢驗檢疫編碼；如不成功則返回

原因。請求方式為POST，詳細請求參數(shù)見表17，返回結(jié)果說明見表18，示例見附錄A.，其中：

——Header：Content-Type:application/json;charset=UTF-8

——接口地址：https://{域名}/api/v1/dataQuery/HSCIQController

表17請求參數(shù)說明

序號代碼名稱中文名稱類型是否必填說明

1CodeTS商品編碼A10是—

2GName商品名稱A..512否—

3UserToken用戶TokenA..255是—

4FieldExtend擴展字段JSON否—

表18返回結(jié)果說明

序號代碼名稱中文名稱類型是否必填說明

1CodeTS商品編碼A10否—

2GName商品名稱A..512否—

3CIQCode檢驗檢疫編碼AN..20是—

4CIQName檢驗檢疫名稱A..50是—

9

DB3502/T117.3—2023

表18返回結(jié)果說明（續(xù)）

序號代碼名稱中文名稱類型是否必填說明

5CIQType檢驗檢疫類型A..50否—

6FieldExtend擴展字段JSON否—

艙單通關(guān)狀態(tài)查詢

企業(yè)使用該服務(wù)接口查詢進出口艙單通關(guān)狀態(tài)信息。支持輸入進口/出口，提運單號、集裝箱號、

報關(guān)單號、運輸工具、航班航次號等查詢條件調(diào)用服務(wù)接口進行查詢，如果失敗，返回失敗原因，如果

成功，則返回運輸工具、艙單、報關(guān)單、物流狀態(tài)等信息。請求方式為POST，詳細請求參數(shù)見表19，返

回結(jié)果說明見表20，示例見附錄A.，其中：

——Header：Content-Type:application/json;charset=UTF-8

——接口地址：https://{域名}/api/v1/dataQuery/BillStatusController

注：該接口來源于艙單通關(guān)業(yè)務(wù)的服務(wù)接口規(guī)范，此處被報關(guān)業(yè)務(wù)服務(wù)所引用。

表19請求參數(shù)說明

序號代碼名稱中文名稱類型是否必填說明

1BillNo提運單號A..32否—

2IEFlag進出口標志A1否—

3TrafNo運輸工具代碼A..32否—

4ContaNo集裝箱號A..32否—

5RepNo報關(guān)單號N18是—

6VoyNo航次號A..32否—

7UserToken用戶TokenA..255是—

8FieldExtend擴展字段JSON否—

表20返回結(jié)果說明

序號代碼名稱中文名稱類型是否必填說明

境內(nèi)收發(fā)貨人代

1TradeCoSccA..10是—

碼

報關(guān)申報單位代

2AgentCodeA..18是—

碼

報關(guān)申報單位名

3AgentNameA..70是—

稱

報關(guān)申報單位社

4AgentSccA..18否—

會信用代碼

5CustomMaster申報地海關(guān)代碼AN..14是—

6BillNo提運單號A..32否—