浦东发展银行银企直连系统接口说明书-客户版本20161213

1、上海浦东发展银行银企直联系统接口说明书总行信息科技总部开发中心2016年12月6日修订时间修订内容修订人补充说明2009-4-17增加支付授权功能吴欣峰2009-9-15增加“理财业务功能”吴欣峰2009-10-198924输出接口王莉莉调整note字段说明2009-12-178924输出接口王莉莉调整字段大小写2009-12-23修改8804接口吴欣峰删除8804交易中的payeeAddress字段，核心接口中没有该字段2010-4-94605输入接口吴欣峰4605增加transferType字段的备注2010-4-20增加“统管资金池功能”、“代理支付功能”吴欣峰8821，8822，879

2、2，87952010-4-29增加“银企直联系统主要错误代码”的说明王莉莉2010-6-12新增贷款信息查询、保证金信息查询接口说明吴欣峰贷款6311，6312保证金44122010-7-30更新9001，9003交易明细中的BEIZXX字段的长度王莉莉2010-8-19新增代发工资的接口吴欣峰5652、5626、56302010-9-8修改8801接口，增加跨行支付的速选功能吴欣峰、王莉莉新增8801增加收款行速选功能及接口说明2010-12-21修改8800接口，增加跨行支付的速选功能王炳卓新增8800增加收款行速选功能及接口说明2011-08-19增加电子商业汇票各功能接口刘毅2011-

3、08-19修改8821接口,增加速选功能刘毅2011-12-9更新EY02接口刘毅、姚静2011-12-9新增备付金存管接口刘毅2012-08-07新增新现金管理平台位佳2012-11-22理财产品位佳、朱小明2013-04-16新增质押查询7404位佳、朱小明2013-08-20增加国泰君安代理结算类朱小明、聂莲2013-10-28增加ER57和ER58账户支付控制朱小明、聂莲2013-11-05增加FT20和FN20的输出的记录状态字段说明倪晨2013-11-13增加网银互联类交易朱小明、聂莲2013-12-09增加4403交易朱小明、聂莲2013-12-20增加对公跨行代收付业务朱小明、

4、聂莲2014-02-24增加跨境及法透业务朱小明、聂莲2014-04-22修改5652代发工资业务接口朱小明、聂莲2014-06-03新增8810中登出入金交易新增5635代发工资网银授权查询交易修改EY02单笔支付网银授权查询接口朱小明、聂莲2014-08-256311接口优化，增加手续费金额字段聂莲、雒晶2014-08-29增加EY02的报文聂莲、雒晶2014-09-05理财产品交易接口优化，增加若干字段聂莲、雒晶2014-09-10增加9004日间账户明细下载交易聂莲、雒晶2014-09-12新增虚账户管理交易聂莲、雒晶2014-09-15修改理财产品某些交易的若干字段含义聂莲、雒晶20

5、14-09-25虚账户管理增加交易及修改某些交易的字段聂莲、雒晶2014-10-30中登出入金交易字段含义优化聂莲、雒晶2014-12-03增加8924报文及优化后添加部分字段聂莲、雒晶2014-12-04增加EY02,5635新增电子凭证号优化交易聂莲、雒晶2014-12-30增加大批量支付8802,8805交易配套优化朱小明、雒晶2015-05-05增加单笔支付同城版8806交易朱小明、雒晶2015-05-05增加跨境人民币资金池额度控制FK29和FK30交易朱小明、雒晶2015-07-09银企直联优化版EG30，新增银企直联交易客户号字段朱小明、雒晶2015-07-15银企直联8801单

6、笔支付增添authMasterID字段朱小明、雒晶2015-10-28新增FK38新现金管理平台按比例上拨规则交易雒晶、陈威2016-01-08新增 FM00批量支付申请提交交易新增 FM26批量支付登记簿模糊查询交易新增 FM27付明细单笔查询申请交易新增 FM28支付明细动态查询申请的处理结果查询新增 FM29批量支付明细结果查询雒晶、陈威2016-01-08新增 EI03跨境汇款交易新增 EK05跨境业务附加信息查询交易雒晶、陈威2016-01-26新增 FW28人民币资金池实时变动值维护交易新增FW29人民币资金池历史净额变动值维护查询雒晶、徐洪宝2016-01-26电票交易优化（EE

7、21,EE22,EE23，EE25，EE27，EE28)雒晶、徐洪宝2016-04-08新增境内外币业务雒晶、徐洪宝2016-04-08对公跨行代收付业务优化雒晶、徐洪宝2016-06-06E企付功能雒晶、徐洪宝2016-07-04人民币资金池及统管资金池配套改造（FK29、FK30、8795）雒晶、徐洪宝2016-08-11新增外币资金池交易（外币资金池交易目录下）雒晶、徐洪宝2016-09-08中移电商超网优化徐洪宝、EG01、EG42新增客户号directMasterID，EG01收款账户类型含义改变2016-11-18电子商业汇票授权优化朱海雨新增DO45业务流水查询功能新增EF55已

8、入池票据信息查询、EF79票据池余额查询2016-11-18实时代收付朱海雨修改DS71输入明细字段格式2016-12-06批量支付增加二次授权优化雒晶8800、8802交易请求中新增接口字段；新增DO48、DO49交易接口2016-12-06实时代收付新增交易雒晶新增DS75、DS76、DS79交易接口；修改DS71接口的payChannelNo字段说明目录一、 报文相关约定11.1 报文字段类型说明11.2 交易返回码说明：1二、 报文格式说明1三、 整体报文内容3四、 账户管理交易报文34.1 账户余额查询（4402）34.2 对公活期账户历史余额查询（4403）54.3 账户明细查询（

9、4404）现在请使用8924交易74.4 账户明细查询（8924）104.5 日终明细获取（9001）134.6 日终明细获取（9003）224.7 日间账户明细下载（9004）234.8 统管资金池一级账户查询（8792）264.9 统管资金池一级账户交易明细查询（8795）294.10 贷款信息查询（6312）314.11 贷款明细信息查询（6311）334.12 保证金余额查询（4412）35五、 转账支付交易报文375.1 单笔支付（8801）375.2 批量支付（8800）415.3 大批量支付（8802）465.4 转账信息查询（8804）505.5 大批量支付查询（8805）55

10、5.6 转账网银授权整包状态查询（DO48）605.7 批量转账网银授权明细状态查询（DO49）635.8 银企直联单笔支付同城版（8806）675.9 支付交易撤销（8809）715.10 网银授权信息查询（EY02）735.11 网银授权信息电子凭证号版查询（EY03）755.12 单笔代理支付（8821）785.13 代理支付信息查询（8822）835.14 行内转账批量支付申请提交交易（FM00)885.15 行内批量支付登记薄模糊查询交易(FM26)915.16 行内支付明细单笔查询申请交易(FM27)945.17 行内支付明细动态查询申请的处理结果查询（FM28)975.18 批量

11、支付明细结果查询(FM29)100六、 集团业务交易报文1036.1 集团账户归集（4605）1036.2 查询集团账户历史余额（4469）1056.3 集团客户关系查询（4603）1076.4 集团账户设置约定规则的查询（4615）1096.5 查询集团账户资产汇总信息（4620）1116.6 查询集团账户负债汇总信息（4621）1116.7 查询集团账户资产当日明细信息（4623）1136.8 查询集团账户负债当日明细信息（4624）1146.9 查询集团账户交易明细（4629）1156.10 实时补足情况查询（4640）1166.11 查询集团账号可用余额（4641）117七、 定期存款

12、业务交易报文1187.1 FT20 定期存款查询1187.2 FT00 活期存款转定期存款1217.3 FT01 定期存款转活期存款123八、 通知存款业务交易报文1258.1 FN20 通知存款查询1258.2 FN00 活期存款转通知存款1278.3 FN01 通知存款支取通知1298.4 FN20 通知存款通知取消1308.5 FN03 通知存款部分支取1328.6 FN04 通知存款全额支取1348.7 FN21 通知存款支取通知查询136九、 利多多通知理财交易报文1389.1 FB20 利多多通知存款查询1389.2 FB00 活期转利多多通知存款A1409.3 FB01 利多多通

13、知存款A转活期1429.4 FB21 利多多通知存款明细查询143一、 代发工资交易报文14510.1 5652 代发工资文件提交/预校验14510.2 5626 非网银授权代发工资交易信息批量查询14810.3 5630 代发工资文件提交/预校验结果信息单笔查询15010.4 5635 网银授权代发工资交易结果信息批量查询15310.5 5636 走授权路线代发工资交易信息批量查询（带电子凭证号版）156一一、 外币资金池交易16011.1 8858 外币资金池划拨16011.2 8828 外币资金池账户对实时净额查询16211.3 8861 外币资金池内部交易明细查询16611.4 882

14、6 外币资金池利率设置16711.5 8827外币资金池综合信息查询（利率、规则类型、可用余额）17011.6 8859外币资金池历史净额查询17411.7 FG64外币资金池手动调拨17611.8 FG69外币资金池双向额度查询17811.9 FG70外币资金池通道本金调拨18011.10 FG71外币资金池通道本金归还18311.11 FG72外币资金池通道利息支付18511.12 FG73外币资金池通道调拨本金与归还状态查询18711.13 FG74外币资金池通道调拨本金流水查询19011.14 FG75外币资金池通道调拨利息查询19211.15 FG77外币资金池账户调拨规则查询195

15、11.16 FG78外币资金池主账户查询197一二、 电子商业汇票19912.1 EE02 出票申请19912.2 EE03 提示承兑20212.3 EE04 提示收票20512.4 EE05 通用撤销交易20812.5 EE06 通用签收报文20912.6 EE07 贴现申请21212.7 EE09 质押申请21612.8 EE11 撤票申请21812.9 EE12 背书22012.10 EE13 保证申请22212.11 EE14 提示付款22412.12 EE15 追索通知22612.13 EE16 追索同意清偿22912.14 EE21 票面基本信息查询23112.15 EE22 票面

16、详细信息查询23412.16 EE23 票据业务查询（可操作票据查询）23812.17 EE24 票据流转信息查询24212.18 EE25 待签收查询24712.19 EE26 业务流水查询25212.20 EE27 批次交易查询25512.21 EE28 批次明细查询25812.22 EF59 照票申请26212.23 EF60 照票详细信息查询26412.24 EF61 通用签收报文（批量方式）26812.25 DO45业务流水查询27112.26 EF55已入池票据信息查询交易描述：27512.27 EF79票据池余额查询交易描述：278一三、 备付金存管28113.1 E079 备付

17、金账号查询28113.2 E080 备付金资金调拨28413.3 E081 备付金当日明细查询28713.4 E082 备付金历史明细查询29113.5 E083 支付公司批量出金29413.6 E084 备付金批次号查询29713.7 E085 备付金批次结果查询299一四、 新现金管理平台30214.1 EC96人民币资金池集团往来交易信息查询30214.2 EC97人民币资金池集团外交易信息查询30514.3 4697集团内部调拨资金汇总查询30714.4 EC25人民币资金池规则查询30914.5 EC26人民币资金池上收规则修改31214.6 EC27人民币资金池定时下拨规则修改31

18、414.7 EC28人民币资金池实时补足规则修改31714.8 EC05 集团客户关系查询31914.9 EC33人民资金池集团账户净额多笔查询32114.10 EC34人民资金池集团账户实时净额单笔查询32314.11 EC48人民币资金池资金内部计价利率查询32614.12 EC49人民币资金池资金内部计价利率维护32814.13 EC55人民币资金池集团账户历史净额查询33014.14 FK38 新现金管理平台按比例上拨规则33214.15 FW28人民币资金池实施净额变动值维护33614.16 FW29人民币资金池历史净额变动值维护查询33814.17 FK29跨境资金池额度信息查询3

19、4014.18 FK30跨境资金池手工划拨342一五、 理财产品345注意：该章节交易目前暂无法使用，如有客户理财交易相关需求请提前咨询总行业务部门，银企直联系统需要开发后才能支持相应业务。34515.1 1903理财产品基本信息查询34515.2 1909理财产品详细信息查询34915.3 1902理财产品认购35515.4 1904理财产品申购35815.5 1913理财产品委托明细查询36115.6 1907理财产品撤单(可操作所有渠道)36315.7 1914理财产品成交查询36615.8 1915理财产品分红查询36915.9 1912 理财产品持仓查询37215.10 1905理财

20、产品赎回37415.11 1925最短持有期产品冻结份额明细查询37715.12 1928产品可售额度查询37915.13 1929 固定持有期持仓明细查询38115.14 1936理财在售产品信息文件下载384一六、 质押查询38616.1 7404质押查询386一七、 国泰君安代理结算38917.1 8661发起查复38917.2 ER33待查复业务下载39117.3 ER34待查复业务下载后确认39517.4 ER20汇出业务申请39617.5 ER22汇出业务多笔查询40017.6 ER21单笔汇出业务查询40417.7 ER30汇入业务下载40917.8 ER31单笔汇入业务下载确认

21、41317.9 ER23多法人业务对账41417.10 ER00行号同步申请41717.11 EJ10业务查复交易41817.12 EX02 信息类业务来账下载42117.13 EJ09发起业务查询交易42417.14 EX03来账业务下载确认42617.15 EX10信息类业务模糊查询42817.16 EI03跨境汇款43017.17 EK05跨境业务附加信息查询交易435一八、 增加账户支付控制43818.1 ER57支付限额维护43818.2 ER58支付限额查询440442一九、 网银互联44319.1 EG14他行信息查询签约功能申请44319.2 EG08他行账户余额查询申请444

22、19.3 EG09他行账户明细查询申请44619.4 EG41他行信息查询签约协议查询44719.5 EG01网银互联跨行转账45019.6 EG42网银互联转账交易信息查询45219.7 EG48网银支付行名行号表查询45519.8 EG30网银互联交易结果信息查询45619.9 EG99网银互联结果文件下载460二、 对公跨行代收付业务46220.1 DS70代收付签约信息查询46220.2 DS71代收/代付交易功能46420.3 DS72代收付批次结果状态查询46820.4 DS73代收付明细结果查询47020.5 DS75跨行实时单笔代收付交易47320.6 DS76跨行实时单笔代收

23、付查询交易47820.7 DS79跨行实时单笔代收付对账交易480二一、 跨境业务查询48421.1 8712境外客户账户多笔查询48421.2 8713境外客户账户明细查询486488二二、 法人透支业务48922.1 4372法人透支账户信息查询489490二三、 中登出入金49123.1 8810中登出入金491二四、 虚账户管理49524.1 4362建立母实子虚账户关联49524.2 5144虚账户母子关系登记薄查询49924.3 4381分摊规则查询50124.4 4465母实子虚账户收入支出分摊查询50324.5 4466母实子虚账户收入支出分摊50624.6 4467母实子虚账

24、户分摊注销50824.7 5145虚账户已分摊交易明细查询51024.8 4662母账户未分摊明细查询51424.9 4476虚账户之间资金划拨51724.10 4468集团账户即时余额查询51924.11 4469集团账户历史余额查询52124.12 5148虚账户发起转账523二五、 外币结算业务52725.1 WB01境内外币支付批量业务申请52725.2 WB02结售汇业务单笔申请53125.3 WB11境内外币支付业务申请单笔查询53425.4 WB12境内外币支付业务申请多笔查询53625.5 WB13结售汇业务申请单笔查询53925.6 WB14结售汇业务申请多笔查询54525.

25、7 WB15汇率查询54725.8 8931单笔跨境、境内外币汇款申请55025.9 8932跨境、境内外币汇款申请单笔查询55625.10 8935跨境、境内外币汇款申请批量查询56225.11 8938跨境、境内外币汇款申请撤销565二六、 E企付功能56726.1 FS05 E企付交易付款明细查询56726.2 FS06 E企付转账57126.3 FS00 E企付信息查询574二七、 交易签名说明576二八、 银企直联系统主要错误码57711上海浦东发展银行银企直联系统文档笃守诚信文档名称：银企直连接口说明书创造卓越一、 报文相关约定1.1 报文字段类型说明Datetime：表示时间戳

26、格式如下: YYYY-MM-DD HH:MM:SSDate：表示日期 格式如下：YYYMMDDFixString（n）：表示固定长度的字符串，左对齐VarString（m）：表示变长的字符串，最长为mFixNumber（n）：表示固定长度的数字，如果长度不够长度右对齐左补空格VarNumber（n,m）：表示变长的数字，n表示最大长度（包括小数点）m表示小数位数1.2 交易返回码说明：交易返回码，是7位的字符。如果交易成功则返回的是对应交易的应答报文体，如果是失败则返回错误报文体。通常情况下，AAAAAAA：表示交易成功，即银行成功收到交易报文；其余返回码均表示处理过程中，发生了失败的情况。这

27、里需要特别指出的是4404和8924的查询交易，当查询账号明细时，可能会收到EGG0521的返回，这个返回表示核心没有该查询条件的明细，银行已经受理了这个请求报文。其中，EYY开头的返回码表示银企直联系统服务器返回的错误码，其他的返回码表示由银行业务处理系统返回。二、 报文格式说明报文报文头报文体 （packetheadbody）报文头（报文字段）n （head（field）n）报文体（报文字段|报文循环字段）* （body（field|lists）*）*）报文循环字段（报文字段）* （lists（list）*） (list=(field)*) 注：n：表示有n个字段 *：表示有一个或者多个字

28、段报文头字段描述：请求报文头字段说明类型是否必输备注transCode交易码FixString（4）Y发送的交易码signFlag签名标志FixString（1）Y0：表示数据没有签名1：表示数据经过签名企业提交浦发的所有报文都必须签名，浦发返回的结果报文除9001，9003外，其它都经过签名。masterID企业客户号FixString（10）Y企业的唯一客户号packetID报文号VarString（20）Y对应企业发送报文的报文号当天内唯一timeStamp交易时间戳DatetimeY企业发送报文的时间戳【注】报文号-企业ERP系统向银行综合业务系统发送报文时，标识该报文的唯一性，企业流

29、水号由企业ERP系统产生，当天内唯一。应答报文头字段说明长度是否必输备注transCode交易码FixString（4）Y交易码signFlag签名标志FixString（1）Y0：表示数据没有签名1：表示数据经过签名packetID报文号FixString（20）Y对应上送的报文号timeStamp交易时间戳DatetimeY银行返回报文的时间戳returnCode返回码FixString（7）Y交易对应的返回码错误报文内容（交易码ERROR）字段说明类型是否必输备注returnCode错误码FixString（7）Y交易对应的返回码returnMsg错误信息描述VarString（100）

30、Y错误码对应的错误信息内容经过签名的报文内容字段说明类型是否必输备注Signature签名后的数据VarString（2048K）Y表示数据内容经过签名的相关内容以及三、 整体报文内容报文长度具体交易报文报文长度：固定长度6位，不足后面补空格，表示报文的总长度，包括报文长度的6位具体交易报文的长度具体交易报文：不定长度，XML形式描述的具体交易内容。四、 账户管理交易报文4.1 账户余额查询（4402）交易描述：该交易用于查询企业相关多个账户的当前余额信息。接口要素交易码：4402请求：字段说明类型是否必输备注循环acctNo账号VarString（20）Y要查询余额的账号应答：字段说明长度备

31、注循环（一次查询不超过10个账户）acctNo账号VarString（20）账户masterID客户号FixString（10）该账户对应的客户号balance账号余额VarNumber（15，2）账户的当前余额reserveBalance保留余额VarNumber（15，2）freezeBalance冻结余额VarNumber（15，2）cortrolBalance控制余额VarNumber（15，2）canUseBalance可用金额VarNumber（15，2）overdraftBalance透支余额VarNumber（15，2）Xml文件请求：44021 1234567890 1122

32、334455 2004-07-28 16:14:25 12345678900000应答：44020 1234567890 2004-07-28 16:14:29 AAAAAAA 12345678900000001122334455231234.3430.23999.00123.23444.2 对公活期账户历史余额查询（4403）交易描述：该交易用于对公活期账户历史余额查询。接口要素交易码：4403请求：字段说明类型是否必输备注acctNo账号VarString（20）YbeginDate开始日期VarString（8）YendDate结束日期VarString（8）Y开始和结束日期不能超过30

33、天应答：字段说明长度是否必输备注acctNo账号VarString（20）currency货币代号FixString（2）循环transDate交易日期VarString（8）balance账户余额VarNumber（15，2）账户余额，非可用余额balanceFlag余额标志FixString（2）0：借方，1：贷方Xml文件请求：应答： 4.3 账户明细查询（4404）现在请使用8924交易交易描述：该交易用于查询企业账户的明细信息。如果输入的起始日期都为当日，则为查询当日明细信息。查询历史明细时开始日期和结束日期的间隔不超过一个会计月度。务必注意每次查询笔数为20笔，如果超过20笔的明细

34、，需要通过客户端自行组包成多次查询，务必关注返回包中的“总笔数”。接口要素 交易码：4404请求：字段说明类型是否必输备注acctNo账号VarString（20）Y需要查询的企业账户。必须是已经签约的账户beginDate开始日期DateY日期之差在一个会计月之内endDate结束日期DateYqueryNumber查询的笔数FixNumber（2）Y请输入20beginNumber查询的起始笔数VarNumber（4）Y从1开始应答：字段说明长度备注totalCount交易总笔数VarNumber（7）acctNo账号VarString（20）账户Currency账户币种FixString

35、（2）以下为循环域voucherNo凭证号VarString（13）seqNo交易流水号FixString（12）txAmount交易金额VarNumber（13，2）Balance账户余额VarNumber（15，2）tranFlag借贷标志FixString(1)0：借1：贷transDate交易日期DatetransTime交易时间VarNumber(6)HHMMSS，最长6位，最短只有1位Note备注VarString（60）客户交易时候的附言Remark摘要代码VarString（22）银行补充的说明payeeBankNo对方行号VarString（12）payeeBankName对

36、方行名VarString（62）payeeAcctNo对方账号VarString（32）payeeName对方户名VarString（60）Xml文件请求：4404 0 1234567890 1122334455 2004-07-28 16:14:25 123456789000002004072820040728101应答：4404 0 1234567890 2004-07-28 16:14:29 AAAAAAA 1077402321243215011.0035445507.880200409060912230测试桥北路营业部4.4 账户明细查询（8924）交易描述：该交易用于查询企业账户的明

37、细信息。如果输入的起始日期都为当日，则为查询当日明细信息。查询历史明细时开始日期和结束日期的间隔必须在一个月之内。该交易与4404交易最大的不同再于可以区分出我行记账的唯一一笔流水。接口要素 交易码：8924请求：字段说明类型是否必输备注acctNo账号FixNumber（20）Y需要查询的企业账户。必须是已经签约的账户beginDate开始日期DateY日期之差在一个月之内endDate结束日期DateYqueryNumber查询的笔数FixNumber（2）Y默认为20beginNumber查询的起始笔数FixNumber（4）Y默认为1transAmount交易金额DOUBLENsubAccount对方帐号CHAR(32)NsubAcctName对方户名CHAR(62)N应答：字段说明长度备注totalCount交易总笔数FixNumber（7）acctNo账号FixNumber（20）账户acctName账号名称VarString（60）currency账户币种FixNumber（2）以下为循环域voucherNo凭证号FixNumber（13）seqNo交易流水号FixNumber（12）记账流水txAmount交易金额VarNumber（13，2）balance账户余额