能否通过Xero会计API创建带自动查找税类型的发票行项目？

排查与修复步骤 #

• 避免发票级别的税务覆盖：创建发票时，不要在发票根节点设置TaxRate、TaxCode等全局税务字段，这些会直接覆盖行项目的自动查找规则。
• 正确关联项目引用：发票行项目必须完整传入ItemRef对象（包含项目ID的value字段），而非仅填写项目编码。仅传编码会导致系统无法读取项目的税务配置。示例请求片段：

  "Line": [
    {
      "Amount": 150.00,
      "DetailType": "SalesItemLineDetail",
      "SalesItemLineDetail": {
        "ItemRef": {
          "value": "PROJ-001"
        }
        // 不要添加TaxType、TaxCodeRef等手动税务配置
      }
    }
  ]
  

• 移除行项目的手动TaxType设置：即使API接受TaxType: "AVALARA"，手动指定该字段会干扰系统的自动查找逻辑。创建行项目时完全不设置TaxType，让系统从关联项目继承配置。
• 验证AVALARA集成有效性：确认你的系统与AVALARA的集成处于活跃状态，没有权限或连接问题。集成断开会导致自动税率查找功能失效。
• 检查项目税务配置：通过Items API再次确认项目的TaxCode为空（自动查找模式下的正确状态），同时确认项目关联了对应销售/采购场景的税务代码框架。

测试建议 #

先在Sandbox环境中创建仅关联项目的发票行，不添加任何手动税务配置，验证税费是否自动计算。若Sandbox正常，再排查生产环境的集成权限、配置一致性问题。

内容的提问来源于stack exchange，提问作者Anthony Colebourne