checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
---
2
2
SHA256:
3
- metadata.gz: acdb0cdea13e0be6e6a41ba6b3c5c40c009497443f9403f94f5343447135c827
4
- data.tar.gz: 7c24642b868c3e02bcc874e904de688ea2fd36eadc2228777acf82b03c01e225
3
+ metadata.gz: b88324dec64a5eaa91d48bbf1877d7b8691f8982ed3004b16543bc0ec0ad2bab
4
+ data.tar.gz: 5aba9d70d103f8784f091b17303a72a42a5e2c2b8590153c3d5e6f7b8293bb06
5
5
SHA512:
6
- metadata.gz: 1e1ced4ca131b1b80f375d193e3dacae07c464c4b54d0e360af1b3369e6d3bbbe3fac2a5a8ff45067efcb40914d36da0c120c6195b5d3b7e408794d8e1e2f440
7
- data.tar.gz: b66ef8d5bce5646278dbcd61d023365c2010b42bd8f64fb18da15c5013513f61b4e2e54eaade3fe2a680f5bfc294c9697284a5a43405e1fc5750a128d920f9ea
6
+ metadata.gz: f2899a3ab6d3e7c6197110809b7c10298e9aa63c217af0ac71a293b6b7d057ed7012200d654cd2876e038d4a26dfbbaedffb00e5e40ca68e4e7b3b3bc5a2843a
7
+ data.tar.gz: 41d77f48abe7e8695b62d4eff438d60ec3a895176b6533be67b19bd37179e492ffd4454563c65847238fb5d77db8968412b6accda2345261a0b112cfe8313533
data/.travis.yml CHANGED
@@ -1,7 +1,15 @@
1
1
language: ruby
2
2
sudo: false
3
3
rvm:
4
- - 2.4
5
- - 2.3
6
- - 2.2
7
- - 2.1
4
+ - 2.4
5
+ - 2.3
6
+ - 2.2
7
+ - 2.1
8
+ deploy:
9
+ provider: rubygems
10
+ api_key:
11
+ secure: VnQH+Ffony43CPwrJ9vBVQ+/4aHFNvlGbXSKZL9Elm2P/FKwgjycwNZ+QtPmKbA9bVUtUkPjK3phJYeL//cTv+asrBBWM/ptBCBWVYB+ICeDXCfhB7id2hcSIWy9xQ4/KdCJxgeD+gwF1Ce95XK7epZLkhcr1OpgNO+cqnA1KlZ7fkZDtFEkXtY8H40oZZ6d5G7S3s+yBUEGHoiAiD2Gj/6RfWqT8iKykT4TzBtQSzyUDVel5/dt3MG2o4kUMcF3IS+HU2fOv61mCBpCP8Y6uDSe14TWPtYrsyR+Y5E5g7OetOq3/JxMacxG7fSo6KYtkL6qYqULgc3YtUoAPyULg4nWHO1aixdBbEiD7WNlBiSeRkUgRxunNHNFwnasW1g1zrkYdcqwkROjPfXChwmFK5ZFho6PpuWpEijttNjbmjwC/IWb/7X04MPwm2tzs5pdVVBsm+Hb1dstxWsm5nLZ+xzFDDfcKqM9ktRUeeRF9SlpY/1eNdedf76IVMcZRRRPvRIJwW/zU7MPGfBqJv1AM74150X4tyGHA+OCV7aUAh9NeJegYhHfi8gFAItjQWo59ZsWXhXjwxRJwKOKTreEmmDlFrdQ7OP6uEBLy+d+4rQgxmQsB/+8TDKV0TH9bhITAqYmue9uu0Fb0mJkSaUMJ4rGl0zGM+58nIwQ2YmoeoY=
12
+ gem: avatax
13
+ on:
14
+ tags: true
15
+ branch: master
data/lib/avatax/client/addresses.rb CHANGED
@@ -12,6 +12,11 @@ module AvaTax
12
12
# This is the same API as the POST /api/v2/addresses/resolve endpoint.
13
13
# Both verbs are supported to provide for flexible implementation.
14
14
#
15
+ # Inorder to get any evaluation for an address please provide atleast one of the following fields/pairs:
16
+ # 1. postal code
17
+ # 2. line1 + city + region
18
+ # 3. line1 + postal code
19
+ #
15
20
# ### Security Policies
16
21
#
17
22
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
data/lib/avatax/client/avafileforms.rb CHANGED
@@ -11,8 +11,8 @@ module AvaTax
11
11
# ### Security Policies
12
12
#
13
13
# * This API requires the user role Compliance Root User.
14
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
15
- # * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request host address whitelisting for [Returns] for your servers.
14
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
15
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
16
16
# @param model [AvaFileFormModel[]] The AvaFileForm you wish to create.
17
17
# @return [AvaFileFormModel[]]
18
18
def create_ava_file_forms(model)
@@ -28,8 +28,8 @@ module AvaTax
28
28
# ### Security Policies
29
29
#
30
30
# * This API requires one of the following user roles: Compliance Root User, ComplianceUser, FirmAdmin.
31
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
32
- # * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request host address whitelisting for [Returns] for your servers.
31
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
32
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
33
33
# @param id [Integer] The ID of the AvaFileForm you wish to delete.
34
34
# @return [ErrorDetail[]]
35
35
def delete_ava_file_form(id)
@@ -45,8 +45,8 @@ module AvaTax
45
45
# ### Security Policies
46
46
#
47
47
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CompanyUser, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, FirmAdmin, FirmUser, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin.
48
- # * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request host address whitelisting for [Returns] for your servers.
49
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
48
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
49
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
50
50
# @param id [Integer] The primary key of this AvaFileForm
51
51
# @return [Object]
52
52
def get_ava_file_form(id)
@@ -63,10 +63,9 @@ module AvaTax
63
63
# ### Security Policies
64
64
#
65
65
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CompanyUser, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, FirmAdmin, FirmUser, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin.
66
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
67
- # * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request host address whitelisting for [Returns] for your servers.
66
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
67
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
68
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/).<br />*Not filterable:* outletTypeId
69
- # @param include [String] A comma separated list of additional data to retrieve.
70
69
# @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
70
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
72
71
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
@@ -85,8 +84,8 @@ module AvaTax
85
84
# ### Security Policies
86
85
#
87
86
# * This API requires the user role Compliance Root User.
88
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
89
- # * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request host address whitelisting for [Returns] for your servers.
87
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
88
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
90
89
# @param id [Integer] The ID of the AvaFileForm you wish to update
91
90
# @param model [Object] The AvaFileForm model you wish to update.
92
91
# @return [Object]
data/lib/avatax/client/batches.rb CHANGED
@@ -20,6 +20,11 @@ module AvaTax
20
20
# required, please use the
21
21
# [CreateTransaction API](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/).
22
22
#
23
+ # The maximum content length of the request body is limited to 28.6 MB. If this limit
24
+ # is exceeded, a 404 Not Found status will be returned (possibly with a CORS error if
25
+ # the API is called from a browser). In this situation, please split the request into
26
+ # smaller batches.
27
+ #
23
28
# ### Security Policies
24
29
#
25
30
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin.
data/lib/avatax/client/certificates.rb CHANGED
@@ -25,6 +25,8 @@ module AvaTax
25
25
# certificate related APIs. To check if this company is set up, call `GetCertificateSetup`. To request setup of the auditable document
26
26
# storage for this company, call `RequestCertificateSetup`.
27
27
#
28
+ # If the users specified in the certificates do not exist, the API will create the user and link them to the certificate
29
+ #
28
30
# ### Security Policies
29
31
#
30
32
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
@@ -61,7 +63,7 @@ module AvaTax
61
63
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
62
64
# @param companyId [Integer] The unique ID number of the company that recorded this certificate
63
65
# @param id [Integer] The unique ID number of this certificate
64
- # @return [Object]
66
+ # @return [ErrorDetail[]]
65
67
def delete_certificate(companyId, id)
66
68
path = "/api/v2/companies/#{companyId}/certificates/#{id}"
67
69
delete(path)
@@ -306,7 +308,7 @@ module AvaTax
306
308
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
307
309
# @param companyId [Integer] The ID number of the company to search
308
310
# @param include [String] OPTIONAL: A comma separated list of special fetch options. You can specify one or more of the following: * customers - Retrieves the list of customers linked to the certificate. * po_numbers - Retrieves all PO numbers tied to the certificate. * attributes - Retrieves all attributes applied to the certificate.
309
- # @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:* status, pdf, pages
311
+ # @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:* exemptionNumber, status, ecmsId, ecmsStatus, pdf, pages
310
312
# @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.
311
313
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
312
314
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
data/lib/avatax/client/companies.rb CHANGED
@@ -3,6 +3,43 @@ module AvaTax
3
3
module Companies
4
4
5
5
6
+ # Checks whether the integration being used to set up this company and run transactions onto this company is compliant to all requirements.
7
+ #
8
+ # Examines the most recent 100 transactions or data from the last month when verifying transaction-related integrations.
9
+ # For partners who write integrations against AvaTax for many clients, this API is a way to do a quick self testing to verify whether the
10
+ # written integrations for a company are sufficient enough to be delivered to the respective customers to start using it.
11
+ #
12
+ # This API provides messages specific enough (through predefined checks) to guide the partner on what integrations are still missing from the company to get fully certified.
13
+ # The API makes the following checks to conclude if the company is NOT fully certified:
14
+ # 1. Any past month items contains generic tax code of P0000000.
15
+ # 2. All the companies on the requesting account are test companies.
16
+ # 3. No Voided/Cancelled documents in the past 30 days.
17
+ # 4. There are less than 2 committed documents.
18
+ # 5. Any documentCode is a generic GUID string.
19
+ # 6. Any customerCode on document is a generic GUID string.
20
+ # 7. No document has more than 1 documentLine.
21
+ # 8. All of the documents have missing exemptionNo, customerUsageType, taxDateOverride or negative amount.
22
+ # 9. Any document quantity is a negative number.
23
+ # 10. Any document have repeated lines.
24
+ # 11. No document has shipping charge.
25
+ # 12. All documents have same ItemCodes, descriptions and taxCodes.
26
+ # 13. Less than 2 addresses used across all documents.
27
+ # 14. Whether locationCode was used in documents.
28
+ # 15. Account with AvaGlobal subscription and no documents have VATBuyerId.
29
+ # 16. Any document has currencyCode not being USD for accounts with AvaGlobal subscription.
30
+ # 17. All documents have countryCode used for accounts with AvaGlobal subscription.
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
+ # @param id [Integer] The ID of the company to check if its integration is certified.
36
+ # @return [String]
37
+ def certify_integration(id)
38
+ path = "/api/v2/companies/#{id}/certify"
39
+ get(path)
40
+ end
41
+
42
+
6
43
# Change the filing status of this company
7
44
#
8
45
# Changes the current filing status of this company.
@@ -63,6 +100,8 @@ module AvaTax
63
100
# A 'company' represents a single corporation or individual that is registered to handle transactional taxes.
64
101
# You may attach nested data objects such as contacts, locations, and nexus with this CREATE call, and those objects will be created with the company.
65
102
#
103
+ # NOTE: Please do not use these blacklisted characters in company name and code: ';', '\', '|'.
104
+ #
66
105
# ### Security Policies
67
106
#
68
107
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
@@ -89,6 +128,7 @@ module AvaTax
89
128
#
90
129
# ### Security Policies
91
130
#
131
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
92
132
# * 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.
93
133
# @param id [Integer] The unique identifier of the company
94
134
# @param model [Object] The funding initialization request
@@ -124,7 +164,7 @@ module AvaTax
124
164
# ### Security Policies
125
165
#
126
166
# * 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
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
167
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
128
168
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
129
169
# @param companyId [Integer] The unique identifier of the company
130
170
# @return [Object]
@@ -144,7 +184,7 @@ module AvaTax
144
184
# ### Security Policies
145
185
#
146
186
# * 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.
147
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
187
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
148
188
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
149
189
# @param companyId [Integer] The unique identifier of the company
150
190
# @param currency [String] The currency of the funding. USD and CAD are the only valid currencies
@@ -244,6 +284,7 @@ module AvaTax
244
284
#
245
285
# ### Security Policies
246
286
#
287
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
247
288
# * 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.
248
289
# @param id [Integer] The unique identifier of the company
249
290
# @return [FundingStatusModel[]]
@@ -292,7 +333,7 @@ module AvaTax
292
333
#
293
334
# * 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.
294
335
# @param include [String] A comma separated list of objects to fetch underneath this company. Any object with a URL path underneath this company can be fetched by specifying its name.
295
- # @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:* contacts, items, locations, nexus, settings, taxCodes, taxRules, upcs, nonReportingChildCompanies, exemptCerts
336
+ # @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:* IsFein, contacts, items, locations, nexus, settings, taxCodes, taxRules, upcs, nonReportingChildCompanies, exemptCerts
296
337
# @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.
297
338
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
298
339
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
@@ -342,6 +383,8 @@ module AvaTax
342
383
#
343
384
# To set a field's value to `null`, you may either set its value to `null` or omit that field from the object you PUT.
344
385
#
386
+ # NOTE: Please do not use these blacklisted characters in company name and code: ';', '\', '|'.
387
+ #
345
388
# ### Security Policies
346
389
#
347
390
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
data/lib/avatax/client/compliance.rb CHANGED
@@ -3,112 +3,6 @@ module AvaTax
3
3
module Compliance
4
4
5
5
6
- # Retrieve a single tax rate.
7
- #
8
- # This API is available by invitation only.
9
- # @param id [Integer] The ID of the tax rate to retrieve.
10
- # @return [Object]
11
- def get_tax_rate(id)
12
- path = "/api/v2/compliance/taxrates/#{id}"
13
- get(path)
14
- end
15
-
16
-
17
- # Retrieve a single tax region.
18
- #
19
- # This API is available by invitation only.
20
- # @param id [Integer] The ID of the tax region to retrieve.
21
- # @return [Object]
22
- def get_tax_region(id)
23
- path = "/api/v2/compliance/taxregions/#{id}"
24
- get(path)
25
- end
26
-
27
-
28
- # Retrieve jurisdictions and rates in a combined format.
29
- #
30
- # This API is available by invitation only.
31
- # @param effectiveDate [DateTime] Used to limit the jurisdictions returned.
32
- # @param endDate [DateTime] Used to limit the jurisdictions returned.
33
- # @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/).
34
- # @param include [String] A comma separated list of objects to fetch underneath this jurisdiction.
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 [Object]
39
- def query_jurisdiction_rates(options={})
40
- path = "/api/v2/compliance/jurisdictionrates"
41
- get(path, options)
42
- end
43
-
44
-
45
- # Retrieve all unique jurisdictions.
46
- #
47
- # This API is available by invitation only.
48
- #
49
- # You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values:
50
- #
51
- # * TaxRates
52
- # @param country [String] The two-character ISO-3166 code for the country.
53
- # @param region [String] The two or three character region code for the region.
54
- # @param effectiveDate [DateTime] Used to limit the jurisdictions or rates returned.
55
- # @param endDate [DateTime] Used to limit the jurisdictions or rates returned.
56
- # @param aggregationOption [String] Aggregation method used if rates are returned using the '$include' parameter. (See StackAggregationOption::* for a list of allowable values)
57
- # @param include [String] A comma separated list of objects to fetch underneath this tax rate.
58
- # @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.
59
- # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
60
- # @return [Object]
61
- def query_jurisdictions(country, region, options={})
62
- path = "/api/v2/compliance/jurisdictions/#{country}/#{region}"
63
- get(path, options)
64
- end
65
-
66
-
67
- # Retrieve all tax rates.
68
- #
69
- # This API is available by invitation only.
70
- # @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/).
71
- # @param include [String] A comma separated list of objects to fetch underneath this tax rate.
72
- # @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.
73
- # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
74
- # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
75
- # @return [Object]
76
- def query_tax_rates(options={})
77
- path = "/api/v2/compliance/taxrates"
78
- get(path, options)
79
- end
80
-
81
-
82
- # Retrieve all tax region jurisdictions.
83
- #
84
- # This API is available by invitation only.
85
- # @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/).
86
- # @param include [String] A comma separated list of objects to fetch underneath this tax region jurisdiction.
87
- # @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.
88
- # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
89
- # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
90
- # @return [Object]
91
- def query_tax_region_jurisdictions(options={})
92
- path = "/api/v2/compliance/taxregionjurisdictions"
93
- get(path, options)
94
- end
95
-
96
-
97
- # Retrieve all tax regions.
98
- #
99
- # This API is available by invitation only.
100
- # @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/).
101
- # @param include [String] A comma separated list of objects to fetch underneath this tax region.
102
- # @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.
103
- # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
104
- # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
105
- # @return [Object]
106
- def query_tax_regions(options={})
107
- path = "/api/v2/compliance/taxregions"
108
- get(path, options)
109
- end
110
-
111
-
112
6
# API to modify the reference fields at the document and the line level.
113
7
#
114
8
#
data/lib/avatax/client/customers.rb CHANGED
@@ -55,7 +55,7 @@ module AvaTax
55
55
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
56
56
# @param companyId [Integer] The unique ID number of the company that recorded this customer
57
57
# @param customerCode [String] The unique code representing this customer
58
- # @return [Object]
58
+ # @return [ErrorDetail[]]
59
59
def delete_customer(companyId, customerCode)
60
60
path = "/api/v2/companies/#{companyId}/customers/#{customerCode}"
61
61
delete(path)
@@ -76,6 +76,7 @@ module AvaTax
76
76
#
77
77
# * Certificates - Fetch a list of certificates linked to this customer.
78
78
# * CustomFields - Fetch a list of custom fields associated to this customer.
79
+ # * attributes - Retrieves all attributes applied to the customer.
79
80
#
80
81
# Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
81
82
# Companies that do not have this storage system set up will receive the error `CertCaptureNotConfiguredError` when they call exemption
@@ -96,6 +97,38 @@ module AvaTax
96
97
end
97
98
98
99
100
+ # Link attributes to a customer
101
+ #
102
+ # Link one or many attributes to a customer.
103
+ #
104
+ # A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a
105
+ # customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API.
106
+ #
107
+ # A customer object defines information about a person or business that purchases products from your
108
+ # company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this
109
+ # record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and
110
+ # identify any certificates linked to this customer object. If any certificate applies to the transaction,
111
+ # AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`.
112
+ #
113
+ # Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
114
+ # Companies that do not have this storage system set up will receive the error `CertCaptureNotConfiguredError` when they call exemption
115
+ # certificate related APIs. To check if this company is set up, call `GetCertificateSetup`. To request setup of the auditable document
116
+ # storage for this company, call `RequestCertificateSetup`.
117
+ #
118
+ # ### Security Policies
119
+ #
120
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin.
121
+ # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
122
+ # @param companyId [Integer] The unique ID number of the company that recorded the provided customer
123
+ # @param customerCode [String] The unique code representing the current customer
124
+ # @param model [CustomerAttributeModel[]] The list of attributes to link to the customer.
125
+ # @return [FetchResult]
126
+ def link_attributes_to_customer(companyId, customerCode, model)
127
+ path = "/api/v2/companies/#{companyId}/customers/#{customerCode}/attributes/link"
128
+ put(path, model)
129
+ end
130
+
131
+
99
132
# Link certificates to a customer
100
133
#
101
134
# Link one or more certificates to a customer.
@@ -155,6 +188,37 @@ module AvaTax
155
188
end
156
189
157
190
191
+ # Retrieve a customer's attributes
192
+ #
193
+ # Retrieve the attributes linked to the customer identified by this URL.
194
+ #
195
+ # A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a
196
+ # customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API.
197
+ #
198
+ # A customer object defines information about a person or business that purchases products from your
199
+ # company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this
200
+ # record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and
201
+ # identify any certificates linked to this customer object. If any certificate applies to the transaction,
202
+ # AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`.
203
+ #
204
+ # Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
205
+ # Companies that do not have this storage system set up will receive the error `CertCaptureNotConfiguredError` when they call exemption
206
+ # certificate related APIs. To check if this company is set up, call `GetCertificateSetup`. To request setup of the auditable document
207
+ # storage for this company, call `RequestCertificateSetup`.
208
+ #
209
+ # ### Security Policies
210
+ #
211
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
212
+ # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
213
+ # @param companyId [Integer] The unique ID number of the company that recorded the provided customer
214
+ # @param customerCode [String] The unique code representing the current customer
215
+ # @return [FetchResult]
216
+ def list_attributes_for_customer(companyId, customerCode)
217
+ path = "/api/v2/companies/#{companyId}/customers/#{customerCode}/attributes"
218
+ get(path)
219
+ end
220
+
221
+
158
222
# List certificates linked to a customer
159
223
#
160
224
# List all certificates linked to a customer.
@@ -177,7 +241,7 @@ module AvaTax
177
241
# @param companyId [Integer] The unique ID number of the company that recorded this customer
178
242
# @param customerCode [String] The unique code representing this customer
179
243
# @param include [String] OPTIONAL: A comma separated list of special fetch options. You can specify one or more of the following: * customers - Retrieves the list of customers linked to the certificate. * po_numbers - Retrieves all PO numbers tied to the certificate. * attributes - Retrieves all attributes applied to the certificate.
180
- # @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:* status, pdf, pages
244
+ # @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:* exemptionNumber, status, ecmsId, ecmsStatus, pdf, pages
181
245
# @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.
182
246
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
183
247
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
@@ -188,7 +252,7 @@ module AvaTax
188
252
end
189
253
190
254
191
- # List active certificates for a location
255
+ # List valid certificates for a location
192
256
#
193
257
# List valid certificates linked to a customer in a particular country and region.
194
258
#
@@ -234,6 +298,7 @@ module AvaTax
234
298
# You can use the `$include` parameter to fetch the following additional objects for expansion:
235
299
#
236
300
# * Certificates - Fetch a list of certificates linked to this customer.
301
+ # * attributes - Retrieves all attributes applied to the customer.
237
302
#
238
303
# Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
239
304
# Companies that do not have this storage system set up will receive the error `CertCaptureNotConfiguredError` when they call exemption
@@ -257,6 +322,38 @@ module AvaTax
257
322
end
258
323
259
324
325
+ # Unlink attributes from a customer
326
+ #
327
+ # Unlink one or many attributes from a customer.
328
+ #
329
+ # A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a
330
+ # customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API.
331
+ #
332
+ # A customer object defines information about a person or business that purchases products from your
333
+ # company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this
334
+ # record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and
335
+ # identify any certificates linked to this customer object. If any certificate applies to the transaction,
336
+ # AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`.
337
+ #
338
+ # Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
339
+ # Companies that do not have this storage system set up will receive the error `CertCaptureNotConfiguredError` when they call exemption
340
+ # certificate related APIs. To check if this company is set up, call `GetCertificateSetup`. To request setup of the auditable document
341
+ # storage for this company, call `RequestCertificateSetup`.
342
+ #
343
+ # ### Security Policies
344
+ #
345
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin.
346
+ # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
347
+ # @param companyId [Integer] The unique ID number of the company that recorded the customer
348
+ # @param customerCode [String] The unique code representing the current customer
349
+ # @param model [CustomerAttributeModel[]] The list of attributes to unlink from the customer.
350
+ # @return [FetchResult]
351
+ def unlink_attributes_from_customer(companyId, customerCode, model)
352
+ path = "/api/v2/companies/#{companyId}/customers/#{customerCode}/attributes/unlink"
353
+ put(path, model)
354
+ end
355
+
356
+
260
357
# Unlink certificates from a customer
261
358
#
262
359
# Remove one or more certificates to a customer.
data/lib/avatax/client/definitions.rb CHANGED
@@ -307,6 +307,8 @@ module AvaTax
307
307
#
308
308
# This API allows you to examine all Avalara-supported jurisdictions. You can filter your search by supplying
309
309
# SQL-like query for fetching only the ones you concerned about. For example: effectiveDate &gt; '2016-01-01'
310
+ #
311
+ # The rate, salesRate, and useRate fields are not available on the JurisdictionModels returned by this API.
310
312
# @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:* rate, salesRate, signatureCode, useRate
311
313
# @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.
312
314
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
data/lib/avatax/client/errortransactions.rb ADDED
@@ -0,0 +1,50 @@
1
+ module AvaTax
2
+ class Client
3
+ module ErrorTransactions
4
+
5
+
6
+ # Delete a batch of error transactions
7
+ #
8
+ # Delete a batch of error transactions attached to a company.
9
+ #
10
+ # If any of the provided error transaction isn't found then it'll be treated as a success.
11
+ #
12
+ # ### Security Policies
13
+ #
14
+ # * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
15
+ # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
16
+ # @param model [Object] The request that contains error transactions to be deleted
17
+ # @return [Object]
18
+ def delete_error_transactions(model)
19
+ path = "/api/v2/errortransactions"
20
+ delete(path, model)
21
+ end
22
+
23
+
24
+ # Retrieve list of error transactions
25
+ #
26
+ # List error transactions attached to this company. Results are dependent on `$filter` if provided.
27
+ #
28
+ # This endpoint is limited to returning 250 error transactions at a time maximum.
29
+ #
30
+ # 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/) .
31
+ # Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
32
+ #
33
+ # ### Security Policies
34
+ #
35
+ # * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
36
+ # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
37
+ # @param companyCode [String] The company code to filter on. This query parameter is required.
38
+ # @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:* companyId, avataxErrorJson, avataxCreateTransactionJson
39
+ # @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.
40
+ # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
41
+ # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
42
+ # @return [FetchResult]
43
+ def list_error_transactions(options={})
44
+ path = "/api/v2/errortransactions"
45
+ get(path, options)
46
+ end
47
+
48
+ end
49
+ end
50
+ end
data/lib/avatax/client/filingcalendars.rb CHANGED
@@ -12,7 +12,7 @@ module AvaTax
12
12
# ### Security Policies
13
13
#
14
14
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
15
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
15
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
16
16
# * This API is available by invitation only.
17
17
# @param companyId [Integer] The company id that we are checking about
18
18
# @param taxFormCode [String] The tax form code that we are checking
@@ -24,6 +24,486 @@ module AvaTax
24
24
get(path, options)
25
25
end
26
26
27
+
28
+ # Approve existing Filing Request
29
+ #
30
+ # This API is available by invitation only.
31
+ # A "filing request" represents a request to change an existing filing calendar. Filing requests
32
+ # are reviewed and validated by Avalara Compliance before being implemented.
33
+ # The filing request must be in the "ChangeRequest" status to be approved.
34
+ #
35
+ # ### Security Policies
36
+ #
37
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
38
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
39
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
40
+ # @param companyId [Integer] The unique ID of the company that owns the filing request object
41
+ # @param id [Integer] The unique ID of the filing request object
42
+ # @return [Object]
43
+ def approve_filing_request(companyId, id)
44
+ path = "/api/v2/companies/#{companyId}/filingrequests/#{id}/approve"
45
+ post(path)
46
+ end
47
+
48
+
49
+ # Cancel existing Filing Request
50
+ #
51
+ # This API is available by invitation only.
52
+ # A "filing request" represents a request to change an existing filing calendar. Filing requests
53
+ # are reviewed and validated by Avalara Compliance before being implemented.
54
+ #
55
+ # ### Security Policies
56
+ #
57
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
58
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
59
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
60
+ # @param companyId [Integer] The unique ID of the company that owns the filing request object
61
+ # @param id [Integer] The unique ID of the filing request object
62
+ # @return [Object]
63
+ def cancel_filing_request(companyId, id)
64
+ path = "/api/v2/companies/#{companyId}/filingrequests/#{id}/cancel"
65
+ post(path)
66
+ end
67
+
68
+
69
+ # Create a new filing request to cancel a filing calendar
70
+ #
71
+ # This API is available by invitation only.
72
+ #
73
+ # A "filing request" represents a request to change an existing filing calendar. Filing requests
74
+ # are reviewed and validated by Avalara Compliance before being implemented.
75
+ #
76
+ # ### Security Policies
77
+ #
78
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
79
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
80
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
81
+ # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
82
+ # @param id [Integer] The unique ID number of the filing calendar to cancel
83
+ # @param model [FilingRequestModel[]] The cancellation request for this filing calendar
84
+ # @return [Object]
85
+ def cancel_filing_requests(companyId, id, model)
86
+ path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}/cancel/request"
87
+ post(path, model)
88
+ end
89
+
90
+
91
+ # Create a filing calendar
92
+ #
93
+ # This API is available by invitation only and only available for users with Compliance access
94
+ # A "filing request" represents information that compliance uses to file a return
95
+ #
96
+ # ### Security Policies
97
+ #
98
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
99
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
100
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
101
+ # @param companyId [Integer] The unique ID of the company that will add the new filing calendar
102
+ # @param model [FilingCalendarModel[]] Filing calendars that will be added
103
+ # @return [FilingCalendarModel[]]
104
+ def create_filing_calendars(companyId, model)
105
+ path = "/api/v2/companies/#{companyId}/filingcalendars"
106
+ post(path, model)
107
+ end
108
+
109
+
110
+ # Create a new filing request to create a filing calendar
111
+ #
112
+ # This API is available by invitation only.
113
+ # A "filing request" represents a request to change an existing filing calendar. Filing requests
114
+ # are reviewed and validated by Avalara Compliance before being implemented.
115
+ #
116
+ # ### Security Policies
117
+ #
118
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
119
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
120
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
121
+ # @param companyId [Integer] The unique ID of the company that will add the new filing calendar
122
+ # @param model [FilingRequestModel[]] Information about the proposed new filing calendar
123
+ # @return [FilingRequestModel[]]
124
+ def create_filing_requests(companyId, model)
125
+ path = "/api/v2/companies/#{companyId}/filingcalendars/add/request"
126
+ post(path, model)
127
+ end
128
+
129
+
130
+ # Create a company return setting
131
+ #
132
+ # This API is available by invitation only and only available for users with Compliance access
133
+ #
134
+ # ### Security Policies
135
+ #
136
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
137
+ # @param companyId [Integer] The unique ID of the company that will add the new filing calendar
138
+ # @param filingCalendarId [Integer] The unique ID of the filing calendar that will add the new filing calendar setting
139
+ # @param model [CompanyReturnSettingModel[]] CompanyReturnSettings that will be added
140
+ # @return [CompanyReturnSettingModel[]]
141
+ def create_update_company_return_settings(companyId, filingCalendarId, model)
142
+ path = "/api/v2/companies/#{companyId}/filingcalendars/#{filingCalendarId}/settings"
143
+ post(path, model)
144
+ end
145
+
146
+
147
+ # Returns a list of options for adding the specified form.
148
+ #
149
+ # This API is available by invitation only.
150
+ #
151
+ # ### Security Policies
152
+ #
153
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
154
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
155
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
156
+ # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
157
+ # @param formCode [String] The unique code of the form
158
+ # @return [CycleAddOptionModel[]]
159
+ def cycle_safe_add(companyId, options={})
160
+ path = "/api/v2/companies/#{companyId}/filingcalendars/add/options"
161
+ get(path, options)
162
+ end
163
+
164
+
165
+ # Indicates when changes are allowed to be made to a filing calendar.
166
+ #
167
+ # This API is available by invitation only.
168
+ #
169
+ # ### Security Policies
170
+ #
171
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
172
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
173
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
174
+ # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
175
+ # @param id [Integer] The unique ID of the filing calendar object
176
+ # @param model [FilingCalendarEditModel[]] A list of filing calendar edits to be made
177
+ # @return [Object]
178
+ def cycle_safe_edit(companyId, id, model)
179
+ path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}/edit/options"
180
+ post(path, model)
181
+ end
182
+
183
+
184
+ # Returns a list of options for expiring a filing calendar
185
+ #
186
+ # This API is available by invitation only.
187
+ #
188
+ # ### Security Policies
189
+ #
190
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
191
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
192
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
193
+ # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
194
+ # @param id [Integer] The unique ID of the filing calendar object
195
+ # @return [Object]
196
+ def cycle_safe_expiration(companyId, id)
197
+ path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}/cancel/options"
198
+ get(path)
199
+ end
200
+
201
+
202
+ # Delete a single filing calendar.
203
+ #
204
+ # This API is available by invitation only.
205
+ # Mark the existing notice object at this URL as deleted.
206
+ # A 'notice' represents a letter sent to a business by a tax authority regarding tax filing issues. Avalara
207
+ # Returns customers often receive support and assistance from the Compliance Notices team in handling notices received by taxing authorities.
208
+ #
209
+ # ### Security Policies
210
+ #
211
+ # * 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.
212
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
213
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
214
+ # @param companyId [Integer] The ID of the company that owns this filing calendar.
215
+ # @param id [Integer] The ID of the filing calendar you wish to delete.
216
+ # @return [ErrorDetail[]]
217
+ def delete_filing_calendar(companyId, id)
218
+ path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}"
219
+ delete(path)
220
+ end
221
+
222
+
223
+ # Retrieve a single filing calendar
224
+ #
225
+ # This API is available by invitation only.
226
+ #
227
+ # ### Security Policies
228
+ #
229
+ # * 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.
230
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
231
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
232
+ # @param companyId [Integer] The ID of the company that owns this filing calendar
233
+ # @param id [Integer] The primary key of this filing calendar
234
+ # @return [Object]
235
+ def get_filing_calendar(companyId, id)
236
+ path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}"
237
+ get(path)
238
+ end
239
+
240
+
241
+ # Retrieve a single filing request
242
+ #
243
+ # This API is available by invitation only.
244
+ # A "filing request" represents a request to change an existing filing calendar. Filing requests
245
+ # are reviewed and validated by Avalara Compliance before being implemented.
246
+ #
247
+ # ### Security Policies
248
+ #
249
+ # * 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.
250
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
251
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
252
+ # @param companyId [Integer] The ID of the company that owns this filing calendar
253
+ # @param id [Integer] The primary key of this filing calendar
254
+ # @return [Object]
255
+ def get_filing_request(companyId, id)
256
+ path = "/api/v2/companies/#{companyId}/filingrequests/#{id}"
257
+ get(path)
258
+ end
259
+
260
+
261
+ # Retrieve all filing calendars for this company
262
+ #
263
+ # This API is available by invitation only.
264
+ #
265
+ # ### Security Policies
266
+ #
267
+ # * 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.
268
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
269
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
270
+ # @param companyId [Integer] The ID of the company that owns these batches
271
+ # @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:* taxAuthorityId, taxAuthorityName, taxAuthorityType, settings
272
+ # @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.
273
+ # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
274
+ # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
275
+ # @param returnCountry [String] A comma separated list of countries
276
+ # @param returnRegion [String] A comma separated list of regions
277
+ # @return [FetchResult]
278
+ def list_filing_calendars(companyId, options={})
279
+ path = "/api/v2/companies/#{companyId}/filingcalendars"
280
+ get(path, options)
281
+ end
282
+
283
+
284
+ # Retrieve all filing requests for this company
285
+ #
286
+ # This API is available by invitation only.
287
+ # A "filing request" represents a request to change an existing filing calendar. Filing requests
288
+ # are reviewed and validated by Avalara Compliance before being implemented.
289
+ #
290
+ # ### Security Policies
291
+ #
292
+ # * 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.
293
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
294
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
295
+ # @param companyId [Integer] The ID of the company that owns these batches
296
+ # @param filingCalendarId [Integer] Specific filing calendar id for the request
297
+ # @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/).
298
+ # @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.
299
+ # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
300
+ # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
301
+ # @return [FetchResult]
302
+ def list_filing_requests(companyId, options={})
303
+ path = "/api/v2/companies/#{companyId}/filingrequests"
304
+ get(path, options)
305
+ end
306
+
307
+
308
+ # New request for getting for validating customer's login credentials
309
+ #
310
+ # This API is available by invitation only.
311
+ #
312
+ # This API verifies that a customer has submitted correct login credentials for a tax authority's online filing system.
313
+ #
314
+ # ### Security Policies
315
+ #
316
+ # * 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.
317
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
318
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
319
+ # @param model [Object] The model of the login information we are verifying
320
+ # @return [Object]
321
+ def login_verification_request(model)
322
+ path = "/api/v2/filingcalendars/credentials/verify"
323
+ post(path, model)
324
+ end
325
+
326
+
327
+ # Gets the request status and Login Result
328
+ #
329
+ # This API is available by invitation only.
330
+ #
331
+ # This API checks the status of a login verification request. It may only be called by authorized users from the account
332
+ # that initially requested the login verification.
333
+ #
334
+ # ### Security Policies
335
+ #
336
+ # * 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.
337
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
338
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
339
+ # @param jobId [Integer] The unique ID number of this login request
340
+ # @return [Object]
341
+ def login_verification_status(jobId)
342
+ path = "/api/v2/filingcalendars/credentials/#{jobId}"
343
+ get(path)
344
+ end
345
+
346
+
347
+ # Retrieve all filing calendars
348
+ #
349
+ # This API is available by invitation only.
350
+ #
351
+ # This API is deprecated - please use POST `/api/v2/filingrequests/query` API.
352
+ #
353
+ # ### Security Policies
354
+ #
355
+ # * 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.
356
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
357
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
358
+ # @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:* taxAuthorityId, taxAuthorityName, taxAuthorityType, settings
359
+ # @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.
360
+ # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
361
+ # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
362
+ # @param returnCountry [String] If specified, fetches only filing calendars that apply to tax filings in this specific country. Uses ISO 3166 country codes.
363
+ # @param returnRegion [String] If specified, fetches only filing calendars that apply to tax filings in this specific region. Uses ISO 3166 region codes.
364
+ # @return [FetchResult]
365
+ def query_filing_calendars(options={})
366
+ path = "/api/v2/filingcalendars"
367
+ get(path, options)
368
+ end
369
+
370
+
371
+ # Retrieve all filing calendars
372
+ #
373
+ # This API is available by invitation only.
374
+ #
375
+ # This API is intended to replace the GET `/api/v2/filingcalendars` API. The fetch request object is posted on the body of the request instead of the URI, so it's not limited by a set number of characters.
376
+ # The documentation of the GET API shows how filtering, sorting and pagination works.
377
+ #
378
+ # ### Security Policies
379
+ #
380
+ # * 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.
381
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
382
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
383
+ # @param returnCountry [String] If specified, fetches only filing calendars that apply to tax filings in this specific country. Uses ISO 3166 country codes.
384
+ # @param returnRegion [String] If specified, fetches only filing calendars that apply to tax filings in this specific region. Uses ISO 3166 region codes.
385
+ # @param model [Object] Query object to filter, sort and paginate the filing calendars.
386
+ # @return [FetchResult]
387
+ def query_filing_calendars_post(model, options={})
388
+ path = "/api/v2/filingcalendars/query"
389
+ post(path, model, options)
390
+ end
391
+
392
+
393
+ # Retrieve all filing requests
394
+ #
395
+ # This API is available by invitation only.
396
+ #
397
+ # This API is deprecated - please use POST `/api/v2/filingrequests/query` API.
398
+ #
399
+ # A "filing request" represents a request to change an existing filing calendar. Filing requests
400
+ # are reviewed and validated by Avalara Compliance before being implemented.
401
+ #
402
+ # 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/) .
403
+ # Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
404
+ #
405
+ # ### Security Policies
406
+ #
407
+ # * 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.
408
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
409
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
410
+ # @param filingCalendarId [Integer] Specific filing calendar id for the request
411
+ # @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/).
412
+ # @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.
413
+ # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
414
+ # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
415
+ # @return [FetchResult]
416
+ def query_filing_requests(options={})
417
+ path = "/api/v2/filingrequests"
418
+ get(path, options)
419
+ end
420
+
421
+
422
+ # Retrieve all filing requests
423
+ #
424
+ # This API is available by invitation only.
425
+ #
426
+ # This API is intended to replace the GET `/api/v2/filingrequests` API. The fetch request object is posted on the body of the request instead of the URI, so it's not limited by a set number of characters.
427
+ # The documentation of the GET API shows how filtering, sorting and pagination works.
428
+ #
429
+ # ### Security Policies
430
+ #
431
+ # * 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.
432
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
433
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
434
+ # @param filingCalendarId [Integer] Specific filing calendar id for the request
435
+ # @param model [Object] Query object to filter, sort and paginate the filing calendars.
436
+ # @return [FetchResult]
437
+ def query_filing_requests_post(model, options={})
438
+ path = "/api/v2/filingrequests/query"
439
+ post(path, model, options)
440
+ end
441
+
442
+
443
+ # Create a new filing request to edit a filing calendar
444
+ #
445
+ # This API is available by invitation only.
446
+ #
447
+ # A "filing request" represents a request to change an existing filing calendar. Filing requests
448
+ # are reviewed and validated by Avalara Compliance before being implemented.
449
+ #
450
+ # Certain users may not update filing calendars directly. Instead, they may submit an edit request
451
+ # to modify the value of a filing calendar using this API.
452
+ #
453
+ # ### Security Policies
454
+ #
455
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
456
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
457
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
458
+ # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
459
+ # @param id [Integer] The unique ID number of the filing calendar to edit
460
+ # @param model [FilingRequestModel[]] A list of filing calendar edits to be made
461
+ # @return [Object]
462
+ def request_filing_calendar_update(companyId, id, model)
463
+ path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}/edit/request"
464
+ post(path, model)
465
+ end
466
+
467
+
468
+ # Edit existing Filing Calendar
469
+ #
470
+ # This API is available by invitation only.
471
+ #
472
+ # ### Security Policies
473
+ #
474
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
475
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
476
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
477
+ # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
478
+ # @param id [Integer] The unique ID of the filing calendar object
479
+ # @param model [Object] The filing calendar model you are wishing to update with.
480
+ # @return [Object]
481
+ def update_filing_calendar(companyId, id, model)
482
+ path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}"
483
+ put(path, model)
484
+ end
485
+
486
+
487
+ # Edit existing Filing Request
488
+ #
489
+ # This API is available by invitation only.
490
+ # A "filing request" represents a request to change an existing filing calendar. Filing requests
491
+ # are reviewed and validated by Avalara Compliance before being implemented.
492
+ #
493
+ # ### Security Policies
494
+ #
495
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
496
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
497
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
498
+ # @param companyId [Integer] The unique ID of the company that owns the filing request object
499
+ # @param id [Integer] The unique ID of the filing request object
500
+ # @param model [Object] A list of filing calendar edits to be made
501
+ # @return [Object]
502
+ def update_filing_request(companyId, id, model)
503
+ path = "/api/v2/companies/#{companyId}/filingrequests/#{id}"
504
+ put(path, model)
505
+ end
506
+
27
507
end
28
508
end
29
509
end
data/lib/avatax/client/filings.rb CHANGED
@@ -3,6 +3,309 @@ module AvaTax
3
3
module Filings
4
4
5
5
6
+ # Approve all filings for the specified company in the given filing period.
7
+ #
8
+ # This API is available by invitation only.
9
+ # Approving a return means the customer is ready to let Avalara file that return.
10
+ # Customer either approves themselves from admin console,
11
+ # else system auto-approves the night before the filing cycle.
12
+ # Sometimes Compliance has to manually unapprove and reapprove to modify liability or filing for the customer.
13
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
14
+ # based on filing frequency of filing.
15
+ #
16
+ # ### Security Policies
17
+ #
18
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
19
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
20
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
21
+ # @param companyId [Integer] The ID of the company that owns the filings.
22
+ # @param year [Integer] The year of the filing period to approve.
23
+ # @param month [Integer] The month of the filing period to approve.
24
+ # @param model [Object] The approve request you wish to execute.
25
+ # @return [FilingModel[]]
26
+ def approve_filings(companyId, year, month, model)
27
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/approve"
28
+ post(path, model)
29
+ end
30
+
31
+
32
+ # Approve all filings for the specified company in the given filing period and country.
33
+ #
34
+ # This API is available by invitation only.
35
+ # Approving a return means the customer is ready to let Avalara file that return.
36
+ # Customer either approves themselves from admin console,
37
+ # else system auto-approves the night before the filing cycle.
38
+ # Sometimes Compliance has to manually unapprove and reapprove to modify liability or filing for the customer.
39
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
40
+ # based on filing frequency of filing.
41
+ #
42
+ # ### Security Policies
43
+ #
44
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
45
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
46
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
47
+ # @param companyId [Integer] The ID of the company that owns the filings.
48
+ # @param year [Integer] The year of the filing period to approve.
49
+ # @param month [Integer] The month of the filing period to approve.
50
+ # @param country [String] The two-character ISO-3166 code for the country.
51
+ # @param model [Object] The approve request you wish to execute.
52
+ # @return [FilingModel[]]
53
+ def approve_filings_country(companyId, year, month, country, model)
54
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/approve"
55
+ post(path, model)
56
+ end
57
+
58
+
59
+ # Approve all filings for the specified company in the given filing period, country and region.
60
+ #
61
+ # This API is available by invitation only.
62
+ # Approving a return means the customer is ready to let Avalara file that return.
63
+ # Customer either approves themselves from admin console,
64
+ # else system auto-approves the night before the filing cycle
65
+ # Sometimes Compliance has to manually unapprove and reapprove to modify liability or filing for the customer.
66
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
67
+ # based on filing frequency of filing.
68
+ #
69
+ # ### Security Policies
70
+ #
71
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
72
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
73
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
74
+ # @param companyId [Integer] The ID of the company that owns the filings.
75
+ # @param year [Integer] The year of the filing period to approve.
76
+ # @param month [Integer] The month of the filing period to approve.
77
+ # @param country [String] The two-character ISO-3166 code for the country.
78
+ # @param region [String] The two or three character region code for the region.
79
+ # @param model [Object] The approve request you wish to execute.
80
+ # @return [FilingModel[]]
81
+ def approve_filings_country_region(companyId, year, month, country, region, model)
82
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/approve"
83
+ post(path, model)
84
+ end
85
+
86
+
87
+ # Add an adjustment to a given filing.
88
+ #
89
+ # This API is available by invitation only.
90
+ # An "Adjustment" is usually an increase or decrease to customer funding to Avalara,
91
+ # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
92
+ # Sometimes may be a manual change in tax liability similar to an augmentation.
93
+ # This API creates a new adjustment for an existing tax filing.
94
+ # This API can only be used when the filing has not yet been approved.
95
+ #
96
+ # ### Security Policies
97
+ #
98
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
99
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
100
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
101
+ # @param companyId [Integer] The ID of the company that owns the filing being adjusted.
102
+ # @param year [Integer] The year of the filing's filing period being adjusted.
103
+ # @param month [Integer] The month of the filing's filing period being adjusted.
104
+ # @param country [String] The two-character ISO-3166 code for the country of the filing being adjusted.
105
+ # @param region [String] The two or three character region code for the region.
106
+ # @param formCode [String] The unique code of the form being adjusted.
107
+ # @param model [FilingAdjustmentModel[]] A list of Adjustments to be created for the specified filing.
108
+ # @return [FilingAdjustmentModel[]]
109
+ def create_return_adjustment(companyId, year, month, country, region, formCode, model)
110
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/#{formCode}/adjust"
111
+ post(path, model)
112
+ end
113
+
114
+
115
+ # Add an augmentation for a given filing.
116
+ #
117
+ # This API is available by invitation only.
118
+ # An "Augmentation" is a manually added increase or decrease in tax liability, by either customer or Avalara
119
+ # usually due to customer wanting to report tax Avatax does not support, e.g. bad debts, rental tax.
120
+ # This API creates a new augmentation for an existing tax filing.
121
+ # This API can only be used when the filing has not been approved.
122
+ #
123
+ # ### Security Policies
124
+ #
125
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
126
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
127
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
128
+ # @param companyId [Integer] The ID of the company that owns the filing being changed.
129
+ # @param year [Integer] The month of the filing's filing period being changed.
130
+ # @param month [Integer] The month of the filing's filing period being changed.
131
+ # @param country [String] The two-character ISO-3166 code for the country of the filing being changed.
132
+ # @param region [String] The two or three character region code for the region of the filing being changed.
133
+ # @param formCode [String] The unique code of the form being changed.
134
+ # @param model [FilingAugmentationModel[]] A list of augmentations to be created for the specified filing.
135
+ # @return [FilingAugmentationModel[]]
136
+ def create_return_augmentation(companyId, year, month, country, region, formCode, model)
137
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/#{formCode}/augment"
138
+ post(path, model)
139
+ end
140
+
141
+
142
+ # Add an payment to a given filing.
143
+ #
144
+ # This API is available by invitation only.
145
+ # An "Payment" is usually an increase or decrease to customer funding to Avalara,
146
+ # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
147
+ # Sometimes may be a manual change in tax liability similar to an augmentation.
148
+ # This API creates a new payment for an existing tax filing.
149
+ # This API can only be used when the filing has not yet been approved.
150
+ #
151
+ # ### Security Policies
152
+ #
153
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
154
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
155
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
156
+ # @param companyId [Integer] The ID of the company that owns the filing being adjusted.
157
+ # @param year [Integer] The year of the filing's filing period being adjusted.
158
+ # @param month [Integer] The month of the filing's filing period being adjusted.
159
+ # @param country [String] The two-character ISO-3166 code for the country of the filing being adjusted.
160
+ # @param region [String] The two or three character region code for the region.
161
+ # @param formCode [String] The unique code of the form being adjusted.
162
+ # @param model [FilingPaymentModel[]] A list of Payments to be created for the specified filing.
163
+ # @return [FilingPaymentModel[]]
164
+ def create_return_payment(companyId, year, month, country, region, formCode, model)
165
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/#{formCode}/payment"
166
+ post(path, model)
167
+ end
168
+
169
+
170
+ # Delete an adjustment for a given filing.
171
+ #
172
+ # This API is available by invitation only.
173
+ # An "Adjustment" is usually an increase or decrease to customer funding to Avalara,
174
+ # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
175
+ # Sometimes may be a manual change in tax liability similar to an augmentation.
176
+ # This API deletes an adjustment for an existing tax filing.
177
+ # This API can only be used when the filing has been unapproved.
178
+ #
179
+ # ### Security Policies
180
+ #
181
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
182
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
183
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
184
+ # @param companyId [Integer] The ID of the company that owns the filing being adjusted.
185
+ # @param id [Integer] The ID of the adjustment being deleted.
186
+ # @param type [String] The type of adjustment that you are trying to delete.
187
+ # @return [ErrorDetail[]]
188
+ def delete_return_adjustment(companyId, id, options={})
189
+ path = "/api/v2/companies/#{companyId}/filings/adjust/#{id}"
190
+ delete(path, options)
191
+ end
192
+
193
+
194
+ # Delete an augmentation for a given filing.
195
+ #
196
+ # This API is available by invitation only.
197
+ # An "Augmentation" is a manually added increase or decrease in tax liability, by either customer or Avalara
198
+ # usually due to customer wanting to report tax Avatax does not support, e.g. bad debts, rental tax.
199
+ # This API deletes an augmentation for an existing tax filing.
200
+ # This API can only be used when the filing has been unapproved.
201
+ #
202
+ # ### Security Policies
203
+ #
204
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
205
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
206
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
207
+ # @param companyId [Integer] The ID of the company that owns the filing being changed.
208
+ # @param id [Integer] The ID of the augmentation being added.
209
+ # @return [ErrorDetail[]]
210
+ def delete_return_augmentation(companyId, id)
211
+ path = "/api/v2/companies/#{companyId}/filings/augment/#{id}"
212
+ delete(path)
213
+ end
214
+
215
+
216
+ # Delete an payment for a given filing.
217
+ #
218
+ # This API is available by invitation only.
219
+ # An "Payment" is usually an increase or decrease to customer funding to Avalara,
220
+ # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
221
+ # Sometimes may be a manual change in tax liability similar to an augmentation.
222
+ # This API deletes an payment for an existing tax filing.
223
+ # This API can only be used when the filing has been unapproved.
224
+ #
225
+ # ### Security Policies
226
+ #
227
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
228
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
229
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
230
+ # @param companyId [Integer] The ID of the company that owns the filing being adjusted.
231
+ # @param id [Integer] The ID of the payment being deleted.
232
+ # @return [ErrorDetail[]]
233
+ def delete_return_payment(companyId, id)
234
+ path = "/api/v2/companies/#{companyId}/filings/payment/#{id}"
235
+ delete(path)
236
+ end
237
+
238
+
239
+ # Retrieve worksheet checkup report for company and filing period.
240
+ #
241
+ # This API is available by invitation only.
242
+ #
243
+ # ### Security Policies
244
+ #
245
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
246
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
247
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
248
+ # @param filingsId [Integer] The unique id of the worksheet.
249
+ # @param companyId [Integer] The unique ID of the company that owns the worksheet.
250
+ # @return [Object]
251
+ def filings_checkup_report(filingsId, companyId)
252
+ path = "/api/v2/companies/#{companyId}/filings/#{filingsId}/checkup"
253
+ get(path)
254
+ end
255
+
256
+
257
+ # Retrieve worksheet checkup report for company and filing period.
258
+ #
259
+ # This API is available by invitation only.
260
+ #
261
+ # ### Security Policies
262
+ #
263
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
264
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
265
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
266
+ # @param companyId [Integer] The unique ID of the company that owns the worksheets object.
267
+ # @param year [Integer] The year of the filing period.
268
+ # @param month [Integer] The month of the filing period.
269
+ # @return [Object]
270
+ def filings_checkup_reports(companyId, year, month)
271
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/checkup"
272
+ get(path)
273
+ end
274
+
275
+
276
+ # Retrieve a list of filings for the specified accrual return.
277
+ #
278
+ # ### Security Policies
279
+ #
280
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
281
+ # @param companyId [Integer] The ID of the company that owns these batches
282
+ # @param filingReturnId [Integer] The ID of the accrual return
283
+ # @return [FetchResult]
284
+ def get_accrual_fillings(companyId, filingReturnId)
285
+ path = "/api/v2/companies/#{companyId}/filings/accrual/#{filingReturnId}"
286
+ get(path)
287
+ end
288
+
289
+
290
+ # Retrieve a single attachment for a filing
291
+ #
292
+ # This API is available by invitation only.
293
+ #
294
+ # ### Security Policies
295
+ #
296
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
297
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
298
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
299
+ # @param companyId [Integer] The ID of the company that owns the filings.
300
+ # @param filingReturnId [Integer] The unique id of the worksheet return.
301
+ # @param fileId [Integer] The unique id of the document you are downloading
302
+ # @return [Object]
303
+ def get_filing_attachment(companyId, filingReturnId, options={})
304
+ path = "/api/v2/companies/#{companyId}/filings/#{filingReturnId}/attachment"
305
+ get(path, options)
306
+ end
307
+
308
+
6
309
# Retrieve a list of filings for the specified company in the year and month of a given filing period.
7
310
#
8
311
# This API is available by invitation only.
@@ -12,7 +315,7 @@ module AvaTax
12
315
# ### Security Policies
13
316
#
14
317
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
15
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
318
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
16
319
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
17
320
# @param companyId [Integer] The ID of the company that owns the filings.
18
321
# @param year [Integer] The year of the filing period.
@@ -33,7 +336,7 @@ module AvaTax
33
336
# ### Security Policies
34
337
#
35
338
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
36
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
339
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
37
340
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
38
341
# @param companyId [Integer] The ID of the company that owns the filings.
39
342
# @param year [Integer] The year of the filing period.
@@ -44,6 +347,313 @@ module AvaTax
44
347
get(path)
45
348
end
46
349
350
+
351
+ # Retrieve a filing for the specified company and id.
352
+ #
353
+ # This API is available by invitation only.
354
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
355
+ # based on filing frequency of filing.
356
+ #
357
+ # ### Security Policies
358
+ #
359
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
360
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
361
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
362
+ # @param companyId [Integer] The ID of the company that owns the filings.
363
+ # @param id [Integer] The id of the filing return your retrieving
364
+ # @param details [Boolean] Indicates if you would like the credit details returned
365
+ # @return [Object]
366
+ def get_filing_return(companyId, id, options={})
367
+ path = "/api/v2/companies/#{companyId}/filings/returns/#{id}"
368
+ get(path, options)
369
+ end
370
+
371
+
372
+ # Retrieve a list of filings for the specified company in the year and month of a given filing period.
373
+ #
374
+ # This API is available by invitation only.
375
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
376
+ # based on filing frequency of filing.
377
+ #
378
+ # ### Security Policies
379
+ #
380
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
381
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
382
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
383
+ # @param companyId [Integer] The ID of the company that owns the filings.
384
+ # @param year [Integer] The year of the filing period.
385
+ # @param month [Integer] The two digit month of the filing period.
386
+ # @return [FetchResult]
387
+ def get_filings(companyId, year, month)
388
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}"
389
+ get(path)
390
+ end
391
+
392
+
393
+ # Retrieve a list of filings for the specified company in the given filing period and country.
394
+ #
395
+ # This API is available by invitation only.
396
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
397
+ # based on filing frequency of filing.
398
+ #
399
+ # ### Security Policies
400
+ #
401
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
402
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
403
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
404
+ # @param companyId [Integer] The ID of the company that owns the filings.
405
+ # @param year [Integer] The year of the filing period.
406
+ # @param month [Integer] The two digit month of the filing period.
407
+ # @param country [String] The two-character ISO-3166 code for the country.
408
+ # @return [FetchResult]
409
+ def get_filings_by_country(companyId, year, month, country)
410
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}"
411
+ get(path)
412
+ end
413
+
414
+
415
+ # Retrieve a list of filings for the specified company in the filing period, country and region.
416
+ #
417
+ # This API is available by invitation only.
418
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
419
+ # based on filing frequency of filing.
420
+ #
421
+ # ### Security Policies
422
+ #
423
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
424
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
425
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
426
+ # @param companyId [Integer] The ID of the company that owns the filings.
427
+ # @param year [Integer] The year of the filing period.
428
+ # @param month [Integer] The two digit month of the filing period.
429
+ # @param country [String] The two-character ISO-3166 code for the country.
430
+ # @param region [String] The two or three character region code for the region.
431
+ # @return [FetchResult]
432
+ def get_filings_by_country_region(companyId, year, month, country, region)
433
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}"
434
+ get(path)
435
+ end
436
+
437
+
438
+ # Retrieve a list of filings for the specified company in the given filing period, country, region and form.
439
+ #
440
+ # This API is available by invitation only.
441
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
442
+ # based on filing frequency of filing.
443
+ #
444
+ # ### Security Policies
445
+ #
446
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
447
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
448
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
449
+ # @param companyId [Integer] The ID of the company that owns the filings.
450
+ # @param year [Integer] The year of the filing period.
451
+ # @param month [Integer] The two digit month of the filing period.
452
+ # @param country [String] The two-character ISO-3166 code for the country.
453
+ # @param region [String] The two or three character region code for the region.
454
+ # @param formCode [String] The unique code of the form.
455
+ # @return [FetchResult]
456
+ def get_filings_by_return_name(companyId, year, month, country, region, formCode)
457
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/#{formCode}"
458
+ get(path)
459
+ end
460
+
461
+
462
+ # Retrieve a list of filings for the specified company in the year and month of a given filing period.
463
+ # This gets the basic information from the filings and doesn't include anything extra.
464
+ #
465
+ # ### Security Policies
466
+ #
467
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
468
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
469
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
470
+ # @param companyId [Integer] The ID of the company that owns these batches
471
+ # @param endPeriodMonth [Integer] The month of the period you are trying to retrieve
472
+ # @param endPeriodYear [Integer] The year of the period you are trying to retrieve
473
+ # @param frequency [String] The frequency of the return you are trying to retrieve (See FilingFrequencyId::* for a list of allowable values)
474
+ # @param status [String] The status of the return(s) you are trying to retrieve (See FilingStatusId::* for a list of allowable values)
475
+ # @param country [String] The country of the return(s) you are trying to retrieve
476
+ # @param region [String] The region of the return(s) you are trying to retrieve
477
+ # @param filingCalendarId [Integer] The filing calendar id of the return you are trying to retrieve
478
+ # @return [FetchResult]
479
+ def get_filings_returns(companyId, options={})
480
+ path = "/api/v2/companies/#{companyId}/filings/returns"
481
+ get(path, options)
482
+ end
483
+
484
+
485
+ # Retrieve a list of filings for the specified company in the year and month of a given filing period.
486
+ #
487
+ # This API is available by invitation only.
488
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
489
+ # based on filing frequency of filing.
490
+ #
491
+ # ### Security Policies
492
+ #
493
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
494
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
495
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
496
+ # @param companyId [Integer] The ID of the company that owns the filings.
497
+ # @param year [Integer] The year of the filing period.
498
+ # @param month [Integer] The two digit month of the filing period.
499
+ # @param country [String] The two-character ISO-3166 code for the country.
500
+ # @param region [String] The two or three character region code for the region.
501
+ # @param formCode [String] The unique code of the form.
502
+ # @return [FetchResult]
503
+ def get_tax_filings(companyId, options={})
504
+ path = "/api/v2/companies/#{companyId}/filings"
505
+ get(path, options)
506
+ end
507
+
508
+
509
+ # Rebuild a set of filings for the specified company in the given filing period.
510
+ #
511
+ # This API is available by invitation only.
512
+ # Rebuilding a return means re-creating or updating the amounts to be filed (worksheet) for a filing.
513
+ # Rebuilding has to be done whenever a customer adds transactions to a filing.
514
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
515
+ # based on filing frequency of filing.
516
+ # This API requires filing to be unapproved.
517
+ #
518
+ # ### Security Policies
519
+ #
520
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
521
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
522
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
523
+ # @param companyId [Integer] The ID of the company that owns the filings.
524
+ # @param year [Integer] The year of the filing period to be rebuilt.
525
+ # @param month [Integer] The month of the filing period to be rebuilt.
526
+ # @param model [Object] The rebuild request you wish to execute.
527
+ # @return [FetchResult]
528
+ def rebuild_filings(companyId, year, month, model)
529
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/rebuild"
530
+ post(path, model)
531
+ end
532
+
533
+
534
+ # Rebuild a set of filings for the specified company in the given filing period and country.
535
+ #
536
+ # This API is available by invitation only.
537
+ # Rebuilding a return means re-creating or updating the amounts to be filed (worksheet) for a filing.
538
+ # Rebuilding has to be done whenever a customer adds transactions to a filing.
539
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
540
+ # based on filing frequency of filing.
541
+ # This API requires filing to be unapproved.
542
+ #
543
+ # ### Security Policies
544
+ #
545
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
546
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
547
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
548
+ # @param companyId [Integer] The ID of the company that owns the filings.
549
+ # @param year [Integer] The year of the filing period to be rebuilt.
550
+ # @param month [Integer] The month of the filing period to be rebuilt.
551
+ # @param country [String] The two-character ISO-3166 code for the country.
552
+ # @param model [Object] The rebuild request you wish to execute.
553
+ # @return [FetchResult]
554
+ def rebuild_filings_by_country(companyId, year, month, country, model)
555
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/rebuild"
556
+ post(path, model)
557
+ end
558
+
559
+
560
+ # Rebuild a set of filings for the specified company in the given filing period, country and region.
561
+ #
562
+ # This API is available by invitation only.audit.CheckAuthorizationReturns(null, companyId);
563
+ # Rebuilding a return means re-creating or updating the amounts to be filed for a filing.
564
+ # Rebuilding has to be done whenever a customer adds transactions to a filing.
565
+ # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
566
+ # based on filing frequency of filing.
567
+ # This API requires filing to be unapproved.
568
+ #
569
+ # ### Security Policies
570
+ #
571
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
572
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
573
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
574
+ # @param companyId [Integer] The ID of the company that owns the filings.
575
+ # @param year [Integer] The year of the filing period to be rebuilt.
576
+ # @param month [Integer] The month of the filing period to be rebuilt.
577
+ # @param country [String] The two-character ISO-3166 code for the country.
578
+ # @param region [String] The two or three character region code for the region.
579
+ # @param model [Object] The rebuild request you wish to execute.
580
+ # @return [FetchResult]
581
+ def rebuild_filings_by_country_region(companyId, year, month, country, region, model)
582
+ path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/rebuild"
583
+ post(path, model)
584
+ end
585
+
586
+
587
+ # Edit an adjustment for a given filing.
588
+ #
589
+ # This API is available by invitation only.
590
+ # An "Adjustment" is usually an increase or decrease to customer funding to Avalara,
591
+ # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
592
+ # Sometimes may be a manual change in tax liability similar to an augmentation.
593
+ # This API modifies an adjustment for an existing tax filing.
594
+ # This API can only be used when the filing has not yet been approved.
595
+ #
596
+ # ### Security Policies
597
+ #
598
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
599
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
600
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
601
+ # @param companyId [Integer] The ID of the company that owns the filing being adjusted.
602
+ # @param id [Integer] The ID of the adjustment being edited.
603
+ # @param model [Object] The updated Adjustment.
604
+ # @return [Object]
605
+ def update_return_adjustment(companyId, id, model)
606
+ path = "/api/v2/companies/#{companyId}/filings/adjust/#{id}"
607
+ put(path, model)
608
+ end
609
+
610
+
611
+ # Edit an augmentation for a given filing.
612
+ #
613
+ # This API is available by invitation only.
614
+ # An "Augmentation" is a manually added increase or decrease in tax liability, by either customer or Avalara
615
+ # usually due to customer wanting to report tax Avatax does not support, e.g. bad debts, rental tax.
616
+ # This API modifies an augmentation for an existing tax filing.
617
+ # This API can only be used when the filing has not been approved.
618
+ #
619
+ # ### Security Policies
620
+ #
621
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
622
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
623
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
624
+ # @param companyId [Integer] The ID of the company that owns the filing being changed.
625
+ # @param id [Integer] The ID of the augmentation being edited.
626
+ # @param model [Object] The updated Augmentation.
627
+ # @return [Object]
628
+ def update_return_augmentation(companyId, id, model)
629
+ path = "/api/v2/companies/#{companyId}/filings/augment/#{id}"
630
+ put(path, model)
631
+ end
632
+
633
+
634
+ # Edit an payment for a given filing.
635
+ #
636
+ # This API is available by invitation only.
637
+ # An "Payment" is usually an increase or decrease to customer funding to Avalara,
638
+ # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
639
+ # Sometimes may be a manual change in tax liability similar to an augmentation.
640
+ # This API modifies an payment for an existing tax filing.
641
+ # This API can only be used when the filing has not yet been approved.
642
+ #
643
+ # ### Security Policies
644
+ #
645
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
646
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
647
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
648
+ # @param companyId [Integer] The ID of the company that owns the filing being adjusted.
649
+ # @param id [Integer] The ID of the payment being edited.
650
+ # @param model [Object] The updated Payment.
651
+ # @return [Object]
652
+ def update_return_payment(companyId, id, model)
653
+ path = "/api/v2/companies/#{companyId}/filings/payment/#{id}"
654
+ put(path, model)
655
+ end
656
+
47
657
end
48
658
end
49
659
end
data/lib/avatax/client/firmclientlinkages.rb ADDED
@@ -0,0 +1,151 @@
1
+ module AvaTax
2
+ class Client
3
+ module FirmClientLinkages
4
+
5
+
6
+ # Approves linkage to a firm for a client account
7
+ #
8
+ # This API enables the account admin of a client account to approve linkage request by a firm.
9
+ #
10
+ # ### Security Policies
11
+ #
12
+ # * This API requires one of the following user roles: AccountAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
13
+ # @param id [Integer]
14
+ # @return [Object]
15
+ def approve_firm_client_linkage(id)
16
+ path = "/api/v2/firmclientlinkages/#{id}/approve"
17
+ post(path)
18
+ end
19
+
20
+
21
+ # Request a new FirmClient account and create an approved linkage to it
22
+ #
23
+ # This API is for use by Firms only.
24
+ #
25
+ # Avalara allows firms to manage returns for clients without the clients needing to use AvaTax service.
26
+ # Firms can create accounts of FirmClient for customers they are managing using this API.
27
+ #
28
+ # Calling this API creates an account with the specified product subscriptions, but without a new user for account.
29
+ # Account is then linked to the Firm so they can managed their returns.
30
+ # You should call this API when a customer does not have an AvaTax account and is to be managed only by the firm.
31
+ #
32
+ # The created account will be created in `Active` status but there will be no user or license key associated with account.
33
+ #
34
+ # ### Security Policies
35
+ #
36
+ # * This API requires one of the following user roles: FirmAdmin, Registrar, SiteAdmin, SystemAdmin.
37
+ # @param model [Object] Information about the account you wish to create.
38
+ # @return [Object]
39
+ def create_and_link_new_firm_client_account(model)
40
+ path = "/api/v2/firmclientlinkages/createandlinkclient"
41
+ post(path, model)
42
+ end
43
+
44
+
45
+ # Links a firm account with the client account
46
+ #
47
+ # This API enables the firm admins/firm users to request the linkage of a firm account and a client account.
48
+ #
49
+ # ### Security Policies
50
+ #
51
+ # * This API requires one of the following user roles: FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
52
+ # @param model [Object] FirmClientLinkageInputModel
53
+ # @return [Object]
54
+ def create_firm_client_linkage(model)
55
+ path = "/api/v2/firmclientlinkages"
56
+ post(path, model)
57
+ end
58
+
59
+
60
+ # Delete a linkage
61
+ #
62
+ # This API marks a linkage between a firm and client as deleted.
63
+ #
64
+ # ### Security Policies
65
+ #
66
+ # * This API requires one of the following user roles: FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
67
+ # @param id [Integer]
68
+ # @return [ErrorDetail[]]
69
+ def delete_firm_client_linkage(id)
70
+ path = "/api/v2/firmclientlinkages/#{id}"
71
+ delete(path)
72
+ end
73
+
74
+
75
+ # Get linkage between a firm and client by id
76
+ #
77
+ # This API enables the firm admins/firm users to request the linkage of a firm account and a client account.
78
+ #
79
+ # ### Security Policies
80
+ #
81
+ # * 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.
82
+ # @param id [Integer]
83
+ # @return [Object]
84
+ def get_firm_client_linkage(id)
85
+ path = "/api/v2/firmclientlinkages/#{id}"
86
+ get(path)
87
+ end
88
+
89
+
90
+ # List client linkages for a firm or client
91
+ #
92
+ # This API enables the firm or account users to request the associated linkages to the account.
93
+ #
94
+ # ### Security Policies
95
+ #
96
+ # * 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.
97
+ # @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:* firmAccountName, clientAccountName
98
+ # @return [FetchResult]
99
+ def list_firm_client_linkage(options={})
100
+ path = "/api/v2/firmclientlinkages"
101
+ get(path, options)
102
+ end
103
+
104
+
105
+ # Rejects linkage to a firm for a client account
106
+ #
107
+ # This API enables the account admin of a client account to reject linkage request by a firm.
108
+ #
109
+ # ### Security Policies
110
+ #
111
+ # * This API requires one of the following user roles: AccountAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
112
+ # @param id [Integer]
113
+ # @return [Object]
114
+ def reject_firm_client_linkage(id)
115
+ path = "/api/v2/firmclientlinkages/#{id}/reject"
116
+ post(path)
117
+ end
118
+
119
+
120
+ # Reset linkage status between a client and firm back to requested
121
+ #
122
+ # This API enables the firm admin of a client account to reset a previously created linkage request by a firm.
123
+ #
124
+ # ### Security Policies
125
+ #
126
+ # * This API requires one of the following user roles: FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
127
+ # @param id [Integer]
128
+ # @return [Object]
129
+ def reset_firm_client_linkage(id)
130
+ path = "/api/v2/firmclientlinkages/#{id}/reset"
131
+ post(path)
132
+ end
133
+
134
+
135
+ # Revokes previously approved linkage to a firm for a client account
136
+ #
137
+ # This API enables the account admin of a client account to revoke a previously approved linkage request by a firm.
138
+ #
139
+ # ### Security Policies
140
+ #
141
+ # * This API requires one of the following user roles: AccountAdmin, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
142
+ # @param id [Integer]
143
+ # @return [Object]
144
+ def revoke_firm_client_linkage(id)
145
+ path = "/api/v2/firmclientlinkages/#{id}/revoke"
146
+ post(path)
147
+ end
148
+
149
+ end
150
+ end
151
+ end
data/lib/avatax/client/fundingrequests.rb CHANGED
@@ -21,8 +21,8 @@ module AvaTax
21
21
# ### Security Policies
22
22
#
23
23
# * 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.
24
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
25
- # * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request host address whitelisting for [Returns] for your servers.
24
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
25
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
26
26
# @param id [Integer] The unique ID number of this funding request
27
27
# @return [Object]
28
28
def activate_funding_request(id)
@@ -47,8 +47,8 @@ module AvaTax
47
47
# ### Security Policies
48
48
#
49
49
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, FirmAdmin, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin.
50
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
51
- # * This API is available by invitation only. To request access to this feature, please speak to a business development manager and request host address whitelisting for [Returns] for your servers.
50
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
51
+ # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
52
52
# @param id [Integer] The unique ID number of this funding request
53
53
# @return [Object]
54
54
def funding_request_status(id)
data/lib/avatax/client/items.rb CHANGED
@@ -3,6 +3,48 @@ module AvaTax
3
3
module Items
4
4
5
5
6
+ # Delete all classifications for an item
7
+ #
8
+ # Delete all the classifications for a given item.
9
+ #
10
+ # A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems which may have different tax rates for a product.
11
+ #
12
+ # When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate.
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 item.
18
+ # @param itemId [Integer] The ID of the item you wish to delete the classifications.
19
+ # @return [ErrorDetail[]]
20
+ def batch_delete_item_classifications(companyId, itemId)
21
+ path = "/api/v2/companies/#{companyId}/items/#{itemId}/classifications"
22
+ delete(path)
23
+ end
24
+
25
+
26
+ # Delete all parameters for an item
27
+ #
28
+ # Delete all the parameters for a given item.
29
+ #
30
+ # Some items can be taxed differently depending on the properties of that item, such as the item grade or by a particular measurement of that item. In AvaTax, these tax-affecting properties are called "parameters".
31
+ #
32
+ # A parameter added to an item will be used by default in tax calculation but will not show on the transaction line referencing the item .
33
+ #
34
+ # A parameter specified on a transaction line will override an item parameter if they share the same parameter name.
35
+ #
36
+ # ### Security Policies
37
+ #
38
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
39
+ # @param companyId [Integer] The ID of the company that owns this item.
40
+ # @param itemId [Integer] The ID of the item you wish to delete the parameters.
41
+ # @return [ErrorDetail[]]
42
+ def batch_delete_item_parameters(companyId, itemId)
43
+ path = "/api/v2/companies/#{companyId}/items/#{itemId}/parameters"
44
+ delete(path)
45
+ end
46
+
47
+
6
48
# Add classifications to an item.
7
49
#
8
50
# Add classifications to an item.
@@ -332,6 +374,33 @@ module AvaTax
332
374
end
333
375
334
376
377
+ # Sync items from a product catalog
378
+ #
379
+ # Syncs a list of items with AvaTax without waiting for them to be created. It is ideal for syncing large product catalogs
380
+ # with AvaTax.
381
+ #
382
+ # Any invalid or duplicate items will be ignored. To diagnose why an item is not created, use the normal create transaction API to receive validation information.
383
+ #
384
+ # This API is currently limited to 1000 items per call (the limit is subject to change).
385
+ #
386
+ # Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you
387
+ # can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions,
388
+ # and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters
389
+ # from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance
390
+ # team can manage your item catalog and adjust the tax behavior of items without having to modify your software.
391
+ #
392
+ # ### Security Policies
393
+ #
394
+ # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
395
+ # @param companyId [Integer] The ID of the company that owns this item.
396
+ # @param model [Object] The request object.
397
+ # @return [Object]
398
+ def sync_items(companyId, model)
399
+ path = "/api/v2/companies/#{companyId}/items/sync"
400
+ post(path, model)
401
+ end
402
+
403
+
335
404
# Update a single item
336
405
#
337
406
# Replace the existing `Item` object at this URL with an updated object.
data/lib/avatax/client/notices.rb CHANGED
@@ -13,7 +13,7 @@ module AvaTax
13
13
# ### Security Policies
14
14
#
15
15
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
16
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
16
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
17
17
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
18
18
# @param companyId [Integer] The ID of the company that owns this notice.
19
19
# @param id [Integer] The ID of the tax notice we are adding the comment for.
@@ -36,7 +36,7 @@ module AvaTax
36
36
# ### Security Policies
37
37
#
38
38
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
39
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
39
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
40
40
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
41
41
# @param companyId [Integer] The ID of the company that owns this notice.
42
42
# @param id [Integer] The ID of the notice added to the finance details.
@@ -58,7 +58,7 @@ module AvaTax
58
58
# ### Security Policies
59
59
#
60
60
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
61
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
61
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
62
62
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
63
63
# @param companyId [Integer] The ID of the company that owns this notice.
64
64
# @param id [Integer] The ID of the tax notice we are adding the responsibility for.
@@ -80,7 +80,7 @@ module AvaTax
80
80
# ### Security Policies
81
81
#
82
82
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
83
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
83
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
84
84
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
85
85
# @param companyId [Integer] The ID of the company that owns this notice.
86
86
# @param id [Integer] The ID of the tax notice we are adding the responsibility for.
@@ -102,7 +102,7 @@ module AvaTax
102
102
# ### Security Policies
103
103
#
104
104
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
105
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
105
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
106
106
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
107
107
# @param companyId [Integer] The ID of the company that owns this notice.
108
108
# @param model [NoticeModel[]] The notice object you wish to create.
@@ -123,7 +123,7 @@ module AvaTax
123
123
# ### Security Policies
124
124
#
125
125
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
126
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
126
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
127
127
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
128
128
# @param companyId [Integer] The ID of the company that owns this notice.
129
129
# @param id [Integer] The ID of the notice you wish to delete the finance detail from.
@@ -146,7 +146,7 @@ module AvaTax
146
146
# ### Security Policies
147
147
#
148
148
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
149
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
149
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
150
150
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
151
151
# @param companyId [Integer] The ID of the company that owns this notice.
152
152
# @param id [Integer] The ID of the notice you wish to delete the finance detail from.
@@ -168,7 +168,7 @@ module AvaTax
168
168
# ### Security Policies
169
169
#
170
170
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
171
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
171
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
172
172
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
173
173
# @param companyId [Integer] The ID of the company that owns this notice.
174
174
# @param id [Integer] The ID of the notice you wish to delete.
@@ -189,7 +189,7 @@ module AvaTax
189
189
# ### Security Policies
190
190
#
191
191
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
192
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
192
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
193
193
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
194
194
# @param companyId [Integer] The ID of the company that owns this notice.
195
195
# @param noticeId [Integer] The ID of the notice you wish to delete.
@@ -211,7 +211,7 @@ module AvaTax
211
211
# ### Security Policies
212
212
#
213
213
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
214
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
214
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
215
215
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
216
216
# @param companyId [Integer] The ID of the company that owns this notice.
217
217
# @param noticeId [Integer] The ID of the notice you wish to delete.
@@ -231,7 +231,7 @@ module AvaTax
231
231
# ### Security Policies
232
232
#
233
233
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
234
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
234
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
235
235
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
236
236
# @param companyId [Integer] The ID of the company for this attachment.
237
237
# @param id [Integer] The ResourceFileId of the attachment to download.
@@ -252,7 +252,7 @@ module AvaTax
252
252
# ### Security Policies
253
253
#
254
254
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
255
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
255
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
256
256
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
257
257
# @param companyId [Integer] The ID of the company for this notice.
258
258
# @param id [Integer] The ID of this notice.
@@ -273,7 +273,7 @@ module AvaTax
273
273
# ### Security Policies
274
274
#
275
275
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
276
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
276
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
277
277
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
278
278
# @param id [Integer] The ID of the notice.
279
279
# @param companyId [Integer] The ID of the company that owns these notices.
@@ -295,7 +295,7 @@ module AvaTax
295
295
# ### Security Policies
296
296
#
297
297
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
298
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
298
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
299
299
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
300
300
# @param id [Integer] The ID of the company that owns these notices.
301
301
# @param companyId [Integer] The ID of the company that owns these notices.
@@ -316,7 +316,7 @@ module AvaTax
316
316
# ### Security Policies
317
317
#
318
318
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
319
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
319
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
320
320
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
321
321
# @param id [Integer] The ID of the notice.
322
322
# @param companyId [Integer] The ID of the company that owns these notices.
@@ -337,7 +337,7 @@ module AvaTax
337
337
# ### Security Policies
338
338
#
339
339
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
340
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
340
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
341
341
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
342
342
# @param id [Integer] The ID of the notice.
343
343
# @param companyId [Integer] The ID of the company that owns these notices.
@@ -361,7 +361,7 @@ module AvaTax
361
361
# ### Security Policies
362
362
#
363
363
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
364
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
364
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
365
365
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
366
366
# @param companyId [Integer] The ID of the company that owns these notices.
367
367
# @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:* status, totalRemit, ticketReferenceNo, ticketReferenceUrl, reason, type, createdByUserName, documentReference, jurisdictionName, jurisdictionType, comments, finances, responsibility, rootCause
@@ -392,7 +392,7 @@ module AvaTax
392
392
# ### Security Policies
393
393
#
394
394
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
395
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
395
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
396
396
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
397
397
# @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:* status, totalRemit, ticketReferenceNo, ticketReferenceUrl, reason, type, createdByUserName, documentReference, jurisdictionName, jurisdictionType, comments, finances, responsibility, rootCause
398
398
# @param include [String] A comma separated list of additional data to retrieve.
@@ -416,7 +416,7 @@ module AvaTax
416
416
# ### Security Policies
417
417
#
418
418
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
419
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
419
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
420
420
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
421
421
# @param model [Object] Query object to filter, sort and paginate the filing calendars.
422
422
# @return [FetchResult]
@@ -435,7 +435,7 @@ module AvaTax
435
435
# ### Security Policies
436
436
#
437
437
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
438
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
438
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
439
439
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
440
440
# @param companyId [Integer] The ID of the company that this notice finance detail belongs to.
441
441
# @param noticeid [Integer] The ID of the notice finance detail you wish to update.
@@ -460,7 +460,7 @@ module AvaTax
460
460
# ### Security Policies
461
461
#
462
462
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
463
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
463
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
464
464
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
465
465
# @param companyId [Integer] The ID of the company that this notice belongs to.
466
466
# @param id [Integer] The ID of the notice you wish to update.
@@ -481,7 +481,7 @@ module AvaTax
481
481
# ### Security Policies
482
482
#
483
483
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
484
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
484
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
485
485
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
486
486
# @param companyId [Integer] The ID of the company that this notice comment belongs to.
487
487
# @param noticeid [Integer] The ID of the notice you wish to update.
@@ -503,7 +503,7 @@ module AvaTax
503
503
# ### Security Policies
504
504
#
505
505
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
506
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
506
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
507
507
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
508
508
# @param companyId [Integer] The ID of the company for this attachment.
509
509
# @param model [Object] The upload request.
data/lib/avatax/client/notifications.rb CHANGED
@@ -18,6 +18,8 @@ module AvaTax
18
18
# dismissed. You can then later review which employees of your company dismissed notifications to
19
19
# determine if they were resolved appropriately.
20
20
#
21
+ # A Global notification with null accountId and companyId cannot be dismissed and will expire within a given time span.
22
+ #
21
23
# ### Security Policies
22
24
#
23
25
# * 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.
data/lib/avatax/client/registrar.rb CHANGED
@@ -32,6 +32,9 @@ module AvaTax
32
32
# to regularly review notifications and then dismiss them when you are certain that you have addressed
33
33
# any relevant concerns raised by this notification.
34
34
#
35
+ # A Global notification is a message which is directed to all the accounts and is set to expire within
36
+ # a certain time and cannot be dismissed by the user. Make accountId and companyId null to create a global notification.
37
+ #
35
38
# An example of a notification would be a message about new software, or a change to AvaTax that may
36
39
# affect you, or a potential issue with your company's tax profile.
37
40
#
data/lib/avatax/client/reports.rb CHANGED
@@ -31,29 +31,6 @@ module AvaTax
31
31
end
32
32
33
33
34
- # Intiate and download an ExportDocumentLine report
35
- #
36
- # This API is deprecated.
37
- #
38
- # Please use the asynchronous reports APIs:
39
- #
40
- # * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type.
41
- # * In the result of the Initiate API, you receive back a report's `id` value.
42
- # * Check the status of a report by calling `GetReport` and passing in the report's `id` value.
43
- # * When a report's status is `Completed`, call `DownloadReport` to retrieve the file.
44
- #
45
- # ### Security Policies
46
- #
47
- # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
48
- # @param companyId [Integer] The unique ID number of the company to report on.
49
- # @param model [Object] Options that may be configured to customize the report.
50
- # @return [Object]
51
- def export_document_line(companyId, model)
52
- path = "/api/v2/companies/#{companyId}/reports/exportdocumentline"
53
- post(path, model)
54
- end
55
-
56
-
57
34
# Retrieve a single report
58
35
#
59
36
# Retrieve a single report by its unique ID number.
@@ -118,10 +95,10 @@ module AvaTax
118
95
# ### Security Policies
119
96
#
120
97
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
121
- # @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:* reportType, parameters, createdUser, completedDate
122
- # @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.
98
+ # @param companyId [Integer] The id of the company for which to get reports.
99
+ # @param pageKey [String] Provide a page key to retrieve the next page of results.
123
100
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
124
- # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
101
+ # @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.
125
102
# @return [FetchResult]
126
103
def list_reports(options={})
127
104
path = "/api/v2/reports"
data/lib/avatax/client/taxcontent.rb CHANGED
@@ -131,7 +131,7 @@ module AvaTax
131
131
#
132
132
# * 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.
133
133
# @param date [DateTime] The date for which point-of-sale data would be calculated (today by default). Example input: 2016-12-31
134
- # @param region [String] If the region is provided, this API is going to generate the tax rate per zipcode for only the region specified.
134
+ # @param region [String] A two character region code which limits results to a specific region.
135
135
# @return [Object]
136
136
def download_tax_rates_by_zip_code(date, options={})
137
137
path = "/api/v2/taxratesbyzipcode/download/#{date}"
data/lib/avatax/client/transactions.rb CHANGED
@@ -63,6 +63,11 @@ module AvaTax
63
63
# * LinesOnly (omit details - reduces API response size)
64
64
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
65
65
#
66
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
67
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
68
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
69
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
70
+ #
66
71
# ### Security Policies
67
72
#
68
73
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -97,6 +102,11 @@ module AvaTax
97
102
# A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like
98
103
# sales, purchases, inventory transfer, and returns (also called refunds).
99
104
#
105
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
106
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
107
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
108
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
109
+ #
100
110
# ### Security Policies
101
111
#
102
112
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -128,6 +138,11 @@ module AvaTax
128
138
# A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like
129
139
# sales, purchases, inventory transfer, and returns (also called refunds).
130
140
#
141
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
142
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
143
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
144
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
145
+ #
131
146
# ### Security Policies
132
147
#
133
148
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -155,7 +170,7 @@ module AvaTax
155
170
# ### Security Policies
156
171
#
157
172
# * This API requires the user role Compliance Root User.
158
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
173
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
159
174
# * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
160
175
# @param model [Object] bulk lock request
161
176
# @return [Object]
@@ -189,6 +204,11 @@ module AvaTax
189
204
# * LinesOnly (omit details - reduces API response size)
190
205
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
191
206
#
207
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
208
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
209
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
210
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
211
+ #
192
212
# ### Security Policies
193
213
#
194
214
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
@@ -228,6 +248,11 @@ module AvaTax
228
248
# * LinesOnly (omit details - reduces API response size)
229
249
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
230
250
#
251
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
252
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
253
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
254
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
255
+ #
231
256
# ### Security Policies
232
257
#
233
258
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
@@ -274,6 +299,11 @@ module AvaTax
274
299
#
275
300
# If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`.
276
301
#
302
+ # NOTE: Avoid using the following strings in your transaction codes as they are encoding strings and will be interpreted differently:
303
+ # * \_-ava2f-\_
304
+ # * \_-ava2b-\_
305
+ # * \_-ava3f-\_
306
+ #
277
307
# ### Security Policies
278
308
#
279
309
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -325,6 +355,11 @@ module AvaTax
325
355
#
326
356
# If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`.
327
357
#
358
+ # NOTE: Avoid using the following strings in your transaction codes as they are encoding strings and will be interpreted differently:
359
+ # * \_-ava2f-\_
360
+ # * \_-ava2b-\_
361
+ # * \_-ava3f-\_
362
+ #
328
363
# ### Security Policies
329
364
#
330
365
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -392,6 +427,11 @@ module AvaTax
392
427
# * SummaryOnly (omit lines and details - reduces API response size)
393
428
# * LinesOnly (omit details - reduces API response size)
394
429
#
430
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
431
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
432
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
433
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
434
+ #
395
435
# ### Security Policies
396
436
#
397
437
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -411,6 +451,11 @@ module AvaTax
411
451
#
412
452
# DEPRECATED: Please use the `GetTransactionByCode` API instead.
413
453
#
454
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
455
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
456
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
457
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
458
+ #
414
459
# ### Security Policies
415
460
#
416
461
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -483,6 +528,11 @@ module AvaTax
483
528
# * SummaryOnly (omit lines and details - reduces API response size)
484
529
# * LinesOnly (omit details - reduces API response size)
485
530
#
531
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
532
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
533
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
534
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
535
+ #
486
536
# ### Security Policies
487
537
#
488
538
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -525,10 +575,15 @@ module AvaTax
525
575
# * LinesOnly (omit details - reduces API response size)
526
576
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
527
577
#
578
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
579
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
580
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
581
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
582
+ #
528
583
# ### Security Policies
529
584
#
530
585
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
531
- # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
586
+ # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.<br />*Firm Managed* (for accounts managed by a firm): ARA, ARAManaged.
532
587
# @param companyCode [String] The company code of the company that recorded this transaction
533
588
# @param transactionCode [String] The transaction code to lock
534
589
# @param documentType [String] (Optional): The document type of the transaction to lock. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values)
@@ -575,6 +630,11 @@ module AvaTax
575
630
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
576
631
# If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`.
577
632
#
633
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
634
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
635
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
636
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
637
+ #
578
638
# ### Security Policies
579
639
#
580
640
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -615,6 +675,11 @@ module AvaTax
615
675
# * LinesOnly (omit details - reduces API response size)
616
676
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
617
677
#
678
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
679
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
680
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
681
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
682
+ #
618
683
# ### Security Policies
619
684
#
620
685
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
@@ -647,13 +712,18 @@ module AvaTax
647
712
# * LinesOnly (omit details - reduces API response size)
648
713
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
649
714
#
715
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
716
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
717
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
718
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
719
+ #
650
720
# ### Security Policies
651
721
#
652
722
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
653
723
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
654
724
# @param companyCode [String] The company code of the company that recorded this transaction
655
- # @param transactionCode [String] The transaction code to commit
656
- # @param documentType [String] (Optional): The document type of the transaction to commit. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values)
725
+ # @param transactionCode [String] The transaction code to Uncommit
726
+ # @param documentType [String] (Optional): The document type of the transaction to Uncommit. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values)
657
727
# @param include [String] Specifies objects to include in this fetch call
658
728
# @return [Object]
659
729
def uncommit_transaction(companyCode, transactionCode, options={})
@@ -676,6 +746,11 @@ module AvaTax
676
746
# * LinesOnly (omit details - reduces API response size)
677
747
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
678
748
#
749
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
750
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
751
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
752
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
753
+ #
679
754
# ### Security Policies
680
755
#
681
756
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
@@ -712,6 +787,11 @@ module AvaTax
712
787
# * LinesOnly (omit details - reduces API response size)
713
788
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
714
789
#
790
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
791
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
792
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
793
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
794
+ #
715
795
# ### Security Policies
716
796
#
717
797
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
@@ -751,6 +831,11 @@ module AvaTax
751
831
# * LinesOnly (omit details - reduces API response size)
752
832
# * TaxDetailsByTaxType - Includes the aggregated tax, exempt tax, taxable and non-taxable for each tax type returned in the transaction summary.
753
833
#
834
+ # NOTE: If your companyCode or transactionCode contains any of these characters /, + or ? please use the following encoding before making a request:
835
+ # * Replace '/' with '\_-ava2f-\_' For example: document/Code becomes document_-ava2f-_Code
836
+ # * Replace '+' with '\_-ava2b-\_' For example: document+Code becomes document_-ava2b-_Code
837
+ # * Replace '?' with '\_-ava3f-\_' For example: document?Code becomes document_-ava3f-_Code
838
+ #
754
839
# ### Security Policies
755
840
#
756
841
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
data/lib/avatax/version.rb CHANGED
@@ -1,3 +1,3 @@
1
1
´╗┐module AvaTax
2
- VERSION = '19.6.0'.freeze unless defined?(::AvaTax::VERSION)
2
+ VERSION = '19.11.0'.freeze unless defined?(::AvaTax::VERSION)
3
3
end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
--- !ruby/object:Gem::Specification
2
2
name: avatax