avatax 19.7.0 → 19.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84e5af57881983a07a47bc4edf4f80952fc03655d04ffbdda0fd9ac1123d6bee
-  data.tar.gz: 477b963fa3fdba9b2707e082eb4884d584ec651e791a877faa69565388eb0af1
+  metadata.gz: bb8f10b49682e45fdf31a4d133c20221f679e2f385717c04eb9fd3ef58a0a998
+  data.tar.gz: fadd3e37b607f12c071a4ce0fbeb789e14da605f0e179ee6051296a4815befec
 SHA512:
-  metadata.gz: f2881ca629ea60a47bef96885a1e87487bf2b79a6dd98c2a60b7f4d7bd83c6ccbd0501dfc11e9266e15c6c818440bc65ed62a9c30f3f9241b2c4aef3c48fd84a
-  data.tar.gz: a2506d940ef9f8be009335cbcd83907815631cf1bb4540d2e1a3cc8ad1af6f2ee4c98f3bfc6a15393023e0e0d75c39952cb64599e30190b762a844dde1a746cb
+  metadata.gz: d7931a896e2a34828fdc2ba050dd78e242b35aa6a67ad1d22edf0aa351e17915ca1ea3df8f42dd35a7d8cb885a9a5376740d4745a2d4ebb98e123e8a28e73b20
+  data.tar.gz: 775389c619cabb591154437a28e158001206f63a2281c9390f72559c5ab8c6708a5773b37fc7f2d9d25470c5e0d324804115ad1ea7b6121fca79463cb8aac517

data/lib/avatax/client/avafileforms.rb

@@ -11,8 +11,8 @@ module AvaTax
       # ### Security Policies
       #
       # * This API requires the user role Compliance Root User.
-      # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
-      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
       # @param model [AvaFileFormModel[]] The AvaFileForm you wish to create.
       # @return [AvaFileFormModel[]]
       def create_ava_file_forms(model)
@@ -28,8 +28,8 @@ module AvaTax
       # ### Security Policies
       #
       # * This API requires one of the following user roles: Compliance Root User, ComplianceUser, FirmAdmin.
-      # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
-      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
       # @param id [Integer] The ID of the AvaFileForm you wish to delete.
       # @return [ErrorDetail[]]
       def delete_ava_file_form(id)
@@ -45,8 +45,8 @@ module AvaTax
       # ### Security Policies
       #
       # * 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.
-      # * 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.
-      # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # * 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.
       # @param id [Integer] The primary key of this AvaFileForm
       # @return [Object]
       def get_ava_file_form(id)
@@ -63,10 +63,9 @@ module AvaTax
       # ### Security Policies
       #
       # * 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.
-      # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
-      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
       # @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
-      # @param include [String] A comma separated list of additional data to retrieve.
       # @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.
       # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
       # @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
       # ### Security Policies
       #
       # * This API requires the user role Compliance Root User.
-      # * This API depends on the following active services<br />*Returns* (at least one of): Mrs, MRSComplianceManager, AvaTaxCsp.
-      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
       # @param id [Integer] The ID of the AvaFileForm you wish to update
       # @param model [Object] The AvaFileForm model you wish to update.
       # @return [Object]

data/lib/avatax/client/certificates.rb

@@ -63,7 +63,7 @@ module AvaTax
       # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
       # @param companyId [Integer] The unique ID number of the company that recorded this certificate
       # @param id [Integer] The unique ID number of this certificate
-      # @return [Object]
+      # @return [ErrorDetail[]]
       def delete_certificate(companyId, id)
         path = "/api/v2/companies/#{companyId}/certificates/#{id}"
         delete(path)
@@ -308,7 +308,7 @@ module AvaTax
       # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
       # @param companyId [Integer] The ID number of the company to search
       # @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.
-      # @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, pdf, pages
+      # @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
       # @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.
       # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
       # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.

data/lib/avatax/client/compliance.rb

@@ -3,112 +3,6 @@ module AvaTax
     module Compliance 
 
 
-      # Retrieve a single tax rate.
-      #
-      # This API is available by invitation only.
-      # @param id [Integer] The ID of the tax rate to retrieve.
-      # @return [Object]
-      def get_tax_rate(id)
-        path = "/api/v2/compliance/taxrates/#{id}"
-        get(path)
-      end
-
-
-      # Retrieve a single tax region.
-      #
-      # This API is available by invitation only.
-      # @param id [Integer] The ID of the tax region to retrieve.
-      # @return [Object]
-      def get_tax_region(id)
-        path = "/api/v2/compliance/taxregions/#{id}"
-        get(path)
-      end
-
-
-      # Retrieve jurisdictions and rates in a combined format.
-      #
-      # This API is available by invitation only.
-      # @param effectiveDate [DateTime] Used to limit the jurisdictions returned.
-      # @param endDate [DateTime] Used to limit the jurisdictions returned.
-      # @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/).
-      # @param include [String] A comma separated list of objects to fetch underneath this jurisdiction.
-      # @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.
-      # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
-      # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
-      # @return [Object]
-      def query_jurisdiction_rates(options={})
-        path = "/api/v2/compliance/jurisdictionrates"
-        get(path, options)
-      end
-
-
-      # Retrieve all unique jurisdictions.
-      #
-      # This API is available by invitation only.
-      #
-      # 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:
-      #
-      # * TaxRates
-      # @param country [String] The two-character ISO-3166 code for the country.
-      # @param region [String] The two or three character region code for the region.
-      # @param effectiveDate [DateTime] Used to limit the jurisdictions or rates returned.
-      # @param endDate [DateTime] Used to limit the jurisdictions or rates returned.
-      # @param aggregationOption [String] Aggregation method used if rates are returned using the '$include' parameter. (See StackAggregationOption::* for a list of allowable values)
-      # @param include [String] A comma separated list of objects to fetch underneath this tax rate.
-      # @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.
-      # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
-      # @return [Object]
-      def query_jurisdictions(country, region, options={})
-        path = "/api/v2/compliance/jurisdictions/#{country}/#{region}"
-        get(path, options)
-      end
-
-
-      # Retrieve all tax rates.
-      #
-      # This API is available by invitation only.
-      # @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/).
-      # @param include [String] A comma separated list of objects to fetch underneath this tax rate.
-      # @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.
-      # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
-      # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
-      # @return [Object]
-      def query_tax_rates(options={})
-        path = "/api/v2/compliance/taxrates"
-        get(path, options)
-      end
-
-
-      # Retrieve all tax region jurisdictions.
-      #
-      # This API is available by invitation only.
-      # @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/).
-      # @param include [String] A comma separated list of objects to fetch underneath this tax region jurisdiction.
-      # @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.
-      # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
-      # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
-      # @return [Object]
-      def query_tax_region_jurisdictions(options={})
-        path = "/api/v2/compliance/taxregionjurisdictions"
-        get(path, options)
-      end
-
-
-      # Retrieve all tax regions.
-      #
-      # This API is available by invitation only.
-      # @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/).
-      # @param include [String] A comma separated list of objects to fetch underneath this tax region.
-      # @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.
-      # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
-      # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
-      # @return [Object]
-      def query_tax_regions(options={})
-        path = "/api/v2/compliance/taxregions"
-        get(path, options)
-      end
-
-
       # API to modify the reference fields at the document and the line level.
       #
       # 

data/lib/avatax/client/customers.rb

@@ -76,6 +76,7 @@ module AvaTax
       #
       # * Certificates - Fetch a list of certificates linked to this customer.
       # * CustomFields - Fetch a list of custom fields associated to this customer.
+      # * attributes - Retrieves all attributes applied to the customer.
       #
       # Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
       # 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
       end
 
 
+      # Link attributes to a customer
+      #
+      # Link one or many attributes to a customer.
+      #
+      # A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a
+      # customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API.
+      #
+      # A customer object defines information about a person or business that purchases products from your
+      # company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this
+      # record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and
+      # identify any certificates linked to this customer object. If any certificate applies to the transaction,
+      # AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`.
+      #
+      # Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
+      # Companies that do not have this storage system set up will receive the error `CertCaptureNotConfiguredError` when they call exemption
+      # certificate related APIs. To check if this company is set up, call `GetCertificateSetup`. To request setup of the auditable document
+      # storage for this company, call `RequestCertificateSetup`.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin.
+      # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
+      # @param companyId [Integer] The unique ID number of the company that recorded the provided customer
+      # @param customerCode [String] The unique code representing the current customer
+      # @param model [CustomerAttributeModel[]] The list of attributes to link to the customer.
+      # @return [FetchResult]
+      def link_attributes_to_customer(companyId, customerCode, model)
+        path = "/api/v2/companies/#{companyId}/customers/#{customerCode}/attributes/link"
+        put(path, model)
+      end
+
+
       # Link certificates to a customer
       #
       # Link one or more certificates to a customer.
@@ -155,6 +188,37 @@ module AvaTax
       end
 
 
+      # Retrieve a customer's attributes
+      #
+      # Retrieve the attributes linked to the customer identified by this URL.
+      #
+      # A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a
+      # customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API.
+      #
+      # A customer object defines information about a person or business that purchases products from your
+      # company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this
+      # record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and
+      # identify any certificates linked to this customer object. If any certificate applies to the transaction,
+      # AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`.
+      #
+      # Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
+      # Companies that do not have this storage system set up will receive the error `CertCaptureNotConfiguredError` when they call exemption
+      # certificate related APIs. To check if this company is set up, call `GetCertificateSetup`. To request setup of the auditable document
+      # storage for this company, call `RequestCertificateSetup`.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
+      # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
+      # @param companyId [Integer] The unique ID number of the company that recorded the provided customer
+      # @param customerCode [String] The unique code representing the current customer
+      # @return [FetchResult]
+      def list_attributes_for_customer(companyId, customerCode)
+        path = "/api/v2/companies/#{companyId}/customers/#{customerCode}/attributes"
+        get(path)
+      end
+
+
       # List certificates linked to a customer
       #
       # List all certificates linked to a customer.
@@ -177,7 +241,7 @@ module AvaTax
       # @param companyId [Integer] The unique ID number of the company that recorded this customer
       # @param customerCode [String] The unique code representing this customer
       # @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.
-      # @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, pdf, pages
+      # @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
       # @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.
       # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
       # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
@@ -234,6 +298,7 @@ module AvaTax
       # You can use the `$include` parameter to fetch the following additional objects for expansion:
       #
       # * Certificates - Fetch a list of certificates linked to this customer.
+      # * attributes - Retrieves all attributes applied to the customer.
       #
       # Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
       # 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
       end
 
 
+      # Unlink attributes from a customer
+      #
+      # Unlink one or many attributes from a customer.
+      #
+      # A customer may have multiple attributes that control its behavior. You may link or unlink attributes to a
+      # customer at any time. The full list of defined attributes may be found using `QueryCompanyCustomerAttributes` API.
+      #
+      # A customer object defines information about a person or business that purchases products from your
+      # company. When you create a tax transaction in AvaTax, you can use the `customerCode` from this
+      # record in your `CreateTransaction` API call. AvaTax will search for this `customerCode` value and
+      # identify any certificates linked to this customer object. If any certificate applies to the transaction,
+      # AvaTax will record the appropriate elements of the transaction as exempt and link it to the `certificate`.
+      #
+      # Using exemption certificates endpoints requires setup of an auditable document storage for each company that will use certificates.
+      # Companies that do not have this storage system set up will receive the error `CertCaptureNotConfiguredError` when they call exemption
+      # certificate related APIs. To check if this company is set up, call `GetCertificateSetup`. To request setup of the auditable document
+      # storage for this company, call `RequestCertificateSetup`.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin.
+      # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
+      # @param companyId [Integer] The unique ID number of the company that recorded the customer
+      # @param customerCode [String] The unique code representing the current customer
+      # @param model [CustomerAttributeModel[]] The list of attributes to unlink from the customer.
+      # @return [FetchResult]
+      def unlink_attributes_from_customer(companyId, customerCode, model)
+        path = "/api/v2/companies/#{companyId}/customers/#{customerCode}/attributes/unlink"
+        put(path, model)
+      end
+
+
       # Unlink certificates from a customer
       #
       # Remove one or more certificates to a customer.

data/lib/avatax/client/filingcalendars.rb

@@ -24,6 +24,486 @@ module AvaTax
         get(path, options)
       end
 
+
+      # Approve existing Filing Request
+      #
+      # This API is available by invitation only.
+      # A "filing request" represents a request to change an existing filing calendar. Filing requests
+      # are reviewed and validated by Avalara Compliance before being implemented.
+      # The filing request must be in the "ChangeRequest" status to be approved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that owns the filing request object
+      # @param id [Integer] The unique ID of the filing request object
+      # @return [Object]
+      def approve_filing_request(companyId, id)
+        path = "/api/v2/companies/#{companyId}/filingrequests/#{id}/approve"
+        post(path)
+      end
+
+
+      # Cancel existing Filing Request
+      #
+      # This API is available by invitation only.
+      # A "filing request" represents a request to change an existing filing calendar. Filing requests
+      # are reviewed and validated by Avalara Compliance before being implemented.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that owns the filing request object
+      # @param id [Integer] The unique ID of the filing request object
+      # @return [Object]
+      def cancel_filing_request(companyId, id)
+        path = "/api/v2/companies/#{companyId}/filingrequests/#{id}/cancel"
+        post(path)
+      end
+
+
+      # Create a new filing request to cancel a filing calendar
+      #
+      # This API is available by invitation only.
+      #
+      # A "filing request" represents a request to change an existing filing calendar. Filing requests
+      # are reviewed and validated by Avalara Compliance before being implemented.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
+      # @param id [Integer] The unique ID number of the filing calendar to cancel
+      # @param model [FilingRequestModel[]] The cancellation request for this filing calendar
+      # @return [Object]
+      def cancel_filing_requests(companyId, id, model)
+        path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}/cancel/request"
+        post(path, model)
+      end
+
+
+      # Create a filing calendar
+      #
+      # This API is available by invitation only and only available for users with Compliance access
+      # A "filing request" represents information that compliance uses to file a return
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that will add the new filing calendar
+      # @param model [FilingCalendarModel[]] Filing calendars that will be added
+      # @return [FilingCalendarModel[]]
+      def create_filing_calendars(companyId, model)
+        path = "/api/v2/companies/#{companyId}/filingcalendars"
+        post(path, model)
+      end
+
+
+      # Create a new filing request to create a filing calendar
+      #
+      # This API is available by invitation only.
+      # A "filing request" represents a request to change an existing filing calendar. Filing requests
+      # are reviewed and validated by Avalara Compliance before being implemented.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that will add the new filing calendar
+      # @param model [FilingRequestModel[]] Information about the proposed new filing calendar
+      # @return [FilingRequestModel[]]
+      def create_filing_requests(companyId, model)
+        path = "/api/v2/companies/#{companyId}/filingcalendars/add/request"
+        post(path, model)
+      end
+
+
+      # Create a company return setting
+      #
+      # This API is available by invitation only and only available for users with Compliance access
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # @param companyId [Integer] The unique ID of the company that will add the new filing calendar
+      # @param filingCalendarId [Integer] The unique ID of the filing calendar that will add the new filing calendar setting
+      # @param model [CompanyReturnSettingModel[]] CompanyReturnSettings that will be added
+      # @return [CompanyReturnSettingModel[]]
+      def create_update_company_return_settings(companyId, filingCalendarId, model)
+        path = "/api/v2/companies/#{companyId}/filingcalendars/#{filingCalendarId}/settings"
+        post(path, model)
+      end
+
+
+      # Returns a list of options for adding the specified form.
+      #
+      # This API is available by invitation only.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
+      # @param formCode [String] The unique code of the form
+      # @return [CycleAddOptionModel[]]
+      def cycle_safe_add(companyId, options={})
+        path = "/api/v2/companies/#{companyId}/filingcalendars/add/options"
+        get(path, options)
+      end
+
+
+      # Indicates when changes are allowed to be made to a filing calendar.
+      #
+      # This API is available by invitation only.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
+      # @param id [Integer] The unique ID of the filing calendar object
+      # @param model [FilingCalendarEditModel[]] A list of filing calendar edits to be made
+      # @return [Object]
+      def cycle_safe_edit(companyId, id, model)
+        path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}/edit/options"
+        post(path, model)
+      end
+
+
+      # Returns a list of options for expiring a filing calendar
+      #
+      # This API is available by invitation only.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
+      # @param id [Integer] The unique ID of the filing calendar object
+      # @return [Object]
+      def cycle_safe_expiration(companyId, id)
+        path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}/cancel/options"
+        get(path)
+      end
+
+
+      # Delete a single filing calendar.
+      #
+      # This API is available by invitation only.
+      # Mark the existing notice object at this URL as deleted.
+      # A 'notice' represents a letter sent to a business by a tax authority regarding tax filing issues. Avalara
+      # Returns customers often receive support and assistance from the Compliance Notices team in handling notices received by taxing authorities.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The ID of the company that owns this filing calendar.
+      # @param id [Integer] The ID of the filing calendar you wish to delete.
+      # @return [ErrorDetail[]]
+      def delete_filing_calendar(companyId, id)
+        path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}"
+        delete(path)
+      end
+
+
+      # Retrieve a single filing calendar
+      #
+      # This API is available by invitation only.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The ID of the company that owns this filing calendar
+      # @param id [Integer] The primary key of this filing calendar
+      # @return [Object]
+      def get_filing_calendar(companyId, id)
+        path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}"
+        get(path)
+      end
+
+
+      # Retrieve a single filing request
+      #
+      # This API is available by invitation only.
+      # A "filing request" represents a request to change an existing filing calendar. Filing requests
+      # are reviewed and validated by Avalara Compliance before being implemented.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The ID of the company that owns this filing calendar
+      # @param id [Integer] The primary key of this filing calendar
+      # @return [Object]
+      def get_filing_request(companyId, id)
+        path = "/api/v2/companies/#{companyId}/filingrequests/#{id}"
+        get(path)
+      end
+
+
+      # Retrieve all filing calendars for this company
+      #
+      # This API is available by invitation only.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The ID of the company that owns these batches
+      # @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
+      # @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.
+      # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
+      # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
+      # @param returnCountry [String] A comma separated list of countries
+      # @param returnRegion [String] A comma separated list of regions
+      # @return [FetchResult]
+      def list_filing_calendars(companyId, options={})
+        path = "/api/v2/companies/#{companyId}/filingcalendars"
+        get(path, options)
+      end
+
+
+      # Retrieve all filing requests for this company
+      #
+      # This API is available by invitation only.
+      # A "filing request" represents a request to change an existing filing calendar. Filing requests
+      # are reviewed and validated by Avalara Compliance before being implemented.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The ID of the company that owns these batches
+      # @param filingCalendarId [Integer] Specific filing calendar id for the request
+      # @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/).
+      # @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.
+      # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
+      # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
+      # @return [FetchResult]
+      def list_filing_requests(companyId, options={})
+        path = "/api/v2/companies/#{companyId}/filingrequests"
+        get(path, options)
+      end
+
+
+      # New request for getting for validating customer's login credentials
+      #
+      # This API is available by invitation only.
+      #
+      # This API verifies that a customer has submitted correct login credentials for a tax authority's online filing system.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param model [Object] The model of the login information we are verifying
+      # @return [Object]
+      def login_verification_request(model)
+        path = "/api/v2/filingcalendars/credentials/verify"
+        post(path, model)
+      end
+
+
+      # Gets the request status and Login Result
+      #
+      # This API is available by invitation only.
+      #
+      # This API checks the status of a login verification request. It may only be called by authorized users from the account
+      # that initially requested the login verification.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param jobId [Integer] The unique ID number of this login request
+      # @return [Object]
+      def login_verification_status(jobId)
+        path = "/api/v2/filingcalendars/credentials/#{jobId}"
+        get(path)
+      end
+
+
+      # Retrieve all filing calendars
+      #
+      # This API is available by invitation only.
+      #
+      # This API is deprecated - please use POST `/api/v2/filingrequests/query` API.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @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
+      # @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.
+      # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
+      # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
+      # @param returnCountry [String] If specified, fetches only filing calendars that apply to tax filings in this specific country. Uses ISO 3166 country codes.
+      # @param returnRegion [String] If specified, fetches only filing calendars that apply to tax filings in this specific region. Uses ISO 3166 region codes.
+      # @return [FetchResult]
+      def query_filing_calendars(options={})
+        path = "/api/v2/filingcalendars"
+        get(path, options)
+      end
+
+
+      # Retrieve all filing calendars
+      #
+      # This API is available by invitation only.
+      #
+      # 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.
+      # The documentation of the GET API shows how filtering, sorting and pagination works.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param returnCountry [String] If specified, fetches only filing calendars that apply to tax filings in this specific country. Uses ISO 3166 country codes.
+      # @param returnRegion [String] If specified, fetches only filing calendars that apply to tax filings in this specific region. Uses ISO 3166 region codes.
+      # @param model [Object] Query object to filter, sort and paginate the filing calendars.
+      # @return [FetchResult]
+      def query_filing_calendars_post(model, options={})
+        path = "/api/v2/filingcalendars/query"
+        post(path, model, options)
+      end
+
+
+      # Retrieve all filing requests
+      #
+      # This API is available by invitation only.
+      #
+      # This API is deprecated - please use POST `/api/v2/filingrequests/query` API.
+      #
+      # A "filing request" represents a request to change an existing filing calendar. Filing requests
+      # are reviewed and validated by Avalara Compliance before being implemented.
+      #
+      # 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/) .
+      # Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param filingCalendarId [Integer] Specific filing calendar id for the request
+      # @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/).
+      # @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.
+      # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
+      # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
+      # @return [FetchResult]
+      def query_filing_requests(options={})
+        path = "/api/v2/filingrequests"
+        get(path, options)
+      end
+
+
+      # Retrieve all filing requests
+      #
+      # This API is available by invitation only.
+      #
+      # 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.
+      # The documentation of the GET API shows how filtering, sorting and pagination works.
+      #
+      # ### Security Policies
+      #
+      # * 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.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param filingCalendarId [Integer] Specific filing calendar id for the request
+      # @param model [Object] Query object to filter, sort and paginate the filing calendars.
+      # @return [FetchResult]
+      def query_filing_requests_post(model, options={})
+        path = "/api/v2/filingrequests/query"
+        post(path, model, options)
+      end
+
+
+      # Create a new filing request to edit a filing calendar
+      #
+      # This API is available by invitation only.
+      #
+      # A "filing request" represents a request to change an existing filing calendar. Filing requests
+      # are reviewed and validated by Avalara Compliance before being implemented.
+      #
+      # Certain users may not update filing calendars directly. Instead, they may submit an edit request
+      # to modify the value of a filing calendar using this API.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
+      # @param id [Integer] The unique ID number of the filing calendar to edit
+      # @param model [FilingRequestModel[]] A list of filing calendar edits to be made
+      # @return [Object]
+      def request_filing_calendar_update(companyId, id, model)
+        path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}/edit/request"
+        post(path, model)
+      end
+
+
+      # Edit existing Filing Calendar
+      #
+      # This API is available by invitation only.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that owns the filing calendar object
+      # @param id [Integer] The unique ID of the filing calendar object
+      # @param model [Object] The filing calendar model you are wishing to update with.
+      # @return [Object]
+      def update_filing_calendar(companyId, id, model)
+        path = "/api/v2/companies/#{companyId}/filingcalendars/#{id}"
+        put(path, model)
+      end
+
+
+      # Edit existing Filing Request
+      #
+      # This API is available by invitation only.
+      # A "filing request" represents a request to change an existing filing calendar. Filing requests
+      # are reviewed and validated by Avalara Compliance before being implemented.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPTester, FirmAdmin, FirmUser, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # * This API is available by invitation only.<br />*Exempt security roles*: ComplianceRootUser, ComplianceAdmin, ComplianceUser, TechnicalSupportAdmin, TechnicalSupportUser.
+      # @param companyId [Integer] The unique ID of the company that owns the filing request object
+      # @param id [Integer] The unique ID of the filing request object
+      # @param model [Object] A list of filing calendar edits to be made
+      # @return [Object]
+      def update_filing_request(companyId, id, model)
+        path = "/api/v2/companies/#{companyId}/filingrequests/#{id}"
+        put(path, model)
+      end
+
     end
   end
 end