QuickBooks Online API销售税覆盖失效：传入值未被Invoice生效

问题背景 #

我是QuickBooks Online API新手，提交新发票时尝试手动指定销售税覆盖值（不想使用自动销售税系统），但系统仍自动计算销售税金额。

API请求地址：

https://sandbox-quickbooks.api.intuit.com/v3/company/4620816365232674520/Invoice?minorversion=4

请求体示例（已脱敏）：

{
    "BillAddr": {
        "City": "AnywhereVille",
        "Country": "USA",
        "CountrySubDivisionCode": "CA",
        "Line1": "",
        "Line2": "Customer Name LLP",
        "Line3": "45 E. Pacific Coast Highway",
        "Line4": "",
        "PostalCode": "90804"
    },
    "CustomField": [{
        "DefinitionId": "1",
        "Name": "P.O. Number",
        "StringValue": "",
        "Type": "StringType"
    }, {
        "DefinitionId": "2",
        "Name": "Sales Rep",
        "StringValue": "TY",
        "Type": "StringType"
    }],
    "CustomerMemo": {
        "value": "Pay your invoice online at: ..."
    },
    "CustomerRef": {
        "value": "60"
    },
    "DocNumber": "11111",
    "DueDate": "2022-08-01",
    "Line": [{
        "Amount": 576,
        "Description": "",
        "DetailType": "SalesItemLineDetail",
        "LineNum": 1,
        "SalesItemLineDetail": {
            "ClassRef": {
                "name": "3 Studios",
                "value": "1111111111111"
            },
            "ItemRef": {
                "name": "16GBUSBFLASH",
                "value": "21"
            },
            "Qty": 48,
            "TaxCodeRef": {
                "value": "TAX"
            },
            "UnitPrice": 12
        }
    }, {
        "Amount": 168,
        "Description": "",
        "DetailType": "SalesItemLineDetail",
        "LineNum": 4,
        "SalesItemLineDetail": {
            "ClassRef": {
                "name": "3 Studios",
                "value": "1111111111111"
            },
            "ItemRef": {
                "name": "DVDMEDIA",
                "value": "23"
            },
            "Qty": 12,
            "TaxCodeRef": {
                "value": "TAX"
            },
            "UnitPrice": 14
        }
    }, {
        "Amount": 600,
        "Description": "",
        "DetailType": "SalesItemLineDetail",
        "LineNum": 6,
        "SalesItemLineDetail": {
            "ClassRef": {
                "name": "3 Studios",
                "value": "1111111111111"
            },
            "ItemRef": {
                "name": "DIGITALDEL30",
                "value": "25"
            },
            "Qty": 12,
            "TaxCodeRef": {
                "value": "TAX"
            },
            "UnitPrice": 50
        }
    }],
    "SalesTermRef": {
        "value": "8"
    },
    "TxnDate": "2022-08-01",
    "TxnTaxDetail": {
        "TaxLine": [{
            "Amount": 130.98,
            "DetailType": "TaxLineDetail",
            "TaxLineDetail": {
                "NetAmountTaxable": 576,
                "PercentBased": true,
                "TaxPercent": 0.0925,
                "TaxRateRef": {
                    "value": "4"
                }
            }
        }],
        "TotalTax": 130.98,
        "TxnTaxCodeRef": {
            "value": "4"
        }
    }
}

问题根源 #

1. 行项目TaxCode触发自动计税：所有行项目的TaxCodeRef.value为TAX，这是QBO默认的应税代码，会强制系统自动计算对应行的销售税，不受TxnTaxDetail的覆盖影响。
2. TaxLine未覆盖全部应税金额：当前TxnTaxDetail.TaxLine仅覆盖了第一个行项目的应税金额（576），另外两个行项目（168、600）未被纳入手动覆盖范围，系统会自动补算这部分税额。

修改方案 #

1. 替换行项目的TaxCode #

将所有行项目的TaxCodeRef.value从TAX改为QBO账户内的免税代码（通常默认代码为NON，需确认你的账户中实际的代码值），彻底关闭系统自动计税的触发条件。

2. 完善TxnTaxDetail的TaxLine #

更新TaxLine的NetAmountTaxable为所有行项目的金额总和（576+168+600=1344），同时确保TaxLine.Amount的总和与TotalTax完全一致。如果需要按不同行项目分别指定税额，可为每个行项目单独添加对应的TaxLine。

修改后的请求体关键部分示例：

{
    // ... 其他字段保持不变
    "Line": [{
        // ... 其他字段保持不变
        "SalesItemLineDetail": {
            // ... 其他字段保持不变
            "TaxCodeRef": {
                "value": "NON" // 替换为免税代码
            }
        }
    }, {
        // ... 其他字段保持不变
        "SalesItemLineDetail": {
            // ... 其他字段保持不变
            "TaxCodeRef": {
                "value": "NON"
            }
        }
    }, {
        // ... 其他字段保持不变
        "SalesItemLineDetail": {
            // ... 其他字段保持不变
            "TaxCodeRef": {
                "value": "NON"
            }
        }
    }],
    // ... 其他字段保持不变
    "TxnTaxDetail": {
        "TaxLine": [{
            "Amount": 124.32, // 1344 * 0.0925 = 124.32，若需保留130.98则调整计算逻辑
            "DetailType": "TaxLineDetail",
            "TaxLineDetail": {
                "NetAmountTaxable": 1344, // 所有行项目金额总和
                "PercentBased": true,
                "TaxPercent": 0.0925,
                "TaxRateRef": {
                    "value": "4"
                }
            }
        }],
        "TotalTax": 124.32, // 与TaxLine.Amount保持一致
        "TxnTaxCodeRef": {
            "value": "4"
        }
    }
}

额外注意事项 #

• 确认你的QBO账户中已存在对应的免税TaxCode，若未创建需先在QBO后台完成配置。
• 若手动指定的税额与税率计算结果不符，需确保TaxLine.Amount和TotalTax的数值完全匹配，避免系统自动修正。

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