ICS35.240.30

CCSA80

35

福建省地方標準

DB35/T1960—2021

單一窗口進出口信用證服務系統(tǒng)接口

技術要求

Thetechnicalrequirementofinterfaceforimportandexportcreditservicesystemof

singlewindow

2021-02-09發(fā)布2021-05-09實施

福建省市場監(jiān)督管理局發(fā)布

DB35/T1960—2021

目次

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

1范圍...............................................................................1

2規(guī)范性引用文件.....................................................................1

3術語和定義.........................................................................1

4縮略語.............................................................................2

5基本要求...........................................................................2

6主要數(shù)據(jù)項.........................................................................2

7數(shù)據(jù)交換方式.......................................................................4

8接口調(diào)用方式.......................................................................4

9報文頭.............................................................................4

10接口信息描述......................................................................5

附錄A（規(guī)范性）數(shù)據(jù)字典.............................................................6

附錄B（資料性）接口信息描述.........................................................8

附錄C（規(guī)范性）銀行代碼............................................................12

附錄D（資料性）接口調(diào)用示例（以Java代碼為例）.....................................13

附錄E（資料性）接口報文示例（JSON）................................................19

參考文獻.............................................................................25

I

DB35/T1960—2021

前言

本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定

起草。

本文件由福建省商務廳提出并歸口。

本文件起草單位：福建省電子口岸管理中心、福建省標準化研究院、福建天礎信息科技有限公司、

福建省標院信息技術有限公司。

本文件主要起草人：張晶、蔣樂超、柴勇、孫琳、李海晏、康雪娟、程軍、王彬彬、程曉明、洪文

木、林曉鑾、王姝敏、劉榮榮。

II

DB35/T1960—2021

單一窗口進出口信用證服務系統(tǒng)接口技術要求

1范圍

本文件規(guī)定了單一窗口進出口信用證服務系統(tǒng)接口的縮略語、基本要求、主要數(shù)據(jù)項、數(shù)據(jù)交換方

式、接口調(diào)用方式、報文頭和接口信息描述。

本文件適用于單一窗口進出口信用證服務系統(tǒng)與銀行信用證業(yè)務系統(tǒng)的數(shù)據(jù)交換，其他需要與單一

窗口進出口信用證服務系統(tǒng)對接的業(yè)務系統(tǒng)可參照執(zhí)行。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T2659世界各國和地區(qū)名稱代碼

GB/T11457信息技術軟件工程術語

GB/T12406表示貨幣和資金的代碼

GB/T16711銀行業(yè)銀行電信報文銀行標識代碼

GB32100法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則

JR/T0014—2005銀行信息化通用代碼集

IETFRFC7231HypertextTransferProtocol(HTTP/1.1):SemanticsandContent

3術語和定義

GB/T11457界定的術語和定義適用于本文件。

3.1

單一窗口singlewindow

貿(mào)易和運輸相關各方在單一登記點提交滿足全部進口、出口和轉口相關監(jiān)管規(guī)定的標準信息和單證

的一項措施。

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

3.2

信用證credit

一項約定，無論其如何命名或描述，該約定不可撤銷并因此構成開證行對于相符交單予以兌付的確

定承諾。

[來源：ICCUCP600中英文對照版，第二條定義]

注：本文件中特指進出口信用證。

3.3

訂單order

平臺上用戶通過單一窗口進出口信用證服務系統(tǒng)向商業(yè)銀行發(fā)起的交易請求。

1

DB35/T1960—2021

4縮略語

下列縮略語適用于本文件。

AES：高級加密標準（AdvancedEncryptionStandard）

API：應用程序編程接口（ApplicationProgrammingInterface）

CA：證書認證機構（CertificateAuthority）

CBC：密文分組鏈接（CipherBlockChaining）

HTTP：超文本傳輸協(xié)議（HypertextTransferProtocol）

HTTPS：超文本傳輸安全協(xié)議（HypertextTransferProtocoloverSecureSocketLayer）

IETF：國際互聯(lián)網(wǎng)工程任務組（TheInternetEngineeringTaskForce）

IP：互聯(lián)網(wǎng)協(xié)議（InternetProtocol）

JSON：JavaScript對象標記（JavaScriptObjectNotation）

PKCS：公鑰加密標準（PublicKeyCryptographyStandards）

RFC：請求評論（RequestForComments）

SHA：安全散列算法（SecureHashAlgorithm）

URI：統(tǒng)一資源標識符（UniformResourceIdentifier）

5基本要求

單一窗口進出口信用證服務系統(tǒng)的接口應能滿足以下基本要求：

a)實用性：能與不同商業(yè)銀行進行業(yè)務對接、完成數(shù)據(jù)交換；

b)安全性：數(shù)據(jù)交換過程中保護國家秘密、商業(yè)秘密和個人隱私；

c)時效性：能實時完成數(shù)據(jù)交換。

6主要數(shù)據(jù)項

接口的主要數(shù)據(jù)項見表1。

表1主要數(shù)據(jù)項

序號分類字段名稱字段中文名稱類型說明

平臺會員聯(lián)系電

1pltfContactTelstring(12)—

話

2pltfCrspName平臺會員聯(lián)系人string(18)—

3平臺會pltfMemName平臺會員名稱string(200)企業(yè)名稱

4員信息pltfMemAddr平臺會員地址string(200)企業(yè)實際經(jīng)營地址

企業(yè)/個人在平臺注冊的唯一ID號，規(guī)則為

5pltfMemId平臺會員編號string(20)

PM+時間（yyyyMMddHH）+8位數(shù)字序列號

6pltfMemRlAcct平臺會員實賬號string(30)—

7pltfMemSt平臺會員狀態(tài)string(1)應符合附錄A表A.1的規(guī)定

平臺會

統(tǒng)一社會信用代

8員信息unfSocCrdtNostring(18)執(zhí)行GB32100

碼

9訂單信cmdtyName商品名稱string(200)—

10息handleSeqNo受理編號string(12)—

2

DB35/T1960—2021

表1主要數(shù)據(jù)項（續(xù)）

序號分類字段名稱字段中文名稱類型說明

11ordrAmt訂單金額number(20,2)數(shù)字格式，保留兩位小數(shù)

12ordrCcy訂單幣種string(3)執(zhí)行GB/T12406

13ordrDtTm訂單時間dateTime格式：yyyy-MM-ddHH:mm:ss

規(guī)則為EO+時間（yyyyMMddHH）+8位數(shù)字序

14訂單信ordrNo訂單號string(20)

列號

息

15ordrSt訂單狀態(tài)string(2)應符合附錄A表A.2的規(guī)定

16ordrTp訂單類型string(1)應符合附錄A表A.3的規(guī)定

17udtAftrOrdrSt修改后訂單狀態(tài)string(2)應符合附錄A表A.2的規(guī)定

18beneAcctNo受益人賬號string(30)—

受益人銀行標識代

19beneBBICstring(11)執(zhí)行GB/T16711

碼BICNO.

20beneBName受益人銀行名稱string(200)—

21beneCName受益人國別名稱string(200)執(zhí)行GB/T2659

22beneCty受益人國別代碼string(3)執(zhí)行GB/T2659，為三字符拉丁字母代碼

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

收付款

開證銀行標識代碼

24信息issuBBICstring(11)執(zhí)行GB/T16711

BICNO.

25issuBName開證銀行名稱string(200)—

26applCName申請人國別名稱string(200)執(zhí)行GB/T2659

27applCty申請人國別代碼string(3)執(zhí)行GB/T2659，為三字符拉丁字母代碼

28applName申請人名稱string(200)—

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

30ytCrdAmt實際交易金額number(20,2)數(shù)字格式，保留兩位小數(shù)

31ytCtfCcy實際交易幣種string(3)執(zhí)行GB/T12406

32crCtfAmt信用證金額number(20,2)數(shù)字格式，保留兩位小數(shù)

33crCtfBussNo信用證交單編號string(50)—

34crCtfCcy信用證幣種string(3)執(zhí)行GB/T12406

35信用證crCtfList信用證記錄信息List<crCtfRst>信用證信息記錄對象數(shù)組

36信息crCtfNo信用證編號string(50)—

37crCtfSt信用證狀態(tài)string(2)應符合附錄A表A.4的規(guī)定

38invNo發(fā)票編號string(50)—

39notiCode通知編號string(50)—

40applySt申請狀態(tài)string(1)應符合附錄A表A.5的規(guī)定

41查詢信qryDataNum查詢結果總數(shù)量number(4)信用證記錄信息條數(shù)

42息qryStrtNum起始查詢筆數(shù)number(4)默認為0

43qryNum需要查詢筆數(shù)number(4)—

44返回信stCode返回狀態(tài)碼string(2)應符合附錄A表A.6的規(guī)定

45息stMsg返回狀態(tài)碼描述string(100)—

3

DB35/T1960—2021

7數(shù)據(jù)交換方式

7.1數(shù)據(jù)對接方式

對接方式包括但不限于：

a)專線+HTTP；

b)HTTPS+CA證書。

7.2數(shù)據(jù)加密方式

數(shù)據(jù)加密方式包括但不限于：

a)SM2橢圓曲線公鑰密碼算法；

b)RSA算法。

8接口調(diào)用方式

8.1請求

8.1.1接口調(diào)用地址：

a)專線+HTTP：http://IP地址/銀行代碼/附錄B中的URI，常見的銀行代碼應符合附錄C的要

求；

b)HTTPS+CA證書：https://IP地址/銀行代碼/附錄B中的URI。

8.1.2請求方法為post，接口調(diào)用示例參見附錄D。

8.2返回

8.2.1返回報文體格式為JSON。

8.2.2交易成功時，返回信息見附錄B中的輸出數(shù)據(jù)項；交易失敗時，返回信息為返回狀態(tài)碼和返回

狀態(tài)碼描述。

8.2.3HTTP返回狀態(tài)碼描述詳見IETFRFC7231規(guī)范定義。

9報文頭

9.1報文頭參數(shù)

報文頭參數(shù)見表2。

表2報文頭參數(shù)

序號字段名稱字段中文名稱說明

1X-Client-ID應用標識—

2X-SIGNATURE報文簽名—

9.2簽名方式

9.2.1客戶端簽名：

a)輸入：content（請求報文體）、secret（密鑰）；

4

DB35/T1960—2021

b)輸出：signature（簽名）。

9.2.2簽名過程要求：

a)content至少經(jīng)過兩次不同加密算法加密處理；

b)最終生成的signature需要轉Base64編碼輸出。

9.2.3調(diào)用signBytes方法時采用JSON字符串，調(diào)用API時請求報文體格式為JSON。

10接口信息描述

10.1接口信息描述包括但不限于以下內(nèi)容：

a)接口類型；

b)URI；

c)功能；

d)輸入數(shù)據(jù)項；

e)輸出數(shù)據(jù)項；

f)方法：

1)查詢字符串（描述資源的鍵/值對）；

2)消息體（描述HTTP請求的消息體）；

3)返回結果（描述HTTP請求的響應）。

10.2接口信息描述參見附錄B，接口報文示例參見附錄E。

5

DB35/T1960—2021

附錄A

（規(guī)范性）

數(shù)據(jù)字典

數(shù)據(jù)字典見表A.1～表A.6。

表A.1會員賬戶狀態(tài)代碼

序號會員賬戶狀態(tài)代碼描述

11正常

22凍結

33掛失

44臨時止付

55透支

66睡眠

77銷戶

89其他

會員賬戶狀態(tài)代碼應符合JR/T0014—2005中表4的規(guī)定

表A.2訂單狀態(tài)代碼

序號訂單狀態(tài)代碼描述

101訂單已撤銷

211進口訂單已生成，未付款

312進口訂單已付匯

413進口訂單已結清

521出口訂單已生成，未收匯

622出口訂單已收匯

723出口訂單已結清

表A.3訂單類型代碼

序號訂單類型代碼描述

11進口訂單

22出口訂單

表A.4信用證狀態(tài)代碼

序號信用證狀態(tài)代碼描述

101已通知

202已寄單

303已到單

404已承兌

6

DB35/T1960—2021

表A.4信用證狀態(tài)代碼（續(xù)）

序號信用證狀態(tài)代碼描述

505已收匯

606已付匯

707已注銷

808余額不足

表A.5批量查詢申請狀態(tài)代碼

序號批量查詢申請狀態(tài)代碼描述

11結果未生成

22結果已生成

表A.6返回狀態(tài)碼

序號返回狀態(tài)碼描述

100交易成功

210交易處理中

320參數(shù)校驗失敗

499未知錯誤

7

DB35/T1960—2021

附錄B

（資料性）

接口信息描述

接口信息描述見表B.1。

表B.1接口信息描述

方法（POST）

接查

返

口詢消

URI功能輸入數(shù)據(jù)項輸出數(shù)據(jù)項回

類字息

結

型符體

果

串

*

建立商戶會員臺平臺會員聯(lián)系電話、平臺會員聯(lián)

**

memberSt新賬，只建立會員臺系人、平臺會員名稱、平臺會員

**

ndBkCrt增賬，不綁定銀行實地址、平臺會員編號、統(tǒng)一社會

*

賬戶信用代碼平臺會員聯(lián)系電話

*

對部分會員信息進、平臺會員聯(lián)系人

**

會行修改，可修改字平臺會員聯(lián)系電話、平臺會員聯(lián)、平臺會員名稱、

*

員memberSt修段為：平臺會員名系人、平臺會員名稱、平臺會員平臺會員地址、平

**

臺ndBkUdt改稱、平臺會員地址、地址、平臺會員編號、統(tǒng)一社會臺會員編號、平臺

**輸輸

賬平臺會員聯(lián)系人、信用代碼會員狀態(tài)、統(tǒng)一社

*入出

接平臺會員聯(lián)系電話會信用代碼、交易

的的

口刪除會員臺賬，不流水號、返回狀態(tài)

*數(shù)數(shù)

memberSt刪刪除數(shù)據(jù)記錄，只碼、返回狀態(tài)碼描

*據(jù)據(jù)

ndBkDel除將會員標志置為平臺會員編號、統(tǒng)一社會信用代述

*項項

“2-銷戶”碼N/A

JSJS

memberSt查查詢已建立的會員

ONON

ndBkQry詢臺賬的詳細信息

格格

平臺會員名稱*、平臺會員編號*、

式式

平臺會員實賬號、統(tǒng)一社會信用代

報報

碼*、商品名稱、訂單金額*、訂單

訂平臺會員編號、統(tǒng)一文文

幣種*、訂單號*、訂單類型*、受益

單社會信用代碼、訂單

人賬號、受益人銀行BICNO.、受**

信新時間、訂單號、訂

orderRgst登記訂單益人銀行名稱、受益人國別名稱、*

息增單狀態(tài)、交易流水

受益人國別代碼、受益人名稱、開*

接號、返回狀態(tài)碼、

證銀行BICNO.、開證銀行名稱、

口返回狀態(tài)碼描述

申請人國別名稱、申請人國別代

碼、申請人名稱、信用證編號*、

發(fā)票編號

8

DB35/T1960—2021

表B.1接口信息描述（續(xù)）

方法（POST）

接查

返

口詢消

URI功能輸入數(shù)據(jù)項輸出數(shù)據(jù)項回

類字息

結

型符體

果

串

*

平臺會員名稱、平臺會員編

平臺會員名稱、平臺會員

*號、平臺會員實賬號、統(tǒng)一

編號、平臺會員實賬號、

*社會信用代碼、商品名稱、

統(tǒng)一社會信用代碼、商**

訂單金額、訂單幣種、訂單

品名稱、訂單金額、訂單***輸輸

*時間、訂單號、訂單狀態(tài)、

幣種、訂單號、修改后*入出

訂單類型、受益人賬號、受

訂單狀態(tài)、受益人賬號、的的

修改訂單狀態(tài)，或益人銀行BICNO.、受益人銀

訂orderIn修受益人銀行BICNO.、受數(shù)數(shù)

者修改訂單中部分行名稱、受益人國別名稱、

單foUdt改益人銀行名稱、受益人據(jù)據(jù)

信息受益人國別代碼、受益人名

信國別名稱、受益人國別項項

稱、開證銀行BICNO.、開證N/A

息代碼、受益人名稱、開證JSJS

銀行名稱、申請人國別名稱、

接銀行BICNO.、開證銀行ONON

申請人國別代碼、申請人名

口名稱、申請人國別名稱、格格

稱、交易流水號、信用證編

申請人國別代碼、申請人**式式

*號、發(fā)票編號、返回狀態(tài)碼、

名稱、信用證編號報報

返回狀態(tài)碼描述

文文

撤銷登記過的訂*平臺會員編號、統(tǒng)一社會信用

平臺會員編號、統(tǒng)一社**

orderIn刪單,撤銷成功后無**代碼、訂單號、訂單狀態(tài)、

會信用代碼、訂單號、*

foDel除法進行各類業(yè)務場*交易流水號、返回狀態(tài)碼、

信用證編號

景返回狀態(tài)碼描述

9

DB35/T1960—2021

表B.1接口信息描述（續(xù)）

方法（POST）

接查

返

口詢消

URI功能輸入數(shù)據(jù)項輸出數(shù)據(jù)項回

類字息

結

型符體