DB3502-T 117.3-2023 国际贸易单一窗口数据服务 第3部分：报关服务接口

35.240CCS

L773502 DB3502/T

117.3—2023国际贸易"单一窗口"数据服务第

3

部分：报关服务接口Data

international

trade

Window—Part

3:

of

clearance

services

发布

实施厦门市市场监督管理局 发

布DB3502/T

117.3—2023 前言

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

II引言

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

III1

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

12 规范性引用文件

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

13 术语和定义

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

14 缩略语

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

15 基本要求

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

16 数据对接方式

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

27 服务接口设计基本规定

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

28 业务服务接口

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

4附录

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

43附录

B（资料性） 通关字典............................................................

61DB3502/T

117.3—2023 本文件按照GB/T

1.1—2020《标准化工作导则

第1部分：标准化文件的结构和起草规则》的规定起草。本文件是DB3502/T

117《国际贸易“单一窗口”数据服务》的第3部分。DB3502/T

117已经发布了以下部分：——第1部分：总体技术要求；——第2部分：报关业务数据元；——第3部分：报关服务接口。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中国(福建)自由贸易试验区厦门片区管理委员会信息化服务中心提出。本文件由中国(福建)自由贸易试验区厦门片区管理委员会归口。()公司、厦门市人民政府口岸工作办公室、厦门海事局、厦门出入境边防检查总站张建财、郭晓晨、张颖慧、陈劭彧IIDB3502/T

117.3—2023 DB3502/T

117范，拟由十七个部分组成。——第

1

部分：总体技术要求；——第

2

部分：报关业务数据元；——第

3

部分：报关服务接口；——第

4

部分：快件业务数据元；——第

5

部分：快件业务服务接口；——第

6

部分：运输工具数据元；——第

7

部分：运输工具服务接口；——第

8

部分：舱单业务数据元；——第

9

部分：舱单业务服务接口；——第

10

部分：跨境电商数据元；——第

11

部分：跨境电商服务接口；——第

12

部分：保税业务数据元；——第

13

部分：保税业务服务接口；——第

14

部分：服务目录；——第

15

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

16

部分：数据服务流程；——第

17

部分：运维服务要求。持不同系统之间的集成和互操作性，确保数据传递的一致性和准确性，提高工作效率，降低维护成本，行和信息交换的高效实现。IIIDB3502/T

117.3—2023

1 范围本文件规定了“单一窗口”数据服务开放平台提供的数据开放服务中报关服务相关接口。本文件适用于相关企业业务系统调用开放的服务接口进行进出口报关申报。2规范性引用文件文件。DB3502/T

117.1国际贸易“”

第1部分：总体技术要求DB3502/T

117.2 国际贸易“”

第2部分：报关业务数据元3术语和定义本文件没有需要界定的术语和定义。4 缩略语下列缩略语适用于本文件。AES：高级加密标准（Advanced

API：应用程序编程接口（Application

Interface）CA：证书认证机构(Certificate

Authority)HTTP：超文本传输协议（Hypertext

Transfer

Protocol)HTTPS：超文本传输安全协议（Hypertext

Transfer

Protocol

over

Secure

Layer）JSON：JavaScript对象标记(JavaScript

Object

JWT：一种用于身份验证和授权的开放标准（JSON

Token）SM系列算法：国家商用密码算法5基本要求数据服务开放平台的接口应满足以下基本要求：——实用性:能与不同企业报关进行业务对接、完成数据交换；——安全性:数据交换过程中保护国家秘密、商业秘密和个人隐私；——时效性:能实时完成数据交换。DB3502/T

117.3—20236 数据对接方式数据对接方式包括：——+HTTPS；——HTTPS+身份认证。7服务接口设计基本规定服务接口命名规定所属领域以及业务含义描述。服务接口编码规定服务接口编码结构如图1所示，其中：——服务版本：默认版本为V1，新版本则为V2，依次类推；——业务分类：根据服务划分的类别以英文字母进行命名，保证每个业务分类唯一；——业务服务名称：数字和字母组成的文本，保证服务接口提供方内唯一。Https://{域名}/api/v1/{bizName}/{service}服务版本

业务分类 业务服务名称图1 服务接口编码结构https://{传输协议应使用标准或者HTTPS标准两种方式。采用HTTPS协议时，服务方应提供接口调用需要的数字证书文件，证书文件应为“单一窗口”数据服务开放平台统一颁发的数字证书。上下行服务接口说明务接口以数据服务开放平台作为数据接收方对应的接口，下行服务接口以数据服务开放平台作为数据提供方对应的接口。接口技术类型服务接口技术类型采用接口，使用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）的签名设计方式实现，本文中所有的服务接口在、SM3实现对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 响应数据结构（续）FieldExtendJSON4例见附录。表4扩展字段定义8业务服务接口业务流程描述报关行报关流程见图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 服务申请企业在或企业第三方应用调用需要的服务接口时需要发送服务申请到开放平台。请求方式为请求方式为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返回结果说明（续）8.2.5 数据授权企业对本企业数据授权给申请数据的企业进行授权服务，请求方式为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 报关数据查询 检验检疫编码查询企业通过服务接口获得进出口商品的检验检疫编码。企业输入商品编码或名称查询检验检疫编码。原因。请求方式为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 返回结果说明（续） 舱单通关状态查询企业使用该服务接口查询进出口舱单通关状态信息。支持输入进口/出口，提运单号、集装箱号、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 返回结果说明（续） 进出口税率查询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 请求参数说明（续）表26返回结果说明 报关单状态查询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 进口/（续）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 进口/（续）1656CusRemarkA..64

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

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

117.3—2023表30进口/（续）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 进口/（续）表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 进口/（续）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 进口/（续）表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报关单随附单据关系（续）表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 企业资质信息表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报税单表头（续）表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 转关单表头（续）表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 转关单表体(提单)（续）表47进口/出口提运单集装箱表表48 进口/出口提运单集装箱商品装配表 出口箱码头放行查询企业通过服务接口获得出口报关单所关联出口提运单号的码头放行信息。企业输入报关单号或出口提运单号查询码头放行信息。接口接收参数信息，并返回是否查询成功，如成功能则返回下列参数；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 返回结果说明 进口箱海关放行查询企业通过服务接口获得进口报关单所关联出口提运单号的码头放行信息。企业输入报关单号或进口提运单号查询码头放行信息。接口接收参数信息，并返回是否查询成功，如成功能则返回下列参数；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返回结果说明（续）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 反馈回执 报关回执单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 返回结果说明（续）30VoyNoOrShipNoA..17TrafNoA..35ocumentA..35tDocumentA..35A..64ReceiptTypeCodeA..501ReceiptTypeDetailA..512FieldExtendJSONTrafModeA1BillNoAN..32VoyNoA..32ocumentA..35UserToken

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

117.3—2023表58 返回结果说明（续）舱单运抵报告状态企业查询运抵报告状态信息接口用于企业ERP系统对接“单一窗口”平台，实现企业查询运抵报告状态信息查询服务。请求方式为POST，请求参数说明见表59，返回结果说明见表60-61，示例见附录A.，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/feedback/BorderQueryController表59 请求参数说明表60 舱单运抵业务报文体（提单）表61 舱单运抵业务报文体（集装箱）31TrafNoA..35ContainerNoA..17A..64ReceiptTypeCodeA..501ReceiptTypeDetailA..512FieldExtendJSONEntNameA..100EntUnicodeAN..18EntCodeCusA..20CreditLevelA1A1FieldExtendJSONEntNameA..100EntUnicodeAN..18EntCodeCusA..20UserToken

A..255DB3502/T

117.3—2023表61舱单运抵业务报文体（集装箱）（续）8.3.4 企业信息查询回原因。请求方式为POST，请求参数说明见表62，返回结果说明见表63，示例见附录，其中：——Header：Content-Type:application/json;charset=UTF-8——接口地址：https://{}/api/v1/feedback/EntCodeController表62请求参数说明表63返回结果说明上行服务接口8.4.1进出口报关申报进出口货物申报接口用于企业ERP系统对接“单一窗口”平台，实现货物电子数据报关申报服务。请求方式为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 报关单表头信息（续）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 报关单表头信息（续）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 报关单表头信息（续）表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 报关单表体信息（续）37EntNameA..100EntUnicodeAN..18EntCodeCusA..20CreditLevelA1A1FieldExtendJSONDocuCodeAN1CertCodeAN..32DecGNoN..2EcoGNoN..9FieldExtendJSONDocuCodeAN1DocAttachedNameAN..100CertCodeAN..32<01>FieldExtendJSONAppCertCodeAN..50ApplOriAN..50ApplCopyQuanAN..50FieldExtendJSONGoodsNoN..9LicTypeCodeAN..547AN..15048FieldExtendJSON3838DB3502/T

117.3—2023表65 报关单表体信息（续）表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许可证信息（续）表71 许可证

VIN

信息表72其他包装信息表73企业资质信息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 返回结果说明（续）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":"系统繁忙，请稍后重试","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":

"本企业数据回流","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":

"企业产品许可类别代码表","DicItemCode":

"101","DicItemName":

"检疫处理单位审批","DicItemShortName":

"DicItemExtField":

"A","DicItemExtField2":

"FieldExtend":

"{}"},

{"DicName":

"企业产品许可类别代码表","DicItemCode":

"304","DicItemName":

"出境水生动物养殖场/包转场检验检疫注册登记","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. 舱单通关状态查询示例{"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":

"医疗或外科口罩","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. 报关单状态查询示例{"RetCode":

"200","retData":

{"statusCode":

"1","StatusName":

"已保存"StatusDesc":

"已处理，等候审批","FieldExtend":

"{}"}}A. 报关单明细查询示例{"RetCode":

"200","retData":

{"DecMessage":

{"DecHead":

{"CusCiqNo":

"统一编号"TradeCoScc":

"63078701018","RcvgdTradeScc":

"境内收发货人社会信用代码","AgentCode":

"AgentName":

"海顺丰船务有限公司","AgentScc":

"OwnerCode":

"消费使用单位（进口）/生产销售单位（出口）代码","OwnerName":

"消费使用单位（进口）/生产销售单位（出口）名称","OwnerCodeScc":

"消费使用单位","CoOwner":

"企业性质代码","CustomMaster":

"申报地海关代码","BillNo":

"AUT29390239223","IEDate":

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

"经停港","TrafMode":

"A","TrafName":

"海丰9号","VoyNo":

"JK233S","TradeAreaCode":

"贸易国（地区）代码（海关）"TradeCountry":

"启运国","IEPort":

"","ContrNo":

"合同协议号（海关）",49DB3502/T

117.3—2023"TradeMode":

"CutMode":

"征免性质代码","ManualNo":

"LicenseNo":

"许可证号"WrapType":

"包装种类"PackNo":

"3500","GrossWet":

"500","NetWt":

"净重","TransMode":

"成交方式代码","RellId":

"AUT29390239223","RelmanNo":

"关联备案号","BonNo":

"监管仓号","CusFie":

"0093874","FeeCurr":

"110","FeeMark":

"运费标记","FeeRate":

"运费／率","OtherCurr":

"杂费币制"OtherMark":

"杂费标记"OtherRate":

"杂费／率"InsurCurr":

"保险费币制","InsurMark":

"保险费标记","InsurRate":

"保险费／率","DeclTrnRel":

"1","InRatio":

"内销比率","ApprNo":

"批准文号","PreEntryId":

"","PromiseItems":

"承诺事项","NoteS":

"备注","TradeName":

"境内收发货人名称","IEFlag":

"I","BillType":

"备案清单类型","CusRemark":

"报关单类型标记","CopNo":

"企业内部编号"DecBpId":

"报关员编号"DecBpNo":

"报关员联系方式","MarkNo":

"标记唛码","DespPortCode":

"启运港代码","EntyPortCode":

"入境口岸","GoodsPlace":

"货物存放地点","BLNo":

"B/L号","InspOrgCode":

"口岸检验检疫机关","SpecDeclFlag":

"特种业务标识","PurpOrgCode":

"目的地检验检疫机关",50DB3502/T

117.3—2023"DespDate":

"CmplDschrgDt":

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

"关联理由","VsaOrgCode":

"领证机关","OrigBoxFlag":

"原集装箱标识","DeclareName":

"","OrgCode":

"检验检疫受理机关","DomesticConsigneeEname":

"境内收发货人名称","OverseasConsignorAddr":

"美国纽约","OverseasConsignorCname":

"john","OverseasConsignorCode":

"境外收发货人代码","OverseasC