Order Entry tax schedules

An Order Entry tax schedule identifies the tax details that are applied when the schedule is referenced by an Order Entry tax schedule map. See Tax schedules—Taxes application for more information.

List Order Entry tax schedules

get/objects/tax/order-entry-tax-schedule

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

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": [
    • {
      • "key": "8",
      • "id": "8",
      • "href": "/objects/tax/order-entry-tax-schedule/8"
      },
    • {
      • "key": "9",
      • "id": "9",
      • "href": "/objects/tax/order-entry-tax-schedule/9"
      },
    • {
      • "key": "10",
      • "id": "10",
      • "href": "/objects/tax/order-entry-tax-schedule/10"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "start": 1,
    • "pageSize": 100,
    • "next": null,
    • "previous": null
    }
}

Create an Order Entry tax schedule

post/objects/tax/order-entry-tax-schedule

Creates a new Order Entry tax schedule.

SecurityOAuth2
Request
Request Body schema: application/json
required
name
string

Name or other unique identifier for the Order Entry tax schedule.

Example: "TaxSched-00004"
status
string
Default: "active"

Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.

Enum: "active" "inactive"
Example: "active"
description
string

Description of the Order Entry tax schedule or other additional information.

Example: "Description of the Tax Schedule"
Array of objects

Order Entry tax schedule details for the tax schedule.

Array
effectiveDate
string <date>

Date when the Order Entry tax schedule detail becomes effective.

Example: "2022-01-08"
object

Order Entry tax details describe a specific type of tax that applies to lines in Accounts Receivable and Order Entry transactions.

object

Different tax solutions are available for different countries. Examples include Australia GST, South Africa VAT, and UK VAT.

key
string

System-assigned key for the tax solution.

Example: "1"
id
string

Unique identifier for the tax solution.

Example: "United Kingdom - VAT"
Responses
201

Created

400

Bad Request

Request samples
application/json
{
  • "name": "TaxSched-00004",
  • "description": "Sales Tax for New York",
  • "taxSolution": {
    • "key": 10
    },
  • "status": "active",
  • "lines": [
    • {
      • "taxDetail": {
        },
      • "effectiveDate": "2022-02-26"
      }
    ]
}
Response samples
application/json
{
  • "ia::result": {
    • "key": "308",
    • "id": "308",
    • "href": "/objects/tax/order-entry-tax-schedule/308"
    },
  • "ia::meta": {
    • "totalCount": 1
    }
}

Get an Order Entry tax schedule

get/objects/tax/order-entry-tax-schedule/{key}

Returns detailed information for a specified Order Entry tax schedule.

SecurityOAuth2
Request
path Parameters
key
required
string

System-assigned unique key for the Order Entry tax schedule.

Example: 99
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "id": "162",
    • "name": "Sales Tax New York",
    • "key": "162",
    • "description": "Sales Tax for New York",
    • "status": "active",
    • "isSystemGenerated": false,
    • "taxSolution": {
      • "id": "Avalara Tax",
      • "key": "1",
      • "href": "/objects/tax/tax-solution/1"
      },
    • "lines": [
      • {
        }
      ],
    • "href": "/objects/tax/order-entry-tax-schedule/162"
    },
  • "ia::meta": {
    • "totalCount": 1
    }
}

Update an Order Entry tax schedule

patch/objects/tax/order-entry-tax-schedule/{key}

Updates an existing Order Entry tax schedule by setting field values. Any fields not provided remain unchanged.

SecurityOAuth2
Request
path Parameters
key
required
string

System-assigned unique key for the Order Entry tax schedule.

Example: 99
Request Body schema: application/json
name
string

Name or other unique identifier for the Order Entry tax schedule.

Example: "TaxSched-00004"
status
string
Default: "active"

Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.

Enum: "active" "inactive"
Example: "active"
description
string

Description of the Order Entry tax schedule or other additional information.

Example: "Description of the Tax Schedule"
Array of objects

Order Entry tax schedule details for the tax schedule.

Array
effectiveDate
string <date>

Date when the Order Entry tax schedule detail becomes effective.

Example: "2022-01-08"
object

Order Entry tax details describe a specific type of tax that applies to lines in Accounts Receivable and Order Entry transactions.

object

Different tax solutions are available for different countries. Examples include Australia GST, South Africa VAT, and UK VAT.

key
string

System-assigned key for the tax solution.

Example: "1"
id
string

Unique identifier for the tax solution.

Example: "United Kingdom - VAT"
Responses
200

OK

400

Bad Request

Request samples
application/json
{
  • "status": "inactive"
}
Response samples
application/json
{
  • "ia::result": {
    • "key": "162",
    • "href": "/objects/tax/order-entry-tax-schedule/162"
    },
  • "ia::meta": {
    • "totalCount": 1
    }
}

Delete an Order Entry tax schedule

delete/objects/tax/order-entry-tax-schedule/{key}

Deletes an Order Entry tax schedule. Delete a tax schedule if it is no longer needed. Deleting a tax schedule removes it from the system so that it can't be recovered.

SecurityOAuth2
Request
path Parameters
key
required
string

System-assigned unique key for the Order Entry tax schedule.

Example: 99
Responses
204

No Content

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}