REST API v2.8

Sales Taxes

Collection of sales taxes (US).

Get Sales Taxes

Endpoint

GET sites/{siteid}/salestaxes

Parameters

start

The index of the item to start fromDefault: 0

num

The number of items returnedDefault: 10

fields

Comma separated list of fields to return. Use this to query only the fields you are using. Default is all fields in salestax.

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns an envelope with items of type salestax.

Example

Request

GET https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxes.json?num=3

Response

{ "totalcount": 3, "items": [ { "salestaxid": 1, "name": "FL State Tax", "code": null, "decimalvaluedefault": "6.000", "productgrouprules": [] }, { "salestaxid": 2, "name": "Miami Dade County Tax", "code": null, "decimalvaluedefault": "1.000", "productgrouprules": [] }, { "salestaxid": 3, "name": "MA State Tax", "code": null, "decimalvaluedefault": "6.250", "productgrouprules": [ { "vatid": 2, "type": 20, "moneymin": "175.00", "moneymax": null, "decimalvalue": "6.250", "externalid": "20010" } ] } ] }

Add Sales Tax

Endpoint

POST sites/{siteid}/salestaxes

Request body

See salestax for fields.
Required fields:
namedecimalvaluedefault

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns salestaxid if successful.

Example

Request

POST https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxes.json { "name": "Washington State Tax", "decimalvaluedefault": "6.500" }

Response

4

Get Sales Tax

Endpoint

GET sites/{siteid}/salestaxes/{salestaxid}

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns an item of type salestax.

Example

Request

GET https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxes/4.json

Response

{ "salestaxid": 4, "name": "Washington State Tax", "code": null, "decimalvaluedefault": "6.500", "productgrouprules": [] }

Update Sales Tax

Endpoint

PUT sites/{siteid}/salestaxes/{salestaxid}

Request body

See salestax for fields.

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns true if successful.

Example

Request

PUT https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxes/4.json { "name": "WA State Tax" }

Response

true

Delete Sales Tax

Endpoint

DELETE sites/{siteid}/salestaxes/{salestaxid}

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns true if successful.

Example

Request

DELETE https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxes/4.json

Response

true

Get Sales Tax Groups

Endpoint

GET sites/{siteid}/salestaxgroups

Parameters

start

The index of the item to start fromDefault: 0

num

The number of items returnedDefault: 10

fields

Comma separated list of fields to return. Use this to query only the fields you are using. Default is all fields in salestaxgroup.

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns an envelope with items of type salestaxgroup.

Example

Request

GET https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxgroups.json?num=2

Response

{ "totalcount": 2, "items": [ { "salestaxgroupid": 1, "name": "Miami Dade", "region": "FL", "salestaxes": [ { "salestaxid": 1, "name": "FL State Tax", "code": null, "decimalvaluedefault": "6.000", "productgrouprules": [] }, { "salestaxid": 2, "name": "Miami Dade County Tax", "code": null, "decimalvaluedefault": "1.000", "productgrouprules": [] } ] }, { "salestaxgroupid": 2, "name": "Massachusetts", "region": "MA", "salestaxes": [ { "salestaxid": 3, "name": "MA State Tax", "code": null, "decimalvaluedefault": "6.250", "productgrouprules": [ { "vatid": 2, "type": 20, "moneymin": "175.00", "moneymax": null, "decimalvalue": "6.250", "externalid": "20010" } ] } ] } ] }

Add Sales Tax Group

Endpoint

POST sites/{siteid}/salestaxgroups

Request body

See salestaxgroup for fields.
Required fields:
name

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns salestaxgroupid if successful.

Example

Request

POST https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxgroups.json { "name": "Miami State (General)", "region": "FL", "salestaxes": [ { "salestaxid": 1 } ] }

Response

3

Get Sales Tax Group

Endpoint

GET sites/{siteid}/salestaxgroups/{salestaxgroupid}

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns an item of type salestaxgroup.

Example

Request

GET https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxgroups/3.json

Response

{ "salestaxgroupid": 3, "name": "Miami State (General)", "region": "FL", "salestaxes": [ { "salestaxid": 1, "name": "FL State Tax", "code": null, "decimalvaluedefault": "6.000", "productgrouprules": [] } ] }

Update Sales Tax Group

Endpoint

PUT sites/{siteid}/salestaxgroups/{salestaxgroupid}

Request body

See salestaxgroup for fields.

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns true if successful.

Example

Request

PUT https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxgroups/3.json { "name": "Miami State (Default)" }

Response

true

Delete Sales Tax Group

Endpoint

DELETE sites/{siteid}/salestaxgroups/{salestaxgroupid}

HTTP Response Status

200

OK. Returns data (see below).

400

Bad Request. Invalid syntax, missing required argument or invalid request.

401

Unauthorized. Authorization failed.

404

Resource not found. The url is invalid.

429

Too Many Requests.

500

Internal Server Error.

Returns

Returns true if successful.

Example

Request

DELETE https://api.mysitoo.com/v2/accounts/1500/sites/1/salestaxgroups/3.json

Response

true