本文讨论了交通银行银企直联中交易明细查询接口的变化,原本在交易明细和回单上会显示税费明细,但自2024年3月起,仅在回单上显示。交通银行对此进行了回复,并提供了新的查询接口410201、410301,需在银企云最新版本中配置相关参数以解决此问题,同时需注意常见问题的解决办法。
相关链接:
关键词:银企直联、交通银行、银企云、交易明细、税费缴纳
参考文档:
无
更新日志:
20241110V1.0.0:初稿
小熊说:
本文帖子针对问题描述和解决办法的说明相对较长,如想直接查看如何解决的,可以跳转第三部分【解决办法】处查看即可。
0.适用版本
适用于:
金蝶云星瀚·银企云(V7.0及以上版本)(具体小版本号待标品排期):支持了交通银行410201当日明细/410301历史明细查询接口,使用该接口查询交易明细,当配置银行账户为【缴税客户】时,支持在摘要返回具体税费明细。
交通银行·云直联前置机软件(24.20.15及以上版本)
不适用于:
金蝶银企平台
1.问题描述
问题现象、报错信息
1.1原本查询交易明细和回单上均会显示缴纳税费明细
2024年2月及之前流水查询,涉及税费扣款时,会直接在摘要中明确显示:XXX税多少钱
1.1.1网银查询记录
1.1.2银企查询记录
请求
<ap> <head> <tr_code>310301</tr_code> <corp_no>客户号</corp_no> <user_no>操作员号</user_no> <req_no>2123123158865415168</req_no> <tr_acdt>20240407</tr_acdt> <tr_time>094225</tr_time> <atom_tr_count>1</atom_tr_count> <channel>0</channel> <reserved></reserved> </head> <body> <acno>银行账号</acno> <start_date>20240110</start_date> <end_date>20240110</end_date> </body> </ap>
响应
<ap> <head> <tr_code>310301</tr_code> <corp_no>客户号</corp_no> <req_no>2123123158865415168</req_no> <serial_no></serial_no> <ans_no></ans_no> <next_no></next_no> <tr_acdt>20240407</tr_acdt> <tr_time>094226</tr_time> <ans_code>0</ans_code> <ans_info></ans_info> <particular_code>0000</particular_code> <particular_info>交易成功</particular_info> <atom_tr_count>1</atom_tr_count> <reserved></reserved> </head> <body> <serial_record>状态|交易日期|交易时间|业务类型|流水号|流水序号|账号|户名|收支标志|币种|交易金额|余额|可用余额|对方账号|对方户名|对方地址|对方开户行行号|对方开户行行名|票据种类|票据号码|票据名称|票据签发日期|附言|备注|0|20240110|170252|3|XXX|1|XXX|XXX有限公司|D|CNY|13425.13|XXX|XXX||||XXX|中华人民共和国国家金库XXX支库|116||||XXX|企业所得税13425.13|0|20240110|170326|3|XXX|1|XXX|XXX公司|D|CNY|18154.45|XXX|XXX||||XXX|中华人民共和国国家金库XXX支库|116||||XXX|教育费附加267.51#增值税17084.4#城市维护建设税624.2#地方教育附加178.34|</serial_record> <field_num>XXX</field_num> <record_num>XXX</record_num> </body> </ap>
小熊说:
可以通过网银和银企都能明确的看出来,银行原先在交易明细中会明确在【摘要】或者【备注】位置上明确具体税费缴纳金额。
比如:企业所得税XXX
1.2从202403起只会在回单上显示缴税明细
1.2.1网银查询记录
1.2.2银企查询记录
请求:
<ap> <head> <tr_code>310301</tr_code> <corp_no>客户号</corp_no> <user_no>操作员号</user_no> <req_no>2123124353310919680</req_no> <tr_acdt>20240407</tr_acdt> <tr_time>094448</tr_time> <atom_tr_count>1</atom_tr_count> <channel>0</channel> <reserved></reserved> </head> <body> <acno>银行账号</acno> <start_date>20240401</start_date> <end_date>20240401</end_date> </body> </ap>
响应:
<ap> <head> <tr_code>310301</tr_code> <corp_no>客户号</corp_no> <req_no>2123124353310919680</req_no> <serial_no></serial_no> <ans_no></ans_no> <next_no></next_no> <tr_acdt>20240407</tr_acdt> <tr_time>094449</tr_time> <ans_code>0</ans_code> <ans_info></ans_info> <particular_code>0000</particular_code> <particular_info>交易成功</particular_info> <atom_tr_count>1</atom_tr_count> <reserved></reserved> </head> <body> <serial_record>状态|交易日期|交易时间|业务类型|流水号|流水序号|账号|户名|收支标志|币种|交易金额|余额|可用余额|对方账号|对方户名|对方地址|对方开户行行号|对方开户行行名|票据种类|票据号码|票据名称|票据签发日期|附言|备注|0|20240401|XXX|3|XXX|1|XXX|XXX公司|D|CNY|869.35|XXX|0||||XXX|中华人民共和国国家金库XXX支库|116||||XXX|税费缴纳|</serial_record> <field_num>XXX</field_num> <record_num>XXX</record_num> </body> </ap>
小熊说:
可以通过网银和银企都能明确的看出来,银行已经不会在流水中明确显示具体税费明细信息,只会统一显示【税费缴纳】
如果需要查看具体缴税明细,只会在【电子回单】中“附加信息”中才会显示。
但是由于缴税这一块是银行代扣代缴的,如果每次都得通过电子回单才能知晓具体缴税明细,那么实际做账效率就会特别低。
注意!
电子回单的附加信息≠银企明细获取中的附言,银企明细中税费缴纳的附言是一串数字(回单编号+记账机构),目前没有接口去专门取回单附加信息。
2.原因分析
分析问题出现的可能原因(视情况而定)
交通银行总行202404回复:营运核心修改了回单的公共规则,目前也有其他直联客户表示不接受这个规则,总行计划优化中。
交通银行总行202406回复:
当日及历史交易新增410201、410301接口(具体接口文档参见本文附件)
相较于原先201和301接口,新增了一个taxFlg,送1,则对于财税库行反馈的交易会备注税种+税金
20240614投产
使用场景说明:
企业这边如有涉及到银企直联缴税通接口或者在柜面签署三方协议办理实时缴税和批量缴税业务,需要使用410201、410301接口对接明细,其余情况还是用旧的明细接口即可。
3.解决方法
解决思路/操作步骤
3.1升级最新版本的银企云
3.2修改银行参数
操作路径:
【查询与支付】-【银企参数设置】-【银行参数配置】-【交通银行参数】-【余额明细参数】-【交易明细查询接口选择】
3.3修改银企账户附加属性
操作路径:
【查询与支付】-【银企基础资料】-【银企账户】-【搜索相关账户】-【附件属性】-【是否财税库行系统缴税】
改为:2)缴税客户
3.4重新联机查询交易明细
如下图所示
4.应用小结
注意事项;补充说明(视情况而定)
小熊说:
交通银行针对某一类业务的优化,总是喜欢不在原有接口中做调整,而是另外再单开一个接口。
此时就比较依赖于总部研发侧的支持。
4.1常见问题
4.1.1使用新的明细接口查询时提示【客户未开通此业务功能】
解决办法:
该接口需要和银行沟通开通权限才可用,所以在切换前一定要和银行确认。
4.1.2查询历史交易明细时提示报错:获取昨日交易明细的值是非法的
原因:
新版通讯机对这个交易有处理逻辑,有个昨日标志yesterday_flag是由前置机生成后并推送给银行的。
解决办法:
需要升级最新版的交通银行前置机软件
410201、410301接口文档.docx(20.49KB)
推荐阅读