Invoice Ninja中BankTransactions API对Nordigen交易ID的支持优化

在Invoice Ninja v5.9.4版本中，BankTransactions API存在一个功能限制：无法通过nordigen_transaction_id字段进行筛选查询，且该字段未包含在API返回结果中。这对于需要实现自动化对账功能的用户造成了不便。

问题背景

当用户通过API创建发票并需要与Stripe交易进行自动对账时，会遇到以下技术挑战：

1. Stripe交易通过GoCardless/Nordigen同步到bank_transactions表
2. 发票中存储了Stripe交易ID（通过自定义字段）
3. 银行交易表中存在nordigen_transaction_id字段，包含对应的交易标识符

技术限制分析

当前BankTransactions API存在两个主要限制：

1. 查询接口不支持按nordigen_transaction_id字段过滤
2. 返回的交易对象中不包含nordigen_transaction_id字段

这使得用户无法通过API直接获取到完整的交易匹配信息，必须通过其他变通方法实现业务逻辑。

解决方案

Invoice Ninja开发团队已确认将在下一个版本中解决此问题：

1. 在数据转换器(transformers)中暴露nordigen_transaction_id字段
2. 确保该字段包含在API返回结果中

技术实现建议

对于需要立即使用此功能的用户，可以考虑以下临时解决方案：

1. 直接查询数据库获取所需信息
2. 创建自定义API端点来扩展现有功能
3. 在本地修改transformer类以包含该字段

升级建议

建议用户关注Invoice Ninja的版本更新，及时升级到包含此功能改进的版本（预计v5.9.5或更高版本）。升级后，用户将能够：

1. 直接通过API查询特定Nordigen交易
2. 在返回结果中获取完整的交易标识信息
3. 简化自动对账流程的实现

总结

这一改进将显著提升Invoice Ninja在支付对账场景下的API可用性，特别是对于使用Nordigen/GoCardless集成和Stripe支付处理的用户。开发团队对用户反馈的快速响应也体现了项目的活跃维护状态。