DB3502-T 117.3-2023 國際貿易單一窗口數據服務 第3部分：報關服務接口

35.240CCS

L773502 DB3502/T

117.3—2023國際貿易"單一窗口"數據服務第

3

部分：報關服務接口Data

international

trade

Window—Part

3:

of

clearance

services

發(fā)布

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

布DB3502/T

117.3—2023 前言

.................................................................................

II引言

................................................................................

III1

...............................................................................

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

.....................................................................

13 術語和定義

.........................................................................

14 縮略語

.............................................................................

15 基本要求

...........................................................................

16 數據對接方式

.......................................................................

27 服務接口設計基本規(guī)定

...............................................................

28 業(yè)務服務接口

.......................................................................

4附錄

A（資料性） 接口示例............................................................

43附錄

B（資料性） 通關字典............................................................

61DB3502/T

117.3—2023 本文件按照GB/T

1.1—2020《標準化工作導則

第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。本文件是DB3502/T

117《國際貿易“單一窗口”數據服務》的第3部分。DB3502/T

117已經發(fā)布了以下部分：——第1部分：總體技術要求；——第2部分：報關業(yè)務數據元；——第3部分：報關服務接口。請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。本文件由中國(福建)自由貿易試驗區(qū)廈門片區(qū)管理委員會信息化服務中心提出。本文件由中國(福建)自由貿易試驗區(qū)廈門片區(qū)管理委員會歸口。()公司、廈門市人民政府口岸工作辦公室、廈門海事局、廈門出入境邊防檢查總站張建財、郭曉晨、張穎慧、陳劭彧IIDB3502/T

117.3—2023 DB3502/T

117范，擬由十七個部分組成?！?/p>

1

部分：總體技術要求；——第

2

部分：報關業(yè)務數據元；——第

3

部分：報關服務接口；——第

4

部分：快件業(yè)務數據元；——第

5

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

6

部分：運輸工具數據元；——第

7

部分：運輸工具服務接口；——第

8

部分：艙單業(yè)務數據元；——第

9

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

10

部分：跨境電商數據元；——第

11

部分：跨境電商服務接口；——第

12

部分：保稅業(yè)務數據元；——第

13

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

14

部分：服務目錄；——第

15

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

16

部分：數據服務流程；——第

17

部分：運維服務要求。持不同系統(tǒng)之間的集成和互操作性，確保數據傳遞的一致性和準確性，提高工作效率，降低維護成本，行和信息交換的高效實現(xiàn)。IIIDB3502/T

117.3—2023

1 范圍本文件規(guī)定了“單一窗口”數據服務開放平臺提供的數據開放服務中報關服務相關接口。本文件適用于相關企業(yè)業(yè)務系統(tǒng)調用開放的服務接口進行進出口報關申報。2規(guī)范性引用文件文件。DB3502/T

117.1國際貿易“”

第1部分：總體技術要求DB3502/T

117.2 國際貿易“”

第2部分：報關業(yè)務數據元3術語和定義本文件沒有需要界定的術語和定義。4 縮略語下列縮略語適用于本文件。AES：高級加密標準（Advanced

API：應用程序編程接口（Application

Interface）CA：證書認證機構(Certificate

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

Transfer

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

Transfer

Protocol

over

Secure

Layer）JSON：JavaScript對象標記(JavaScript

Object

JWT：一種用于身份驗證和授權的開放標準（JSON

Token）SM系列算法：國家商用密碼算法5基本要求數據服務開放平臺的接口應滿足以下基本要求：——實用性:能與不同企業(yè)報關進行業(yè)務對接、完成數據交換；——安全性:數據交換過程中保護國家秘密、商業(yè)秘密和個人隱私；——時效性:能實時完成數據交換。DB3502/T

117.3—20236 數據對接方式數據對接方式包括：——+HTTPS；——HTTPS+身份認證。7服務接口設計基本規(guī)定服務接口命名規(guī)定所屬領域以及業(yè)務含義描述。服務接口編碼規(guī)定服務接口編碼結構如圖1所示，其中：——服務版本：默認版本為V1，新版本則為V2，依次類推；——業(yè)務分類：根據服務劃分的類別以英文字母進行命名，保證每個業(yè)務分類唯一；——業(yè)務服務名稱：數字和字母組成的文本，保證服務接口提供方內唯一。Https://{域名}/api/v1/{bizName}/{service}服務版本

業(yè)務分類 業(yè)務服務名稱圖1 服務接口編碼結構https://{傳輸協(xié)議應使用標準或者HTTPS標準兩種方式。采用HTTPS協(xié)議時，服務方應提供接口調用需要的數字證書文件，證書文件應為“單一窗口”數據服務開放平臺統(tǒng)一頒發(fā)的數字證書。上下行服務接口說明務接口以數據服務開放平臺作為數據接收方對應的接口，下行服務接口以數據服務開放平臺作為數據提供方對應的接口。接口技術類型服務接口技術類型采用接口，使用GET或POST方法，返回報文數據格式為JSON格式。交換數據類型數據類型說明見DB3502/T

117.2中數據元表示方法。服務接口安全要求ClientIDA..10EntTypeA201EntAccessTimeDateTimeSignatureA..500

EncryptNameA..10AES256EncryptKeyA..512IcCardNoA32IC

IC

FormatA..40

JSONMessageIdA..44EntID+yyyy-

AccountNameA..33ParamDataJSON

json

ContentTypeJSON

JSON

UTF-8application/json;charset=utf-8A..51.0TokenA..256

ClientIDA..10RetTimeDateTimeDB3502/T

117.3—2023服務接口安全采用基于開放標準（RFC

7519）的簽名設計方式實現(xiàn)，本文中所有的服務接口在、SM3實現(xiàn)對JWT的加密操作，在持久化存儲至數據庫過程中，則采用國產解密算法。請求參數數據結構請求頭參數數據結構見表1，請求參數數據結構見表2，示例見附錄。表1請求頭參數數據結構表2請求參數數據結構響應數據結構響應數據結構見表3，示例見附錄A.2。表3 響應數據結構RetDataJSONRetMsgA..500SignatureA..50使用簽名秘鑰對請求者身份標識、服務

EncryptNameA..10AES256SM4EncryptKeyA..512ClientIDA..255FieldnameA..255fieldLengthN..5fieldTypeA..50fieldRequiredA1fieldValueA..500DB3502/T

117.3—2023表3 表3 響應數據結構（續(xù)）FieldExtendJSON4例見附錄。表4擴展字段定義8業(yè)務服務接口業(yè)務流程描述報關行報關流程見圖2/貨代報關流程見圖3。DB3502/T

117.3—2023圖2 報關行報關流程圖3貨主/貨代報關流程通用接口8.2.1開放平臺認證服務數據服務開放平臺采用TokenPOST5，返回結果說明見表6，示例見附錄A.4.1.1，其中：——Header：Content-Type:application/json;charset=UTF-8RetCodeA3RetTimeDateTimeUserId

IDA.255UserToken

A..255

ExpireTime

N..255UserID

IDAN..32UserNameAN..50ServiceAppAN..32ServiceListJSONIPAddress

IP

AN..50FieldExtendJSONUserID

IDAN..32UserNameAN..50ServiceAppAN..32IPAddress

IP

AN..50FieldExtendJSONClientID

IDA..255ClientSecretA..256DB3502/T

117.3—2023——接口地址：https://{}/api/v1/auth/tokens表5 請求參數說明表6 返回結果說明8.2.2 用戶授權接口POST求參數說明見表7，返回參數說明見表8，示例見附錄A.4.1.2，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/access/accessList表7 請求參數說明表8 返回參數說明ServiceListAN..10ServAccessA..60SerTimeLimitAN..120SerSumLimitAN..120FieldExtendJSONChannelId

IdAN..36TimeStampN14

10

HashSignAN32MD5.encode(

ChannelId

IdAN..36TimeStampN14

10

HashSignAN32MD5.encode(

ServiceDataAN...120DB3502/T

117.3—20238.2.3 服務申請企業(yè)在或企業(yè)第三方應用調用需要的服務接口時需要發(fā)送服務申請到開放平臺。請求方式為請求方式為POST，請求參數說明見表9，返回結果說明見表10，示例見附錄，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/Serv/ServiceApply表9 請求參數說明表10 返回結果說明8.2.4 數據申請用期限、次數、范圍等，請求方式為POST，請求參數說明見表11，返回結果說明見表12，示例見附錄A.4.1.4，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/Serv/dataApply表11 請求參數說明表12 返回結果說明ServiceDataAN...120dataAccessA..60dataTimeLimitAN..120dataSumLimitAN..120accessFileAN..120FieldExtendJSONServiceDataAN...120dataUsingA..60dataTimeLimitAN..120dataSumLimitAN..120DataUnitAN..120DataPUnitAN..120FieldExtendJSONChannelId

IdAN..36TimeStampN14

10

HashSignAN32MD5.encode(

DB3502/T

117.3—2023表12返回結果說明（續(xù)）8.2.5 數據授權企業(yè)對本企業(yè)數據授權給申請數據的企業(yè)進行授權服務，請求方式為POST，請求參數說明見表，返回結果說明見表14，示例見附錄——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/Serv/dataAccess表13 請求參數說明表14 返回結果說明下行服務接口8.3.1 通關參數查詢式為POST，詳細請求參數見表15，返回結果說明見表16，示例見附錄，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/dictype/DicControllerDicItemCodeA..255DicNameA..255DicItemNameA..255A..255DicItemExtFieldA..500A..500

A..500DicItemExtName2

A..500FieldExtendJSONDicNameA..255Dic_type_001

UserToken

A..255FieldExtendJSONCodeTSA10—GNameA..512—UserToken

A..255—FieldExtendJSON—CodeTSA10—GNameA..512—CIQCodeAN..20—CIQNameA..50—DB3502/T

117.3—2023表15請求參數說明表16 返回結果說明8.3.2 報關數據查詢 檢驗檢疫編碼查詢企業(yè)通過服務接口獲得進出口商品的檢驗檢疫編碼。企業(yè)輸入商品編碼或名稱查詢檢驗檢疫編碼。原因。請求方式為POST，詳細請求參數見表17，返回結果說明見表18，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/dataQuery/HSCIQController表17 請求參數說明表18 返回結果說明TradeCoSccA..10AgentCodeA..18AgentNameA..70AgentSccA..18CustomMasterAN..14BillNoA..32IEDateDateBillNoA..32IEFlagA1TrafNoA..32ContaNoA..32RepNoN18VoyNoA..32UserToken

A..255FieldExtendJSONCIQTypeA..50—FieldExtendJSON—DB3502/T

117.3—2023表18 返回結果說明（續(xù)） 艙單通關狀態(tài)查詢企業(yè)使用該服務接口查詢進出口艙單通關狀態(tài)信息。支持輸入進口/出口，提運單號、集裝箱號、POST回結果說明見表20，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/dataQuery/BillStatusController表19 請求參數說明表20 返回結果說明10TrafModeA1TrafNameA..5010VoyNoA..3211ManualNoA..1212DeclTrnRelA1

13TradeNameA..7014IEFlagA1

15PassStatusA216FieldExtendJSONTaxNoA..10GNameA..255EtaxRateN..12,2EtaxCurrRateN..12,2EtaxTempRateN..12,2ItaxRateN..12,2FieldExtendJSONCodeTSN10—TaxNoA..10—GNameA..255—UserToken

A..255FieldExtendJSONDB3502/T

117.3—2023表20 返回結果說明（續(xù)） 進出口稅率查詢POST21說明見表22，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/dataQuery/TaxController表21請求參數說明表22 返回結果說明11CodeTsA10GNameA..512LicenceNoA..20FirstUnitA3FirstUnitCNA..50SecondUnitA3SecondUnitCNA..50GModelA..255FieldExtendJSONCodeTSAN10GNameAN..512LicenceNoA..20UserToken

A..255FieldExtendJSONGNameAN..512CodeTsA10DB3502/T

117.3—20第一二計量單位查詢HSPOST2324，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/report/UnitController表23 請求參數說明表24返回結果說明進出口商品查詢HSPOST，請求參數說明見表25，返回結果說明見表26，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/report/HSGoodsController表25 請求參數說明12CodeTsA10GNameA..512LicenceNoA..20FirstUnitA3FirstUnitCNA..50SecondUnitA3SecondUnitCNA..50GTypeA3FieldExtendJSONRepNoN18TradeCodeA..18AgentCodeA..18Token

A..256FieldExtendJSONLicenceNoA..20UserToken

A..255FieldExtendJSONDB3502/T

117.3—2023表25 請求參數說明（續(xù)）表26返回結果說明 報關單狀態(tài)查詢POST數說明見表27，返回結果說明見表28，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/report/RepStatusController表27請求參數說明13RepNoN18TradeCode

IDA..18RepTradeCode

IDA..18Token

A..256TradeCoSccA..10RepStartTimeDateRepEndTimeDateBillNoA..32UserToken

A..25510FieldExtendJSONCusCiqNoA..18TradeCoSccA..10RcvgdTradeSccA..18AgentCodeA..10AgentNameA..70statusCodeA1StatusNameA..50StatusDescA..512FieldExtendJSONDB3502/T

117.3—2023表28返回結果說明報關單明細查詢POST2930-48A.——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/report/RepController表29 請求參數說明表30 進口/出口報關單表頭14AgentSccA..18OwnerCodeA..18OwnerNameA..70OwnerCodeSccA..1810CoOwnerA111CustomMasterA..112BillNoA..3213IEDateDate14DistinatePortA..615TrafModeA116TrafNameA..5017VoyNoA..3218TradeAreaCodeA..319TradeCountryA..320IEPortA..621ContrNoA..3222TradeModeA..423CutModeA..324ManualNoA..1225LicenseNoA..2026WrapTypeA..227PackNoAN..91515DB3502/T

117.3—2023表30 進口/（續(xù)）28grossWetN..19,529NetWtN..19,530TransModeA131RellIdN1832RelmanNoA..1233BonNoA..3234CusFieA..25535FeeCurrA..336FeeMarkA1：率；37FeeRateN..16,438OtherCurrA..339OtherMarkA1：率；40OtherRateN..16,441InsurCurrA..342InsurMarkA1：率；43InsurRateN..16,444DeclTrnRelA145InRatioAN..246ApprNoA..3247PreEntryIdA..1848PromiseItemsA..3249NoteSA..25550TradeNameA..7051IEFlagA152BillTypeA1

53CopNoA..4054DecBpIdA..1055DecBpNoA..13DB3502/T

117.3—2023表30 進口/（續(xù)）1656CusRemarkA..64

57MarkNoA..40058DespPortCodeA..859EntyPortCodeA..860GoodsPlaceA..10061BLNo

A..5062InspOrgCodeA..1063SpecDeclFlagA..1064PurpOrgCodeA..1065DespDateDate66CmplDschrgDtDate67lagA..268VsaOrgCodeA..1069OrigBoxFlagA170DeclareNameA..1071OrgCodeA..10DB3502/T

117.3—2023表30進口/（續(xù)）1772DomesticConsigneeEnameA..40073ddrA..50074nameA..25575odeA..5076nameA..40077CorrelationNoA..50078OwnerCiqCodeA..1079DeclCiqCodeA..1080IsCopPromiseA181TradeCiqCodeA..1082FieldExtendJSONClassMarkA1CodeTSA..10ContrItemAN..19

DeclPriceN..19,5

z(15).z(4)DeclTotalN..19,5

z(17).z(2)DutyModeA1ExgNoA..30ExgVersionAN..8FactorN..11,310FirstUnitA..311FirstQtyN..19,512GUnitA..3DB3502/T

117.3—2023表30 進口/（續(xù)）表31 進口/出口報關單表體1813GModelA..255

5014GNameA..255

5015GNoAN..19

16GQtyN..19,517OriginCountryA..3

originalCountry

originalCountry

18SecondUnitA..319SecondQtyN..19,520TradeCurrA..321UseToA..222WorkUsdN..19,4

z(17).z(2)23A..3

24CIQCodeA..2025A..10026OrigPlaceCodeA..5027PurposeA..128ProdValidDtA..20yyyy-MM-dd29ProdQgpA..2030GoodsAttrA..2031StuffA..40032UncodeUN

A..2033DangNameA..8034DangPackTypeA..135DangPackSpecA..2436EngManEntCnmA..10037NoDangFlagA138DestCodeA..839GoodsSpecA..200040GoodsModelA..200041GoodsBrandA..2000DB3502/T

117.3—2023表31 進口/（續(xù)）1942ProduceDateDateyyyy-MM-dd,43ProdBatchNoA..200044DistrictCodeA..545CiqNameA..50

46MnufctrRegnoA..2047A..15048RcepOrigPlaceCodeA..349FieldExtendJSONCusCiqNoA..18AttSeqNoAN..10AttTypeCodeA..8A..2USFieldExtendJSONContaNoA..32ContainerMdA..32GoodsNoA..2551,3LclFlagA1GoodsContaWtN..19,5FieldExtendJSONCusCiqNoA..18FormSeqNoAN..10AcmpFormCodeA1AcmpFormNoA..32FieldExtendJSONDB3502/T

117.3—2023表31 進口/（續(xù)）表32 報關單集裝箱表33 隨附單證表34報關單隨附單據關系20AttEdocNoA..171.

17

2.

14

3.

17

OpNoteA..255EntOrigFileNameA..500BizTypeCodeA..8DECEDOC：報關單；DECMOD10A..2：補傳；11CertNoA..50

CusCiqNoA..18FormSeqNoAN..10EcoRelSeqNoAN..10IEFlagA1CertTypeA..3CertNOA..64GoodsNoAN..10EcoGNoAN..19FieldExtendJSONCusCiqNoA..18WrapTypeA..2PackQtyN..19,5FieldExtendJSONDB3502/T

117.3—2023表34報關單隨附單據關系（續(xù)）表35 報關單其他包裝表36 原產地對應關系21CusCiqNoA..18GoodsNoAN..10GoodsLimitSeqNoAN..10

AN..10LicenceNoA..20LicTypeCodeA..5VinNo

A..100BillLadDateDateyyyy-mm-ddhh-mm-ssQualityQgpA..10010MotorNoA..10011VinCodeVINA..2012ChassisNoA..2013InvoiceNumN..19,514ProdCnnmA..50015ProdEnnmA..50016ModelEnA..50017PricePerUnitA..2018InvoiceNoA..3019FieldExtendJSONCusCiqNoA..18GoodsNoAN..10GoodsLimitSeqNoAN..10LicenceNoA..20LicTypeCodeA..5LicTypeNameA..50A..2LicWrtofQtyN..19,5LicWrtofQtyUnitA..310FieldExtendJSONDB3502/T

117.3—2023表37 報關單商品許可證信息表38 報關單商品許可證

22CusCiqNoA..18MarkLobSeqNoAN..10AttachTypeA..2AttachNameA..80EdocSizeA..12AttachmentA..100000

base64FieldExtendJSONCusCiqNoA..18EntQualifSeqNoAN..10EntQualifNoA..20EntQualifTypeCodeA..5EntQualifTypeNameA..200BizTypeA..10

FieldExtendJSONCusCiqNoA..18AN..10A..20UseOrgPersonTelA..20FieldExtendJSONCusCiqNoA..18FirIDateDateyyyy-mm-ddhh-mm-ssGuidNoA..36DB3502/T

117.3—2023表39 企業(yè)資質信息表40 進口/出口報關單使用人信息表41 標記號碼附件信息表42 報稅單表頭23GoodsNoAN..10AgreementIdA..3AntidumpingA1AntisubsidyA1DutyValueN..21,7DutyRateN..21,7QtyDutyRateN..21,7RegRateN..21,7QtyRegRateN..21,710TaxRateN..21,711AntidumpingRateN..21,712AntisubsidyRateN..21,713TrashfundRateN..21,714FieldExtendJSONTransformNoA..18TrnPreIdA..18TurnNoA..18IEFlagA1TransNoA..16ESealFlagA1GoodsNoAN..10DetailSeqNoAN..10TaxTypeA1RealTaxN..17,2FieldExtendJSONTaxNoA..18FieldExtendJSON2424DB3502/T

117.3—2023表42報稅單表頭（續(xù)）表43 報稅單表體表44 稅費計征結果表45 轉關單表頭TransFlagA..21G1T1E1P其中“1P”的轉關類型只在出口提前轉關單時可選擇，其余轉關類型可以在進口或出口提前TransTypeA..2

A110TrafCustomsNoA..1311A..10012A..3213A..10014A..915TransApplCodeA..1016TransApplNameA..25517TransApplSccA..1818ContaCountAN..619ContaIniCountAN..620ContaEmptyCountAN..621ValidDateDate22NoteA..80023FieldExtendJSONTransformNoA..18BillSeqNoAN..10DB3502/T

117.3—2023表45 轉關單表頭（續(xù)）表46 轉關單表體()25TransformNoA..18BillSeqNoAN..10ContaSnAN..10ContaNoA..100ContainerMdCodeA1SealNoA..128SealNumAN..6A..100TransWeightN..14,410SealQtyA..411FieldExtendJSONTrafModeA1ShipIdA..32ShipNameEnA..255VoyNoA..32BillNoA..32ContaCountAN..6IEDateDate10FieldExtendJSONTransformNoA..18BillSeqNoAN..10GoodsNoAN..10ContaSnAN..10ContaNoA..32ContaGoodsCountAN..9N..14,4FieldExtendJSONDB3502/T

117.3—2023表46 轉關單表體(提單)（續(xù)）表47進口/出口提運單集裝箱表表48 進口/出口提運單集裝箱商品裝配表 出口箱碼頭放行查詢企業(yè)通過服務接口獲得出口報關單所關聯(lián)出口提運單號的碼頭放行信息。企業(yè)輸入報關單號或出口提運單號查詢碼頭放行信息。接口接收參數信息，并返回是否查詢成功，如成功能則返回下列參數；26EntranceFlagA1EntranceDateDateTimeDockReceiveTimeDateTimeCustomerReleaseTimeDateTimeDockReleaseFlagA1DockReleaseTimeDateTimeShipmentFlagDateTimeShipmentTimeDateTimeFieldExtendJSONRepNoN18BillNoA..32UserToken

A..255FieldExtendJSONRepNoN18BillNoA..32UserToken

A..255UnshipFlagA12727DB3502/T

117.3—2023POST49，返回結果說明見表50，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/feedback/DockReleaseController表49請求參數說明表50 返回結果說明 進口箱海關放行查詢企業(yè)通過服務接口獲得進口報關單所關聯(lián)出口提運單號的碼頭放行信息。企業(yè)輸入報關單號或進口提運單號查詢碼頭放行信息。接口接收參數信息，并返回是否查詢成功，如成功能則返回下列參數；POST51，返回結果說明見表52，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/feedback/CustomerReleaseController表51 請求參數說明表52 返回結果說明UnshipTimeDateTimeCustomerReleaseFlagA1CustomerReleaseTimeDateTimeDockReleaseFlagDateTimeDockReleaseTimeDateTimeDepartureFlagA1DepartureDateDateTimeFieldExtendJSONRepNoN18BillNoA..32ContaNoA..11UserToken

A..255PlaceFlagA1DockCodeA..10FieldExtendJSONDB3502/T

117.3—2023表52返回結果說明（續(xù)）0 查驗箱移箱/5354例見附錄A.0，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/feedback/BoxCheckController表53請求參數說明表54返回結果說明1進箱/截箱時間查詢檢驗檢疫編碼；如不成功則返回原因。請求方式為POST，請求參數說明見表55，返回結果說明見表56，示例見附錄A.1，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/feedback/AnchorkController28AgentNameA..70AgentCodeA..18TradeCoSccA..18DeclDateDateyyyy-mm-ddBillNoA..32VoyNoA..32UserToken

A..255FieldExtendJSONPreAnchorTimeDateTimePermitEntTimeDateTimeExpireBoxTimeDateTimeDateTimeExpireEntTimeDateTimeFieldExtendJSON船名A..30VoyNo航次A..32UserToken

A..255TradeCoSccA..18NoticeDateDate2929DB3502/T

117.3—2023表55 請求參數說明表56返回結果說明8.3.3 反饋回執(zhí) 報關回執(zhí)單POST57見表58，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/feedback/RepBackController表57請求參數說明表58 返回結果說明ChannelFlagA1

NoteA..800DeclPortA..4AgentNameA..70DeclareNoA..32CusFieA..8BondedNoA..3210IEDateDate11PackNoAN..912BillNoA..32DB3502/T

117.3—2023表58 返回結果說明（續(xù)）30VoyNoOrShipNoA..17TrafNoA..35ocumentA..35tDocumentA..35A..64ReceiptTypeCodeA..501ReceiptTypeDetailA..512FieldExtendJSONTrafModeA1BillNoAN..32VoyNoA..32ocumentA..35UserToken

A..255FieldExtendJSON13TrafModeA114VoyNoA..3215DeclDateDate16FieldExtendJSONVoyNoA..17DB3502/T

117.3—2023表58 返回結果說明（續(xù)）艙單運抵報告狀態(tài)企業(yè)查詢運抵報告狀態(tài)信息接口用于企業(yè)ERP系統(tǒng)對接“單一窗口”平臺，實現(xiàn)企業(yè)查詢運抵報告狀態(tài)信息查詢服務。請求方式為POST，請求參數說明見表59，返回結果說明見表60-61，示例見附錄A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/feedback/BorderQueryController表59 請求參數說明表60 艙單運抵業(yè)務報文體（提單）表61 艙單運抵業(yè)務報文體（集裝箱）31TrafNoA..35ContainerNoA..17A..64ReceiptTypeCodeA..501ReceiptTypeDetailA..512FieldExtendJSONEntNameA..100EntUnicodeAN..18EntCodeCusA..20CreditLevelA1A1FieldExtendJSONEntNameA..100EntUnicodeAN..18EntCodeCusA..20UserToken

A..255DB3502/T

117.3—2023表61艙單運抵業(yè)務報文體（集裝箱）（續(xù)）8.3.4 企業(yè)信息查詢回原因。請求方式為POST，請求參數說明見表62，返回結果說明見表63，示例見附錄，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/feedback/EntCodeController表62請求參數說明表63返回結果說明上行服務接口8.4.1進出口報關申報進出口貨物申報接口用于企業(yè)ERP系統(tǒng)對接“單一窗口”平臺，實現(xiàn)貨物電子數據報關申報服務。請求方式為POST，請求參數說明見表64-79，返回結果說明見表80，示例見附錄A.4.3.1，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/dataUpload/TradeReportController32OperTypeAN..50ADD

BusAppNoAN..50TradeCodeA..100TradeNameA..512PreEntNoA..18EntryTypeAN1TaxUnitAN..36DistrictCodeA..5ContrNoA..3210ManualNoA..1211ApprNoA..3212LicenseNoA..2913TransNameA..2614VoyNoA..3215BillNoA.3216WrapTypeN217TrafModeA118TransModeA119TradeModeA..420CutModeA321IEFlagA122PackNoN..923NetWtN..19,524GrossWetN..19,525FeeMarkA126FeeRateN..19,527FeeCurrn328InsuranceMarkA129InsuranceRateN..19,530InsuranceCurrencyA331OtherMarkA132OtherRateN..19,533OtherCurrN334PayModeA135InRatioN..21,736IEDateDateDB3502/T

117.3—2023表64報關單表頭信息3337NoteA..25538StatusA..10DRAFT:39GjBillTypeA..1040AgentCodeA..1841AgentNameA..7042CustomMasterA443DistinatePortA..644IEPortA445OwnerCodeA..1846OwnerNameA..6047TradeCountryA348InRatioN..21,749BusinessTradeCodeA..1050BusinessTradeNameA..6051AN..1852AgentCodeSccAN..1853OwnerCodeSccAN..1854CopCodeSccAN..1855PromiseItmesAN..3256TradeAreaCodeN357RelIdN1858RelManNoAN..1259BonNoAN..3260CusFieAN..861BillTypeA162IsSzA1

63CheckFlowA1DB3502/T

117.3—2023表64 報關單表頭信息（續(xù)）3464TaxAaminMarkA165MarkNoA..40066DespPortCodeA..867EntyPortCodeA..868GoodsPlaceA..10069BLNo

A..5070InspOrgCodeA..10施檢機構，對本批貨物實施檢驗檢疫的機構71SpecDeclFlagA..1072PurpOrgCodeAN..1073DespDateDate74CmplDschrgDtDate75CorrelationReasonFlagAN..276VsaOrgCodeAN..1077OrigBoxFlagA1

78NoOtherPackA179OrgCodeA..1080OverseasConsignorCodeA..5081AN..15082AN..10083OverseasConsignorAddrAN..10084OverseasConsigneeCodeAN..5085AN..4003535DB3502/T

117.3—2023表64 報關單表頭信息（續(xù)）86TradeEnNameAN..40087CorrelationNoA..50088OwnerCiqCodeA..1089TradeCiqCodeAN..1090DeclCiqCodeAN..1091IsZbzjAN192IsPromiseAN193DeclTrnRelAN10/94TwoStepTypeAN10/95IsStepSzAN196IsStepSjAN197IsStepSsAN198WarehousingNoAN..5099UserToken

A..255100FieldExtendJSONGoodsNoN..9GoodsHsCodeN10MaterialNoA..30GoodsCnNameAN..255GoodsModelAN..255ContrItemN..5QuantityN..19,4QuantityUnitN3UnitPriceN..15,410TotalPriceN..17,211CurrencyN3DB3502/T

117.3—2023表64 報關單表頭信息（續(xù)）表65報關單表體信息3612FirstQuantityN..19,413FirstUnitN314SecondQuantityN..19,415SecondUnitN316OriginCodeAN317UseAN218DutyModeN119ProcessionChargesN..17,220GoodsVersionN..821ClassMarkAN122GjItemN..923N324CIQCodeAN..2025AN..10026OrigPlaceCodeAN..5027PurposeAN..428ProdValidDtAN..2029ProdQgpN..2030GoodsAttrAN..2031StuffAN..40032UnCodeUN

AN..2033DangNameAN..8034DangPackTypeAN..435DangPackSpecAN..2436EngManEntCnmAN..10037NoDangFlagAN..138DestCodeAN..839GoodsSpecAN..20040CiqGoodsModelAN..20041GoodsBrandN..200042ProduceDateN..200043ProdBatchNoAN..20044DistrictCodeAN..545CiqNameAN..5046MnufctrRegnoAN..20DB3502/T

117.3—2023表65 報關單表體信息（續(xù)）37EntNameA..100EntUnicodeAN..18EntCodeCusA..20CreditLevelA1A1FieldExtendJSONDocuCodeAN1CertCodeAN..32DecGNoN..2EcoGNoN..9FieldExtendJSONDocuCodeAN1DocAttachedNameAN..100CertCodeAN..32<01>FieldExtendJSONAppCertCodeAN..50ApplOriAN..50ApplCopyQuanAN..50FieldExtendJSONGoodsNoN..9LicTypeCodeAN..547AN..15048FieldExtendJSON3838DB3502/T

117.3—2023表65 報關單表體信息（續(xù)）表66箱子信息表67 單證信息表68原產地證序號表69表68原產地證序號表70 許可證信息LicenceNoAN..20LicTypeCodeAN..5VinNo

AN..100BillLadDaten8QualityQgpAN..100MotorNoAN..100VinCodeVINAN..20ChassisNoAN..20InvoiceNumN..19,510ProdCnnmAN..50011ProdEnnmAN..50012ModeEnAN..50013PricePerUnitAN..2014FieldExtendJSONLicenceNoAN..40AN..2LicWrtofQtyAN..20FieldExtendJSONEntQualifNoAN..40EntQualifTypeCodeAN..5FieldExtendJSONPackQtyN..19,5PackTypeAN..20FieldExtendJSONDB3502/T

117.3—2023表70許可證信息（續(xù)）表71 許可證

VIN

信息表72其他包裝信息表73企業(yè)資質信息39AN..1TrafCustomsNoAN..13AN..30AN..32ESealFlagAN..1

AN..10AN..70ValidTimeAN..8yyyy-mm-ddTrnTypeAN..10/10TransFlagAN..2AA:1K:1S:1P:1G:1E:11FieldExtendJSONAttachNameAN..80AttachTypeAN..2AttachmentAN..max

Convert.ToBase64String(Java

FieldExtendJSONAN..20UseOrgPersonTelAN..20FieldExtendJSONDB3502/T

117.3—2023表74 使用人信息表75 標記號碼附件表76轉關單表頭40ContaSnN..9ContaNoAN..32SealNoAN..128SealQtyN..4TransWeight

KGN..9,4ContaModelAN..4A..30FieldExtendJSONBizRelNoAN..50EtNoAN..50PreEntNoAN..18RepNoN18BillNoAN..50CusStatusCodeA1CusStatusNameA..200NoticeDateDateTimeShipIdAN..32ShipNameEnAN..255VoyageNoAN..32BillNoAN..32IEDateDateFieldExtendJSONContaSnN..9ContaNoAN..32GNoN..19ContaGoodsCountN..9N..19,5FieldExtendJSON4141DB3502/T

117.3—2023表77轉關單箱信息表78轉關單箱貨關系表79轉關單箱貨關系表80 返回結果說明IEDateDate10NoteSAN..25511FieldExtendJSONDB3502/T

117.3—2023表80 返回結果說明（續(xù)）42DB3502/T

117.3—2023附錄 A（資料性）接口示例A.1 請求參數數據示例{"EntId":

"1234567802","EntType":

"01","Signature":

"EncryptName":

"EncryptKey":

"fddde323231245","EntAccessTime":

"Format":

"JSON","MessageId":

"AccountName":

"123456789","IcCardNo":

"ParamData":

}A.2 響應數據示例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":""43DB3502/T

117.3—2023}A.3 數據結構擴展字段示例{dicExt:

[{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":

"UserToken":"ZVHG4duTbeUDwvwJGqFzMI4fM5IE+vJ+/px7OcAU5q+6WfT1CagBhpa\r\n761xg8er45wBYyPJXnP1vj","ExpireTime":

"7200"}}A.4.1.2 用戶授權接口示例{"RetCode":

"200","retData":

{"UserID":

"UserName":

"外代公司"ServiceApp":

"customsDeclarationBusiness",44DB3502/T

117.3—2023"ServiceList":"v1/dataQuery/HSCIQController;v1/dataQuery/BillStatusController;v1/dataQuery/TaxController;v1/report/UnitController","IPAddress":

"

50","FieldExtend":

"{}"}}A.4.1.3 服務申請示例{"RetCode":

"200","retData":

{"ServAccess":

"ALL","ServiceList":"v1/dataQuery/HSCIQController;v1/dataQuery/BillStatusController;v1/dataQuery/TaxController;v1/report/UnitController","SerTimeLimit":

"SerSumLimit":

"20","FieldExtend":

"{}"}}A.4.1.4 數據申請示例{"RetCode":

"200","retData":

{"dataUsing":

"本企業(yè)數據回流","SerTimeLimit":

"SerSumLimit":

"20","DataUnit":

"91310230MA1AAAAAA4","DataPUnit":

"ServiceData":

{"CodeTs":

"0101210010","CName":

"種用玉米","LicenceNo":

"FirstUnit":

"12","FirstUnitCN":

"","SecondUnit":

"11","SecondUnitCN":

"袋","GType":

"999"},"FieldExtend":

"{}"}45DB3502/T

117.3—2023}A.4.1.5 數據授權示例{"RetCode":

"200","retData":

{"dataTimeLimit":

"dataSumLimit":

"20","accessFile":

"A-CUSTOMERS-SERVICE-20230909","dataAccess":

"91310230MA1AAAAAA4","ServiceData":

{"CodeTs":

"0101210010","CName":

"種用玉米","LicenceNo":

"FirstUnit":

"12","FirstUnitCN":

"","SecondUnit":

"11","SecondUnitCN":

"袋","GType":

"999"}

}

},"FieldExtend":

"{}"A.4.2 下行服務接口示例A.4.2.1 通關參數查詢示例{"RetCode":

"200","RetData":

{"DicS":

[{"DicName":

"企業(yè)產品許可類別代碼表","DicItemCode":

"101","DicItemName":

"檢疫處理單位審批","DicItemShortName":

"DicItemExtField":

"A","DicItemExtField2":

"FieldExtend":

"{}"},

{"DicName":

"企業(yè)產品許可類別代碼表","DicItemCode":

"304","DicItemName":

"出境水生動物養(yǎng)殖場/包轉場檢驗檢疫注冊登記","DicItemShortName":

46DB3502/T

117.3—2023"DicItemExtField":

"A","DicItemExtField2":

"FieldExtend":

"{}"}]}}A.4.2.2 報關數據查詢示例A. 檢驗檢疫編碼查詢示例{"RetCode":

"200","retData":

{"CodeTS":

"0101210010","GName":

"改良種用瀕危野馬","CIQCode":

"0101210010999","CIQName":

"改良種用瀕危野馬","CIQType":

"PQ","FieldExtend":

"{}"}}A. 艙單通關狀態(tài)查詢示例{"RetCode":

"200","retData":

{"TradeCoScc":

"TCNYY0007892"，"AgentCode":

，"AgentName":

"海順豐船務有限公司"，"AgentScc":

"45454xxx9999333"，"CustomMaster":

"廈門海關","BillNo":

"Ex98228392382","IEDate":

"2021-12-15","TrafMode":

"海運"TrafName":

"海豐9號","VoyNo":

"JK233S","ManualNo":

"DeclTrnRel":

"1","TradeName":

"永豐船運"IEFlag":

"I","PassStatus":

"11","FieldExtend":

"{}"}47DB3502/T

117.3—2023}A. 進出口稅率查詢示例{"RetCode":

"200","retData":

{"TaxNo":

"6307901010","GName":

"醫(yī)療或外科口罩","ETaxRate":

"6%","ETaxCurrRate":

"92%","ETaxTempRate":

"98%","ITaxRate":

"9%","FieldExtend":

"{}"}}A. 第一二計量單位查詢示例{"RetCode":

"200","retData":

{"CodeTS":

"0101210010","GName":

"種用玉米","LicenceNo":

"FirstUnit":

"12","FirstUnitCN":

"","SecondUnit":

"11","SecondUnitCN":

"袋","GModel":

"","FieldExtend":

"{}"}}A. 進出口商品查詢示例{"RetCode":

"200","retData":

{"CodeTs":

"0101210010","CName":

"種用玉米","LicenceNo":

"FirstUnit":

"FirstUnitCN":

"千克"SecondUnit":

"11",

"袋",48DB3502/T

117.3—2023"GType":

"FieldExtend":

"{}"}}A. 報關單狀態(tài)查詢示例{"RetCode":

"200","retData":

{"statusCode":

"1","StatusName":

"已保存"StatusDesc":

"已處理，等候審批","FieldExtend":

"{}"}}A. 報關單明細查詢示例{"RetCode":

"200","retData":

{"DecMessage":

{"DecHead":

{"CusCiqNo":

"統(tǒng)一編號"TradeCoScc":

"63078701018","RcvgdTradeScc":

"境內收發(fā)貨人社會信用代碼","AgentCode":

"AgentName":

"海順豐船務有限公司","AgentScc":

"OwnerCode":

"消費使用單位（進口）/生產銷售單位（出口）代碼","OwnerName":

"消費使用單位（進口）/生產銷售單位（出口）名稱","OwnerCodeScc":

"消費使用單位","CoOwner":

"企業(yè)性質代碼","CustomMaster":

"申報地海關代碼","BillNo":

"AUT29390239223","IEDate":

"2021-10-18","DistinatePort":

"經停港","TrafMode":

"A","TrafName":

"海豐9號","VoyNo":

"JK233S","TradeAreaCode":

"貿易國（地區(qū)）代碼（海關）"TradeCountry":

"啟運國","IEPort":

"","ContrNo":

"合同協(xié)議號（海關）",49DB3502/T

117.3—2023"TradeMode":

"CutMode":

"征免性質代碼","ManualNo":

"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":

"內銷比率","ApprNo":

"批準文號","PreEntryId":

"","PromiseItems":

"承諾事項","NoteS":

"備注","TradeName":

"境內收發(fā)貨人名稱","IEFlag":

"I","BillType":

"備案清單類型","CusRemark":

"報關單類型標記","CopNo":

"企業(yè)內部編號"DecBpId":

"報關員編號"DecBpNo":

"報關員聯(lián)系方式","MarkNo":

"標記嘜碼","DespPortCode":

"啟運港代碼","EntyPortCode":

"入境口岸","GoodsPlace":

"貨物存放地點","BLNo":

"B/L號","InspOrgCode":

"口岸檢驗檢疫機關","SpecDeclFlag":

"特種業(yè)務標識","PurpOrgCode":

"目的地檢驗檢疫機關",50DB3502/T

117.3—2023"DespDate":

"CmplDschrgDt":

"2022-10-19","CorrelationReasonFlag":

"關聯(lián)理由","VsaOrgCode":

"領證機關","OrigBoxFlag":

"原集裝箱標識","DeclareName":

"","OrgCode":

"檢驗檢疫受理機關","DomesticConsigneeEname":

"境內收發(fā)貨人名稱","OverseasConsignorAddr":

"美國紐約","OverseasConsignorCname":

"john","OverseasConsignorCode":

"境外收發(fā)貨人代碼","OverseasC