如何用C#通过XERO API按InvoiceId更新AmountDue及解决验证异常

Hey there, let's figure out why you're getting that validation error when trying to update the AmountDue field, and walk through how to fix it.

常见的错误原因 #

• AmountDue是只读计算字段：绝大多数会计类API（从你的代码里的Invoices.Update来看，大概率是QuickBooks Online这类）中，AmountDue是系统自动计算的结果——它等于发票总金额（TotalAmt）减去已支付金额的总和。API不允许手动修改这个字段，直接赋值肯定会触发验证失败。
• 缺少并发控制字段SyncToken：更新发票时，API需要你提供最新的SyncToken（这个字段用来防止多人同时修改同一张发票的冲突）。如果你获取发票后没保留这个字段就直接修改提交，系统会判定你的数据不是最新版本，抛出验证异常。
• 数据格式不符合要求：虽然你用了Convert.ToDecimal(100.00)，但有些API对小数的精度、格式有严格要求（比如必须保留两位小数），格式不匹配也会触发验证错误。

对应的解决方法 #

• 不要直接修改AmountDue，调整关联可编辑字段：如果需要改变应收金额，应该修改发票的总金额（TotalAmt），或者添加/调整对应的支付记录，让系统自动重新计算AmountDue。示例代码：

  // 不要直接改AmountDue，改为修改TotalAmt
  ByInvoiceId.TotalAmt = Convert.ToDecimal(100.00);
  public_app_api.Invoices.Update(ByInvoiceId);
  

• 确保携带最新的SyncToken：正确的更新流程需要先获取包含最新SyncToken的发票对象，再修改提交：

  // 1. 先获取最新的发票详情（包含SyncToken）
  var targetInvoice = public_app_api.Invoices.GetById(yourInvoiceId);
  // 2. 修改允许编辑的字段（比如TotalAmt）
  targetInvoice.TotalAmt = Convert.ToDecimal(100.00);
  // 3. 提交更新，此时SyncToken会被自动提交到API
  public_app_api.Invoices.Update(targetInvoice);
  

• 检查并规范数据格式：确认你传递的小数符合API的精度要求，比如如果要求保留两位小数，可以用Math.Round(100.00, 2)来确保格式正确，避免因精度问题触发验证。

内容的提问来源于stack exchange，提问作者Muttu B C