DB3502_T 117.3-2023国际贸易“单一窗口”数据服务 第3部分：报关服务接口.pdf

ICS 35.240 CCS L77 3502 福建省厦门市地方标准 DB3502/T 117.32023 国际贸易单一窗口数据服务 第 3 部分：报关服务接口 Data services for international trade Single Window Part 3:Interface of customs clearance services 2023-12-28 发布 2023-12-28 实施 厦门市市场监督管理局 发 布 DB3502/T 117.32023 I 目次 前言.II 引言.III 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.1 5 基本要求.1 6 数据对接方式.2 7 服务接口设计基本规定.2 8 业务服务接口.4 附录 A（资料性）接口示例.43 附录 B（资料性）通关字典.61 DB3502/T 117.32023 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。本文件是DB3502/T 117国际贸易“单一窗口”数据服务的第3部分。DB3502/T 117已经发布了以下部分：第1部分：总体技术要求；第2部分：报关业务数据元；第3部分：报关服务接口。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中国(福建)自由贸易试验区厦门片区管理委员会信息化服务中心提出。本文件由中国(福建)自由贸易试验区厦门片区管理委员会归口。本文件起草单位：中国(福建)自由贸易试验区厦门片区管理委员会信息化服务中心、北京国研数通软件技术有限公司、厦门市标准化研究院、厦门自贸试验区电子口岸有限公司、中国厦门外轮代理有限公司、厦门市人民政府口岸工作办公室、厦门海事局、厦门出入境边防检查总站 本文件主要起草人：吴志强、李童、王李强、郑建欣、林华、李倩文、刘裴寰、叶少鹏、杨晨、严伟荣、吴永馨、周印亮、李红、徐锋、赵健、谢晓芳、胡流辉、李健、郑巍伟、陈瑀、李钊茜、詹永祥、张建财、郭晓晨、张颖慧、陈劭彧 DB3502/T 117.32023 III 引言 国际贸易“单一窗口”数据服务开放平台的建设，可以充分发掘数据资产价值，提升厦门“单一窗口”创新服务效率，优化厦门市营商环境，积极服务“单一窗口”相关企业。DB3502/T 117旨在确立数据服务开放平台总体架构、技术架构、开放过程等的技术标准，为数据服务开放平台的建设提供基础规范，拟由十七个部分组成。第 1 部分：总体技术要求；第 2 部分：报关业务数据元；第 3 部分：报关服务接口；第 4 部分：快件业务数据元；第 5 部分：快件业务服务接口；第 6 部分：运输工具数据元；第 7 部分：运输工具服务接口；第 8 部分：舱单业务数据元；第 9 部分：舱单业务服务接口；第 10 部分：跨境电商数据元；第 11 部分：跨境电商服务接口；第 12 部分：保税业务数据元；第 13 部分：保税业务服务接口；第 14 部分：服务目录；第 15 部分：安全管理要求；第 16 部分：数据服务流程；第 17 部分：运维服务要求。报关服务接口用于规范报关业务领域内接口设计、数据传递方式、参数格式、交互流程等内容，支持不同系统之间的集成和互操作性，确保数据传递的一致性和准确性，提高工作效率，降低维护成本，支持业务流程自动化等，为特定业务领域内的系统交互提供了标准化的框架，促进了业务流程的顺畅进行和信息交换的高效实现。DB3502/T 117.32023 1 国际贸易单一窗口数据服务 第 3 部分：报关服务接口 1 范围 本文件规定了“单一窗口”数据服务开放平台提供的数据开放服务中报关服务相关接口。本文件适用于相关企业业务系统调用开放的服务接口进行进出口报关申报。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。DB3502/T 117.1 国际贸易“单一窗口”数据服务 第1部分：总体技术要求 DB3502/T 117.2 国际贸易“单一窗口”数据服务 第2部分：报关业务数据元 3 术语和定义 本文件没有需要界定的术语和定义。4 缩略语 下列缩略语适用于本文件。AES：高级加密标准（Advanced Encryption Standard)API：应用程序编程接口（Application Programming Interface）CA：证书认证机构(Certificate Authority)HTTP：超文本传输协议（Hypertext Transfer Protocol)HTTPS：超文本传输安全协议（Hypertext Transfer Protocol over Secure Socket Layer）JSON：JavaScript对象标记(JavaScript Object Notation)JWT：一种用于身份验证和授权的开放标准（JSON Web Token）SM系列算法：国家商用密码算法 5 基本要求 数据服务开放平台的接口应满足以下基本要求：实用性:能与不同企业报关进行业务对接、完成数据交换；安全性:数据交换过程中保护国家秘密、商业秘密和个人隐私；时效性:能实时完成数据交换。DB3502/T 117.32023 2 6 数据对接方式 数据对接方式包括：专线+HTTPS；HTTPS+身份认证。7 服务接口设计基本规定 服务接口命名规定 服务接口的名称应采用厦门“单一窗口”业务的中文描述进行命名，服务接口业务描述为服务接口所属领域以及业务含义描述。服务接口编码规定 服务接口编码结构如图1所示，其中：服务版本：默认版本为V1，新版本则为V2，依次类推；业务分类：根据服务划分的类别以英文字母进行命名，保证每个业务分类唯一；业务服务名称：数字和字母组成的文本，保证服务接口提供方内唯一。图1 服务接口编码结构 示例：https:/域名/api/v1/dataQuery/HSCIQController 传输协议应使用HTTP1.0/1.1标准或者HTTPS标准两种方式。采用HTTPS协议时，服务方应提供接口调用需要的数字证书文件，证书文件应为“单一窗口”数据服务开放平台统一颁发的数字证书。上下行服务接口说明 企业需要上报到数据服务开放平台的数据，调用数据服务开放平台相关的上行服务接口，数据服务开放平台需要提供给各企业的数据，由企业从下行服务接口中调用相应的查询接口获取。其中，上行服务接口以数据服务开放平台作为数据接收方对应的接口，下行服务接口以数据服务开放平台作为数据提供方对应的接口。接口技术类型 服务接口技术类型采用REST接口，使用GET或POST方法，返回报文数据格式为JSON格式。交换数据类型 数据类型说明见DB3502/T 117.2中数据元表示方法。服务接口安全要求 服务版本 业务分类业务服务名称Https:/域名/api/v1/bizName/serviceDB3502/T 117.32023 3 服务接口安全采用基于JWT开放标准（RFC 7519）的签名设计方式实现，本文中所有的服务接口在传输过程中，均采用国密SM2、SM3等国产算法进行加密，通过使用支持国产加密算法的工具库或框架来实现对JWT的加密操作，在持久化存储至数据库过程中，则采用国产解密算法。请求参数数据结构 请求头参数数据结构见表1，请求参数数据结构见表2，示例见附录A.1。表1 请求头参数数据结构 代码名称 类型 是否必填 描述 示例值 ContentType JSON 是 内容类型为 JSON，编码类型为 UTF-8 application/json;charset=utf-8 ServiceVersion A.5 是 调用的接口版本 1.0 Token A.256 是 通过 token 服务获取 token 表2 请求参数数据结构 代码名称 类型 是否必填 描述 示例值 ClientID A.10 是 数据服务调用者身份标识 EntType A2 是 数据服务调用者类型 01 EntAccessTime DateTime 是 数据服务调用时间 Signature A.500 否 数据服务调用者身份标识、服务标识、签名秘钥由“单一窗口”数据服务开放平台向企业下发。参数签名信息的生成需要使用签名秘钥计算，计算的方式为使用签名秘钥对请求者身份标识、服务调用时间进行 MD5 加密获得 EncryptName A.10 否 对称加密算法，支持：AES256、SM4，需要加密时填写 EncryptKey A.512 否 对称秘钥 IcCardNo A32 否 IC 卡卡号，需要业务签名的接口必须填做业务的 IC 卡卡号 Format A.40 否 业务节点的数据类型：默认 JSON MessageId A.44 是 报文唯一标识，命名规范：EntID+yyyy-MM-ddHHmmss+4 位自定义流水号 AccountName A.33 是 实际业务方单一窗口登录账号 ParamData JSON 是 请求参数 json 字符串 响应数据结构 响应数据结构见表3，示例见附录A.2。表3 响应数据结构 代码名称 类型 是否必填 描述 示例值 ClientID A.10 是 返回代码 RetTime DateTime 是 返回时间 DB3502/T 117.32023 4 表3 响应数据结构（续）代码名称 类型 是否必填 描述 示例值 RetData JSON 是 返回数据 RetMsg A.500 是 返回消息 Signature A.50 否 数据服务调用者身份标识、服务标识、签名秘钥由“单一窗口”数据服务开放平台向企业下发。参数签名信息的生成需要使用签名秘钥计算，计算的方式为使用签名秘钥对请求者身份标识、服务调用时间进行 MD5 或 sm3 加密获得 EncryptName A.10 否 对称加密算法，支持：AES256、SM4，需要加密时填写 EncryptKey A.512 否 对称秘钥 数据结构扩展字段定义 扩展字段（“FieldExtend”）内容通过JSON文本进行定义，基础数据结构扩展字段定义见表4，示例见附录A.3。注：请求参数和返回结果由于自贸区业务存在持续改进，本文件仅定义基础数据结构。表4 扩展字段定义 代码名称 类型 是否必填 描述 说明 ClientID A.255 是 字段编码 Fieldname A.255 是 字段名称 fieldLength N.5 否 字段长度 fieldType A.50 是 字段类型 fieldRequired A1 否 字段是否必填 fieldValue A.500 否 字段值 8 业务服务接口 业务流程描述 报关行报关流程见图2。货主/货代报关流程见图3。DB3502/T 117.32023 5 图2 报关行报关流程 图3 货主/货代报关流程 通用接口 8.2.1 开放平台认证服务 数据服务开放平台采用Token认证，通过Token认证通用请求。请求方式为POST，请求参数说明见表5，返回结果说明见表6，示例见附录A.4.1.1，其中：Header：Content-Type:application/json;charset=UTF-8 DB3502/T 117.32023 6 接口地址：https:/域名/api/v1/auth/tokens 表5 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 ClientID 客户端 ID A.255 是 2 ClientSecret 客户端密码 A.256 是 表6 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 RetCode 返回代码 A3 是 2 RetTime 返回时间 DateTime 是 3 UserId 用户 ID A.255 是 4 UserToken 用户 Token A.255 是 用户 Token，计算的方式为使用签名秘钥对请求者身份标识、服务调用时间进行 MD5 加密获得。5 ExpireTime Token 过期时间 N.255 是 8.2.2 用户授权接口 对用户访问的数据服务进行服务权限的鉴定，判断其是否有权限访问该服务。请求方式为POST，请求参数说明见表7，返回参数说明见表8，示例见附录A.4.1.2，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/access/accessList 表7 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 UserID 用户 ID AN.32 是 2 UserName 用户名称 AN.50 是 3 ServiceApp 应用名称 AN.32 是 4 IPAddress 访问 IP 地址 AN.50 是 5 FieldExtend 扩展字段 JSON 否 表8 返回参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 UserID 用户 ID AN.32 是 2 UserName 用户名称 AN.50 是 3 ServiceApp 应用名称 AN.32 是 4 ServiceList 访问服务列表 JSON 是 5 IPAddress 访问 IP 地址 AN.50 是 6 FieldExtend 扩展字段 JSON 否 DB3502/T 117.32023 7 8.2.3 服务申请 企业在ERP或企业第三方应用调用需要的服务接口时需要发送服务申请到开放平台。请求方式为请求方式为POST，请求参数说明见表9，返回结果说明见表10，示例见附录A.4.1.3，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/Serv/ServiceApply 表9 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 ChannelId 通道 Id AN.36 是 2 TimeStamp 时间戳 N14 是 时间戳 yyyyMMddhhmmss，当前时间前后 10 分钟内有效 3 HashSign 签名 AN32 是 MD5.encode(通道 ID+密钥+timestamp+请求参数)表10 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 ServiceList 申请服务列表 AN.10 是 2 ServAccess 服务访问权限 A.60 是 3 SerTimeLimit 服务时间权限 AN.120 是 4 SerSumLimit 服务访问次数权限 AN.120 否 5 FieldExtend 扩展字段 JSON 否 8.2.4 数据申请 数据使用企业需要其他企业的数据，首先需要向其他企业进行申请使用，说明申请使用的用途、使用期限、次数、范围等，请求方式为POST，请求参数说明见表11，返回结果说明见表12，示例见附录A.4.1.4，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/Serv/dataApply 表11 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 ChannelId 通道 Id AN.36 是 2 TimeStamp 时间戳 N14 是 时间戳 yyyyMMddhhmmss，当前时间前后 10 分钟内有效 3 HashSign 签名 AN32 是 MD5.encode(通道 ID+密钥+timestamp+请求参数)表12 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 ServiceData 数据内容 AN.120 是 DB3502/T 117.32023 8 表12 返回结果说明（续）序号 代码名称 中文名称 类型 是否必填 说明 2 dataUsing 数据使用用途 A.60 是 3 dataTimeLimit 数据时间范围 AN.120 否 4 dataSumLimit 数据使用次数 AN.120 否 5 DataUnit 申请企业 AN.120 是 6 DataPUnit 授权企业 AN.120 是 7 FieldExtend 扩展字段 JSON 否 8.2.5 数据授权 企业对本企业数据授权给申请数据的企业进行授权服务，请求方式为POST，请求参数说明见表13，返回结果说明见表14，示例见附录A.4.1.5，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/Serv/dataAccess 表13 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 ChannelId 通道 Id AN.36 是 2 TimeStamp 时间戳 N14 是 时间戳 yyyyMMddhhmmss，当前时间前后 10 分钟内有效 3 HashSign 签名 AN32 是 MD5.encode(通道 ID+密钥+timestamp+请求参数)表14 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 ServiceData 数据描述 AN.120 是 2 dataAccess 数据访问策略 A.60 是 3 dataTimeLimit 数据访问时间权限 AN.120 否 4 dataSumLimit 访问次数权限 AN.120 否 5 accessFile 授权协议文件 AN.120 是 6 FieldExtend 扩展字段 JSON 否 7 ServiceData 数据描述 AN.120 是 下行服务接口 8.3.1 通关参数查询 企业通过服务接口获得通关相关的参数数据。企业输入查询参数、字典名称。接口接收企业查询通过参数信息，并返回是否查询成功，如成功能则返回该数据字典结果包；如不成功则返回原因。请求方式为POST，详细请求参数见表15，返回结果说明见表16，示例见附录A.4.2.1，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/dictype/DicController DB3502/T 117.32023 9 表15 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 DicName 字典名称 A.255 是 示例：Dic_type_001，通关字典见附录 B 2 UserToken 用户 Token A.255 是 3 FieldExtend 扩展字段 JSON 否 注：请求参数存放请求令牌信息和字典参数名称，所有字段都必须有，“是否必填”指字段内容是否必填，非必填字段可以为空。表16 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 DicItemCode 字典项代码 A.255 是 2 DicName 字典名称 A.255 是 3 DicItemName 字典项名称 A.255 是 4 DicItemShortName 字典项简称 A.255 否 5 DicItemExtField 扩展字段 A.500 否 6 DicItemExtName 扩展字段名称 A.500 否 7 DicItemExtField2 扩展字段 2 A.500 否 8 DicItemExtName2 扩展字段 2 名称 A.500 否 9 FieldExtend 扩展字段 JSON 否 8.3.2 报关数据查询 8.3.2.1 检验检疫编码查询 企业通过服务接口获得进出口商品的检验检疫编码。企业输入商品编码或名称查询检验检疫编码。接口接收参数信息，并返回是否查询成功，如成功能则返回该类商品的检验检疫编码；如不成功则返回原因。请求方式为POST，详细请求参数见表17，返回结果说明见表18，示例见附录A.4.2.2.1，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/dataQuery/HSCIQController 表17 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 CodeTS 商品编码 A10 是 2 GName 商品名称 A.512 否 3 UserToken 用户 Token A.255 是 4 FieldExtend 扩展字段 JSON 否 表18 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 CodeTS 商品编码 A10 否 2 GName 商品名称 A.512 否 3 CIQCode 检验检疫编码 AN.20 是 4 CIQName 检验检疫名称 A.50 是 DB3502/T 117.32023 10 表18 返回结果说明（续）序号 代码名称 中文名称 类型 是否必填 说明 5 CIQType 检验检疫类型 A.50 否 6 FieldExtend 扩展字段 JSON 否 8.3.2.2 舱单通关状态查询 企业使用该服务接口查询进出口舱单通关状态信息。支持输入进口/出口，提运单号、集装箱号、报关单号、运输工具、航班航次号等查询条件调用服务接口进行查询，如果失败，返回失败原因，如果成功，则返回运输工具、舱单、报关单、物流状态等信息。请求方式为POST，详细请求参数见表19，返回结果说明见表20，示例见附录A.4.2.2.2，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/dataQuery/BillStatusController 注：该接口来源于舱单通关业务的服务接口规范，此处被报关业务服务所引用。表19 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 BillNo 提运单号 A.32 否 2 IEFlag 进出口标志 A1 否 3 TrafNo 运输工具代码 A.32 否 4 ContaNo 集装箱号 A.32 否 5 RepNo 报关单号 N18 是 6 VoyNo 航次号 A.32 否 7 UserToken 用户 Token A.255 是 8 FieldExtend 扩展字段 JSON 否 表20 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 TradeCoScc 境内收发货人代码 A.10 是 2 AgentCode 报关申报单位代码 A.18 是 3 AgentName 报关申报单位名称 A.70 是 4 AgentScc 报关申报单位社会信用代码 A.18 否 5 CustomMaster 申报地海关代码 AN.14 是 6 BillNo 提运单号 A.32 否 7 IEDate 进口日期（进口）/出口日期（出口）Date 否 DB3502/T 117.32023 11 表20 返回结果说明（续）序号 代码名称 中文名称 类型 是否必填 说明 8 TrafMode 运输方式代码（海关）A1 是 9 TrafName 运输工具名称 A.50 否 10 VoyNo 航次号 A.32 否 航次号/运输工具号码 11 ManualNo 备案号 A.12 否 12 DeclTrnRel 报关/转关关系标志 A1 是 报关单单据类型:0：一般报关单 1：转关提前报关单 2：备案清单 3：转关提前备案清单 13 TradeName 境内收发货人名称（中文）A.70 是 14 IEFlag 进出口标识（海关）A1 是 进出口标识（海关）：I：进口 E：出口 15 PassStatus 通关状态 A2 否 16 FieldExtend 扩展字段 JSON 否 8.3.2.3 进出口税率查询 企业使用该服务接口查询进出口税率信息。支持输入税号、商品名称调用接口进行查询，如果失败，返回失败原因，如果成功，则返回进出口税率信息。请求方式为POST，详细请求参数见表21，返回结果说明见表22，示例见附录A.4.2.2.3，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/dataQuery/TaxController 表21 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 CodeTS 商品编码 N10 是 2 TaxNo 税号 A.10 否 3 GName 商品名称 A.255 否 4 UserToken 用户 Token A.255 是 5 FieldExtend 扩展字段 JSON 否 表22 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 TaxNo 税号 A.10 是 2 GName 商品名称 A.255 否 3 EtaxRate 进口最惠国税率 N.12,2 是 4 EtaxCurrRate 进口普通税率 N.12,2 是 5 EtaxTempRate 进口暂定税率 N.12,2 否 6 ItaxRate 出口税率 N.12,2 否 7 FieldExtend 扩展字段 JSON 否 DB3502/T 117.32023 12 8.3.2.4 第一二计量单位查询 企业使用该服务接口查询进出口商品第一二计量单位信息。输入商品名称、商品HS编码、许可证代码，调用服务接口，查询进出口商品第一计量单位、第二计量单位，如果失败，返回失败原因，如果成功，则返回进出口商品第一二单位信息。请求方式为POST，请求参数说明见表23，返回结果说明见表24，示例见附录A.4.2.2.4，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/report/UnitController 表23 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 CodeTS 商品编码 AN10 是 2 GName 商品名称 AN.512 否 3 LicenceNo 许可证编号 A.20 否 4 UserToken 用户 Token A.255 是 5 FieldExtend 扩展字段 JSON 否 表24 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 CodeTs 商品编码 A10 是 2 GName 商品名称 A.512 是 3 LicenceNo 许可证编号 A.20 是 4 FirstUnit 第一计量单位 A3 是 5 FirstUnitCN 第一计量单位名称 A.50 是 6 SecondUnit 第二计量单位 A3 是 7 SecondUnitCN 第二计量单位名称 A.50 是 8 GModel 商品规格、型号 A.255 是 9 FieldExtend 扩展字段 JSON 否 8.3.2.5 进出口商品查询 企业使用该服务接口查询进出口商品信息。输入商品分类、商品HS编码、许可证代码，调用服务接口，查询进出口商品，如果失败，返回失败原因，如果成功，则返回进出口商品信息。请求方式为POST，请求参数说明见表25，返回结果说明见表26，示例见附录A.4.2.2.5，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/report/HSGoodsController 表25 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 GName 商品名称 AN.512 是 2 CodeTs 商品编码 A10 是 DB3502/T 117.32023 13 表25 请求参数说明（续）序号 代码名称 中文名称 类型 是否必填 说明 3 LicenceNo 许可证编号 A.20 否 4 UserToken 用户 Token A.255 是 5 FieldExtend 扩展字段 JSON 否 表26 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 CodeTs 商品编码 A10 是 2 GName 商品名称 A.512 是 3 LicenceNo 许可证编号 A.20 是 4 FirstUnit 第一计量单位 A3 是 5 FirstUnitCN 第一计量单位名称 A.50 是 6 SecondUnit 第二计量单位 A3 是 7 SecondUnitCN 第二计量单位名称 A.50 是 8 GType 商品分类 A3 是 9 FieldExtend 扩展字段 JSON 否 8.3.2.6 报关单状态查询 企业通过服务接口实时查询本企业报关单状态结果信息。企业用户输入报关单号，查询本企业的报关单状态结果。输入报关单号和本企业统一社会信用代码或海关编码，申报单位统一社会信用代码或海关编码，可以查询报关单状态信息。如果查询成功，则返回报关单状态结果。请求方式为POST，请求参数说明见表27，返回结果说明见表28，示例见附录A.4.2.2.6，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/report/RepStatusController 表27 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 RepNo 报关单号 N18 是 2 TradeCode 报关企业代码 A.18 是 3 AgentCode 申报企业代码 A.18 否 4 Token 通过 token 服务获取 token A.256 是 示例：Ivj6eZRx40+MTx2ZvnG8nA 5 FieldExtend 扩展字段 JSON 否 注：请求参数存放请求令牌信息和请求参数信息，所有字段都必须有，“是否必填”指字段内容是否必填，非必填字段可以为空。DB3502/T 117.32023 14 表28 返回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 1 statusCode 状态编码 A1 是 2 StatusName 状态名称 A.50 是 3 StatusDesc 状态描述 A.512 是 4 FieldExtend 扩展字段 JSON 否 8.3.2.7 报关单明细查询 企业通过服务接口实时查询本企业一段时间周期内报关单结果信息。企业用户输入报关单号，企业统一社会信用代码或海关注册码，收发货人代码、报关时间段开始时间和结束时间，查询本企业报关单信息。请求方式为POST，请求参数说明见表29，返回结果说明见表30-48，示例见附录A.4.2.2.7，其中：Header：Content-Type:application/json;charset=UTF-8 接口地址：https:/域名/api/v1/report/RepController 表29 请求参数说明 序号 代码名称 中文名称 类型 是否必填 说明 1 RepNo 报关单号 N18 否 2 TradeCode 报关企业 ID A.18 是 3 RepTradeCode 申报企业 ID A.18 否 4 Token 通过 token 服务获取 token A.256 是 示例：Ivj6eZRx40+MTx2ZvnG8nA 5 TradeCoScc 境内收发货人代码 A.10 否 6 RepStartTime 报关开始时间 Date 是 7 RepEndTime 报关结束时间 Date 是 8 BillNo 提运单号 A.32 否 9 UserToken 用户 Token A.255 是 10 FieldExtend 扩展字段 JSON 否 表30 进口/出口报关单表头 序号 代码名称 中文名称 类型 是否必填 说明 1 CusCiqNo 统一编号 A.18 否 2 TradeCoScc 境内收发货人代码 A.10 是 3 RcvgdTradeScc 境内收发货人社会信用代码 A.18 是 4 AgentCode 报关申报单位代码 A.10 是 5 AgentName 报关申报单位名称 A.70 是 DB3502/T 117.32023 15 表30 进口/出口报关单表头（续）序号 代码名称 中文名称 类型 是否必填 说明 6 AgentScc 报关申报单位社会信用代码 A.18 否 7 OwnerCode 消费使用单位（进口）/生产销售单位（出口）代码 A.18 是 8 OwnerName 消费使用单位（进口）/生产销售单位（出口）名称 A.70 是 9 OwnerCodeScc 消费使用单位（进口）/生产销售单位（出口）社会信用代码 A.18 是 10 CoOwner 企业性质代码 A1 否 11 CustomMaster 申报地海关代码 A.1 是 12 BillNo 提运单号 A.32 否 13 IEDate 进口日期（进口）/出口日期（出口）Date 否 14 DistinatePort 经停港（进口）/指运港（出口）A.6 是 15 TrafMode 运输方式代码（海关）A1 是 16 TrafName 运输工具名称 A.50 否 17 VoyNo 航次号 A.32 否 航次号/运输工具号码 18 TradeAreaCode 贸易国（地区）代码（海关）A.3 是 19 TradeCountry 启运国（地区）/运抵国（地区）（海关）A.3 是 20 IEPort 进出境关别代码 A.6 是 21 ContrNo 合同协议号（海关）A.32 否 22 TradeMode 监管方式 A.4 是 23 CutMode 征免性质代码 A.3 否 24 ManualNo 备案号 A.12 否 25 LicenseNo 许可证号 A.20 否 26 WrapType 包装种类 A.2 是 27 PackNo 件数 AN.9 是 DB3502/T 117.32023 16 表30 进口/出口报关单表头（续）序号 代码名称 中文名称 类型 是否必填 说明 28 grossWet 报关毛重 N.19,5 是 29 NetWt 净重 N.19,5 是 30 TransMode 成交方式代码 A1 是 31 RellId 关联报关单号 N18 否 32 RelmanNo 关联备案号 A.12 否 33 BonNo 监管仓号 A.32 否 34 CusFie 货场代码 A.255 否 35 FeeCurr 运费币制 A.3 否 36 FeeMark 运费标记 A1 否 运费标记：1：率；2：单价；3：总价 37 FeeRate 运费率 N.16,4 否 38 OtherCurr 杂费币制 A.3 否 39 OtherMark 杂费标记 A1 否 杂费标志：1：率；2：单价；3：总价 40 OtherRate 杂费率 N.16,4 否 杂费率 41 InsurCurr 保险费币制 A.3 否 保险费币制 42 InsurMark 保险费标记 A1 否 保险费标记：1：率；3：总价 43 InsurRate 保险费率 N.16,4 否 保险费率 44 DeclTrnRel 报关/转关关系标志 A1 是 报关单单据类型：0：一般报关单；1：转关提前报关单 2：备案清单；3：转关提前备案清单 45 InRatio 内销比率 AN.2 否 46 ApprNo 批准文号 A.32 否 47 PreEntryId 预录入编号 A.18 否 报关预录入编号：采用全国自动赋号的，不用录入；未采用的，需要手工录入编号。48 PromiseItems 承诺事项 A.32 否 操作数据：1：勾选；0：未选 第一位：特殊关系确认 第二位：价格影响确认 第三位：支付特许权使用费确认 49 NoteS 备注 A.255 否 50 TradeName 境内