avatax 20.1.0 → 20.9.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/avatax.gemspec +0 -1
- data/lib/avatax/client/accounts.rb +236 -172
- data/lib/avatax/client/addresses.rb +54 -54
- data/lib/avatax/client/advancedrules.rb +63 -162
- data/lib/avatax/client/avafileforms.rb +78 -78
- data/lib/avatax/client/batches.rb +223 -170
- data/lib/avatax/client/certexpressinvites.rb +97 -97
- data/lib/avatax/client/certificates.rb +424 -424
- data/lib/avatax/client/companies.rb +457 -350
- data/lib/avatax/client/compliance.rb +15 -15
- data/lib/avatax/client/contacts.rb +106 -106
- data/lib/avatax/client/customers.rb +376 -376
- data/lib/avatax/client/datasources.rb +99 -99
- data/lib/avatax/client/definitions.rb +862 -847
- data/lib/avatax/client/distancethresholds.rb +122 -122
- data/lib/avatax/client/ecommercetoken.rb +37 -0
- data/lib/avatax/client/filingcalendars.rb +20 -508
- data/lib/avatax/client/filings.rb +37 -26
- data/lib/avatax/client/firmclientlinkages.rb +123 -123
- data/lib/avatax/client/free.rb +100 -100
- data/lib/avatax/client/fundingrequests.rb +52 -52
- data/lib/avatax/client/items.rb +423 -423
- data/lib/avatax/client/jurisdictionoverrides.rb +118 -118
- data/lib/avatax/client/locations.rb +253 -139
- data/lib/avatax/client/multidocument.rb +390 -310
- data/lib/avatax/client/nexus.rb +341 -201
- data/lib/avatax/client/notifications.rb +75 -75
- data/lib/avatax/client/provisioning.rb +49 -49
- data/lib/avatax/client/registrar.rb +198 -198
- data/lib/avatax/client/reports.rb +97 -97
- data/lib/avatax/client/settings.rb +156 -156
- data/lib/avatax/client/subscriptions.rb +62 -62
- data/lib/avatax/client/taxcodes.rb +120 -120
- data/lib/avatax/client/taxcontent.rb +133 -133
- data/lib/avatax/client/taxrules.rb +170 -170
- data/lib/avatax/client/transactions.rb +836 -791
- data/lib/avatax/client/upcs.rb +111 -111
- data/lib/avatax/client/users.rb +183 -183
- data/lib/avatax/client/utilities.rb +61 -61
- data/lib/avatax/connection.rb +3 -3
- data/lib/avatax/request.rb +2 -0
- data/lib/avatax/version.rb +1 -1
- metadata +4 -17
@@ -1,63 +1,63 @@
|
|
1
|
-
module AvaTax
|
2
|
-
class Client
|
3
|
-
module Subscriptions
|
4
|
-
|
5
|
-
|
6
|
-
# Retrieve a single subscription
|
7
|
-
#
|
8
|
-
# Get the subscription object identified by this URL.
|
9
|
-
# A 'subscription' indicates a licensed subscription to a named Avalara service.
|
10
|
-
# To request or remove subscriptions, please contact Avalara sales or your customer account manager.
|
11
|
-
#
|
12
|
-
# ### Security Policies
|
13
|
-
#
|
14
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
15
|
-
# @param accountId [Integer] The ID of the account that owns this subscription
|
16
|
-
# @param id [Integer] The primary key of this subscription
|
17
|
-
# @return [Object]
|
18
|
-
def get_subscription(accountId, id) path = "/api/v2/accounts/#{accountId}/subscriptions/#{id}"
|
19
|
-
get(path) end
|
20
|
-
|
21
|
-
# Retrieve subscriptions for this account
|
22
|
-
#
|
23
|
-
# List all subscription objects attached to this account.
|
24
|
-
# A 'subscription' indicates a licensed subscription to a named Avalara service.
|
25
|
-
# To request or remove subscriptions, please contact Avalara sales or your customer account manager.
|
26
|
-
#
|
27
|
-
# Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
|
28
|
-
# Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
|
29
|
-
#
|
30
|
-
# ### Security Policies
|
31
|
-
#
|
32
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
33
|
-
# @param accountId [Integer] The ID of the account that owns these subscriptions
|
34
|
-
# @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).<br />*Not filterable:* subscriptionDescription
|
35
|
-
# @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
|
36
|
-
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
|
37
|
-
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
|
38
|
-
# @return [FetchResult]
|
39
|
-
def list_subscriptions_by_account(accountId, options={}) path = "/api/v2/accounts/#{accountId}/subscriptions"
|
40
|
-
get(path, options) end
|
41
|
-
|
42
|
-
# Retrieve all subscriptions
|
43
|
-
#
|
44
|
-
# Get multiple subscription objects across all accounts.
|
45
|
-
# A 'subscription' indicates a licensed subscription to a named Avalara service.
|
46
|
-
# To request or remove subscriptions, please contact Avalara sales or your customer account manager.
|
47
|
-
#
|
48
|
-
# Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
|
49
|
-
# Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
|
50
|
-
#
|
51
|
-
# ### Security Policies
|
52
|
-
#
|
53
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
54
|
-
# @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).<br />*Not filterable:* subscriptionDescription
|
55
|
-
# @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
|
56
|
-
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
|
57
|
-
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
|
58
|
-
# @return [FetchResult]
|
59
|
-
def query_subscriptions(options={}) path = "/api/v2/subscriptions"
|
60
|
-
get(path, options) end
|
61
|
-
end
|
62
|
-
end
|
1
|
+
module AvaTax
|
2
|
+
class Client
|
3
|
+
module Subscriptions
|
4
|
+
|
5
|
+
|
6
|
+
# Retrieve a single subscription
|
7
|
+
#
|
8
|
+
# Get the subscription object identified by this URL.
|
9
|
+
# A 'subscription' indicates a licensed subscription to a named Avalara service.
|
10
|
+
# To request or remove subscriptions, please contact Avalara sales or your customer account manager.
|
11
|
+
#
|
12
|
+
# ### Security Policies
|
13
|
+
#
|
14
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
15
|
+
# @param accountId [Integer] The ID of the account that owns this subscription
|
16
|
+
# @param id [Integer] The primary key of this subscription
|
17
|
+
# @return [Object]
|
18
|
+
def get_subscription(accountId, id) path = "/api/v2/accounts/#{accountId}/subscriptions/#{id}"
|
19
|
+
get(path) end
|
20
|
+
|
21
|
+
# Retrieve subscriptions for this account
|
22
|
+
#
|
23
|
+
# List all subscription objects attached to this account.
|
24
|
+
# A 'subscription' indicates a licensed subscription to a named Avalara service.
|
25
|
+
# To request or remove subscriptions, please contact Avalara sales or your customer account manager.
|
26
|
+
#
|
27
|
+
# Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
|
28
|
+
# Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
|
29
|
+
#
|
30
|
+
# ### Security Policies
|
31
|
+
#
|
32
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
33
|
+
# @param accountId [Integer] The ID of the account that owns these subscriptions
|
34
|
+
# @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).<br />*Not filterable:* subscriptionDescription
|
35
|
+
# @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
|
36
|
+
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
|
37
|
+
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
|
38
|
+
# @return [FetchResult]
|
39
|
+
def list_subscriptions_by_account(accountId, options={}) path = "/api/v2/accounts/#{accountId}/subscriptions"
|
40
|
+
get(path, options) end
|
41
|
+
|
42
|
+
# Retrieve all subscriptions
|
43
|
+
#
|
44
|
+
# Get multiple subscription objects across all accounts.
|
45
|
+
# A 'subscription' indicates a licensed subscription to a named Avalara service.
|
46
|
+
# To request or remove subscriptions, please contact Avalara sales or your customer account manager.
|
47
|
+
#
|
48
|
+
# Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
|
49
|
+
# Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
|
50
|
+
#
|
51
|
+
# ### Security Policies
|
52
|
+
#
|
53
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
54
|
+
# @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).<br />*Not filterable:* subscriptionDescription
|
55
|
+
# @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
|
56
|
+
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
|
57
|
+
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
|
58
|
+
# @return [FetchResult]
|
59
|
+
def query_subscriptions(options={}) path = "/api/v2/subscriptions"
|
60
|
+
get(path, options) end
|
61
|
+
end
|
62
|
+
end
|
63
63
|
end
|
@@ -1,121 +1,121 @@
|
|
1
|
-
module AvaTax
|
2
|
-
class Client
|
3
|
-
module TaxCodes
|
4
|
-
|
5
|
-
|
6
|
-
# Create a new tax code
|
7
|
-
#
|
8
|
-
# Create one or more new taxcode objects attached to this company.
|
9
|
-
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
10
|
-
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
11
|
-
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
12
|
-
# taxability rules for this product in all supported jurisdictions.
|
13
|
-
#
|
14
|
-
# ### Security Policies
|
15
|
-
#
|
16
|
-
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
|
17
|
-
# @param companyId [Integer] The ID of the company that owns this tax code.
|
18
|
-
# @param model [TaxCodeModel[]] The tax code you wish to create.
|
19
|
-
# @return [TaxCodeModel[]]
|
20
|
-
def create_tax_codes(companyId, model) path = "/api/v2/companies/#{companyId}/taxcodes"
|
21
|
-
post(path, model) end
|
22
|
-
|
23
|
-
# Delete a single tax code
|
24
|
-
#
|
25
|
-
# Marks the existing TaxCode object at this URL as deleted.
|
26
|
-
#
|
27
|
-
# ### Security Policies
|
28
|
-
#
|
29
|
-
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
|
30
|
-
# @param companyId [Integer] The ID of the company that owns this tax code.
|
31
|
-
# @param id [Integer] The ID of the tax code you wish to delete.
|
32
|
-
# @return [ErrorDetail[]]
|
33
|
-
def delete_tax_code(companyId, id) path = "/api/v2/companies/#{companyId}/taxcodes/#{id}"
|
34
|
-
delete(path) end
|
35
|
-
|
36
|
-
# Retrieve a single tax code
|
37
|
-
#
|
38
|
-
# Get the taxcode object identified by this URL.
|
39
|
-
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
40
|
-
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
41
|
-
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
42
|
-
# taxability rules for this product in all supported jurisdictions.
|
43
|
-
#
|
44
|
-
# ### Security Policies
|
45
|
-
#
|
46
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
47
|
-
# @param companyId [Integer] The ID of the company that owns this tax code
|
48
|
-
# @param id [Integer] The primary key of this tax code
|
49
|
-
# @return [Object]
|
50
|
-
def get_tax_code(companyId, id) path = "/api/v2/companies/#{companyId}/taxcodes/#{id}"
|
51
|
-
get(path) end
|
52
|
-
|
53
|
-
# Retrieve tax codes for this company
|
54
|
-
#
|
55
|
-
# List all taxcode objects attached to this company.
|
56
|
-
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
57
|
-
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
58
|
-
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
59
|
-
# taxability rules for this product in all supported jurisdictions.
|
60
|
-
#
|
61
|
-
# Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
|
62
|
-
# Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
|
63
|
-
#
|
64
|
-
# ### Security Policies
|
65
|
-
#
|
66
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
67
|
-
# @param companyId [Integer] The ID of the company that owns these tax codes
|
68
|
-
# @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
|
69
|
-
# @param include [String] A comma separated list of additional data to retrieve.
|
70
|
-
# @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
|
71
|
-
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
|
72
|
-
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
|
73
|
-
# @return [FetchResult]
|
74
|
-
def list_tax_codes_by_company(companyId, options={}) path = "/api/v2/companies/#{companyId}/taxcodes"
|
75
|
-
get(path, options) end
|
76
|
-
|
77
|
-
# Retrieve all tax codes
|
78
|
-
#
|
79
|
-
# Get multiple taxcode objects across all companies.
|
80
|
-
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
81
|
-
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
82
|
-
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
83
|
-
# taxability rules for this product in all supported jurisdictions.
|
84
|
-
#
|
85
|
-
# Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
|
86
|
-
# Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
|
87
|
-
#
|
88
|
-
# ### Security Policies
|
89
|
-
#
|
90
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
91
|
-
# @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
|
92
|
-
# @param include [String] A comma separated list of additional data to retrieve.
|
93
|
-
# @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
|
94
|
-
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
|
95
|
-
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
|
96
|
-
# @return [FetchResult]
|
97
|
-
def query_tax_codes(options={}) path = "/api/v2/taxcodes"
|
98
|
-
get(path, options) end
|
99
|
-
|
100
|
-
# Update a single tax code
|
101
|
-
#
|
102
|
-
# Replace the existing taxcode object at this URL with an updated object.
|
103
|
-
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
104
|
-
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
105
|
-
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
106
|
-
# taxability rules for this product in all supported jurisdictions.
|
107
|
-
# All data from the existing object will be replaced with data in the object you PUT.
|
108
|
-
# To set a field's value to null, you may either set its value to null or omit that field from the object you post.
|
109
|
-
#
|
110
|
-
# ### Security Policies
|
111
|
-
#
|
112
|
-
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
|
113
|
-
# @param companyId [Integer] The ID of the company that this tax code belongs to.
|
114
|
-
# @param id [Integer] The ID of the tax code you wish to update
|
115
|
-
# @param model [Object] The tax code you wish to update.
|
116
|
-
# @return [Object]
|
117
|
-
def update_tax_code(companyId, id, model) path = "/api/v2/companies/#{companyId}/taxcodes/#{id}"
|
118
|
-
put(path, model) end
|
119
|
-
end
|
120
|
-
end
|
1
|
+
module AvaTax
|
2
|
+
class Client
|
3
|
+
module TaxCodes
|
4
|
+
|
5
|
+
|
6
|
+
# Create a new tax code
|
7
|
+
#
|
8
|
+
# Create one or more new taxcode objects attached to this company.
|
9
|
+
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
10
|
+
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
11
|
+
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
12
|
+
# taxability rules for this product in all supported jurisdictions.
|
13
|
+
#
|
14
|
+
# ### Security Policies
|
15
|
+
#
|
16
|
+
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
|
17
|
+
# @param companyId [Integer] The ID of the company that owns this tax code.
|
18
|
+
# @param model [TaxCodeModel[]] The tax code you wish to create.
|
19
|
+
# @return [TaxCodeModel[]]
|
20
|
+
def create_tax_codes(companyId, model) path = "/api/v2/companies/#{companyId}/taxcodes"
|
21
|
+
post(path, model) end
|
22
|
+
|
23
|
+
# Delete a single tax code
|
24
|
+
#
|
25
|
+
# Marks the existing TaxCode object at this URL as deleted.
|
26
|
+
#
|
27
|
+
# ### Security Policies
|
28
|
+
#
|
29
|
+
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
|
30
|
+
# @param companyId [Integer] The ID of the company that owns this tax code.
|
31
|
+
# @param id [Integer] The ID of the tax code you wish to delete.
|
32
|
+
# @return [ErrorDetail[]]
|
33
|
+
def delete_tax_code(companyId, id) path = "/api/v2/companies/#{companyId}/taxcodes/#{id}"
|
34
|
+
delete(path) end
|
35
|
+
|
36
|
+
# Retrieve a single tax code
|
37
|
+
#
|
38
|
+
# Get the taxcode object identified by this URL.
|
39
|
+
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
40
|
+
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
41
|
+
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
42
|
+
# taxability rules for this product in all supported jurisdictions.
|
43
|
+
#
|
44
|
+
# ### Security Policies
|
45
|
+
#
|
46
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
47
|
+
# @param companyId [Integer] The ID of the company that owns this tax code
|
48
|
+
# @param id [Integer] The primary key of this tax code
|
49
|
+
# @return [Object]
|
50
|
+
def get_tax_code(companyId, id) path = "/api/v2/companies/#{companyId}/taxcodes/#{id}"
|
51
|
+
get(path) end
|
52
|
+
|
53
|
+
# Retrieve tax codes for this company
|
54
|
+
#
|
55
|
+
# List all taxcode objects attached to this company.
|
56
|
+
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
57
|
+
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
58
|
+
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
59
|
+
# taxability rules for this product in all supported jurisdictions.
|
60
|
+
#
|
61
|
+
# Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
|
62
|
+
# Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
|
63
|
+
#
|
64
|
+
# ### Security Policies
|
65
|
+
#
|
66
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
67
|
+
# @param companyId [Integer] The ID of the company that owns these tax codes
|
68
|
+
# @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
|
69
|
+
# @param include [String] A comma separated list of additional data to retrieve.
|
70
|
+
# @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
|
71
|
+
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
|
72
|
+
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
|
73
|
+
# @return [FetchResult]
|
74
|
+
def list_tax_codes_by_company(companyId, options={}) path = "/api/v2/companies/#{companyId}/taxcodes"
|
75
|
+
get(path, options) end
|
76
|
+
|
77
|
+
# Retrieve all tax codes
|
78
|
+
#
|
79
|
+
# Get multiple taxcode objects across all companies.
|
80
|
+
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
81
|
+
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
82
|
+
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
83
|
+
# taxability rules for this product in all supported jurisdictions.
|
84
|
+
#
|
85
|
+
# Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
|
86
|
+
# Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
|
87
|
+
#
|
88
|
+
# ### Security Policies
|
89
|
+
#
|
90
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
91
|
+
# @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
|
92
|
+
# @param include [String] A comma separated list of additional data to retrieve.
|
93
|
+
# @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
|
94
|
+
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
|
95
|
+
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
|
96
|
+
# @return [FetchResult]
|
97
|
+
def query_tax_codes(options={}) path = "/api/v2/taxcodes"
|
98
|
+
get(path, options) end
|
99
|
+
|
100
|
+
# Update a single tax code
|
101
|
+
#
|
102
|
+
# Replace the existing taxcode object at this URL with an updated object.
|
103
|
+
# A 'TaxCode' represents a uniquely identified type of product, good, or service.
|
104
|
+
# Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions.
|
105
|
+
# If you identify your products by tax code in your 'Create Transacion' API calls, Avalara will correctly calculate tax rates and
|
106
|
+
# taxability rules for this product in all supported jurisdictions.
|
107
|
+
# All data from the existing object will be replaced with data in the object you PUT.
|
108
|
+
# To set a field's value to null, you may either set its value to null or omit that field from the object you post.
|
109
|
+
#
|
110
|
+
# ### Security Policies
|
111
|
+
#
|
112
|
+
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
|
113
|
+
# @param companyId [Integer] The ID of the company that this tax code belongs to.
|
114
|
+
# @param id [Integer] The ID of the tax code you wish to update
|
115
|
+
# @param model [Object] The tax code you wish to update.
|
116
|
+
# @return [Object]
|
117
|
+
def update_tax_code(companyId, id, model) path = "/api/v2/companies/#{companyId}/taxcodes/#{id}"
|
118
|
+
put(path, model) end
|
119
|
+
end
|
120
|
+
end
|
121
121
|
end
|
@@ -1,134 +1,134 @@
|
|
1
|
-
module AvaTax
|
2
|
-
class Client
|
3
|
-
module TaxContent
|
4
|
-
|
5
|
-
|
6
|
-
# Build a multi-location tax content file
|
7
|
-
#
|
8
|
-
# Builds a tax content file containing information useful for a retail point-of-sale solution.
|
9
|
-
#
|
10
|
-
# Since tax rates may change based on decisions made by a variety of tax authorities, we recommend
|
11
|
-
# that users of this tax content API download new data every day. Many tax authorities may finalize
|
12
|
-
# decisions on tax changes at unexpected times and may make changes in response to legal issues or
|
13
|
-
# governmental priorities. Any tax content downloaded for future time periods is subject to change
|
14
|
-
# if tax rates or tax laws change.
|
15
|
-
#
|
16
|
-
# A TaxContent file contains a matrix of the taxes that would be charged when you sell any of your
|
17
|
-
# Items at any of your Locations. To create items, use `CreateItems()`. To create locations, use
|
18
|
-
# `CreateLocations()`. The file is built by looking up the tax profile for your location and your
|
19
|
-
# item and calculating taxes for each in turn. To include a custom `TaxCode` in this tax content
|
20
|
-
# file, first create the custom tax code using `CreateTaxCodes()` to create the custom tax code,
|
21
|
-
# then use `CreateItems()` to create an item that uses the custom tax code.
|
22
|
-
#
|
23
|
-
# This data file can be customized for specific partner devices and usage conditions.
|
24
|
-
#
|
25
|
-
# The result of this API is the file you requested in the format you requested using the `responseType` field.
|
26
|
-
#
|
27
|
-
# This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content
|
28
|
-
# file for a single location at a time, please use `BuildTaxContentFileForLocation`.
|
29
|
-
#
|
30
|
-
# NOTE: This API does not work for Tennessee tax holiday scenarios.
|
31
|
-
#
|
32
|
-
# ### Security Policies
|
33
|
-
#
|
34
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
35
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
36
|
-
# @param model [Object] Parameters about the desired file format and report format, specifying which company, locations and TaxCodes to include.
|
37
|
-
# @return [Object]
|
38
|
-
def build_tax_content_file(model) path = "/api/v2/pointofsaledata/build"
|
39
|
-
post(path, model) end
|
40
|
-
|
41
|
-
# Build a tax content file for a single location
|
42
|
-
#
|
43
|
-
# Builds a tax content file containing information useful for a retail point-of-sale solution.
|
44
|
-
#
|
45
|
-
# Since tax rates may change based on decisions made by a variety of tax authorities, we recommend
|
46
|
-
# that users of this tax content API download new data every day. Many tax authorities may finalize
|
47
|
-
# decisions on tax changes at unexpected times and may make changes in response to legal issues or
|
48
|
-
# governmental priorities. Any tax content downloaded for future time periods is subject to change
|
49
|
-
# if tax rates or tax laws change.
|
50
|
-
#
|
51
|
-
# A TaxContent file contains a matrix of the taxes that would be charged when you sell any of your
|
52
|
-
# Items at any of your Locations. To create items, use `CreateItems()`. To create locations, use
|
53
|
-
# `CreateLocations()`. The file is built by looking up the tax profile for your location and your
|
54
|
-
# item and calculating taxes for each in turn. To include a custom `TaxCode` in this tax content
|
55
|
-
# file, first create the custom tax code using `CreateTaxCodes()` to create the custom tax code,
|
56
|
-
# then use `CreateItems()` to create an item that uses the custom tax code.
|
57
|
-
#
|
58
|
-
# This data file can be customized for specific partner devices and usage conditions.
|
59
|
-
#
|
60
|
-
# The result of this API is the file you requested in the format you requested using the `responseType` field.
|
61
|
-
#
|
62
|
-
# This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content
|
63
|
-
# file for a multiple locations in a single file, please use `BuildTaxContentFile`.
|
64
|
-
#
|
65
|
-
# NOTE: This API does not work for Tennessee tax holiday scenarios.
|
66
|
-
#
|
67
|
-
# ### Security Policies
|
68
|
-
#
|
69
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
70
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
71
|
-
# @param companyId [Integer] The ID number of the company that owns this location.
|
72
|
-
# @param id [Integer] The ID number of the location to retrieve point-of-sale data.
|
73
|
-
# @param date [DateTime] The date for which point-of-sale data would be calculated (today by default)
|
74
|
-
# @param format [String] The format of the file (JSON by default) (See PointOfSaleFileType::* for a list of allowable values)
|
75
|
-
# @param partnerId [String] If specified, requests a custom partner-formatted version of the file. (See PointOfSalePartnerId::* for a list of allowable values)
|
76
|
-
# @param includeJurisCodes [Boolean] When true, the file will include jurisdiction codes in the result.
|
77
|
-
# @return [Object]
|
78
|
-
def build_tax_content_file_for_location(companyId, id, options={}) path = "/api/v2/companies/#{companyId}/locations/#{id}/pointofsaledata"
|
79
|
-
get(path, options) end
|
80
|
-
|
81
|
-
# Download a file listing tax rates by postal code
|
82
|
-
#
|
83
|
-
# Download a CSV file containing all five digit postal codes in the United States and their sales
|
84
|
-
# and use tax rates for tangible personal property.
|
85
|
-
#
|
86
|
-
# Since tax rates may change based on decisions made by a variety of tax authorities, we recommend
|
87
|
-
# that users of this tax content API download new data every day. Many tax authorities may finalize
|
88
|
-
# decisions on tax changes at unexpected times and may make changes in response to legal issues or
|
89
|
-
# governmental priorities. Any tax content downloaded for future time periods is subject to change
|
90
|
-
# if tax rates or tax laws change.
|
91
|
-
#
|
92
|
-
# This rates file is intended to be used as a default for tax calculation when your software cannot
|
93
|
-
# call the `CreateTransaction` API call. When using this file, your software will be unable to
|
94
|
-
# handle complex tax rules such as:
|
95
|
-
#
|
96
|
-
# * Zip+4 - This tax file contains five digit zip codes only.
|
97
|
-
# * Different product types - This tax file contains tangible personal property tax rates only.
|
98
|
-
# * Mixed sourcing - This tax file cannot be used to resolve origin-based taxes.
|
99
|
-
# * Threshold-based taxes - This tax file does not contain information about thresholds.
|
100
|
-
#
|
101
|
-
# If you use this file to provide default tax rates, please ensure that your software calls `CreateTransaction`
|
102
|
-
# to reconcile the actual transaction and determine the difference between the estimated general tax
|
103
|
-
# rate and the final transaction tax.
|
104
|
-
#
|
105
|
-
# The file provided by this API is in CSV format with the following columns:
|
106
|
-
#
|
107
|
-
# * ZIP_CODE - The five digit zip code for this record.
|
108
|
-
# * STATE_ABBREV - A valid two character US state abbreviation for this record. Zip codes may span multiple states.
|
109
|
-
# * COUNTY_NAME - A valid county name for this record. Zip codes may span multiple counties.
|
110
|
-
# * CITY_NAME - A valid city name for this record. Zip codes may span multiple cities.
|
111
|
-
# * STATE_SALES_TAX - The state component of the sales tax rate.
|
112
|
-
# * STATE_USE_TAX - The state component of the use tax rate.
|
113
|
-
# * COUNTY_SALES_TAX - The county component of the sales tax rate.
|
114
|
-
# * COUNTY_USE_TAX - The county component of the use tax rate.
|
115
|
-
# * CITY_SALES_TAX - The city component of the sales tax rate.
|
116
|
-
# * CITY_USE_TAX - The city component of the use tax rate.
|
117
|
-
# * TOTAL_SALES_TAX - The total tax rate for sales tax for this postal code. This value may not equal the sum of the state/county/city due to special tax jurisdiction rules.
|
118
|
-
# * TOTAL_USE_TAX - The total tax rate for use tax for this postal code. This value may not equal the sum of the state/county/city due to special tax jurisdiction rules.
|
119
|
-
# * TAX_SHIPPING_ALONE - This column contains 'Y' if shipping is taxable.
|
120
|
-
# * TAX_SHIPPING_AND_HANDLING_TOGETHER - This column contains 'Y' if shipping and handling are taxable when sent together.
|
121
|
-
#
|
122
|
-
# For more detailed tax content, please use the `BuildTaxContentFile` API which allows usage of exact items and exact locations.
|
123
|
-
#
|
124
|
-
# ### Security Policies
|
125
|
-
#
|
126
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
127
|
-
# @param date [DateTime] The date for which point-of-sale data would be calculated (today by default). Example input: 2016-12-31
|
128
|
-
# @param region [String] A two character region code which limits results to a specific region.
|
129
|
-
# @return [Object]
|
130
|
-
def download_tax_rates_by_zip_code(date, options={}) path = "/api/v2/taxratesbyzipcode/download/#{date}"
|
131
|
-
get(path, options) end
|
132
|
-
end
|
133
|
-
end
|
1
|
+
module AvaTax
|
2
|
+
class Client
|
3
|
+
module TaxContent
|
4
|
+
|
5
|
+
|
6
|
+
# Build a multi-location tax content file
|
7
|
+
#
|
8
|
+
# Builds a tax content file containing information useful for a retail point-of-sale solution.
|
9
|
+
#
|
10
|
+
# Since tax rates may change based on decisions made by a variety of tax authorities, we recommend
|
11
|
+
# that users of this tax content API download new data every day. Many tax authorities may finalize
|
12
|
+
# decisions on tax changes at unexpected times and may make changes in response to legal issues or
|
13
|
+
# governmental priorities. Any tax content downloaded for future time periods is subject to change
|
14
|
+
# if tax rates or tax laws change.
|
15
|
+
#
|
16
|
+
# A TaxContent file contains a matrix of the taxes that would be charged when you sell any of your
|
17
|
+
# Items at any of your Locations. To create items, use `CreateItems()`. To create locations, use
|
18
|
+
# `CreateLocations()`. The file is built by looking up the tax profile for your location and your
|
19
|
+
# item and calculating taxes for each in turn. To include a custom `TaxCode` in this tax content
|
20
|
+
# file, first create the custom tax code using `CreateTaxCodes()` to create the custom tax code,
|
21
|
+
# then use `CreateItems()` to create an item that uses the custom tax code.
|
22
|
+
#
|
23
|
+
# This data file can be customized for specific partner devices and usage conditions.
|
24
|
+
#
|
25
|
+
# The result of this API is the file you requested in the format you requested using the `responseType` field.
|
26
|
+
#
|
27
|
+
# This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content
|
28
|
+
# file for a single location at a time, please use `BuildTaxContentFileForLocation`.
|
29
|
+
#
|
30
|
+
# NOTE: This API does not work for Tennessee tax holiday scenarios.
|
31
|
+
#
|
32
|
+
# ### Security Policies
|
33
|
+
#
|
34
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
35
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
36
|
+
# @param model [Object] Parameters about the desired file format and report format, specifying which company, locations and TaxCodes to include.
|
37
|
+
# @return [Object]
|
38
|
+
def build_tax_content_file(model) path = "/api/v2/pointofsaledata/build"
|
39
|
+
post(path, model) end
|
40
|
+
|
41
|
+
# Build a tax content file for a single location
|
42
|
+
#
|
43
|
+
# Builds a tax content file containing information useful for a retail point-of-sale solution.
|
44
|
+
#
|
45
|
+
# Since tax rates may change based on decisions made by a variety of tax authorities, we recommend
|
46
|
+
# that users of this tax content API download new data every day. Many tax authorities may finalize
|
47
|
+
# decisions on tax changes at unexpected times and may make changes in response to legal issues or
|
48
|
+
# governmental priorities. Any tax content downloaded for future time periods is subject to change
|
49
|
+
# if tax rates or tax laws change.
|
50
|
+
#
|
51
|
+
# A TaxContent file contains a matrix of the taxes that would be charged when you sell any of your
|
52
|
+
# Items at any of your Locations. To create items, use `CreateItems()`. To create locations, use
|
53
|
+
# `CreateLocations()`. The file is built by looking up the tax profile for your location and your
|
54
|
+
# item and calculating taxes for each in turn. To include a custom `TaxCode` in this tax content
|
55
|
+
# file, first create the custom tax code using `CreateTaxCodes()` to create the custom tax code,
|
56
|
+
# then use `CreateItems()` to create an item that uses the custom tax code.
|
57
|
+
#
|
58
|
+
# This data file can be customized for specific partner devices and usage conditions.
|
59
|
+
#
|
60
|
+
# The result of this API is the file you requested in the format you requested using the `responseType` field.
|
61
|
+
#
|
62
|
+
# This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content
|
63
|
+
# file for a multiple locations in a single file, please use `BuildTaxContentFile`.
|
64
|
+
#
|
65
|
+
# NOTE: This API does not work for Tennessee tax holiday scenarios.
|
66
|
+
#
|
67
|
+
# ### Security Policies
|
68
|
+
#
|
69
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
70
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
71
|
+
# @param companyId [Integer] The ID number of the company that owns this location.
|
72
|
+
# @param id [Integer] The ID number of the location to retrieve point-of-sale data.
|
73
|
+
# @param date [DateTime] The date for which point-of-sale data would be calculated (today by default)
|
74
|
+
# @param format [String] The format of the file (JSON by default) (See PointOfSaleFileType::* for a list of allowable values)
|
75
|
+
# @param partnerId [String] If specified, requests a custom partner-formatted version of the file. (See PointOfSalePartnerId::* for a list of allowable values)
|
76
|
+
# @param includeJurisCodes [Boolean] When true, the file will include jurisdiction codes in the result.
|
77
|
+
# @return [Object]
|
78
|
+
def build_tax_content_file_for_location(companyId, id, options={}) path = "/api/v2/companies/#{companyId}/locations/#{id}/pointofsaledata"
|
79
|
+
get(path, options) end
|
80
|
+
|
81
|
+
# Download a file listing tax rates by postal code
|
82
|
+
#
|
83
|
+
# Download a CSV file containing all five digit postal codes in the United States and their sales
|
84
|
+
# and use tax rates for tangible personal property.
|
85
|
+
#
|
86
|
+
# Since tax rates may change based on decisions made by a variety of tax authorities, we recommend
|
87
|
+
# that users of this tax content API download new data every day. Many tax authorities may finalize
|
88
|
+
# decisions on tax changes at unexpected times and may make changes in response to legal issues or
|
89
|
+
# governmental priorities. Any tax content downloaded for future time periods is subject to change
|
90
|
+
# if tax rates or tax laws change.
|
91
|
+
#
|
92
|
+
# This rates file is intended to be used as a default for tax calculation when your software cannot
|
93
|
+
# call the `CreateTransaction` API call. When using this file, your software will be unable to
|
94
|
+
# handle complex tax rules such as:
|
95
|
+
#
|
96
|
+
# * Zip+4 - This tax file contains five digit zip codes only.
|
97
|
+
# * Different product types - This tax file contains tangible personal property tax rates only.
|
98
|
+
# * Mixed sourcing - This tax file cannot be used to resolve origin-based taxes.
|
99
|
+
# * Threshold-based taxes - This tax file does not contain information about thresholds.
|
100
|
+
#
|
101
|
+
# If you use this file to provide default tax rates, please ensure that your software calls `CreateTransaction`
|
102
|
+
# to reconcile the actual transaction and determine the difference between the estimated general tax
|
103
|
+
# rate and the final transaction tax.
|
104
|
+
#
|
105
|
+
# The file provided by this API is in CSV format with the following columns:
|
106
|
+
#
|
107
|
+
# * ZIP_CODE - The five digit zip code for this record.
|
108
|
+
# * STATE_ABBREV - A valid two character US state abbreviation for this record. Zip codes may span multiple states.
|
109
|
+
# * COUNTY_NAME - A valid county name for this record. Zip codes may span multiple counties.
|
110
|
+
# * CITY_NAME - A valid city name for this record. Zip codes may span multiple cities.
|
111
|
+
# * STATE_SALES_TAX - The state component of the sales tax rate.
|
112
|
+
# * STATE_USE_TAX - The state component of the use tax rate.
|
113
|
+
# * COUNTY_SALES_TAX - The county component of the sales tax rate.
|
114
|
+
# * COUNTY_USE_TAX - The county component of the use tax rate.
|
115
|
+
# * CITY_SALES_TAX - The city component of the sales tax rate.
|
116
|
+
# * CITY_USE_TAX - The city component of the use tax rate.
|
117
|
+
# * TOTAL_SALES_TAX - The total tax rate for sales tax for this postal code. This value may not equal the sum of the state/county/city due to special tax jurisdiction rules.
|
118
|
+
# * TOTAL_USE_TAX - The total tax rate for use tax for this postal code. This value may not equal the sum of the state/county/city due to special tax jurisdiction rules.
|
119
|
+
# * TAX_SHIPPING_ALONE - This column contains 'Y' if shipping is taxable.
|
120
|
+
# * TAX_SHIPPING_AND_HANDLING_TOGETHER - This column contains 'Y' if shipping and handling are taxable when sent together.
|
121
|
+
#
|
122
|
+
# For more detailed tax content, please use the `BuildTaxContentFile` API which allows usage of exact items and exact locations.
|
123
|
+
#
|
124
|
+
# ### Security Policies
|
125
|
+
#
|
126
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
|
127
|
+
# @param date [DateTime] The date for which point-of-sale data would be calculated (today by default). Example input: 2016-12-31
|
128
|
+
# @param region [String] A two character region code which limits results to a specific region.
|
129
|
+
# @return [Object]
|
130
|
+
def download_tax_rates_by_zip_code(date, options={}) path = "/api/v2/taxratesbyzipcode/download/#{date}"
|
131
|
+
get(path, options) end
|
132
|
+
end
|
133
|
+
end
|
134
134
|
end
|