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

ICS35.240.30CCSA80福建省地35方标准DB35/T1960—2021单一窗口进出口信用证服务系统接口技术要求Thetechnicalrequirementofinterfaceforimportandexportcreditservicesystemofsinglewindow福建省市场监督管理局发布IDBT021 附录D(资料性)接口调用示例(以Java代码为例) 13附录E(资料性)接口报文示例(JSON) 19 DBT021前言文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定福建天础信息科技有限公司、1DBT021。引用文件GBT世界各国和地区名称代码GBT57信息技术软件工程术语GBT表示货币和资金的代码GBT银行业银行电信报文银行标识代码GB法人和其他组织统一社会信用代码编码规则JRT05银行信息化通用代码集RFCHypertextTransferProtocolHTTPSemanticsandContent义dowit2DBT0214缩略语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)基本要求c数据项1ontactTel话—2rspName人—3emName4emAddr5emIdPM+时间(yyyyMMddHH)+8位数字序列号6emRlAcct号—7emSt合附录A表A.1的规定8ocCrdtNo码GB1009息—eSeqNo—3DBT021number位小数息GBT12406yyyyMMddHHmm:ss规则为EO+时间(yyyyMMddHH)+8位数字序A表A.2的规定录A表A.3的规定ftrOrdrStA表A.2的规定AcctNo—BBIC码BICNO.GBT16711BName—CNameGBT659CtyGBT9，为三字符拉丁字母代码Name—码BICNO.GBT16711—meGBT659GBT9，为三字符拉丁字母代码e——tnumber位小数yGBT12406number位小数o—GBT12406crCtfRst对象数组—AA的规定—ode—息录A表A.5的规定mmber条数mmbermber—息A表A.6的规定—4DBT021式对接方式a线+HTTP；加密方式调用方式.1请求.2返回9报文头.1报文头参数1X-Client-ID—2NATURE—9.2签名方式a)输入：content(请求报文体)、secret(密钥)；5DBT021b)输出：signature(签名)。N1)查询字符串(描述资源的键/值对)；2)消息体(描述HTTP请求的消息体)；3)返回结果(描述HTTP请求的响应)。6DBT021附录A(规范性)数据字典见表A.1~表A.6。A代码代码1122334455667789码应符合JR/T0014—2005中表4的规定A码12成，未付款3付汇4结清567A码1122A码12347DBT0215678A状态代码状态代码1122A12348DBT021附录B(资料性)信息描述见表B.1。B接口类型I方法(POST)查询字符串消息体返回结果会员台账接口berStrt新增建立商户会员台账，只建立会员台账，不绑定银行实平台会员联系电话流水号、返回状态述NA输入的数据项格式报文输出的数据项格式报文berStdt修改对部分会员信息进行修改，可修改字段为：平台会员名平台会员联系人、电话平台会员联系电话、平台会员联系人、平台会员名称、平台会员berStel删除删除会员台账，不删除数据记录，只将会员标志置为“2-销户”*码berStry查询查询已建立的会员订单信息接口新增申请人国别名称、申请人国别代9DBT021接口类型I方法(POST)查询字符串消息体返回结果订单信息接口修改修改订单状态，或者修改订单中部分币种、订单号*、修改后益人银行名称、受益人国别名称、受益人国别号、平台会员实账号、统一受益人国别代码、受益人名申请人国别代码、申请人名称、交易流水号、信用证编NA输入的数据项格式报文输出的数据项格式报文删除撤销登记过的订单,撤销成功后无法进行各类业务场景台会员编号*、统一社DBT021接口类型I方法(POST)查询字符串消息体返回结果订单信息接口查询会员已登记订单号*、信用证编号*台会员编号、平台会员实账号、统一社会信用代码、商受益人账号、受益益人银行名称、受益人国别名称、受益人国别代码、受益人名称、开证银行名称、申请人国别名称、申请人国别代码、申请人名称、交易流水号、NA输入的数据项格式报文输出的数据项格式报文DBT021接口类型I方法(POST)查询字符串消息体返回结果信用证查询接口询—统一社会信用代平台会员编号、统一社会信用代交易币种*、信用证金额*、信用证币种*、信用证编号、信用证交单、通知编号、查询结果总数量*、返回状态码*、述NA输入的数据项格式报文输出的数据项格式报文crCtfBtchQryApl——受理编号*、交易流水号、返回状—、实际交易金额*、实际交易信用证状态*、通知编号、申请状态*、查询结果总数量、返回状态见附录D见附录E中涉及“平台会员编号”和“统一社会信用代码”的，可选择其中一项DBT021附录C(规范性)C行代码1H23OC456BC789股份有限公司DBT021附录D(资料性)publicclassJsonUtil{ingObjectconfignewHashMapStringObjectparamobj被转换的对象publicstaticStringParseObjectObjectobj){}turnJsonObjectwsUnsupportedEncodingExceptionpublicstaticJsonObjectStringObjectParseJsonStringjsonStr)throwspportedEncodingExceptionJsonObjectStringObjectjonewJsonObject();;DBT021ambanewByteArrayInputStreamjsonStrgetBytesUTFrnjo}}D名类description签名类publicclassCryptoSample{description取报文摘要paramalgorithm密钥parambytes请求报文体returnbyte摘要privatestaticbyte[]digestBytes(Stringalgorithm,byte[]bytes){try{ealgorithmmessageDigestupdatebytesturnmessageDigestdigest}catch(Exceptione){kTrace}rnnull}paramcipherAlgorithm算法/模式/补码方式paramkeyBytes密钥摘要DBT021paramkeyAlgorithm密算法名称paramcontentDigest文摘要returnString加密并编码后的字符串privatestaticStringencryptStringcipherAlgorithm,byte[]keyBytes,StringkeyAlgorithm,StringcontentDigest){try{SecretKeySpeckeySpecnewSecretKeySpeckeyByteskeyAlgorithm);byte[]iv=SpecivParamSpecnewIvParameterSpecivbyteencyptedBytescipher.doFinal(contentDigest.getBytes());byteresultBytesnewbyte[encyptedBytes.length+16];eslength}catch(Exceptione){kTrace}rnnull}description文签名paramcontent请求报文体paramsecret密钥returnstring签名后的字符串publicstaticStringsignBytes(byte[]content,byte[]secret){DBT021bytekeyBytes=newbyte[16];StringcipherAlgorithmAESCBCPKCSPadding;tringkeyAlgorithmAESyByteskeyAlgorithmcontentDigest}}publicclassHttpClientUtil{pClientclientnewOkHttpClientBuildereUnitMINUTESeUnitMILLISECONDSparamurl请求地址paramclientIdclientIdparamclientSecret密钥rnDBT021publicstaticStringpostWithJsonMsgStringjsonStr,Stringurl,StringtringclientSecretngresultaTypeMediaTypeparseapplicationjsoncharsetutfcreatemediaTypejsonStrRequestrequestnewRequest.Builder()ddHeadercontenttypeapplicationjsoncharsetutfderXClientIdclientIdtBytesSecretgetBytesbuildCallrequestexecuteresultnewStringresponsebodybytes,"UTF-8");OExceptionekTrace}rnresult}}D用description调用示例publicclassTest{立接口调用DBT021ramargspublicstaticvoidmainString[]args){JsonObjectobjnewJsonObjectobjputpltfContactTel8888888");objputpltfCrspName;XobjputpltfMemIdPM03272000000004");objputunfSocCrdtNo000012345678G");Stringurlhttp.0.1:9093/SPDB/memberStndBkCrt";acfcfnSuPoO5wK4dY8uX4aN0tT7hH6rU8jU7oW6aE7aI6iV6qO4qD");t}}DBT021(资料性)接口报文示例(JSON)EE文示例{pltfContactTel8",spNameltfMemNameXXXltfMemAddrXXpltfMemIdPM00000004",unfSocCrdtNo45678G"}E文示例{pltfContactTel8",pNameXXfMemNameXXXltfMemAddrXXpltfMemIdPM00000021",mStunfSocCrdtNo345678G",transNo11910034654561",}EE文示例{pltfContactTel8",spNameltfMemAddrXXpltfMemIdPM00000004",unfSocCrdtNo45678G"}E文示例DBT021E文示例{pltfMemIdPM00000021",unfSocCrdtNo45678G"}E文示例E询E3.1，输出报文示例：参见E.1.1.2。EEE文示例{pltfMemNameXXX,pltfMemIdPM00000021",ltfMemRlAcctXXXXXXXXXXXunfSocCrdtNo345678G",ordrAmt",SDordrNoEO0000001",crCtfNoILC}E文示例{pltfMemIdPM00000006",unfSocCrdtNo345678G",ordrDtTm18:10:09",ordrNoEO0000001",ttransNo200610097426655",}EE文示例DBT021{pltfMemIdPM00000021",ltfMemRlAcctXXXXXXXXXXXunfSocCrdtNo345678G",ordrNoEO0000001",rOrdrStrCtfNoILC}E文示例{pltfMemNameXXX,pltfMemIdPM00000021",ltfMemRlAcctXXXXXXXXXXXordrAmt",SDordrDtTm18:10:09",ordrNoEO0000001",ttransNo200610097426655",crCtfNoILC",MHCBJPJTuBNameMIZUHOBANKLTDTOKYOCNameRepublicofCubaUBNameLIDLHONGKONGLIMITED}E询