DB3502_T 117.3-2023国际贸易“单一窗口”数据服务 第3部分:报关服务接口.pdf
《DB3502_T 117.3-2023国际贸易“单一窗口”数据服务 第3部分:报关服务接口.pdf》由会员分享,可在线阅读,更多相关《DB3502_T 117.3-2023国际贸易“单一窗口”数据服务 第3部分:报关服务接口.pdf(65页珍藏版)》请在咨信网上搜索。
1、 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
2、基本要求.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部分:报关服务接口。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中国(福建)自由贸易试验
3、区厦门片区管理委员会信息化服务中心提出。本文件由中国(福建)自由贸易试验区厦门片区管理委员会归口。本文件起草单位:中国(福建)自由贸易试验区厦门片区管理委员会信息化服务中心、北京国研数通软件技术有限公司、厦门市标准化研究院、厦门自贸试验区电子口岸有限公司、中国厦门外轮代理有限公司、厦门市人民政府口岸工作办公室、厦门海事局、厦门出入境边防检查总站 本文件主要起草人:吴志强、李童、王李强、郑建欣、林华、李倩文、刘裴寰、叶少鹏、杨晨、严伟荣、吴永馨、周印亮、李红、徐锋、赵健、谢晓芳、胡流辉、李健、郑巍伟、陈瑀、李钊茜、詹永祥、张建财、郭晓晨、张颖慧、陈劭彧 DB3502/T 117.32023 II
4、I 引言 国际贸易“单一窗口”数据服务开放平台的建设,可以充分发掘数据资产价值,提升厦门“单一窗口”创新服务效率,优化厦门市营商环境,积极服务“单一窗口”相关企业。DB3502/T 117旨在确立数据服务开放平台总体架构、技术架构、开放过程等的技术标准,为数据服务开放平台的建设提供基础规范,拟由十七个部分组成。第 1 部分:总体技术要求;第 2 部分:报关业务数据元;第 3 部分:报关服务接口;第 4 部分:快件业务数据元;第 5 部分:快件业务服务接口;第 6 部分:运输工具数据元;第 7 部分:运输工具服务接口;第 8 部分:舱单业务数据元;第 9 部分:舱单业务服务接口;第 10 部分:
5、跨境电商数据元;第 11 部分:跨境电商服务接口;第 12 部分:保税业务数据元;第 13 部分:保税业务服务接口;第 14 部分:服务目录;第 15 部分:安全管理要求;第 16 部分:数据服务流程;第 17 部分:运维服务要求。报关服务接口用于规范报关业务领域内接口设计、数据传递方式、参数格式、交互流程等内容,支持不同系统之间的集成和互操作性,确保数据传递的一致性和准确性,提高工作效率,降低维护成本,支持业务流程自动化等,为特定业务领域内的系统交互提供了标准化的框架,促进了业务流程的顺畅进行和信息交换的高效实现。DB3502/T 117.32023 1 国际贸易单一窗口数据服务 第 3 部
6、分:报关服务接口 1 范围 本文件规定了“单一窗口”数据服务开放平台提供的数据开放服务中报关服务相关接口。本文件适用于相关企业业务系统调用开放的服务接口进行进出口报关申报。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。DB3502/T 117.1 国际贸易“单一窗口”数据服务 第1部分:总体技术要求 DB3502/T 117.2 国际贸易“单一窗口”数据服务 第2部分:报关业务数据元 3 术语和定义 本文件没有需要界定的术语和定义。4 缩
7、略语 下列缩略语适用于本文件。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:一种用于身
8、份验证和授权的开放标准(JSON Web Token)SM系列算法:国家商用密码算法 5 基本要求 数据服务开放平台的接口应满足以下基本要求:实用性:能与不同企业报关进行业务对接、完成数据交换;安全性:数据交换过程中保护国家秘密、商业秘密和个人隐私;时效性:能实时完成数据交换。DB3502/T 117.32023 2 6 数据对接方式 数据对接方式包括:专线+HTTPS;HTTPS+身份认证。7 服务接口设计基本规定 服务接口命名规定 服务接口的名称应采用厦门“单一窗口”业务的中文描述进行命名,服务接口业务描述为服务接口所属领域以及业务含义描述。服务接口编码规定 服务接口编码结构如图1所示,其
9、中:服务版本:默认版本为V1,新版本则为V2,依次类推;业务分类:根据服务划分的类别以英文字母进行命名,保证每个业务分类唯一;业务服务名称:数字和字母组成的文本,保证服务接口提供方内唯一。图1 服务接口编码结构 示例:https:/域名/api/v1/dataQuery/HSCIQController 传输协议应使用HTTP1.0/1.1标准或者HTTPS标准两种方式。采用HTTPS协议时,服务方应提供接口调用需要的数字证书文件,证书文件应为“单一窗口”数据服务开放平台统一颁发的数字证书。上下行服务接口说明 企业需要上报到数据服务开放平台的数据,调用数据服务开放平台相关的上行服务接口,数据服务
10、开放平台需要提供给各企业的数据,由企业从下行服务接口中调用相应的查询接口获取。其中,上行服务接口以数据服务开放平台作为数据接收方对应的接口,下行服务接口以数据服务开放平台作为数据提供方对应的接口。接口技术类型 服务接口技术类型采用REST接口,使用GET或POST方法,返回报文数据格式为JSON格式。交换数据类型 数据类型说明见DB3502/T 117.2中数据元表示方法。服务接口安全要求 服务版本 业务分类业务服务名称Https:/域名/api/v1/bizName/serviceDB3502/T 117.32023 3 服务接口安全采用基于JWT开放标准(RFC 7519)的签名设计方式实
11、现,本文中所有的服务接口在传输过程中,均采用国密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 是 通过 toke
12、n 服务获取 token 表2 请求参数数据结构 代码名称 类型 是否必填 描述 示例值 ClientID A.10 是 数据服务调用者身份标识 EntType A2 是 数据服务调用者类型 01 EntAccessTime DateTime 是 数据服务调用时间 Signature A.500 否 数据服务调用者身份标识、服务标识、签名秘钥由“单一窗口”数据服务开放平台向企业下发。参数签名信息的生成需要使用签名秘钥计算,计算的方式为使用签名秘钥对请求者身份标识、服务调用时间进行 MD5 加密获得 EncryptName A.10 否 对称加密算法,支持:AES256、SM4,需要加密时填写
13、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 是
14、返回代码 RetTime DateTime 是 返回时间 DB3502/T 117.32023 4 表3 响应数据结构(续)代码名称 类型 是否必填 描述 示例值 RetData JSON 是 返回数据 RetMsg A.500 是 返回消息 Signature A.50 否 数据服务调用者身份标识、服务标识、签名秘钥由“单一窗口”数据服务开放平台向企业下发。参数签名信息的生成需要使用签名秘钥计算,计算的方式为使用签名秘钥对请求者身份标识、服务调用时间进行 MD5 或 sm3 加密获得 EncryptName A.10 否 对称加密算法,支持:AES256、SM4,需要加密时填写 Encryp
15、tKey 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 业务服务
16、接口 业务流程描述 报关行报关流程见图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 请求参数说明 序号 代码名称
17、 中文名称 类型 是否必填 说明 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 用户授权接口 对用户
18、访问的数据服务进行服务权限的鉴定,判断其是否有权限访问该服务。请求方式为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.5
19、0 是 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或企业第三方应用调用需要的服务接口时需要发送服务申请到开放平台。请求方式为请求方式为
20、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
21、+请求参数)表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,其中:H
22、eader: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 Se
23、rviceData 数据内容 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,请求参数说明
24、见表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 返
25、回结果说明 序号 代码名称 中文名称 类型 是否必填 说明 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 通关参数查询 企业通过服务接口获得通关相关的参数数据。企业输入查询参数、字典名称。接口接收企业查询通过参数信
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB3502_T 117.3-2023国际贸易“单一窗口”数据服务 第3部分:报关服务接口 117.3 2023 国际贸易 单一 窗口 数据 服务 部分 报关 接口
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【Fis****915】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【Fis****915】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。
链接地址:https://www.zixin.com.cn/doc/590491.html