华夏银行银企直联系统企业与前置机接口综合v1.11

文档编号：华夏银行银企直联项目企业与前置机交易接口雅普兰科技发展有限公司2014年02月10日文档修改记录版本内容参考日期编写审核1.0创建文档2010/7/29刘旭东1.1修改：XHJ2001、XHJ2002XHJ3001、XHJ30022010/7/30刘旭东1．2补充XHJ3002返回明细状态标准数据（0失败1成功）2010/8/27刘旭东1.3补充银企直连一期、CR709及跨行支付接口2010/12/3刘旭东1.4修改xhj0001、xhj0002和xhj0009返回报文的循环体中最后两个备用域的名称：将“备用域1”改成“备用域1[备注：企业端流水号]”，将“备用域2”改成“交易时间”2011/5/17邓芳1.5修改内容如下：xhj1006上送报文循环体‘流水号’改成‘企业端流水号’xhj1007上送报文‘变码印鉴’改成‘企业端流水号’xhj3001上送和返回报2011/5/17邓芳文‘代发工资流水号’改成‘企业端流水号’xhj3002上送和返回报文‘代发工资流水号’改成‘企业端流水号’xhj3008上送和返回报文‘批量报销流水号’改成‘企业端流水号’xhj3009上送和返回报文‘批量报销流水号’改成‘企业端流水号’xhj3013上送报文‘交易流水号’改成‘企业端流水号’xhj3016上送报文‘变码印鉴’改成‘企业端流水号’xhj3010上送报文‘指令序号’改成‘企业端流水号’xhj3005上送和返回报文‘对公向对私转账流水号’改成‘企业端流水号’xhj3006上送和返回报文‘对公向对私转账流水号’改成‘企业端流水号’xhj3007上送报文‘转账流水号’改成‘企业端流水号’xhj2003返回报文‘流水号’改成‘批次号’xhj2004上送报文‘银行端流水号’改成‘批次号’xhj2012上送报文循环体‘流水号’改成‘企业端流水号’1.6“单账户当日明细查询（xhj0002）”和“单账户多日明细查询（xhj0009）”两支交易最后增加一句备注：如企业财务软件根据当日明细自动对账，请以“交易日期+会计流水（交易核心流水号）+交易金额+交易时间”四项要素共同作为对账标志。2011/5/18刘旭东1.7新增加交易：(新)跨行员工报销与借款（xhj2102）(新)网银跨行转账（xhj2108）单笔转账交易结果查询（xhj5001）批量转账交2013/7/9王得义易结果查询（xhj5002）代发工资(支持授权)（xhj4001）代发工资结果查询（支持授权）（xhj4002）直通转账（支持授权）（xhj4003）据付款帐号查询单笔转帐交易结果（xhj4019）对公向对私单笔转账（xhj4007）单账户多日明细查询（xhj4009）1.8增加xhj5003电子回单查询xhj5004手续费查询xhj5005银企直联存贷款利息查询2013/08/26王得义1.9增加新接口xhj5006当日来往账信息查询增加新接口xhj3017定期转活期支持部分定期转活期2013/10/18王得义1.10修改接口xhj5006当日来往账信息查询，返回给客户序号字段和交易时间字段交换位置2014/02/10王得义1.11增加新交易xhj4004代发工资xhj4005直通转账xhj4006对公向对私批量转账xhj4010对公向对私转账结果查询修改xhj4002代发工资结果查询xhj4019单笔转账结果查询一、概述本文档描述了银企直联企业端与银证直联前置机间的交易接口。采用SOCKETTCP/IP同步通信方式。二、接口描述报文元素之间以“#”分割，循环体内部以“|”分割，并以“|”结束循环体。报文结束符为“@@@@”例如：请求报文：xhj0001#4001213483821#20040315#@@@@返回报文：000000#111111111111#20100505#2#1|RMB|123454|0|100.00|2222222222|张|华夏行|20000.00|sdfsd|qwer|1|sdf|sdfs|#2|RMB|123455|0|100.00|2222222222|李|北京华夏|20000.00|sdfsd|qwer|1|sdf|sdfs|#@@@@返回代码：“000000”表示交易成功。1.查询单账户单日历史交易明细（xhj0001）此交易为查询单账户单日历史交易明细。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00012acctNo账号223transDate交易日期8yyyyMMdd响应报文编号代码名称类型长度固定值备注1response_code报文标识62acctNo账号223transDate交易日期8yyyyMMdd4rec明细数循环体条数5cyc_str循环体循环体格式：交易日期|明细序号|币种|会计流水|借贷标记[备注:1:借2：贷]|交易金额|对方账号|对方账户名|对方开户行|账户余额|摘要|附言|凭证种类|备用域1[备注：企业端流水号]|交易时间|2.查询单账户当日交易明细（xhj0002）此交易为查询单账户当日交易明细。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00022acctNo账号22响应报文编号代码名称类型长度固定值备注1response_code报文标识62acctNo账号22循环体条数3rec明细数4cyc_str循环体循环体格式：交易日期|明细序号|币种|会计流水|借贷标记[备注:1:借2：贷]|交易金额|对方账号|对方账户名|对方开户行|账户余额|摘要|附言|凭证种类|备用域1[备注：企业端流水号]|交易时间|注：如企业财务软件根据当日明细自动对账，请以“交易日期+会计流水（交易核心流水号）+交易金额+交易时间”四项要素共同作为对账标志。3.查询单账户单日历史余额（xhj0003）此交易为查询单账户单日历史余额。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00032acctNo账号223transDate交易日期8yyyyMMdd响应报文编号代码名称类型长度固定值备注1response_code报文标识62acctNo账号223transDate交易日期84Balance余额5Note1备用域16Note1备用域14.查询单账户余额（xhj0004）此交易为查询单账户余额。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00042acctNo账号22响应报文编号代码名称类型长度固定值备注1response_code报文标识62acctNo账号223Balance余额4availBal可用余额5Note1备用域16Note1备用域15.转账交易（xhj0006）此交易为普通转账交易，行内直通，行外落地，无法使用查询单笔转账交易结果交易查询转账结果。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00062entryDate录入日期3transType转账类型1：行内2：跨行4FlowNO企业端流水号205custID企业经办人1099999999996PayerAcct付款账号227Amount发生额8payeeAcctNo收款账号329payeeName收款人名称60跨行长度12010payeeBankName收款行名11payeeBankAddr收款行地址12abstract摘要响应报文编号代码名称类型长度固定值备注1response_code报文标识62Balance余额6.查询单笔转账交易结果（xhj0007）此交易为根据企业端流水号查询一笔转账的交易结果。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00072entryDate录入日期yyyyMMdd3FlowNo企业端流水号20响应报文编号代码名称类型长度固定值备注1response_code报文标识62succFlag成功标志1：成功0：失败3Transtatus交易状态对应net_flow的clbz1:已处理并扣帐0：银行已收妥待处理8：被银行柜台撤销9:被系统自动冲正7.集团内资金调拨（xhj0008）此交易为普通转账交易，为集团内部转账，故为行内转账。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00082FlowNO企业端流水号203PayerAcct付款账号224Amount发生额5payeeAcctNo收款账号6abstract摘要响应报文编号代码名称类型长度固定值备注1response_code报文标识62Balance余额8.单账户多日明细查询（xhj0009）此交易为查询单账户多日明细，也可包括当日明细。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00092acctNo账号223beginDate开始日期8yyyyMMdd4endDate结束日期8yyyyMMdd响应报文编号代码名称类型长度固定值备注1response_code报文标识62acctNo账号223rec明细数循环体条数4cyc_str循环体循环体格式：交易日期|明细序号|币种|会计流水|借贷标记|交易金额|对方账号|对方账户名|对方开户行|账户余额|摘要|附言-渠道|凭证种类-此字段不显示或显示字符|备用域1[备注：]|交易时间|核心不记录，报表记录，整理数据会在网银上显示渠道注：如企业财务软件根据明细自动对账，请以“交易日期+会计流水（交易核心流水号）+交易金额+交易时间”四项要素共同作为对账标志。9.多账户余额查询（xhj0010）此交易为查询多个账户的余额结果。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00102sendNumber记录数6循环条数3cyc_str循环体循环体格式：账号|#响应报文编号代码名称类型长度固定值备注1response_code报文标识62rec明细数循环体条数3cyc_str循环体循环体格式：账号|余额|可用余额|备用域1|备用域2|10.三方转账－零在途转账（xhj0012）---暂停服务此交易为总公司代子公司签约划款，交易流程为由总公司划拨资金到子公司账号，再经由子公司账号向收款账号付款。手续费由子公司账号支付。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00122entryDate录入日期3transType转账类型1：行内2：跨行4FlowNO企业端流水号205custID企业经办人1099999999996groupAcct总公司账号227entrAcct子公司账号227Amount发生额8payeeAcctNo收款账号9payeeName收款人名称10payeeBankName收款行名11payeeBankAddr收款行地址12abstract摘要响应报文编号代码名称类型长度固定值备注1response_code报文标识62Balance余额11.查询单笔到账通知（xhj0013）---暂停服务此交易为一笔转账是否到账。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00132entryDate录入日期8yyyyMMdd3PayerAcct付款账号224Amount发生额5PayeeAcct收款账号6Note1备用域17Note2备用域2响应报文编号代码名称类型长度固定值备注1response_code报文标识62Transtatus交易状态1：有效已处理；2：有效待提出；0：其他3Note1备用域14Note2备用域212.转账交易（新意接口）（xhj0016）此交易和转账交易相比，添加了企业端流水号，故由此交易转账，可以通过查询单笔转账交易结果进行转账结果查询。请求报文编号代码名称类型长度固定值备注1tran_code交易代码xhj00162entryDate录入日期3transType转账类型1：行内2：跨行4FlowNo企业端流水号205custID企业经办人109