DB35/T 1960-2021 单一窗口进出口信用证服务系统接口技术要求

ICS35.240.30

CCSA80

35

福建省地方标准

DB35/T1960—2021

单一窗口进出口信用证服务系统接口

技术要求

Thetechnicalrequirementofinterfaceforimportandexportcreditservicesystemof

singlewindow

2021-02-09发布2021-05-09实施

福建省市场监督管理局发布

DB35/T1960—2021

目次

前言.................................................................................II

1范围...............................................................................1

2规范性引用文件.....................................................................1

3术语和定义.........................................................................1

4缩略语.............................................................................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

I

DB35/T1960—2021

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

本文件由福建省商务厅提出并归口。

本文件起草单位：福建省电子口岸管理中心、福建省标准化研究院、福建天础信息科技有限公司、

福建省标院信息技术有限公司。

本文件主要起草人：张晶、蒋乐超、柴勇、孙琳、李海晏、康雪娟、程军、王彬彬、程晓明、洪文

木、林晓銮、王姝敏、刘荣荣。

II

DB35/T1960—2021

单一窗口进出口信用证服务系统接口技术要求

1范围

本文件规定了单一窗口进出口信用证服务系统接口的缩略语、基本要求、主要数据项、数据交换方

式、接口调用方式、报文头和接口信息描述。

本文件适用于单一窗口进出口信用证服务系统与银行信用证业务系统的数据交换，其他需要与单一

窗口进出口信用证服务系统对接的业务系统可参照执行。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T2659世界各国和地区名称代码

GB/T11457信息技术软件工程术语

GB/T12406表示货币和资金的代码

GB/T16711银行业银行电信报文银行标识代码

GB32100法人和其他组织统一社会信用代码编码规则

JR/T0014—2005银行信息化通用代码集

IETFRFC7231HypertextTransferProtocol(HTTP/1.1):SemanticsandContent

3术语和定义

GB/T11457界定的术语和定义适用于本文件。

3.1

单一窗口singlewindow

贸易和运输相关各方在单一登记点提交满足全部进口、出口和转口相关监管规定的标准信息和单证

的一项措施。

[来源：GB/T36597—2018，2.1]

3.2

信用证credit

一项约定，无论其如何命名或描述，该约定不可撤销并因此构成开证行对于相符交单予以兑付的确

定承诺。

[来源：ICCUCP600中英文对照版，第二条定义]

注：本文件中特指进出口信用证。

3.3

订单order

平台上用户通过单一窗口进出口信用证服务系统向商业银行发起的交易请求。

1

DB35/T1960—2021

4缩略语

下列缩略语适用于本文件。

AES：高级加密标准（AdvancedEncryptionStandard）

API：应用程序编程接口（ApplicationProgrammingInterface）

CA：证书认证机构（CertificateAuthority）

CBC：密文分组链接（CipherBlockChaining）

HTTP：超文本传输协议（HypertextTransferProtocol）

HTTPS：超文本传输安全协议（HypertextTransferProtocoloverSecureSocketLayer）

IETF：国际互联网工程任务组（TheInternetEngineeringTaskForce）

IP：互联网协议（InternetProtocol）

JSON：JavaScript对象标记（JavaScriptObjectNotation）

PKCS：公钥加密标准（PublicKeyCryptographyStandards）

RFC：请求评论（RequestForComments）

SHA：安全散列算法（SecureHashAlgorithm）

URI：统一资源标识符（UniformResourceIdentifier）

5基本要求

单一窗口进出口信用证服务系统的接口应能满足以下基本要求：

a)实用性：能与不同商业银行进行业务对接、完成数据交换；

b)安全性：数据交换过程中保护国家秘密、商业秘密和个人隐私；

c)时效性：能实时完成数据交换。

6主要数据项

接口的主要数据项见表1。

表1主要数据项

序号分类字段名称字段中文名称类型说明

平台会员联系电

1pltfContactTelstring(12)—

话

2pltfCrspName平台会员联系人string(18)—

3平台会pltfMemName平台会员名称string(200)企业名称

4员信息pltfMemAddr平台会员地址string(200)企业实际经营地址

企业/个人在平台注册的唯一ID号，规则为

5pltfMemId平台会员编号string(20)

PM+时间（yyyyMMddHH）+8位数字序列号

6pltfMemRlAcct平台会员实账号string(30)—

7pltfMemSt平台会员状态string(1)应符合附录A表A.1的规定

平台会

统一社会信用代

8员信息unfSocCrdtNostring(18)执行GB32100

码

9订单信cmdtyName商品名称string(200)—

10息handleSeqNo受理编号string(12)—

2

DB35/T1960—2021

表1主要数据项（续）

序号分类字段名称字段中文名称类型说明

11ordrAmt订单金额number(20,2)数字格式，保留两位小数

12ordrCcy订单币种string(3)执行GB/T12406

13ordrDtTm订单时间dateTime格式：yyyy-MM-ddHH:mm:ss

规则为EO+时间（yyyyMMddHH）+8位数字序

14订单信ordrNo订单号string(20)

列号

息

15ordrSt订单状态string(2)应符合附录A表A.2的规定

16ordrTp订单类型string(1)应符合附录A表A.3的规定

17udtAftrOrdrSt修改后订单状态string(2)应符合附录A表A.2的规定

18beneAcctNo受益人账号string(30)—

受益人银行标识代

19beneBBICstring(11)执行GB/T16711

码BICNO.

20beneBName受益人银行名称string(200)—

21beneCName受益人国别名称string(200)执行GB/T2659

22beneCty受益人国别代码string(3)执行GB/T2659，为三字符拉丁字母代码

23beneName受益人名称string(200)—

收付款

开证银行标识代码

24信息issuBBICstring(11)执行GB/T16711

BICNO.

25issuBName开证银行名称string(200)—

26applCName申请人国别名称string(200)执行GB/T2659

27applCty申请人国别代码string(3)执行GB/T2659，为三字符拉丁字母代码

28applName申请人名称string(200)—

29transNo交易流水号string(30)—

30ytCrdAmt实际交易金额number(20,2)数字格式，保留两位小数

31ytCtfCcy实际交易币种string(3)执行GB/T12406

32crCtfAmt信用证金额number(20,2)数字格式，保留两位小数

33crCtfBussNo信用证交单编号string(50)—

34crCtfCcy信用证币种string(3)执行GB/T12406

35信用证crCtfList信用证记录信息List<crCtfRst>信用证信息记录对象数组

36信息crCtfNo信用证编号string(50)—

37crCtfSt信用证状态string(2)应符合附录A表A.4的规定

38invNo发票编号string(50)—

39notiCode通知编号string(50)—

40applySt申请状态string(1)应符合附录A表A.5的规定

41查询信qryDataNum查询结果总数量number(4)信用证记录信息条数

42息qryStrtNum起始查询笔数number(4)默认为0

43qryNum需要查询笔数number(4)—

44返回信stCode返回状态码string(2)应符合附录A表A.6的规定

45息stMsg返回状态码描述string(100)—

3

DB35/T1960—2021

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，接口调用示例参见附录D。

8.2返回

8.2.1返回报文体格式为JSON。

8.2.2交易成功时，返回信息见附录B中的输出数据项；交易失败时，返回信息为返回状态码和返回

状态码描述。

8.2.3HTTP返回状态码描述详见IETFRFC7231规范定义。

9报文头

9.1报文头参数

报文头参数见表2。

表2报文头参数

序号字段名称字段中文名称说明

1X-Client-ID应用标识—

2X-SIGNATURE报文签名—

9.2签名方式

9.2.1客户端签名：

a)输入：content（请求报文体）、secret（密钥）；

4

DB35/T1960—2021

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)返回结果（描述HTTP请求的响应）。

10.2接口信息描述参见附录B，接口报文示例参见附录E。

5

DB35/T1960—2021

附录A

（规范性）

数据字典

数据字典见表A.1～表A.6。

表A.1会员账户状态代码

序号会员账户状态代码描述

11正常

22冻结

33挂失

44临时止付

55透支

66睡眠

77销户

89其他

会员账户状态代码应符合JR/T0014—2005中表4的规定

表A.2订单状态代码

序号订单状态代码描述

101订单已撤销

211进口订单已生成，未付款

312进口订单已付汇

413进口订单已结清

521出口订单已生成，未收汇

622出口订单已收汇

723出口订单已结清

表A.3订单类型代码

序号订单类型代码描述

11进口订单

22出口订单

表A.4信用证状态代码

序号信用证状态代码描述

101已通知

202已寄单

303已到单

404已承兑

6

DB35/T1960—2021

表A.4信用证状态代码（续）

序号信用证状态代码描述

505已收汇

606已付汇

707已注销

808余额不足

表A.5批量查询申请状态代码

序号批量查询申请状态代码