调用Xero API的updateInvoice端点时折扣字段异常更新问题

针对你遇到的仅更新SentToContact字段却导致Xero发票折扣字段异常变更的问题，核心原因大概率和Xero API的字段计算逻辑、Parex Bridge初始化发票的方式有关，具体可从以下几点排查：

• Xero API的自动重算机制：Xero的发票更新端点（Invoices/GUID）在处理部分字段更新时，会自动重新计算关联的金额类字段。当你仅传入SentToContact: true时，Xero会基于发票现有数据（比如总金额、行项目）反向推导折扣相关字段。如果初始由Parex创建的发票是金额型折扣，但Xero后台可能默认按百分比折扣的逻辑重新计算，就会出现DiscountRate被覆盖、DiscountAmount消失、TotalDiscount异常的情况。

• Parex Bridge初始化发票的字段完整性问题：Parex在同步Shopify折扣到Xero时，可能只设置了表面可见的折扣字段（比如DiscountAmount），但没有正确配置Xero要求的折扣类型标识（比如区分全局金额折扣/百分比折扣的字段）。当后续调用更新时，Xero无法识别原折扣的类型，就会自动按默认规则重新计算折扣值。

• 折扣字段的依赖关联冲突：Xero中DiscountAmount、DiscountRate、TotalDiscount三个字段存在强依赖关系：

  • 如果设置了DiscountAmount（全局金额折扣），Xero会自动计算对应的DiscountRate；
  • 如果设置了DiscountRate（全局百分比折扣），则会自动计算DiscountAmount和TotalDiscount。
    当Parex初始化发票时，可能没有锁定折扣类型，导致更新操作触发Xero重新计算，覆盖了原有的金额折扣设置。

• 调用Xero的Invoices/GUID端点获取发票的完整原始数据，检查是否存在隐藏的折扣相关字段（比如DiscountType）未被正确设置；
• 尝试在更新SentToContact时，同时传入原有的DiscountAmount和TotalDiscount字段，强制Xero保留原折扣设置；
• 联系Parex Bridge支持，确认其同步Shopify折扣到Xero时的字段映射逻辑，是否遗漏了折扣类型的配置。

内容的提问来源于stack exchange，提问作者Joe Morgan