avatax 19.5.0 → 19.9.1

data/lib/avatax/client/errortransactions.rb

@@ -0,0 +1,50 @@
+module AvaTax
+  class Client
+    module ErrorTransactions 
+
+
+      # Delete a batch of error transactions
+      #
+      # Delete a batch of error transactions attached to a company.
+      #
+      # If any of the provided error transaction isn't found then it'll be treated as a success.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
+      # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
+      # @param model [Object] The request that contains error transactions to be deleted
+      # @return [Object]
+      def delete_error_transactions(model)
+        path = "/api/v2/errortransactions"
+        delete(path, model)
+      end
+
+
+      # Retrieve list of error transactions
+      #
+      # List error transactions attached to this company. Results are dependent on `$filter` if provided.
+      #
+      # This endpoint is limited to returning 250 error transactions at a time maximum.
+      #
+      # 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, CSPAdmin, CSPTester, ProStoresOperator, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
+      # * This API depends on the following active services<br />*Required* (all): AvaTaxPro.
+      # @param companyCode [String] The company code to filter on. This query parameter is required.
+      # @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).<br />*Not filterable:* companyId, avataxErrorJson, avataxCreateTransactionJson
+      # @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_error_transactions(options={})
+        path = "/api/v2/errortransactions"
+        get(path, options)
+      end
+
+    end
+  end
+end

data/lib/avatax/client/filingcalendars.rb

@@ -3,6 +3,28 @@ module AvaTax
     module FilingCalendars 
 
 
+      # Checks to see if the company has a valid POA for a tax form code
+      #
+      # This API is available by invitation only.
+      #
+      # This API fetches valid POA's for a company by TaxFormCode or by country/region
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, CompanyAdmin, CompanyUser, Compliance Operator, Compliance Root User, Compliance Temp User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ProStoresOperator, Registrar, SiteAdmin, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
+      # * 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.
+      # @param companyId [Integer] The company id that we are checking about
+      # @param taxFormCode [String] The tax form code that we are checking
+      # @param country [String] The country we are fetching POAs for
+      # @param region [String] The region we are fetching POAs for
+      # @return [PowerOfAttorneyCheckModel[]]
+      def active_power_of_attorney(companyId, options={})
+        path = "/api/v2/companies/#{companyId}/filingcalendars/powerofattorney"
+        get(path, options)
+      end
+
+
       # Approve existing Filing Request
       #
       # This API is available by invitation only.
@@ -13,8 +35,8 @@ module AvaTax
       # ### 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.
-      # * 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 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]
@@ -33,8 +55,8 @@ module AvaTax
       # ### 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.
-      # * 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 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]
@@ -54,8 +76,8 @@ module AvaTax
       # ### 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.
-      # * 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 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
@@ -74,11 +96,11 @@ module AvaTax
       # ### 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.
-      # * 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 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 [Object]
+      # @return [FilingCalendarModel[]]
       def create_filing_calendars(companyId, model)
         path = "/api/v2/companies/#{companyId}/filingcalendars"
         post(path, model)
@@ -94,17 +116,34 @@ module AvaTax
       # ### 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.
-      # * 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 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 [Object]
+      # @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.
@@ -112,8 +151,8 @@ module AvaTax
       # ### 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.
-      # * 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 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[]]
@@ -130,8 +169,8 @@ module AvaTax
       # ### 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.
-      # * 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 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
@@ -149,8 +188,8 @@ module AvaTax
       # ### 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.
-      # * 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 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]
@@ -170,8 +209,8 @@ module AvaTax
       # ### 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.
-      # * 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 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[]]
@@ -188,8 +227,8 @@ module AvaTax
       # ### 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.
-      # * 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 companyId [Integer] The ID of the company that owns this filing calendar
       # @param id [Integer] The primary key of this filing calendar
       # @return [Object]
@@ -208,8 +247,8 @@ module AvaTax
       # ### 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.
-      # * 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 companyId [Integer] The ID of the company that owns this filing calendar
       # @param id [Integer] The primary key of this filing calendar
       # @return [Object]
@@ -226,10 +265,10 @@ module AvaTax
       # ### 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.
-      # * 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 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:* formCountry, formRegion, taxFormCode, taxAuthorityId, taxAuthorityName, taxAuthorityType, settings
+      # @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`.
@@ -251,8 +290,8 @@ module AvaTax
       # ### 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.
-      # * 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 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/).
@@ -275,8 +314,8 @@ module AvaTax
       # ### 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.
-      # * 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 [Object] The model of the login information we are verifying
       # @return [Object]
       def login_verification_request(model)
@@ -295,8 +334,8 @@ module AvaTax
       # ### 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.
-      # * 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 jobId [Integer] The unique ID number of this login request
       # @return [Object]
       def login_verification_status(jobId)
@@ -314,9 +353,9 @@ module AvaTax
       # ### 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.
-      # * 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.
-      # @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:* formCountry, formRegion, taxFormCode, taxAuthorityId, taxAuthorityName, taxAuthorityType, settings
+      # * 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`.
@@ -339,8 +378,8 @@ module AvaTax
       # ### 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.
-      # * 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 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.
@@ -366,8 +405,8 @@ module AvaTax
       # ### 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.
-      # * 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 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.
@@ -390,8 +429,8 @@ module AvaTax
       # ### 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.
-      # * 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 filingCalendarId [Integer] Specific filing calendar id for the request
       # @param model [Object] Query object to filter, sort and paginate the filing calendars.
       # @return [FetchResult]
@@ -414,8 +453,8 @@ module AvaTax
       # ### 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.
-      # * 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 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
@@ -433,8 +472,8 @@ module AvaTax
       # ### 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.
-      # * 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 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.
@@ -454,8 +493,8 @@ module AvaTax
       # ### 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.
-      # * 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 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

data/lib/avatax/client/filings.rb

@@ -3,6 +3,309 @@ module AvaTax
     module Filings 
 
 
+      # Approve all filings for the specified company in the given filing period.
+      #
+      # This API is available by invitation only.
+      # Approving a return means the customer is ready to let Avalara file that return.
+      # Customer either approves themselves from admin console,
+      # else system auto-approves the night before the filing cycle.
+      # Sometimes Compliance has to manually unapprove and reapprove to modify liability or filing for the customer.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filings.
+      # @param year [Integer] The year of the filing period to approve.
+      # @param month [Integer] The month of the filing period to approve.
+      # @param model [Object] The approve request you wish to execute.
+      # @return [FilingModel[]]
+      def approve_filings(companyId, year, month, model)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/approve"
+        post(path, model)
+      end
+
+
+      # Approve all filings for the specified company in the given filing period and country.
+      #
+      # This API is available by invitation only.
+      # Approving a return means the customer is ready to let Avalara file that return.
+      # Customer either approves themselves from admin console,
+      # else system auto-approves the night before the filing cycle.
+      # Sometimes Compliance has to manually unapprove and reapprove to modify liability or filing for the customer.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filings.
+      # @param year [Integer] The year of the filing period to approve.
+      # @param month [Integer] The month of the filing period to approve.
+      # @param country [String] The two-character ISO-3166 code for the country.
+      # @param model [Object] The approve request you wish to execute.
+      # @return [FilingModel[]]
+      def approve_filings_country(companyId, year, month, country, model)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/approve"
+        post(path, model)
+      end
+
+
+      # Approve all filings for the specified company in the given filing period, country and region.
+      #
+      # This API is available by invitation only.
+      # Approving a return means the customer is ready to let Avalara file that return.
+      # Customer either approves themselves from admin console,
+      # else system auto-approves the night before the filing cycle
+      # Sometimes Compliance has to manually unapprove and reapprove to modify liability or filing for the customer.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filings.
+      # @param year [Integer] The year of the filing period to approve.
+      # @param month [Integer] The month of the filing period to approve.
+      # @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 model [Object] The approve request you wish to execute.
+      # @return [FilingModel[]]
+      def approve_filings_country_region(companyId, year, month, country, region, model)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/approve"
+        post(path, model)
+      end
+
+
+      # Add an adjustment to a given filing.
+      #
+      # This API is available by invitation only.
+      # An "Adjustment" is usually an increase or decrease to customer funding to Avalara,
+      # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
+      # Sometimes may be a manual change in tax liability similar to an augmentation.
+      # This API creates a new adjustment for an existing tax filing.
+      # This API can only be used when the filing has not yet been 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 ID of the company that owns the filing being adjusted.
+      # @param year [Integer] The year of the filing's filing period being adjusted.
+      # @param month [Integer] The month of the filing's filing period being adjusted.
+      # @param country [String] The two-character ISO-3166 code for the country of the filing being adjusted.
+      # @param region [String] The two or three character region code for the region.
+      # @param formCode [String] The unique code of the form being adjusted.
+      # @param model [FilingAdjustmentModel[]] A list of Adjustments to be created for the specified filing.
+      # @return [FilingAdjustmentModel[]]
+      def create_return_adjustment(companyId, year, month, country, region, formCode, model)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/#{formCode}/adjust"
+        post(path, model)
+      end
+
+
+      # Add an augmentation for a given filing.
+      #
+      # This API is available by invitation only.
+      # An "Augmentation" is a manually added increase or decrease in tax liability, by either customer or Avalara
+      # usually due to customer wanting to report tax Avatax does not support, e.g. bad debts, rental tax.
+      # This API creates a new augmentation for an existing tax filing.
+      # This API can only be used when the filing has not been approved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filing being changed.
+      # @param year [Integer] The month of the filing's filing period being changed.
+      # @param month [Integer] The month of the filing's filing period being changed.
+      # @param country [String] The two-character ISO-3166 code for the country of the filing being changed.
+      # @param region [String] The two or three character region code for the region of the filing being changed.
+      # @param formCode [String] The unique code of the form being changed.
+      # @param model [FilingAugmentationModel[]] A list of augmentations to be created for the specified filing.
+      # @return [FilingAugmentationModel[]]
+      def create_return_augmentation(companyId, year, month, country, region, formCode, model)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/#{formCode}/augment"
+        post(path, model)
+      end
+
+
+      # Add an payment to a given filing.
+      #
+      # This API is available by invitation only.
+      # An "Payment" is usually an increase or decrease to customer funding to Avalara,
+      # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
+      # Sometimes may be a manual change in tax liability similar to an augmentation.
+      # This API creates a new payment for an existing tax filing.
+      # This API can only be used when the filing has not yet been approved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filing being adjusted.
+      # @param year [Integer] The year of the filing's filing period being adjusted.
+      # @param month [Integer] The month of the filing's filing period being adjusted.
+      # @param country [String] The two-character ISO-3166 code for the country of the filing being adjusted.
+      # @param region [String] The two or three character region code for the region.
+      # @param formCode [String] The unique code of the form being adjusted.
+      # @param model [FilingPaymentModel[]] A list of Payments to be created for the specified filing.
+      # @return [FilingPaymentModel[]]
+      def create_return_payment(companyId, year, month, country, region, formCode, model)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/#{formCode}/payment"
+        post(path, model)
+      end
+
+
+      # Delete an adjustment for a given filing.
+      #
+      # This API is available by invitation only.
+      # An "Adjustment" is usually an increase or decrease to customer funding to Avalara,
+      # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
+      # Sometimes may be a manual change in tax liability similar to an augmentation.
+      # This API deletes an adjustment for an existing tax filing.
+      # This API can only be used when the filing has been unapproved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filing being adjusted.
+      # @param id [Integer] The ID of the adjustment being deleted.
+      # @param type [String] The type of adjustment that you are trying to delete.
+      # @return [ErrorDetail[]]
+      def delete_return_adjustment(companyId, id, options={})
+        path = "/api/v2/companies/#{companyId}/filings/adjust/#{id}"
+        delete(path, options)
+      end
+
+
+      # Delete an augmentation for a given filing.
+      #
+      # This API is available by invitation only.
+      # An "Augmentation" is a manually added increase or decrease in tax liability, by either customer or Avalara
+      # usually due to customer wanting to report tax Avatax does not support, e.g. bad debts, rental tax.
+      # This API deletes an augmentation for an existing tax filing.
+      # This API can only be used when the filing has been unapproved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filing being changed.
+      # @param id [Integer] The ID of the augmentation being added.
+      # @return [ErrorDetail[]]
+      def delete_return_augmentation(companyId, id)
+        path = "/api/v2/companies/#{companyId}/filings/augment/#{id}"
+        delete(path)
+      end
+
+
+      # Delete an payment for a given filing.
+      #
+      # This API is available by invitation only.
+      # An "Payment" is usually an increase or decrease to customer funding to Avalara,
+      # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
+      # Sometimes may be a manual change in tax liability similar to an augmentation.
+      # This API deletes an payment for an existing tax filing.
+      # This API can only be used when the filing has been unapproved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filing being adjusted.
+      # @param id [Integer] The ID of the payment being deleted.
+      # @return [ErrorDetail[]]
+      def delete_return_payment(companyId, id)
+        path = "/api/v2/companies/#{companyId}/filings/payment/#{id}"
+        delete(path)
+      end
+
+
+      # Retrieve worksheet checkup report for company and filing period.
+      #
+      # 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 filingsId [Integer] The unique id of the worksheet.
+      # @param companyId [Integer] The unique ID of the company that owns the worksheet.
+      # @return [Object]
+      def filings_checkup_report(filingsId, companyId)
+        path = "/api/v2/companies/#{companyId}/filings/#{filingsId}/checkup"
+        get(path)
+      end
+
+
+      # Retrieve worksheet checkup report for company and filing period.
+      #
+      # 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 worksheets object.
+      # @param year [Integer] The year of the filing period.
+      # @param month [Integer] The month of the filing period.
+      # @return [Object]
+      def filings_checkup_reports(companyId, year, month)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/checkup"
+        get(path)
+      end
+
+
+      # Retrieve a list of filings for the specified accrual 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.
+      # @param companyId [Integer] The ID of the company that owns these batches
+      # @param filingReturnId [Integer] The ID of the accrual return
+      # @return [FetchResult]
+      def get_accrual_fillings(companyId, filingReturnId)
+        path = "/api/v2/companies/#{companyId}/filings/accrual/#{filingReturnId}"
+        get(path)
+      end
+
+
+      # Retrieve a single attachment for a filing
+      #
+      # 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 ID of the company that owns the filings.
+      # @param filingReturnId [Integer] The unique id of the worksheet return.
+      # @param fileId [Integer] The unique id of the document you are downloading
+      # @return [Object]
+      def get_filing_attachment(companyId, filingReturnId, options={})
+        path = "/api/v2/companies/#{companyId}/filings/#{filingReturnId}/attachment"
+        get(path, options)
+      end
+
+
       # Retrieve a list of filings for the specified company in the year and month of a given filing period.
       #
       # This API is available by invitation only.
@@ -12,7 +315,7 @@ module AvaTax
       # ### 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.
+      # * 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 the filings.
       # @param year [Integer] The year of the filing period.
@@ -33,7 +336,7 @@ module AvaTax
       # ### 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.
+      # * 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 the filings.
       # @param year [Integer] The year of the filing period.
@@ -44,6 +347,313 @@ module AvaTax
         get(path)
       end
 
+
+      # Retrieve a filing for the specified company and id.
+      #
+      # This API is available by invitation only.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      #
+      # ### 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 ID of the company that owns the filings.
+      # @param id [Integer] The id of the filing return your retrieving
+      # @param details [Boolean] Indicates if you would like the credit details returned
+      # @return [Object]
+      def get_filing_return(companyId, id, options={})
+        path = "/api/v2/companies/#{companyId}/filings/returns/#{id}"
+        get(path, options)
+      end
+
+
+      # Retrieve a list of filings for the specified company in the year and month of a given filing period.
+      #
+      # This API is available by invitation only.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      #
+      # ### 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 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 companyId [Integer] The ID of the company that owns the filings.
+      # @param year [Integer] The year of the filing period.
+      # @param month [Integer] The two digit month of the filing period.
+      # @return [FetchResult]
+      def get_filings(companyId, year, month)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}"
+        get(path)
+      end
+
+
+      # Retrieve a list of filings for the specified company in the given filing period and country.
+      #
+      # This API is available by invitation only.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      #
+      # ### 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 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 companyId [Integer] The ID of the company that owns the filings.
+      # @param year [Integer] The year of the filing period.
+      # @param month [Integer] The two digit month of the filing period.
+      # @param country [String] The two-character ISO-3166 code for the country.
+      # @return [FetchResult]
+      def get_filings_by_country(companyId, year, month, country)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}"
+        get(path)
+      end
+
+
+      # Retrieve a list of filings for the specified company in the filing period, country and region.
+      #
+      # This API is available by invitation only.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      #
+      # ### 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 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 companyId [Integer] The ID of the company that owns the filings.
+      # @param year [Integer] The year of the filing period.
+      # @param month [Integer] The two digit month of the filing period.
+      # @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.
+      # @return [FetchResult]
+      def get_filings_by_country_region(companyId, year, month, country, region)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}"
+        get(path)
+      end
+
+
+      # Retrieve a list of filings for the specified company in the given filing period, country, region and form.
+      #
+      # This API is available by invitation only.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      #
+      # ### 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 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 companyId [Integer] The ID of the company that owns the filings.
+      # @param year [Integer] The year of the filing period.
+      # @param month [Integer] The two digit month of the filing period.
+      # @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 formCode [String] The unique code of the form.
+      # @return [FetchResult]
+      def get_filings_by_return_name(companyId, year, month, country, region, formCode)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/#{formCode}"
+        get(path)
+      end
+
+
+      # Retrieve a list of filings for the specified company in the year and month of a given filing period.
+      # This gets the basic information from the filings and doesn't include anything extra.
+      #
+      # ### 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 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 companyId [Integer] The ID of the company that owns these batches
+      # @param endPeriodMonth [Integer] The month of the period you are trying to retrieve
+      # @param endPeriodYear [Integer] The year of the period you are trying to retrieve
+      # @param frequency [String] The frequency of the return you are trying to retrieve (See FilingFrequencyId::* for a list of allowable values)
+      # @param status [String] The status of the return(s) you are trying to retrieve (See FilingStatusId::* for a list of allowable values)
+      # @param country [String] The country of the return(s) you are trying to retrieve
+      # @param region [String] The region of the return(s) you are trying to retrieve
+      # @param filingCalendarId [Integer] The filing calendar id of the return you are trying to retrieve
+      # @return [FetchResult]
+      def get_filings_returns(companyId, options={})
+        path = "/api/v2/companies/#{companyId}/filings/returns"
+        get(path, options)
+      end
+
+
+      # Retrieve a list of filings for the specified company in the year and month of a given filing period.
+      #
+      # This API is available by invitation only.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      #
+      # ### 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 ID of the company that owns the filings.
+      # @param year [Integer] The year of the filing period.
+      # @param month [Integer] The two digit month of the filing period.
+      # @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 formCode [String] The unique code of the form.
+      # @return [FetchResult]
+      def get_tax_filings(companyId, options={})
+        path = "/api/v2/companies/#{companyId}/filings"
+        get(path, options)
+      end
+
+
+      # Rebuild a set of filings for the specified company in the given filing period.
+      #
+      # This API is available by invitation only.
+      # Rebuilding a return means re-creating or updating the amounts to be filed (worksheet) for a filing.
+      # Rebuilding has to be done whenever a customer adds transactions to a filing.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      # This API requires filing to be unapproved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 companyId [Integer] The ID of the company that owns the filings.
+      # @param year [Integer] The year of the filing period to be rebuilt.
+      # @param month [Integer] The month of the filing period to be rebuilt.
+      # @param model [Object] The rebuild request you wish to execute.
+      # @return [FetchResult]
+      def rebuild_filings(companyId, year, month, model)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/rebuild"
+        post(path, model)
+      end
+
+
+      # Rebuild a set of filings for the specified company in the given filing period and country.
+      #
+      # This API is available by invitation only.
+      # Rebuilding a return means re-creating or updating the amounts to be filed (worksheet) for a filing.
+      # Rebuilding has to be done whenever a customer adds transactions to a filing.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      # This API requires filing to be unapproved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 companyId [Integer] The ID of the company that owns the filings.
+      # @param year [Integer] The year of the filing period to be rebuilt.
+      # @param month [Integer] The month of the filing period to be rebuilt.
+      # @param country [String] The two-character ISO-3166 code for the country.
+      # @param model [Object] The rebuild request you wish to execute.
+      # @return [FetchResult]
+      def rebuild_filings_by_country(companyId, year, month, country, model)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/rebuild"
+        post(path, model)
+      end
+
+
+      # Rebuild a set of filings for the specified company in the given filing period, country and region.
+      #
+      # This API is available by invitation only.audit.CheckAuthorizationReturns(null, companyId);
+      # Rebuilding a return means re-creating or updating the amounts to be filed for a filing.
+      # Rebuilding has to be done whenever a customer adds transactions to a filing.
+      # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,
+      # based on filing frequency of filing.
+      # This API requires filing to be unapproved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 companyId [Integer] The ID of the company that owns the filings.
+      # @param year [Integer] The year of the filing period to be rebuilt.
+      # @param month [Integer] The month of the filing period to be rebuilt.
+      # @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 model [Object] The rebuild request you wish to execute.
+      # @return [FetchResult]
+      def rebuild_filings_by_country_region(companyId, year, month, country, region, model)
+        path = "/api/v2/companies/#{companyId}/filings/#{year}/#{month}/#{country}/#{region}/rebuild"
+        post(path, model)
+      end
+
+
+      # Edit an adjustment for a given filing.
+      #
+      # This API is available by invitation only.
+      # An "Adjustment" is usually an increase or decrease to customer funding to Avalara,
+      # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
+      # Sometimes may be a manual change in tax liability similar to an augmentation.
+      # This API modifies an adjustment for an existing tax filing.
+      # This API can only be used when the filing has not yet been approved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filing being adjusted.
+      # @param id [Integer] The ID of the adjustment being edited.
+      # @param model [Object] The updated Adjustment.
+      # @return [Object]
+      def update_return_adjustment(companyId, id, model)
+        path = "/api/v2/companies/#{companyId}/filings/adjust/#{id}"
+        put(path, model)
+      end
+
+
+      # Edit an augmentation for a given filing.
+      #
+      # This API is available by invitation only.
+      # An "Augmentation" is a manually added increase or decrease in tax liability, by either customer or Avalara
+      # usually due to customer wanting to report tax Avatax does not support, e.g. bad debts, rental tax.
+      # This API modifies an augmentation for an existing tax filing.
+      # This API can only be used when the filing has not been approved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filing being changed.
+      # @param id [Integer] The ID of the augmentation being edited.
+      # @param model [Object] The updated Augmentation.
+      # @return [Object]
+      def update_return_augmentation(companyId, id, model)
+        path = "/api/v2/companies/#{companyId}/filings/augment/#{id}"
+        put(path, model)
+      end
+
+
+      # Edit an payment for a given filing.
+      #
+      # This API is available by invitation only.
+      # An "Payment" is usually an increase or decrease to customer funding to Avalara,
+      # such as early filer discount amounts that are refunded to the customer, or efile fees from websites.
+      # Sometimes may be a manual change in tax liability similar to an augmentation.
+      # This API modifies an payment for an existing tax filing.
+      # This API can only be used when the filing has not yet been approved.
+      #
+      # ### Security Policies
+      #
+      # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, Compliance Root User, ComplianceAdmin, CSPTester, FirmUser, SSTAdmin, TechnicalSupportAdmin.
+      # * 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 the filing being adjusted.
+      # @param id [Integer] The ID of the payment being edited.
+      # @param model [Object] The updated Payment.
+      # @return [Object]
+      def update_return_payment(companyId, id, model)
+        path = "/api/v2/companies/#{companyId}/filings/payment/#{id}"
+        put(path, model)
+      end
+
     end
   end
 end