QuickBooks Online API - 销售税：尝试覆盖自动销售税，但它不尊重我的输入

Question

QBOnline API：覆盖销售税的问题 - 传入的值在发票上不受尊重（AST 似乎覆盖了我的覆盖）

大家好

是的，我是 API 新手。首先潜入头部！ :)

我正在尝试解决我的应用程序的问题。它向 QBOnline API 提交新发票，并传递所有行项目信息。我们并没有尝试使用 AST 系统 - 所以我尝试设置覆盖值。 （文档：https://developer.intuit.com/app/developer/qbo/docs/workflows/manage-sales-tax-for-us-locales#specifying-sales-tax）

我认为我提供的值正确，但系统仍在计算其自己的销售税金额。

目标 API URL：

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"
        }
    }
}

Answer 1

自从 Intuit 推出 AST（自动销售税）以来，我们公司就面临着同样的问题。因此，在与 Intuit 和研发部进行多次沟通后，我们发现 Inuit 文档帮助我们实现了相同的目标 -> https://developer.intuit.com/app/developer/qbo/docs/workflows/manage-sales-tax-for -us-locales#working-with-tax-codes

使用其他税码覆盖“基于位置”的税码时需要注意的重要事项 ->

1. 您需要在交易请求中发送minorversion=62或以上。
2. 在交易请求数据中，您需要按照以下格式发送税码名称 “税率参考”：{ “值”：“2”， “名称”：“图森市” }
3. 目前，仅可操作通过 QBO 上的 UI 创建的自定义税率。我所说的可操作，是指只有这样的利率才能在 QBO 交易中被用来覆盖。

如何判断税码是自定义（用户生成）还是系统生成？

Ans -> 您可以查询下载minorversion=51或以上的公司文件的所有税码，您将得到一个名为“TaxCodeConfigType”的节点。它包含值 USER_DEFINED、SYSTEM_GENERATED。 Intuit 文档 -> https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/taxcode

除了用户生成的一次税码之外，我们仍在寻找一种用系统生成的税码覆盖税码的方法。