avatax 24.12.0 → 25.1.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 23c6e22bc99c4346e4a4e9581a0246c5744339b996999c1e965c62f2088a830f
4
- data.tar.gz: 65c3c85f55d99e0cde39ab53ded24835a3b93fbd05e17deaa6e491d9d15bfa0b
3
+ metadata.gz: fa1155a6296f49af8222f9bc8086c233f43b226f7c1a37ec9e9f24f7885eacd9
4
+ data.tar.gz: 85c01a9cee7c89aa0426c4975b6fc71442d2ad4e5a938ad4439425e91a1dc42c
5
5
  SHA512:
6
- metadata.gz: '023576914a148c654b759922ba29b5d456f3ca714308aa1fe2ffd5f5e21f30f39fe0912dbe9ce1b6343d2a58cbadde08ae756ccafb297f8fed59d7e58294555c'
7
- data.tar.gz: 05b452bd5925008c78ddf3a3992d6477f09484d210e310b7c0a6eccd34f5d61b38cce476e2801d20ff96c0e5f0c078a2d42525dcb3b587e8fabd948eab01e1b1
6
+ metadata.gz: f8618a1521529122a70b671637467ca05f6b81129bfc1b587a3a8883131125859c81f3dc4f894f2ce450aa02b272492909270627bde8c47265b88753843863e7
7
+ data.tar.gz: 463d93fce3e936b6a6ac3ad6ce5453a34f1dd95162e46d3bfefdcc508857d87c720bdfa04240e7b36ff3c08878ef4c81bd236c7a0a3961f14d17fd7fc202ce7e
@@ -173,7 +173,7 @@ module AvaTax
173
173
  # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, ECMAccountUser, ECMCompanyUser, FirmAdmin, FirmUser, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
174
174
  # Swagger Name: AvaTaxClient
175
175
  # @param id [Integer] The ID of the account to retrieve
176
- # @param licensekeyname [String] The ID of the account to retrieve
176
+ # @param licensekeyname [String] The license key name to be retrieved
177
177
  # @return [Object]
178
178
  def get_license_key(id, licensekeyname) path = "/api/v2/accounts/#{id}/licensekey/#{licensekeyname}"
179
179
  get(path, {}, AvaTax::VERSION) end
@@ -20,7 +20,7 @@ module AvaTax
20
20
  #
21
21
  # ### Security Policies
22
22
  #
23
- # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin.
23
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin.
24
24
  # Swagger Name: AvaTaxClient
25
25
  # @param companyId [Integer] The ID of the company that owns this batch.
26
26
  # @param id [Integer] The ID of the batch to cancel.
@@ -52,7 +52,7 @@ module AvaTax
52
52
  #
53
53
  # ### Security Policies
54
54
  #
55
- # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin.
55
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin.
56
56
  # Swagger Name: AvaTaxClient
57
57
  # @param companyId [Integer] The ID of the company that owns this batch.
58
58
  # @param model [BatchModel[]] The batch you wish to create.
@@ -82,7 +82,7 @@ module AvaTax
82
82
  #
83
83
  # ### Security Policies
84
84
  #
85
- # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin.
85
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin.
86
86
  # Swagger Name: AvaTaxClient
87
87
  # @param companyId [Integer] The ID of the company that owns this batch.
88
88
  # @param model [Object] The transaction batch you wish to create.
@@ -105,7 +105,7 @@ module AvaTax
105
105
  #
106
106
  # ### Security Policies
107
107
  #
108
- # * This API requires one of the following user roles: BatchServiceAdmin, CSPAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin.
108
+ # * This API requires one of the following user roles: BatchServiceAdmin, CSPAdmin, CSPTester, FirmAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin.
109
109
  # Swagger Name: AvaTaxClient
110
110
  # @param companyId [Integer] The ID of the company that owns this batch.
111
111
  # @param id [Integer] The ID of the batch to delete.
@@ -119,7 +119,7 @@ module AvaTax
119
119
  #
120
120
  # ### Security Policies
121
121
  #
122
- # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser.
122
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser.
123
123
  # Swagger Name: AvaTaxClient
124
124
  # @param companyId [Integer] The ID of the company that owns this batch
125
125
  # @param batchId [Integer] The ID of the batch object
@@ -148,7 +148,7 @@ module AvaTax
148
148
  #
149
149
  # ### Security Policies
150
150
  #
151
- # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser.
151
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser.
152
152
  # Swagger Name: AvaTaxClient
153
153
  # @param companyId [Integer] The ID of the company that owns this batch
154
154
  # @param id [Integer] The primary key of this batch
@@ -182,7 +182,7 @@ module AvaTax
182
182
  #
183
183
  # ### Security Policies
184
184
  #
185
- # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser.
185
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser.
186
186
  # Swagger Name: AvaTaxClient
187
187
  # @param companyId [Integer] The ID of the company that owns these batches
188
188
  # @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:* files
@@ -217,7 +217,7 @@ module AvaTax
217
217
  #
218
218
  # ### Security Policies
219
219
  #
220
- # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser.
220
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser.
221
221
  # Swagger Name: AvaTaxClient
222
222
  # @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:* files
223
223
  # @param include [String] A comma separated list of additional data to retrieve.
@@ -301,7 +301,7 @@ module AvaTax
301
301
  # Swagger Name: AvaTaxClient
302
302
  # @param companyId [Integer] The ID number of the company to search
303
303
  # @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. * histories - Retrieves the certificate update history * jobs - Retrieves the jobs for this certificate * logs - Retrieves the certificate log * invalid_reasons - Retrieves invalid reasons for this certificate if the certificate is invalid * custom_fields - Retrieves custom fields set for this certificate
304
- # @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, ecmStatus, ecmsId, ecmsStatus, pdf, pages
304
+ # @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
305
305
  # @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.
306
306
  # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
307
307
  # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
@@ -235,7 +235,7 @@ module AvaTax
235
235
  # @param companyId [Integer] The unique ID number of the company that recorded this customer
236
236
  # @param customerCode [String] The unique code representing this customer
237
237
  # @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. * histories - Retrieves the certificate update history * jobs - Retrieves the jobs for this certificate * logs - Retrieves the certificate log * invalid_reasons - Retrieves invalid reasons for this certificate if the certificate is invalid * custom_fields - Retrieves custom fields set for this certificate
238
- # @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, ecmStatus, ecmsId, ecmsStatus, pdf, pages
238
+ # @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
239
239
  # @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.
240
240
  # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
241
241
  # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
@@ -296,6 +296,16 @@ module AvaTax
296
296
  def list_filing_frequencies(options={}) path = "/api/v2/definitions/filingfrequencies"
297
297
  get(path, options, AvaTax::VERSION) end
298
298
 
299
+ # List of all HS code classification statuses that can be assigned to an Item.
300
+ #
301
+ # ### Security Policies
302
+ #
303
+ # * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
304
+ # Swagger Name: AvaTaxClient
305
+ # @return [ItemHSCodeClassificationStatusOutputModel[]]
306
+ def list_item_h_s_code_classification_status() path = "/api/v2/definitions/items/hscode-classification-status"
307
+ get(path, {}, AvaTax::VERSION) end
308
+
299
309
  # List of all recommendation status which can be assigned to an item
300
310
  #
301
311
  # ### Security Policies
@@ -290,6 +290,21 @@ module AvaTax
290
290
  def delete_item_tags(companyId, itemId) path = "/api/v2/companies/#{companyId}/items/#{itemId}/tags"
291
291
  delete(path, {}, AvaTax::VERSION) end
292
292
 
293
+ # Dismiss the `Status` and `Details` values of the given ItemHSCodeClassificationStatus.
294
+ #
295
+ # Dismiss the existing `Status` and `Details` of the ItemHSCodeClassificationStatus object at this URL with an updated object.
296
+ #
297
+ # ### Security Policies
298
+ #
299
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
300
+ # Swagger Name: AvaTaxClient
301
+ # @param companyId [Integer] The ID of the company to which this item belongs.
302
+ # @param itemId [Integer] The ID of the item whose classification status you want to update.
303
+ # @param country [String] The country of the HS code classification request status record that is to be updated.
304
+ # @return [Object]
305
+ def dismiss_h_s_code_classification_status(companyId, itemId, options={}) path = "/api/v2/companies/#{companyId}/items/#{itemId}/hscode-classifications-status/$dismiss"
306
+ put(path, options, AvaTax::VERSION) end
307
+
293
308
  # Retrieve a single item
294
309
  #
295
310
  # Get the `Item` object identified by this URL.
@@ -404,9 +419,22 @@ module AvaTax
404
419
  # @param companyId [Integer] The ID of the company that owns this item object
405
420
  # @param itemCode [String] The ItemCode of the item for which you want to retrieve premium classification
406
421
  # @param systemCode [String] The SystemCode for which you want to retrieve premium classification
422
+ # @param country [String] Optional: Provide the country for which you want to retrieve the premium classification.
407
423
  # @return [Object]
408
- def get_premium_classification(companyId, itemCode, systemCode) path = "/api/v2/companies/#{companyId}/items/#{itemCode}/premiumClassification/#{systemCode}"
409
- get(path, {}, AvaTax::VERSION) end
424
+ def get_premium_classification(companyId, itemCode, systemCode, options={}) path = "/api/v2/companies/#{companyId}/items/#{itemCode}/premiumClassification/#{systemCode}"
425
+ get(path, options, AvaTax::VERSION) end
426
+
427
+ # Create an HS code classification request.
428
+ #
429
+ # ### Security Policies
430
+ #
431
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
432
+ # Swagger Name: AvaTaxClient
433
+ # @param companyId [Integer] The ID of the company for which you want to create this HS code classification request.
434
+ # @param model [ItemHSCodeClassificationInputModel[]] Item HSCodeClassification input Model
435
+ # @return [ItemHSCodeClassificationOutputModel[]]
436
+ def initiate_h_s_code_classification(companyId, model) path = "/api/v2/companies/#{companyId}/items/$initiate-hscode-classification"
437
+ post(path, model, {}, AvaTax::VERSION) end
410
438
 
411
439
  # Retrieve Restrictions for Item by CountryOfImport
412
440
  #
@@ -452,7 +480,7 @@ module AvaTax
452
480
  # Swagger Name: AvaTaxClient
453
481
  # @param companyId [Integer] The company id.
454
482
  # @param itemId [Integer] The item id.
455
- # @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:* productCode, systemCode, IsPremium
483
+ # @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:* productCode, systemCode, country, IsPremium, ClassificationEvent
456
484
  # @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.
457
485
  # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
458
486
  # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
@@ -487,6 +515,33 @@ module AvaTax
487
515
  def list_item_parameters(companyId, itemId, options={}) path = "/api/v2/companies/#{companyId}/items/#{itemId}/parameters"
488
516
  get(path, options, AvaTax::VERSION) end
489
517
 
518
+ # Retrieve premium classification for an item based on its `companyId` and `itemCode`.
519
+ #
520
+ # Retrieve the premium classification for an Item based on its `itemCode` and `companyId`.
521
+ #
522
+ # NOTE: If your item code contains any of these characters /, +, ?,",' ,% or #, please use the following encoding before making a request:
523
+ # * Replace '/' with '\_-ava2f-\_' For example: 'Item/Code' becomes 'Item_-ava2f-_Code'
524
+ # * Replace '+' with '\_-ava2b-\_' For example: 'Item+Code' becomes 'Item_-ava2b-_Code'
525
+ # * Replace '?' with '\_-ava3f-\_' For example: 'Item?Code' becomes 'Item_-ava3f-_Code'
526
+ # * Replace '%' with '\_-ava25-\_' For example: 'Item%Code' becomes 'Item_-ava25-_Code'
527
+ # * Replace '#' with '\_-ava23-\_' For example: 'Item#Code' becomes 'Item_-ava23-_Code'
528
+ # * Replace ''' with '\_-ava27-\_' For example: 'Item'Code' becomes 'Item_-ava27-_Code'
529
+ # * Replace '"' with '\_-ava22-\_' For example: 'Item"Code' becomes 'Item_-ava22-_Code'
530
+ #
531
+ # ### Security Policies
532
+ #
533
+ # * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
534
+ # Swagger Name: AvaTaxClient
535
+ # @param companyId [Integer] The ID of the company that owns this item object.
536
+ # @param itemCode [String] The item code of the item for which you want to retrieve premium classification.
537
+ # @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:* HsCode, justification, createdDate, createdUserId
538
+ # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
539
+ # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
540
+ # @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.
541
+ # @return [FetchResult]
542
+ def list_item_premium_classifications(companyId, itemCode, options={}) path = "/api/v2/companies/#{companyId}/items/#{itemCode}/premiumClassifications"
543
+ get(path, options, AvaTax::VERSION) end
544
+
490
545
  # Retrieve items for this company
491
546
  #
492
547
  # List all items defined for the current company.
@@ -507,6 +562,12 @@ module AvaTax
507
562
  #
508
563
  # You may specify Tax Code recommendation status in the `taxCodeRecommendationStatus` query parameter if you want to filter items on the basis of tax code recommendation status
509
564
  #
565
+ # You can specify an HS code classification status in the `hsCodeClassificationStatus` query parameter if you want to filter items based on an HS code classification status.
566
+ #
567
+ # You can specify a comma-separated list of countries in the `hsCodeExistsInCountries` query parameter if you want to filter items based on whether an HS code exists for the provided countries.
568
+ #
569
+ # You can specify a comma-separated list of countries in the `hsCodeDoesNotExistsInCountries` query parameter if you want to filter items on the basis of whether an HS code does not exist for the provided countries.
570
+ #
510
571
  # 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:
511
572
  #
512
573
  # * Parameters
@@ -514,6 +575,7 @@ module AvaTax
514
575
  # * Tags
515
576
  # * Properties
516
577
  # * TaxCodeRecommendationStatus
578
+ # * HsCodeClassificationStatus
517
579
  # * TaxCodeDetails
518
580
  #
519
581
  # ### Security Policies
@@ -521,7 +583,7 @@ module AvaTax
521
583
  # * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
522
584
  # Swagger Name: AvaTaxClient
523
585
  # @param companyId [Integer] The ID of the company that defined these items
524
- # @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:* taxCode, source, sourceEntityId, itemType, upc, summary, classifications, parameters, tags, properties, itemStatus, taxCodeRecommendationStatus, taxCodeRecommendations, taxCodeDetails
586
+ # @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:* taxCode, source, sourceEntityId, itemType, upc, summary, classifications, parameters, tags, properties, itemStatus, taxCodeRecommendationStatus, taxCodeRecommendations, taxCodeDetails, hsCodeClassificationStatus
525
587
  # @param include [String] A comma separated list of additional data to retrieve.
526
588
  # @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.
527
589
  # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
@@ -529,6 +591,9 @@ module AvaTax
529
591
  # @param tagName [String] Tag Name on the basis of which you want to filter Items
530
592
  # @param itemStatus [String] A comma separated list of item status on the basis of which you want to filter Items
531
593
  # @param taxCodeRecommendationStatus [String] Tax code recommendation status on the basis of which you want to filter Items
594
+ # @param hsCodeClassificationStatus [String] HS code classification status on the basis of which you want to filter items.
595
+ # @param hsCodeExistsInCountries [String] A comma-separated list of countries for which the HS code is assigned and based on which you want to filter the items.
596
+ # @param hsCodeDoesNotExistsInCountries [String] A comma-separated list of countries for which the HS code is not assigned and based on which you want to filter the items.
532
597
  # @return [FetchResult]
533
598
  def list_items_by_company(companyId, options={}) path = "/api/v2/companies/#{companyId}/items"
534
599
  get(path, options, AvaTax::VERSION) end
@@ -553,6 +618,32 @@ module AvaTax
553
618
  def list_recommended_parameter_by_company_id_and_item_id(companyId, itemId, options={}) path = "/api/v2/definitions/companies/#{companyId}/items/#{itemId}/parameters"
554
619
  get(path, options, AvaTax::VERSION) end
555
620
 
621
+ # Patch a single item
622
+ #
623
+ # Update the existing item object at this URL with the specified patch changes.
624
+ #
625
+ # Items are a way of separating your tax calculation process from your tax configuration details. If you choose, you
626
+ # can provide `itemCode` values for each `CreateTransaction()` API call rather than specifying tax codes, parameters, descriptions,
627
+ # and other data fields. AvaTax will automatically look up each `itemCode` and apply the correct tax codes and parameters
628
+ # from the item table instead. This allows your CreateTransaction call to be as simple as possible, and your tax compliance
629
+ # team can manage your item catalog and adjust the tax behavior of items without having to modify your software.
630
+ #
631
+ # Only specified fields in the existing object will be updated with the data you provide via PATCH.
632
+ # To set a field's value to null, you can either set the field to null explicitly or omit it from the PATCH request.
633
+ #
634
+ # The tax code takes precedence over the tax code ID if both are provided.
635
+ #
636
+ # ### Security Policies
637
+ #
638
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
639
+ # Swagger Name: AvaTaxClient
640
+ # @param companyId [Integer] The ID of the company that this item belongs to.
641
+ # @param id [Integer] The ID of the item you want to update.
642
+ # @param model [Operation[]] A JSON patch (refer to https://datatracker.ietf.org/doc/html/rfc6902).
643
+ # @return [Object]
644
+ def patch_item(companyId, id, model) path = "/api/v2/companies/#{companyId}/items/#{id}"
645
+ patch(path, model, {}, AvaTax::VERSION) end
646
+
556
647
  # Retrieve all items
557
648
  #
558
649
  # Get multiple item objects across all companies.
@@ -571,7 +662,7 @@ module AvaTax
571
662
  #
572
663
  # * This API requires one of the following user roles: AccountAdmin, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
573
664
  # Swagger Name: AvaTaxClient
574
- # @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:* taxCode, source, sourceEntityId, itemType, upc, summary, classifications, parameters, tags, properties, itemStatus, taxCodeRecommendationStatus, taxCodeRecommendations, taxCodeDetails
665
+ # @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:* taxCode, source, sourceEntityId, itemType, upc, summary, classifications, parameters, tags, properties, itemStatus, taxCodeRecommendationStatus, taxCodeRecommendations, taxCodeDetails, hsCodeClassificationStatus
575
666
  # @param include [String] A comma separated list of additional data to retrieve.
576
667
  # @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.
577
668
  # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
@@ -628,7 +719,7 @@ module AvaTax
628
719
  # Swagger Name: AvaTaxClient
629
720
  # @param companyId [Integer] The ID of the company that defined these items.
630
721
  # @param tag [String] The master tag to be associated with item.
631
- # @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:* taxCode, source, sourceEntityId, itemType, upc, summary, classifications, parameters, tags, properties, itemStatus, taxCodeRecommendationStatus, taxCodeRecommendations, taxCodeDetails
722
+ # @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:* taxCode, source, sourceEntityId, itemType, upc, summary, classifications, parameters, tags, properties, itemStatus, taxCodeRecommendationStatus, taxCodeRecommendations, taxCodeDetails, hsCodeClassificationStatus
632
723
  # @param include [String] A comma separated list of additional data to retrieve.
633
724
  # @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.
634
725
  # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
@@ -753,6 +844,27 @@ module AvaTax
753
844
  # @return [Object]
754
845
  def update_item_parameter(companyId, itemId, id, model) path = "/api/v2/companies/#{companyId}/items/#{itemId}/parameters/#{id}"
755
846
  put(path, model, {}, AvaTax::VERSION) end
847
+
848
+ # Add/update item classifications.
849
+ #
850
+ # Add/update classifications to an item.
851
+ #
852
+ # A classification is the code for a product in a particular tax system. Classifications enable an item to be used in multiple tax systems that may have different tax rates for a product.
853
+ #
854
+ # When an item is used in a transaction, the applicable classification will be used to determine the appropriate tax rate.
855
+ #
856
+ # An item may only have one classification per tax system per country.
857
+ #
858
+ # ### Security Policies
859
+ #
860
+ # * This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin.
861
+ # Swagger Name: AvaTaxClient
862
+ # @param companyId [Integer] The company ID.
863
+ # @param itemId [Integer] The item ID.
864
+ # @param model [ItemClassificationInputModel[]] The item classifications you want to create.
865
+ # @return [ItemClassificationOutputModel[]]
866
+ def upsert_item_classifications(companyId, itemId, model) path = "/api/v2/companies/#{companyId}/items/#{itemId}/classifications"
867
+ put(path, model, {}, AvaTax::VERSION) end
756
868
  end
757
869
  end
758
870
  end
@@ -135,9 +135,6 @@ module AvaTax
135
135
 
136
136
  # Sales tax rates for a specified address
137
137
  #
138
- # Usage of this API is subject to rate limits. Users who exceed the rate limit will receive HTTP
139
- # response code 429 - `Too Many Requests`.
140
- #
141
138
  # This API assumes that you are selling general tangible personal property at a retail point-of-sale
142
139
  # location in the United States only.
143
140
  #
@@ -1,3 +1,3 @@
1
1
  module AvaTax
2
- VERSION = '24.12.0'.freeze unless defined?(::AvaTax::VERSION)
2
+ VERSION = '25.1.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
3
3
  version: !ruby/object:Gem::Version
4
- version: 24.12.0
4
+ version: 25.1.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Marcus Vorwaller
8
- autorequire:
8
+ autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-12-18 00:00:00.000000000 Z
11
+ date: 2025-01-28 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: rake
@@ -188,7 +188,7 @@ files:
188
188
  homepage: https://github.com/avadev/AvaTax-REST-V2-Ruby-SDK
189
189
  licenses: []
190
190
  metadata: {}
191
- post_install_message:
191
+ post_install_message:
192
192
  rdoc_options: []
193
193
  require_paths:
194
194
  - lib
@@ -204,7 +204,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
204
204
  version: 2.0.0
205
205
  requirements: []
206
206
  rubygems_version: 3.0.3.1
207
- signing_key:
207
+ signing_key:
208
208
  specification_version: 4
209
209
  summary: Ruby wrapper for the AvaTax API
210
210
  test_files: []