现有发票添加新发票行失败：QuickBooks与MySQL同步异常

你遇到的是QuickBooks双向同步里典型的「引用对象不存在」问题——错误码320明确提示你传入的对象ID“64-1518123234”在QuickBooks端找不到。结合你的场景，我给你梳理几个排查和修复的方向：

第一步：先搞清楚这个ID到底是什么 #

首先要明确“64-1518123234”的本质：

• 这个值大概率是你试图关联的发票唯一标识符，但一定要区分是QuickBooks系统生成的TxnID，还是你本地自定义的发票编号。QuickBooks只认自己生成的TxnID作为对象引用，如果你误传了自定义发票号，肯定会触发这个错误。
• 先在本地qb_invoice表验证这个ID是否存在：

  -- 替换成你实际存储QuickBooks TxnID的字段名，比如qb_txn_id
  SELECT * FROM qb_invoice WHERE qb_txn_id = '64-1518123234';
  

  如果查不到，说明本地记录的发票ID本身就有问题；如果能查到，直接去QuickBooks后台搜索这个ID，确认发票是否还存在（有没有被删除或归档）。

第二步：检查发票行的关联逻辑 #

问题大概率出在qb_invoice_invoicline表的关联字段上：

• 确认你新增的发票行对应的外键字段（比如invoice_id），是不是关联到了qb_invoice表中正确的QuickBooks TxnID，而不是本地自增ID或者其他自定义字段。
• 举个例子：如果你的qb_invoice表有id（本地自增主键）和qb_txn_id（QuickBooks的系统ID），那发票行的关联字段必须是qb_txn_id，否则同步时会把本地ID传给QuickBooks，自然找不到对应的对象。

第三步：排查同步工具的字段映射 #

• 检查你的同步工具是否正确配置了字段映射：确保在发送新增发票行的请求时，InvoiceRef参数的值是从qb_invoice表的qb_txn_id字段读取的，而不是其他字段。
• 有没有可能在新增发票行时，对应的发票在QuickBooks端已经被修改或删除？比如你本地保留着旧的发票记录，但QuickBooks里已经删除了这个发票，同步时自然会找不到对象。

快速修复步骤 #

1. 去QuickBooks后台找到对应发票的TxnID（通常在发票详情的「更多信息」里，或者通过API调试工具获取）。
2. 对比本地qb_invoice表中该发票的qb_txn_id，确保两者完全一致。
3. 更新qb_invoice_invoicline表中关联的发票ID为正确的QuickBooks TxnID。
4. 重新触发同步任务，观察是否还报错。

如果以上步骤都没用，建议导出同步工具的请求日志，看看发送给QuickBooks的完整请求内容——日志通常能直接暴露字段映射错误的问题，比如是不是把发票编号当成了TxnID传了过去。

内容的提问来源于stack exchange，提问作者Muhammad Basham