DB35 T 1960-2021 单一窗口进出口信用证服务系统接口技术要求.pdf
《DB35 T 1960-2021 单一窗口进出口信用证服务系统接口技术要求.pdf》由会员分享,可在线阅读,更多相关《DB35 T 1960-2021 单一窗口进出口信用证服务系统接口技术要求.pdf(28页珍藏版)》请在麦多课文档分享上搜索。
1、 ICS 35.240.30 CCS A 80 35 福建省地方标准 DB35/T 1960 2021 单一窗口进出口信用证服务系统接口 技术要求 The technical requirement of interface for import and export credit service system of single window 2021 - 02 - 09 发布 2021 - 05 - 09 实施 福建省市场监督管理局 发布 DB35/T 1960 2021 I 目次 前言 . . II 1 范围 . . 1 2 规范性引 用文件 . . 1 3 术语和定 义 . . 1 4
2、 缩略语 . . 2 5 基本要求 . . 2 6 主要数据 项 . . 2 7 数据交换 方式 . . 4 8 接口调用 方式 . . 4 9 报文头 . . 4 10 接口信 息描述 . . 5 附录 A(规范性) 数据字典 . 6 附录 B(资料性) 接口信息描述 . 8 附录 C(规范性) 银行代码 . 12 附录 D(资料性) 接口调用示例(以 Java 代码为例) . 13 附录 E(资料性) 接口报文示例(JSON) . 19 参考文献 . . 25 DB35/T 1960 2021 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规
3、则的规定 起草。 本文件由福建省商务厅提出并归口。 本文件起草单位:福建省电子口岸管理中心、福建省标准化研究院、福建天础信息科技有限公司、 福建省标院信息技术有限公司。 本文件主要起草人:张晶、蒋乐超、柴勇、孙琳、李海晏、康雪娟、程军、王彬彬、程晓明、洪文 木、林晓銮、王姝敏、刘荣荣。 DB35/T 1960 2021 1 单一窗口进出口信用证服务系统接口技术要求 1 范围 本文件规定了单一窗口进出口信用证服务系统接口的缩略语、基本要求、主要数据项、数据交换方 式、接口调用方式、报文头和接口信息描述。 本文件适用于单一窗口进出口信用证服务系统与银行信用证业务系统的数据交换, 其他需要与单一 窗
4、口进出口信用证服务系统对接的业务系统可参照执行。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中, 注日期的引用文件, 仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本 文件。 GB/T 2659 世界各国和地区名称代码 GB/T 11457 信息技术 软件工程术语 GB/T 12406 表示货币和资金的代码 GB/T 16711 银行业 银行电信报文 银行标识代码 GB 32100 法人和其他组织统一社会信用代码编码规则 JR/T 0014 2005 银行信息化通用代码集 IETF RFC 7231 Hyp
5、ertext Transfer Protocol (HTTP/1.1):Semantics and Content 3 术语和定义 GB/T 11457界定的术语和定义适用于本文件。 3.1 单一窗口 single window 贸易和运输相关各方在单一登记点提交满足全部进口、 出口和转口相关监管规定的标准信息和单证 的一项措施。 来源:GB/T 365 972018,2.1 3.2 信用证 credit 一项约定,无论其如何命名或描述,该约定不可撤销并因此构成开证行对于相符交单予以兑付的确 定承诺。 来源:ICC UCP 600中英文对照版,第二条定义 注: 本文件中特指进出口信用证。 3.
6、3 订单 order 平台上用户通过单一窗口进出口信用证服务系统向商业银行发起的交易请求。 DB35/T 1960 2021 2 4 缩略语 下列缩略语适用于本文件。 AES:高级加密标准(Advanced Enc ryption Standard) API:应用程序编程接口(Applica tion Programming Interface) CA:证书认证机构(Certificat e Authority) CBC:密文分组链接(Cipher B lock Chaining) HTTP:超文本传输协议(Hypertext Tr ansfer Protocol) HTTPS:超文本传输安全
7、协议(Hypertext Transfer Protocol over Secure Socket Layer) IETF:国际互联网工程任务组(The Inte rnet Engineering Task Force) IP:互联网协议(Internet Protocol) JSON:JavaScript对象标记(JavaScript Object Notation) PKCS:公钥加密标准(Public Key Cryp tography Standards) RFC:请求评论(Request For Comments) SHA:安全散列算法(Secure H ash Algorithm)
8、 URI:统一资源标识符(Uniform Re source Identifier) 5 基本要求 单一窗口进出口信用证服务系统的接口应能满足以下基本要求: a) 实用性:能与不同商业银行进行业务对接、完成数据交换; b) 安全性:数据交换过程中保护国家秘密、商业秘密和个人隐私; c) 时效性:能实时完成数据交换。 6 主要数据项 接口的主要数据项见表1。 表1 主要数据项 序号 分类 字段名称 字段中文名称 类型 说明 1 平台会 员信息 pltfContactTel 平台会员联系电 话 string(12) 2 pltfCrspName 平台会员联系人 string(18) 3 pltfM
9、emName 平台会员名称 string(200) 企业名称 4 pltfMemAddr 平台会员地址 string(200) 企业实际经营地址 5 pltfMemId 平台会员编号 string(20) 企业/个人在平台注册的唯一ID号,规则为 PM+时间(yyyyMMddHH)+8位数字序列号 6 pltfMemRlAcct 平台会员实账号 string(30) 7 平台会 员信息 pltfMemSt 平台会员状态 string(1) 应符合附录A表A.1的规定 8 unfSocCrdtNo 统一社会信用代 码 string(18) 执行GB 32100 9 订单信 息 cmdtyName
10、 商品名称 string(200) 10 handleSeqNo 受理编号 string(12) DB35/T 1960 2021 3 表 1 主要数据项 (续) 序号 分类 字段名称 字段中文名称 类型 说明 11 ordrAmt 订单金额 number(20,2) 数字格式,保留两位小数 12 订单信 息 ordrCcy 订单币种 string(3) 执行GB/T 12406 13 ordrDtTm 订单时间 dateTime 格式:yyyy-MM-dd HH:mm:ss 14 ordrNo 订单号 string(20) 规则为EO+时间(yyyyMMddHH)+8位数字序 列号 15 o
11、rdrSt 订单状态 string(2) 应符合附录A表A.2的规定 16 ordrTp 订单类型 string(1) 应符合附录A表A.3的规定 17 udtAftrOrdrSt 修改后订单状态 string(2) 应符合附录A表A.2的规定 18 收付款 信息 beneAcctNo 受益人账号 string(30) 19 beneBBIC 受益人银行标识代 码BIC NO. string(11) 执行GB/T 16711 20 beneBName 受益人银行名称 string(200) 21 beneCName 受益人国别名称 string(200) 执行GB/T 2659 22 bene
12、Cty 受益人国别代码 string(3) 执行GB/T 2659,为三字符拉丁字母代码 23 beneName 受益人名称 string(200) 24 issuBBIC 开证银行标识代码 BIC NO. string(11) 执行GB/T 16711 25 issuBName 开证银行名称 string(200) 26 applCName 申请人国别名称 string(200) 执行GB/T 2659 27 applCty 申请人国别代码 string(3) 执行GB/T 2659,为三字符拉丁字母代码 28 applName 申请人名称 string(200) 29 transNo 交易
13、流水号 string(30) 30 ytCrdAmt 实际交易金额 number(20,2) 数字格式,保留两位小数 31 ytCtfCcy 实际交易币种 string(3) 执行GB/T 12406 32 信用证 信息 crCtfAmt 信用证金额 number(20,2) 数字格式,保留两位小数 33 crCtfBussNo 信用证交单编号 string(50) 34 crCtfCcy 信用证币种 string(3) 执行GB/T 12406 35 crCtfList 信用证记录信息 List 信用证信息记录对象数组 36 crCtfNo 信用证编号 string(50) 37 crCtf
14、St 信用证状态 string(2) 应符合附录A表A.4的规定 38 invNo 发票编号 string(50) 39 notiCode 通知编号 string(50) 40 查询信 息 applySt 申请状态 string(1) 应符合附录A表A.5的规定 41 qryDataNum 查询结果总数量 number(4) 信用证记录信息条数 42 qryStrtNum 起始查询笔数 number(4) 默认为0 43 qryNum 需要查询笔数 number(4) 44 返回信 息 stCode 返回状态码 string(2) 应符合附录A表A.6的规定 45 stMsg 返回状态码描述
15、string(100) DB35/T 1960 2021 4 7 数据交换方式 数据对接方式 7.1 对接方式包括但不限于: a) 专线+HTTP; b) HTTPS+CA 证书。 数据加密方式 7.2 数据加密方式包括但不限于: a) SM2 椭圆曲线公钥密码算法; b) RSA 算法。 8 接口调用方式 请求 8.1 8.1.1 接口调用地址: a) 专线+HTTP:http:/IP 地址/银行代码/附录 B 中的 URI,常见的银行代码应符合附录 C 的要 求; b) HTTPS+CA 证书:https:/IP 地址/银行代码/附录B 中的URI。 8.1.2 请求方法为 post,接口
16、调用示例参见附录 D。 返回 8.2 8.2.1 返回报文体格式为 JSON。 8.2.2 交易成功时,返回信息见附录 B 中的输出数据项;交易失败时,返回信息为返回状态码和返回 状态码描述。 8.2.3 HTTP 返回状态码描述详见 IETF RFC 7231 规范定义。 9 报文头 报文头参数 9.1 报文头参数见表2。 表2 报文头参数 序号 字段名称 字段中文名称 说明 1 X-Client-ID 应用标识 2 X-SIGNATURE 报文签名 签名方式 9.2 9.2.1 客户端签名: a) 输入:content(请求报文体)、secret(密钥); DB35/T 1960 2021
17、 5 b) 输出:signature(签名)。 9.2.2 签名过程要求: a) content 至少经过两次不同加密算法加密处理; b) 最终生成的 signature 需要转 Base64编码输出。 9.2.3 调用 signBytes 方法时采用 JSON 字符串,调用 API 时请求报文体格式为 JSON。 10 接口信息描述 接口信息描述包括但不限于以下内容: 10.1 a) 接口类型; b) URI; c) 功能; d) 输入数据项; e) 输出数据项; f) 方法: 1) 查询字符串(描述资源的键/值对); 2) 消息体(描述 HTTP 请求的消息体); 3) 返回结果(描述 H
18、TTP 请求的响应)。 接口信息描述参见附录 B,接口报文示例参见附录 E。 10.2 DB35/T 1960 2021 6 附录A (规范性) 数据字典 数据字典见表A.1表A.6。 表A.1 会员账户状态代码 序号 会员账户状态代码 描述 1 1 正常 2 2 冻结 3 3 挂失 4 4 临时止付 5 5 透支 6 6 睡眠 7 7 销户 8 9 其他 会员账户状态代码应符合JR/T 00142005中表4的规定 表A.2 订单状态代码 序号 订单状态代码 描述 1 01 订单已撤销 2 11 进口订单已生成,未付款 3 12 进口订单已付汇 4 13 进口订单已结清 5 21 出口订单已
19、生成,未收汇 6 22 出口订单已收汇 7 23 出口订单已结清 表A.3 订单类型代码 序号 订单类型代码 描述 1 1 进口订单 2 2 出口订单 表A.4 信用证状态代码 序号 信用证状态代码 描述 1 01 已通知 2 02 已寄单 3 03 已到单 4 04 已承兑 DB35/T 1960 2021 7 表A.4 信用证状态代码 (续) 序号 信用证状态代码 描述 5 05 已收汇 6 06 已付汇 7 07 已注销 8 08 余额不足 表A.5 批量查询申请状态代码 序号 批量查询申请状态代码 描述 1 1 结果未生成 2 2 结果已生成 表A.6 返回状态码 序号 返回状态码 描
20、述 1 00 交易成功 2 10 交易处理中 3 20 参数校验失败 4 99 未知错误 DB35/T 1960 2021 8 附录B (资料性) 接口信息描述 接口信息描述见表B.1。 表B.1 接口信息描述 接 口 类 型 URI 功能 输入数据项 输出数据项 方法(POST) 查 询 字 符 串 消 息 体 返 回 结 果 会 员 台 账 接 口 memberSt ndBkCrt 新 增 建立商户会员台 账,只建立会员台 账,不绑定银行实 账户 平台会员联系电话 * 、平台会员联 系人 * 、平台会员名称 * 、平台会员 地址 * 、平台会员编号 * 、统一社会 信用代码 * 平台会员联
21、系电话 * 、平台会员联系人 * 、平台会员名称 * 、 平台会员地址 * 、平 台会员编号 * 、平台 会员状态 * 、统一社 会信用代码 * 、交易 流水号、返回状态 码 * 、返回状态码描 述 N/A 输 入 的 数 据 项 JS ON 格 式 报 文 输 出 的 数 据 项 JS ON 格 式 报 文 memberSt ndBkUdt 修 改 对部分会员信息进 行修改,可修改字 段为:平台会员名 称、 平台会员地址、 平台会员联系人、 平台会员联系电话 平台会员联系电话、平台会员联 系人、平台会员名称、平台会员 地址、平台会员编号 * 、统一社会 信用代码 * memberSt ndB
22、kDel 删 除 删除会员台账,不 删除数据记录,只 将会员标志置为 “2-销户” 平台会员编号 * 、统一社会信用代 码 * memberSt ndBkQry 查 询 查询已建立的会员 台账的详细信息 订 单 信 息 接 口 orderRgst 新 增 登记订单 平台会员名称 * 、平台会员编号 * 、 平台会员实账号、 统一社会信用代 码 * 、商品名称、订单金额 * 、订单 币种 * 、订单号 * 、订单类型 * 、受益 人账号、受益人银行BIC NO.、受 益人银行名称、受益人国别名称、 受益人国别代码、受益人名称、开 证银行BIC NO.、开证银行名称、 申请人国别名称、申请人国别代
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB35 1960-2021 单一窗口进出口信用证服务系统接口技术要求 1960 2021 单一 窗口 进出口 信用证 服务 系统 接口 技术 要求
