Tax solutions

A tax solution provides the underlying mechanism (tax engine) for capturing and reporting taxes. A tax solution also includes information about the GL accounts for input and output taxes as well as the start date of the first tax submission period. Pre-configured tax solutions are only available for AU, CAN, FR, GB, and ZA.

List tax solutions

get/objects/tax/tax-solution

Returns a collection with a key, ID, and link for each solution. This operation is mostly for use in testing; use the query service to find tax solutions that meet certain criteria and specify the properties that are returned.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": [
    • {
      • "key": "265",
      • "id": "Oregon",
      • "href": "/objects/tax/tax-solution/265"
      },
    • {
      • "key": "263",
      • "id": "Alaska",
      • "href": "/objects/tax/tax-solution/263"
      },
    • {
      • "key": "264",
      • "id": "Montana",
      • "href": "/objects/tax/tax-solution/264"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "start": 1,
    • "pageSize": 100,
    • "next": null,
    • "previous": null
    }
}

Get a tax solution

get/objects/tax/tax-solution/{key}

Returns detailed information for a specified tax solution.

SecurityOAuth2
Request
path Parameters
key
required
string

System-assigned key for the tax solution.

Example: 43
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "key": "1",
  • "id": "Australia - GST",
  • "description": "Australian tax solution",
  • "taxCalculationMethod": "VAT",
  • "status": "active",
  • "taxSolutionType": "standard",
  • "taxSubmissionStartDate": "2019-05-01",
  • "enableMultilineTax": false,
  • "purchaseGLAccount": {
    • "key": "7",
    • "id": "6850.03",
    • "href": "/objects/general-ledger/account/23"
    },
  • "salesGLAccount": {
    • "key": "9",
    • "id": "6500.05",
    • "href": "/objects/general-ledger/account/13"
    },
  • "alternativeSetup": false,
  • "lastUpdatedTaxDate": null,
  • "href": "/objects/tax/tax-solution/1"
}