avatax 20.5.0 → 20.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/avatax/client/accounts.rb +116 -83
- data/lib/avatax/client/addresses.rb +26 -20
- data/lib/avatax/client/advancedrules.rb +56 -41
- data/lib/avatax/client/avafileforms.rb +56 -41
- data/lib/avatax/client/batches.rb +125 -48
- data/lib/avatax/client/certexpressinvites.rb +36 -27
- data/lib/avatax/client/certificates.rb +156 -111
- data/lib/avatax/client/companies.rb +166 -118
- data/lib/avatax/client/compliance.rb +16 -13
- data/lib/avatax/client/contacts.rb +66 -48
- data/lib/avatax/client/customers.rb +136 -97
- data/lib/avatax/client/datasources.rb +66 -48
- data/lib/avatax/client/definitions.rb +596 -419
- data/lib/avatax/client/distancethresholds.rb +66 -48
- data/lib/avatax/client/filingcalendars.rb +16 -13
- data/lib/avatax/client/filings.rb +16 -13
- data/lib/avatax/client/firmclientlinkages.rb +96 -69
- data/lib/avatax/client/free.rb +36 -27
- data/lib/avatax/client/fundingrequests.rb +26 -20
- data/lib/avatax/client/items.rb +196 -139
- data/lib/avatax/client/jurisdictionoverrides.rb +66 -48
- data/lib/avatax/client/locations.rb +76 -55
- data/lib/avatax/client/multidocument.rb +106 -76
- data/lib/avatax/client/nexus.rb +82 -183
- data/lib/avatax/client/notifications.rb +36 -27
- data/lib/avatax/client/provisioning.rb +26 -20
- data/lib/avatax/client/registrar.rb +106 -76
- data/lib/avatax/client/reports.rb +46 -34
- data/lib/avatax/client/settings.rb +66 -48
- data/lib/avatax/client/subscriptions.rb +36 -27
- data/lib/avatax/client/taxcodes.rb +66 -48
- data/lib/avatax/client/taxcontent.rb +36 -27
- data/lib/avatax/client/taxrules.rb +66 -48
- data/lib/avatax/client/transactions.rb +216 -153
- data/lib/avatax/client/upcs.rb +66 -48
- data/lib/avatax/client/users.rb +86 -62
- data/lib/avatax/client/utilities.rb +36 -27
- data/lib/avatax/version.rb +1 -1
- metadata +2 -2
@@ -1,10 +1,10 @@
|
|
1
|
-
module AvaTax
|
2
|
-
class Client
|
3
|
-
module Transactions
|
4
|
-
|
5
|
-
|
6
|
-
# Add lines to an existing unlocked transaction
|
7
|
-
#
|
1
|
+
module AvaTax
|
2
|
+
class Client
|
3
|
+
module Transactions
|
4
|
+
|
5
|
+
|
6
|
+
# Add lines to an existing unlocked transaction
|
7
|
+
#
|
8
8
|
# Add lines to an existing unlocked transaction.
|
9
9
|
#
|
10
10
|
# The `AddLines` API allows you to add additional transaction lines to existing transaction, so that customer will
|
@@ -29,15 +29,18 @@ module AvaTax
|
|
29
29
|
# ### Security Policies
|
30
30
|
#
|
31
31
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
32
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
32
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
33
33
|
# @param include [String] Specifies objects to include in the response after transaction is created
|
34
34
|
# @param model [Object] information about the transaction and lines to be added
|
35
|
-
# @return [Object]
|
36
|
-
def add_lines(model, options={})
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
35
|
+
# @return [Object]
|
36
|
+
def add_lines(model, options={})
|
37
|
+
path = "/api/v2/companies/transactions/lines/add"
|
38
|
+
post(path, model, options)
|
39
|
+
end
|
40
|
+
|
41
|
+
|
42
|
+
# Correct a previously created transaction
|
43
|
+
#
|
41
44
|
# Replaces the current transaction uniquely identified by this URL with a new transaction.
|
42
45
|
#
|
43
46
|
# A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like
|
@@ -69,18 +72,21 @@ module AvaTax
|
|
69
72
|
# ### Security Policies
|
70
73
|
#
|
71
74
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
72
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
75
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
73
76
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
74
77
|
# @param transactionCode [String] The transaction code to adjust
|
75
78
|
# @param documentType [String] (Optional): The document type of the transaction to adjust. (See DocumentType::* for a list of allowable values)
|
76
79
|
# @param include [String] Specifies objects to include in this fetch call
|
77
80
|
# @param model [Object] The adjustment you wish to make
|
78
|
-
# @return [Object]
|
79
|
-
def adjust_transaction(companyCode, transactionCode, model, options={})
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
81
|
+
# @return [Object]
|
82
|
+
def adjust_transaction(companyCode, transactionCode, model, options={})
|
83
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/adjust"
|
84
|
+
post(path, model, options)
|
85
|
+
end
|
86
|
+
|
87
|
+
|
88
|
+
# Get audit information about a transaction
|
89
|
+
#
|
84
90
|
# Retrieve audit information about a transaction stored in AvaTax.
|
85
91
|
#
|
86
92
|
# The `AuditTransaction` API retrieves audit information related to a specific transaction. This audit
|
@@ -106,15 +112,18 @@ module AvaTax
|
|
106
112
|
# ### Security Policies
|
107
113
|
#
|
108
114
|
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
109
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
115
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
110
116
|
# @param companyCode [String] The code identifying the company that owns this transaction
|
111
117
|
# @param transactionCode [String] The code identifying the transaction
|
112
|
-
# @return [Object]
|
113
|
-
def audit_transaction(companyCode, transactionCode)
|
114
|
-
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
+
# @return [Object]
|
119
|
+
def audit_transaction(companyCode, transactionCode)
|
120
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/audit"
|
121
|
+
get(path)
|
122
|
+
end
|
123
|
+
|
124
|
+
|
125
|
+
# Get audit information about a transaction
|
126
|
+
#
|
118
127
|
# Retrieve audit information about a transaction stored in AvaTax.
|
119
128
|
#
|
120
129
|
# The `AuditTransaction` API retrieves audit information related to a specific transaction. This audit
|
@@ -140,16 +149,19 @@ module AvaTax
|
|
140
149
|
# ### Security Policies
|
141
150
|
#
|
142
151
|
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
143
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
152
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
144
153
|
# @param companyCode [String] The code identifying the company that owns this transaction
|
145
154
|
# @param transactionCode [String] The code identifying the transaction
|
146
155
|
# @param documentType [String] The document type of the original transaction (See DocumentType::* for a list of allowable values)
|
147
|
-
# @return [Object]
|
148
|
-
def audit_transaction_with_type(companyCode, transactionCode, documentType)
|
149
|
-
|
150
|
-
|
151
|
-
|
152
|
-
|
156
|
+
# @return [Object]
|
157
|
+
def audit_transaction_with_type(companyCode, transactionCode, documentType)
|
158
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/types/#{documentType}/audit"
|
159
|
+
get(path)
|
160
|
+
end
|
161
|
+
|
162
|
+
|
163
|
+
# Lock a set of documents
|
164
|
+
#
|
153
165
|
# This API is available by invitation only.
|
154
166
|
#
|
155
167
|
# Lock a set of transactions uniquely identified by DocumentIds provided. This API allows locking multiple documents at once.
|
@@ -161,14 +173,17 @@ module AvaTax
|
|
161
173
|
# ### Security Policies
|
162
174
|
#
|
163
175
|
# * This API requires the user role Compliance Root User.
|
164
|
-
# * 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.
|
176
|
+
# * 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.
|
165
177
|
# @param model [Object] bulk lock request
|
166
|
-
# @return [Object]
|
167
|
-
def bulk_lock_transaction(model)
|
168
|
-
|
169
|
-
|
170
|
-
|
171
|
-
|
178
|
+
# @return [Object]
|
179
|
+
def bulk_lock_transaction(model)
|
180
|
+
path = "/api/v2/transactions/lock"
|
181
|
+
post(path, model)
|
182
|
+
end
|
183
|
+
|
184
|
+
|
185
|
+
# Change a transaction's code
|
186
|
+
#
|
172
187
|
# Renames a transaction uniquely identified by this URL by changing its `code` value.
|
173
188
|
#
|
174
189
|
# This API is available as long as the transaction is in `saved` or `posted` status. When a transaction
|
@@ -200,18 +215,21 @@ module AvaTax
|
|
200
215
|
# ### Security Policies
|
201
216
|
#
|
202
217
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
|
203
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
218
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
204
219
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
205
220
|
# @param transactionCode [String] The transaction code to change
|
206
221
|
# @param documentType [String] (Optional): The document type of the transaction to change document code. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values)
|
207
222
|
# @param include [String] Specifies objects to include in this fetch call
|
208
223
|
# @param model [Object] The code change request you wish to execute
|
209
|
-
# @return [Object]
|
210
|
-
def change_transaction_code(companyCode, transactionCode, model, options={})
|
211
|
-
|
212
|
-
|
213
|
-
|
214
|
-
|
224
|
+
# @return [Object]
|
225
|
+
def change_transaction_code(companyCode, transactionCode, model, options={})
|
226
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/changecode"
|
227
|
+
post(path, model, options)
|
228
|
+
end
|
229
|
+
|
230
|
+
|
231
|
+
# Commit a transaction for reporting
|
232
|
+
#
|
215
233
|
# Marks a transaction by changing its status to `Committed`.
|
216
234
|
#
|
217
235
|
# Transactions that are committed are available to be reported to a tax authority by Avalara Managed Returns.
|
@@ -241,18 +259,21 @@ module AvaTax
|
|
241
259
|
#
|
242
260
|
# ### Security Policies
|
243
261
|
#
|
244
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
|
262
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
|
245
263
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
246
264
|
# @param transactionCode [String] The transaction code to commit
|
247
265
|
# @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)
|
248
266
|
# @param include [String] Specifies objects to include in this fetch call
|
249
267
|
# @param model [Object] The commit request you wish to execute
|
250
|
-
# @return [Object]
|
251
|
-
def commit_transaction(companyCode, transactionCode, model, options={})
|
252
|
-
|
253
|
-
|
254
|
-
|
255
|
-
|
268
|
+
# @return [Object]
|
269
|
+
def commit_transaction(companyCode, transactionCode, model, options={})
|
270
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/commit"
|
271
|
+
post(path, model, options)
|
272
|
+
end
|
273
|
+
|
274
|
+
|
275
|
+
# Create or adjust a transaction
|
276
|
+
#
|
256
277
|
# Records a new transaction or adjust an existing transaction in AvaTax.
|
257
278
|
#
|
258
279
|
# The `CreateOrAdjustTransaction` endpoint is used to create a new transaction or update an existing one. This API
|
@@ -290,15 +311,18 @@ module AvaTax
|
|
290
311
|
# ### Security Policies
|
291
312
|
#
|
292
313
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
293
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
314
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
294
315
|
# @param include [String] Specifies objects to include in the response after transaction is created
|
295
316
|
# @param model [Object] The transaction you wish to create or adjust
|
296
|
-
# @return [Object]
|
297
|
-
def create_or_adjust_transaction(model, options={})
|
298
|
-
|
299
|
-
|
300
|
-
|
301
|
-
|
317
|
+
# @return [Object]
|
318
|
+
def create_or_adjust_transaction(model, options={})
|
319
|
+
path = "/api/v2/transactions/createoradjust"
|
320
|
+
post(path, model, options)
|
321
|
+
end
|
322
|
+
|
323
|
+
|
324
|
+
# Create a new transaction
|
325
|
+
#
|
302
326
|
# Records a new transaction in AvaTax.
|
303
327
|
#
|
304
328
|
# A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like
|
@@ -343,15 +367,18 @@ module AvaTax
|
|
343
367
|
# ### Security Policies
|
344
368
|
#
|
345
369
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
346
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
370
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
347
371
|
# @param include [String] Specifies objects to include in the response after transaction is created
|
348
372
|
# @param model [Object] The transaction you wish to create
|
349
|
-
# @return [Object]
|
350
|
-
def create_transaction(model, options={})
|
351
|
-
|
352
|
-
|
353
|
-
|
354
|
-
|
373
|
+
# @return [Object]
|
374
|
+
def create_transaction(model, options={})
|
375
|
+
path = "/api/v2/transactions/create"
|
376
|
+
post(path, model, options)
|
377
|
+
end
|
378
|
+
|
379
|
+
|
380
|
+
# Remove lines from an existing unlocked transaction
|
381
|
+
#
|
355
382
|
# Remove lines to an existing unlocked transaction.
|
356
383
|
#
|
357
384
|
# The `DeleteLines` API allows you to remove transaction lines from existing unlocked transaction, so that customer will
|
@@ -373,15 +400,18 @@ module AvaTax
|
|
373
400
|
# ### Security Policies
|
374
401
|
#
|
375
402
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
376
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
403
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
377
404
|
# @param include [String] Specifies objects to include in the response after transaction is created
|
378
405
|
# @param model [Object] information about the transaction and lines to be removed
|
379
|
-
# @return [Object]
|
380
|
-
def delete_lines(model, options={})
|
381
|
-
|
382
|
-
|
383
|
-
|
384
|
-
|
406
|
+
# @return [Object]
|
407
|
+
def delete_lines(model, options={})
|
408
|
+
path = "/api/v2/companies/transactions/lines/delete"
|
409
|
+
post(path, model, options)
|
410
|
+
end
|
411
|
+
|
412
|
+
|
413
|
+
# Retrieve a single transaction by code
|
414
|
+
#
|
385
415
|
# Get the current transaction identified by this company code, transaction code, and document type.
|
386
416
|
#
|
387
417
|
# A transaction is uniquely identified by `companyCode`, `code` (often called Transaction Code), and `documentType`.
|
@@ -410,17 +440,20 @@ module AvaTax
|
|
410
440
|
# ### Security Policies
|
411
441
|
#
|
412
442
|
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
413
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
443
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
414
444
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
415
445
|
# @param transactionCode [String] The transaction code to retrieve
|
416
446
|
# @param documentType [String] (Optional): The document type of the transaction to retrieve (See DocumentType::* for a list of allowable values)
|
417
447
|
# @param include [String] Specifies objects to include in this fetch call
|
418
|
-
# @return [Object]
|
419
|
-
def get_transaction_by_code(companyCode, transactionCode, options={})
|
420
|
-
|
421
|
-
|
422
|
-
|
423
|
-
|
448
|
+
# @return [Object]
|
449
|
+
def get_transaction_by_code(companyCode, transactionCode, options={})
|
450
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}"
|
451
|
+
get(path, options)
|
452
|
+
end
|
453
|
+
|
454
|
+
|
455
|
+
# Retrieve a single transaction by code
|
456
|
+
#
|
424
457
|
# DEPRECATED: Please use the `GetTransactionByCode` API instead.
|
425
458
|
#
|
426
459
|
# NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request:
|
@@ -432,17 +465,20 @@ module AvaTax
|
|
432
465
|
# ### Security Policies
|
433
466
|
#
|
434
467
|
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
435
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
468
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
436
469
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
437
470
|
# @param transactionCode [String] The transaction code to retrieve
|
438
471
|
# @param documentType [String] The transaction type to retrieve (See DocumentType::* for a list of allowable values)
|
439
472
|
# @param include [String] Specifies objects to include in this fetch call
|
440
|
-
# @return [Object]
|
441
|
-
def get_transaction_by_code_and_type(companyCode, transactionCode, documentType, options={})
|
442
|
-
|
443
|
-
|
444
|
-
|
445
|
-
|
473
|
+
# @return [Object]
|
474
|
+
def get_transaction_by_code_and_type(companyCode, transactionCode, documentType, options={})
|
475
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/types/#{documentType}"
|
476
|
+
get(path, options)
|
477
|
+
end
|
478
|
+
|
479
|
+
|
480
|
+
# Retrieve a single transaction by ID
|
481
|
+
#
|
446
482
|
# Get the unique transaction identified by this URL.
|
447
483
|
#
|
448
484
|
# This endpoint retrieves the exact transaction identified by this ID number even if that transaction was later adjusted
|
@@ -464,15 +500,18 @@ module AvaTax
|
|
464
500
|
# ### Security Policies
|
465
501
|
#
|
466
502
|
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
467
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
503
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
468
504
|
# @param id [Integer] The unique ID number of the transaction to retrieve
|
469
505
|
# @param include [String] Specifies objects to include in this fetch call
|
470
|
-
# @return [Object]
|
471
|
-
def get_transaction_by_id(id, options={})
|
472
|
-
|
473
|
-
|
474
|
-
|
475
|
-
|
506
|
+
# @return [Object]
|
507
|
+
def get_transaction_by_id(id, options={})
|
508
|
+
path = "/api/v2/transactions/#{id}"
|
509
|
+
get(path, options)
|
510
|
+
end
|
511
|
+
|
512
|
+
|
513
|
+
# Retrieve all transactions
|
514
|
+
#
|
476
515
|
# List all transactions attached to this company.
|
477
516
|
#
|
478
517
|
# This endpoint is limited to returning 1,000 transactions at a time maximum.
|
@@ -504,7 +543,7 @@ module AvaTax
|
|
504
543
|
# ### Security Policies
|
505
544
|
#
|
506
545
|
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
507
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
546
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
508
547
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
509
548
|
# @param dataSourceId [Integer] Optionally filter transactions to those from a specific data source.
|
510
549
|
# @param include [String] Specifies objects to include in this fetch call
|
@@ -512,12 +551,15 @@ module AvaTax
|
|
512
551
|
# @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.
|
513
552
|
# @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
|
514
553
|
# @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
|
515
|
-
# @return [FetchResult]
|
516
|
-
def list_transactions_by_company(companyCode, options={})
|
517
|
-
|
518
|
-
|
519
|
-
|
520
|
-
|
554
|
+
# @return [FetchResult]
|
555
|
+
def list_transactions_by_company(companyCode, options={})
|
556
|
+
path = "/api/v2/companies/#{companyCode}/transactions"
|
557
|
+
get(path, options)
|
558
|
+
end
|
559
|
+
|
560
|
+
|
561
|
+
# Lock a single transaction
|
562
|
+
#
|
521
563
|
# Lock a transaction uniquely identified by this URL.
|
522
564
|
#
|
523
565
|
# This API is mainly used for connector developer to simulate what happens when Returns product locks a document.
|
@@ -549,18 +591,21 @@ module AvaTax
|
|
549
591
|
# ### Security Policies
|
550
592
|
#
|
551
593
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
552
|
-
# * 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.
|
594
|
+
# * 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.
|
553
595
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
554
596
|
# @param transactionCode [String] The transaction code to lock
|
555
597
|
# @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)
|
556
598
|
# @param include [String] Specifies objects to include in this fetch call
|
557
599
|
# @param model [Object] The lock request you wish to execute
|
558
|
-
# @return [Object]
|
559
|
-
def lock_transaction(companyCode, transactionCode, model, options={})
|
560
|
-
|
561
|
-
|
562
|
-
|
563
|
-
|
600
|
+
# @return [Object]
|
601
|
+
def lock_transaction(companyCode, transactionCode, model, options={})
|
602
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/lock"
|
603
|
+
post(path, model, options)
|
604
|
+
end
|
605
|
+
|
606
|
+
|
607
|
+
# Create a refund for a transaction
|
608
|
+
#
|
564
609
|
# Create a refund for a transaction.
|
565
610
|
#
|
566
611
|
# The `RefundTransaction` API allows you to quickly and easily create a `ReturnInvoice` representing a refund
|
@@ -602,19 +647,22 @@ module AvaTax
|
|
602
647
|
# ### Security Policies
|
603
648
|
#
|
604
649
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
605
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
650
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
606
651
|
# @param companyCode [String] The code of the company that made the original sale
|
607
652
|
# @param transactionCode [String] The transaction code of the original sale
|
608
653
|
# @param include [String] Specifies objects to include in the response after transaction is created
|
609
654
|
# @param documentType [String] (Optional): The document type of the transaction to refund. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values)
|
610
655
|
# @param useTaxDateOverride [Boolean] (Optional): If set to true, processes refund using taxDateOverride rather than taxAmountOverride (Note: taxAmountOverride is not allowed for SST states).
|
611
656
|
# @param model [Object] Information about the refund to create
|
612
|
-
# @return [Object]
|
613
|
-
def refund_transaction(companyCode, transactionCode, model, options={})
|
614
|
-
|
615
|
-
|
616
|
-
|
617
|
-
|
657
|
+
# @return [Object]
|
658
|
+
def refund_transaction(companyCode, transactionCode, model, options={})
|
659
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/refund"
|
660
|
+
post(path, model, options)
|
661
|
+
end
|
662
|
+
|
663
|
+
|
664
|
+
# Perform multiple actions on a transaction
|
665
|
+
#
|
618
666
|
# Performs one or more actions against the current transaction uniquely identified by this URL.
|
619
667
|
#
|
620
668
|
# The `SettleTransaction` API call can perform the work of `ChangeCode`, `VerifyTransaction`, and `CommitTransaction`.
|
@@ -644,18 +692,21 @@ module AvaTax
|
|
644
692
|
#
|
645
693
|
# ### Security Policies
|
646
694
|
#
|
647
|
-
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
|
695
|
+
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
|
648
696
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
649
697
|
# @param transactionCode [String] The transaction code to settle
|
650
698
|
# @param documentType [String] (Optional): The document type of the transaction to settle. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values)
|
651
699
|
# @param include [String] Specifies objects to include in this fetch call
|
652
700
|
# @param model [Object] The data from an external system to reconcile against AvaTax
|
653
|
-
# @return [Object]
|
654
|
-
def settle_transaction(companyCode, transactionCode, model, options={})
|
655
|
-
|
656
|
-
|
657
|
-
|
658
|
-
|
701
|
+
# @return [Object]
|
702
|
+
def settle_transaction(companyCode, transactionCode, model, options={})
|
703
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/settle"
|
704
|
+
post(path, model, options)
|
705
|
+
end
|
706
|
+
|
707
|
+
|
708
|
+
# Uncommit a transaction for reporting
|
709
|
+
#
|
659
710
|
# Adjusts a transaction by changing it to an uncommitted status.
|
660
711
|
#
|
661
712
|
# Transactions that have been previously reported to a tax authority by Avalara Managed Returns are considered `locked` and are
|
@@ -680,17 +731,20 @@ module AvaTax
|
|
680
731
|
# ### Security Policies
|
681
732
|
#
|
682
733
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
683
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
734
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
684
735
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
685
736
|
# @param transactionCode [String] The transaction code to Uncommit
|
686
737
|
# @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)
|
687
738
|
# @param include [String] Specifies objects to include in this fetch call
|
688
|
-
# @return [Object]
|
689
|
-
def uncommit_transaction(companyCode, transactionCode, options={})
|
690
|
-
|
691
|
-
|
692
|
-
|
693
|
-
|
739
|
+
# @return [Object]
|
740
|
+
def uncommit_transaction(companyCode, transactionCode, options={})
|
741
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/uncommit"
|
742
|
+
post(path, options)
|
743
|
+
end
|
744
|
+
|
745
|
+
|
746
|
+
# Unvoids a transaction
|
747
|
+
#
|
694
748
|
# Unvoids a voided transaction
|
695
749
|
#
|
696
750
|
# 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:
|
@@ -712,17 +766,20 @@ module AvaTax
|
|
712
766
|
# ### Security Policies
|
713
767
|
#
|
714
768
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
|
715
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
769
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
716
770
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
717
771
|
# @param transactionCode [String] The transaction code to commit
|
718
772
|
# @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)
|
719
773
|
# @param include [String] Specifies objects to include in this fetch call
|
720
|
-
# @return [Object]
|
721
|
-
def unvoid_transaction(companyCode, transactionCode, options={})
|
722
|
-
|
723
|
-
|
724
|
-
|
725
|
-
|
774
|
+
# @return [Object]
|
775
|
+
def unvoid_transaction(companyCode, transactionCode, options={})
|
776
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/unvoid"
|
777
|
+
post(path, options)
|
778
|
+
end
|
779
|
+
|
780
|
+
|
781
|
+
# Verify a transaction
|
782
|
+
#
|
726
783
|
# Verifies that the transaction uniquely identified by this URL matches certain expected values.
|
727
784
|
#
|
728
785
|
# If the transaction does not match these expected values, this API will return an error code indicating which value did not match.
|
@@ -751,18 +808,21 @@ module AvaTax
|
|
751
808
|
# ### Security Policies
|
752
809
|
#
|
753
810
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
|
754
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
811
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
|
755
812
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
756
813
|
# @param transactionCode [String] The transaction code to settle
|
757
814
|
# @param documentType [String] (Optional): The document type of the transaction to verify. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values)
|
758
815
|
# @param include [String] Specifies objects to include in this fetch call
|
759
816
|
# @param model [Object] The data from an external system to reconcile against AvaTax
|
760
|
-
# @return [Object]
|
761
|
-
def verify_transaction(companyCode, transactionCode, model, options={})
|
762
|
-
|
763
|
-
|
764
|
-
|
765
|
-
|
817
|
+
# @return [Object]
|
818
|
+
def verify_transaction(companyCode, transactionCode, model, options={})
|
819
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/verify"
|
820
|
+
post(path, model, options)
|
821
|
+
end
|
822
|
+
|
823
|
+
|
824
|
+
# Void a transaction
|
825
|
+
#
|
766
826
|
# Voids the current transaction uniquely identified by this URL.
|
767
827
|
#
|
768
828
|
# A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like
|
@@ -793,15 +853,18 @@ module AvaTax
|
|
793
853
|
# ### Security Policies
|
794
854
|
#
|
795
855
|
# * This API requires one of the following user roles: AccountAdmin, AccountOperator, CompanyAdmin, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
|
796
|
-
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
856
|
+
# * This API depends on the following active services<br />*Required* (all): AvaTaxPro, BasicReturns.
|
797
857
|
# @param companyCode [String] The company code of the company that recorded this transaction
|
798
858
|
# @param transactionCode [String] The transaction code to void
|
799
859
|
# @param documentType [String] (Optional): The document type of the transaction to void. If not provided, the default is SalesInvoice. (See DocumentType::* for a list of allowable values)
|
800
860
|
# @param include [String] Specifies objects to include in this fetch call
|
801
861
|
# @param model [Object] The void request you wish to execute. To void a transaction the code must be set to 'DocVoided'
|
802
|
-
# @return [Object]
|
803
|
-
def void_transaction(companyCode, transactionCode, model, options={})
|
804
|
-
|
805
|
-
|
806
|
-
|
862
|
+
# @return [Object]
|
863
|
+
def void_transaction(companyCode, transactionCode, model, options={})
|
864
|
+
path = "/api/v2/companies/#{companyCode}/transactions/#{transactionCode}/void"
|
865
|
+
post(path, model, options)
|
866
|
+
end
|
867
|
+
|
868
|
+
end
|
869
|
+
end
|
807
870
|
end
|