Module: AvaTax::Client::Definitions

Included in:
AvaTax::Client
Defined in:
lib/avatax/client/definitions.rb

Instance Method Summary collapse

Instance Method Details

#get_cross_border_code(country, hsCode) ⇒ FetchResult

Lists all parents of an HS Code.

Retrieves the specified HS code and all of its parents, reflecting all sections, chapters, headings, and subheadings

a list of HS Codes that are the parents and information branches of the HS Code for the given destination country, if lower detail is available.

This API will include information branches if applicable. These do not have HS Codes and cannot be referenced, but can contain information relevant to deciding the correct HS Code.

This API is intended to be useful to review the descriptive hierarchy of an HS Code, which can be particularly helpful when HS Codes can have multiple levels of generic descriptions.

Security Policies

  • This API depends on the following active services:Required (all): AvaTaxGlobal. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The name or code of the destination country.

  • hsCode (String) —

    The partial or full HS Code for which you would like to view all of the parents.

Returns:

  • (FetchResult) 


26
27
 
# File 'lib/avatax/client/definitions.rb', line 26

def get_cross_border_code(country, hsCode)        path = "/api/v2/definitions/crossborder/#{country}/#{hsCode}/hierarchy"
get(path, {}, AvaTax::VERSION)      end

#list_all_marketplace_locations(options = {}) ⇒ FetchResult

List all market place locations.

List all market place locations. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


38
39
 
# File 'lib/avatax/client/definitions.rb', line 38

def list_all_marketplace_locations(options={})        path = "/api/v2/definitions/listallmarketplacelocations"
get(path, options, AvaTax::VERSION)      end

#list_all_unit_of_basis(options = {}) ⇒ FetchResult

Retrieve the list of all valid unit of basis

Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: attributesUsed

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


50
51
 
# File 'lib/avatax/client/definitions.rb', line 50

def list_all_unit_of_basis(options={})        path = "/api/v2/definitions/unitofbasis"
get(path, options, AvaTax::VERSION)      end

#list_ava_file_forms(options = {}) ⇒ FetchResult

Retrieve the full list of the AvaFile Forms available

This API is deprecated.

Please use the ListTaxForms API.

Returns the full list of Avalara-supported AvaFile Forms This API is intended to be useful to identify all the different AvaFile Forms Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: outletTypeId

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


67
68
 
# File 'lib/avatax/client/definitions.rb', line 67

def list_ava_file_forms(options={})        path = "/api/v2/definitions/avafileforms"
get(path, options, AvaTax::VERSION)      end

#list_certificate_attributes(options = {}) ⇒ FetchResult

List certificate attributes used by a company

List the certificate attributes defined by a company either specified by the user or the user's default company.

A certificate may have multiple attributes that control its behavior. You may apply or remove attributes to a certificate at any time.

If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to check and provision account. Swagger Name: AvaTaxClient

Parameters:

  • companyid (Integer) —

    Id of the company the user wish to fetch the certificates' attributes from. If not specified the API will use user's default company.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


86
87
 
# File 'lib/avatax/client/definitions.rb', line 86

def list_certificate_attributes(options={})        path = "/api/v2/definitions/certificateattributes"
get(path, options, AvaTax::VERSION)      end

#list_certificate_exempt_reasons(options = {}) ⇒ FetchResult

List the certificate exempt reasons defined by a company

List the certificate exempt reasons defined by a company.

An exemption reason defines why a certificate allows a customer to be exempt for purposes of tax calculation.

If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to check and provision account. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


104
105
 
# File 'lib/avatax/client/definitions.rb', line 104

def list_certificate_exempt_reasons(options={})        path = "/api/v2/definitions/certificateexemptreasons"
get(path, options, AvaTax::VERSION)      end

#list_certificate_exposure_zones(options = {}) ⇒ FetchResult

List certificate exposure zones used by a company

List the certificate exposure zones defined by a company.

An exposure zone is a location where a certificate can be valid. Exposure zones may indicate a taxing authority or other legal entity to which a certificate may apply.

If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to check and provision account. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: id, companyId, name, tag, description, created, modified, region, country

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


122
123
 
# File 'lib/avatax/client/definitions.rb', line 122

def list_certificate_exposure_zones(options={})        path = "/api/v2/definitions/certificateexposurezones"
get(path, options, AvaTax::VERSION)      end

#list_classification_parameters_usage(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported usage of extra parameters for classification of a item.

Returns the full list of Avalara-supported usage of extra parameters for item classification. The list of parameters is available for use with Item Classification. Some parameters are only available for use if you have subscribed to certain features of AvaTax. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: attributeSubType, values

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


136
137
 
# File 'lib/avatax/client/definitions.rb', line 136

def list_classification_parameters_usage(options={})        path = "/api/v2/definitions/classification/parametersusage"
get(path, options, AvaTax::VERSION)      end

#list_communications_service_types(id, options = {}) ⇒ FetchResult

Retrieve the full list of communications service types

Returns full list of service types for a given transaction type ID. Swagger Name: AvaTaxClient

Parameters:

  • id (Integer) —

    The transaction type ID to examine

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: requiredParameters

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


149
150
 
# File 'lib/avatax/client/definitions.rb', line 149

def list_communications_service_types(id, options={})        path = "/api/v2/definitions/communications/transactiontypes/#{id}/servicetypes"
get(path, options, AvaTax::VERSION)      end

#list_communications_t_s_pairs(options = {}) ⇒ FetchResult

Retrieve the full list of communications transaction/service type pairs

Returns full list of communications transaction/service type pairs which are accepted in communication tax calculation requests. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: requiredParameters

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


175
176
 
# File 'lib/avatax/client/definitions.rb', line 175

def list_communications_t_s_pairs(options={})        path = "/api/v2/definitions/communications/tspairs"
get(path, options, AvaTax::VERSION)      end

#list_communications_transaction_types(options = {}) ⇒ FetchResult

Retrieve the full list of communications transactiontypes

Returns full list of communications transaction types which are accepted in communication tax calculation requests. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


162
163
 
# File 'lib/avatax/client/definitions.rb', line 162

def list_communications_transaction_types(options={})        path = "/api/v2/definitions/communications/transactiontypes"
get(path, options, AvaTax::VERSION)      end

#list_countries(options = {}) ⇒ FetchResult

List all ISO 3166 countries

Returns a list of ISO 3166 country codes based on the scope filter. This API is intended to be useful when presenting a dropdown box in your website to allow customers to select a country for a shipping address.

Scope options:

  • Custom: Return only countries for which there is a TaxTypeMapping with IsCustomContent = true (requires subscription)
  • All (default): Return all ISO 3166 countries Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: alpha3Code, isEuropeanUnion, localizedNames, addressesRequireRegion

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • scope (String) —

    Optional query parameter to filter by Custom or All countries (default: All) (See ContentScope::* for a list of allowable values)

Returns:

  • (FetchResult) 


194
195
 
# File 'lib/avatax/client/definitions.rb', line 194

def list_countries(options={})        path = "/api/v2/definitions/countries"
get(path, options, AvaTax::VERSION)      end

#list_cover_letters(options = {}) ⇒ FetchResult

List certificate exposure zones used by a company

List available cover letters that can be used when sending invitation to use CertExpress to upload certificates.

The CoverLetter model represents a message sent along with an invitation to use CertExpress to upload certificates. An invitation allows customers to use CertExpress to upload their exemption certificates directly; this cover letter explains why the invitation was sent.

If you see the 'CertCaptureNotConfiguredError', please use CheckProvision and RequestProvision endpoints to check and provision account. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: id, companyId, subject, description, createdDate, modifiedDate, pageCount, templateFilename, version

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


213
214
 
# File 'lib/avatax/client/definitions.rb', line 213

def list_cover_letters(options={})        path = "/api/v2/definitions/coverletters"
get(path, options, AvaTax::VERSION)      end

#list_cross_border_codes(country, hsCode, options = {}) ⇒ FetchResult

Lists the next level of HS Codes given a destination country and HS Code prefix.

Retrieves a list of HS Codes that are the children of the prefix for the given destination country, if additional children are available.

HS Code is interchangeable with "tariff code" and definitions are generally unique to a destination country. An HS Code describes an item and its eligibility/rate for tariffs. HS Codes are organized by Section/Chapter/Heading/Subheading/Classification.

This API is intended to be useful to identify the correct HS Code to use for your item.

Security Policies

  • This API depends on the following active services:Required (all): AvaTaxGlobal. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The name or code of the destination country.

  • hsCode (String) —

    The Section or partial HS Code for which you would like to view the next level of HS Code detail, if more detail is available.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: hsCodeSource, system, destinationCountry, isDecisionNode, zeroPaddingCount, isSystemDefined, isTaxable, effDate, endDate, hsCodeSourceLength

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


238
239
 
# File 'lib/avatax/client/definitions.rb', line 238

def list_cross_border_codes(country, hsCode, options={})        path = "/api/v2/definitions/crossborder/#{country}/#{hsCode}"
get(path, options, AvaTax::VERSION)      end

#list_cross_border_sections ⇒ FetchResult

List top level HS Code Sections.

Returns the full list of top level HS Code Sections. Sections are the broadest level of detail for classifying tariff codes and the items to which they apply. HS Codes are organized by Section/Chapter/Heading/Subheading/Classification.

This API is intended to be useful to identify the top level Sections for further LandedCost HS Code lookups.

Security Policies

  • This API depends on the following active services:Required (all): AvaTaxGlobal. Swagger Name: AvaTaxClient

Returns:

  • (FetchResult) 


255
256
 
# File 'lib/avatax/client/definitions.rb', line 255

def list_cross_border_sections()        path = "/api/v2/definitions/crossborder/sections"
get(path, {}, AvaTax::VERSION)      end

#list_currencies(options = {}) ⇒ FetchResult

List all ISO 4217 currencies supported by AvaTax.

Lists all ISO 4217 currencies supported by AvaTax.

This API produces a list of currency codes that can be used when calling AvaTax. The values from this API can be used to fill out the currencyCode field in a CreateTransactionModel. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


270
271
 
# File 'lib/avatax/client/definitions.rb', line 270

def list_currencies(options={})        path = "/api/v2/definitions/currencies"
get(path, options, AvaTax::VERSION)      end

#list_entity_use_codes(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported entity use codes

Returns the full list of Avalara-supported entity use codes. Entity/Use Codes are definitions of the entity who is purchasing something, or the purpose for which the transaction is occurring. This information is generally used to determine taxability of the product. In order to facilitate correct reporting of your taxes, you are encouraged to select the proper entity use codes for all transactions that are exempt. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: validCountries

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


286
287
 
# File 'lib/avatax/client/definitions.rb', line 286

def list_entity_use_codes(options={})        path = "/api/v2/definitions/entityusecodes"
get(path, options, AvaTax::VERSION)      end

#list_filing_frequencies(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported filing frequencies.

Returns the full list of Avalara-supported filing frequencies. This API is intended to be useful to identify all the different filing frequencies that can be used in notices. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


299
300
 
# File 'lib/avatax/client/definitions.rb', line 299

def list_filing_frequencies(options={})        path = "/api/v2/definitions/filingfrequencies"
get(path, options, AvaTax::VERSION)      end

#list_item_h_s_code_classification_status ⇒ ItemHSCodeClassificationStatusOutputModel[]

List of all HS code classification statuses that can be assigned to an Item.

Security Policies

  • This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, AvaTaxOnlyAccountAdmin, AvaTaxOnlyAccountUser, AvaTaxOnlyCompanyAdmin, AvaTaxOnlyCompanyUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ReturnsOnlyAccountAdmin, ReturnsOnlyAccountUser, ReturnsOnlyCompanyAdmin, ReturnsOnlyCompanyUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. Swagger Name: AvaTaxClient

Returns:

  • (ItemHSCodeClassificationStatusOutputModel[]) 


309
310
 
# File 'lib/avatax/client/definitions.rb', line 309

def list_item_h_s_code_classification_status()        path = "/api/v2/definitions/items/hscode-classification-status"
get(path, {}, AvaTax::VERSION)      end

#list_item_reverse_sync_events ⇒ ItemReverseSyncEventDefinitionOutputModel[]

List of all event types that can be subscribed to for Item reverse sync webhook registrations.

Security Policies

  • This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, AvaTaxOnlyAccountAdmin, AvaTaxOnlyAccountUser, AvaTaxOnlyCompanyAdmin, AvaTaxOnlyCompanyUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ReturnsOnlyAccountAdmin, ReturnsOnlyAccountUser, ReturnsOnlyCompanyAdmin, ReturnsOnlyCompanyUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. Swagger Name: AvaTaxClient

Returns:

  • (ItemReverseSyncEventDefinitionOutputModel[]) 


319
320
 
# File 'lib/avatax/client/definitions.rb', line 319

def list_item_reverse_sync_events()        path = "/api/v2/definitions/items/events"
get(path, {}, AvaTax::VERSION)      end

#list_items_recommendations_status ⇒ ItemTaxCodeRecommendationStatusModel[]

List of all recommendation status which can be assigned to an item

Security Policies

  • This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, AvaTaxOnlyAccountAdmin, AvaTaxOnlyAccountUser, AvaTaxOnlyCompanyAdmin, AvaTaxOnlyCompanyUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ReturnsOnlyAccountAdmin, ReturnsOnlyAccountUser, ReturnsOnlyCompanyAdmin, ReturnsOnlyCompanyUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. Swagger Name: AvaTaxClient

Returns:

  • (ItemTaxCodeRecommendationStatusModel[]) 


329
330
 
# File 'lib/avatax/client/definitions.rb', line 329

def list_items_recommendations_status()        path = "/api/v2/definitions/items/recommendationstatus"
get(path, {}, AvaTax::VERSION)      end

#list_items_status ⇒ ItemStatusModel[]

List of all possible status which can be assigned to an item

Security Policies

  • This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, AvaTaxOnlyAccountAdmin, AvaTaxOnlyAccountUser, AvaTaxOnlyCompanyAdmin, AvaTaxOnlyCompanyUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ReturnsOnlyAccountAdmin, ReturnsOnlyAccountUser, ReturnsOnlyCompanyAdmin, ReturnsOnlyCompanyUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. Swagger Name: AvaTaxClient

Returns:

  • (ItemStatusModel[]) 


339
340
 
# File 'lib/avatax/client/definitions.rb', line 339

def list_items_status()        path = "/api/v2/definitions/items/status"
get(path, {}, AvaTax::VERSION)      end

#list_jurisdiction_tax_types_and_sub_types(country, region, jurisdictionTypeId, jurisdictionCode, options = {}) ⇒ FetchResult

List tax types, subtypes, and rate types applicable for a given jurisdiction

Returns a list of tax type and subtype groups, and optionally the available rate types for each group, applicable for a given jurisdiction.

This API lets you filter tax types and rate types based on whether they may apply in a given jurisdiction and provides a description of each.

If a company ID is provided, then only the tax types for which the company has nexus are shown.

If custom content is included, then all available custom tax types are included in the result if the calling user has the appropriate subscription and the tax types are available in the jurisdiction's country. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    ISO country code (e.g. US)

  • region (String) —

    ISO region or state/province code (e.g. CA for California)

  • jurisdictionTypeId (String) —

    Jurisdiction type identifier (e.g. STA for state)

  • jurisdictionCode (String) —

    Code identifying a specific jurisdiction

  • companyId (Integer) —

    Optional query parameter. When set, tax type/subtype pairs are filtered to those which correspond to the company's configured nexus. When omitted, no nexus-based filtering is applied.

  • effectiveDate (DateTime) —

    Optional query parameter. When companyId is not provided, this is the date used to filter effective tax types and rate types. Defaults to the current date.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: rateTypes

  • includeCustomContent (Boolean) —

    When true, merges in potentially applicable custom tax types and subtypes into result (i.e. for which no system content is defined). Defaults to false.

  • includeRateTypes (Boolean) —

    Query parameter $includeRateTypes. When true (default), returns the rate types available for each tax type + subtype pair in the result.

Returns:

  • (FetchResult) 


455
456
 
# File 'lib/avatax/client/definitions.rb', line 455

def list_jurisdiction_tax_types_and_sub_types(country, region, jurisdictionTypeId, jurisdictionCode, options={})        path = "/api/v2/definitions/jurisdictions/#{country}/#{region}/#{jurisdictionTypeId}/#{jurisdictionCode}/taxTypesAndSubTypes"
get(path, options, AvaTax::VERSION)      end

#list_jurisdiction_types_by_rate_type_tax_type_mapping(country, taxTypeId, taxSubTypeId, options = {}) ⇒ string[]

List jurisdiction types based on the provided taxTypeId, taxSubTypeId, country, and rateTypeId

Returns a list of all applicable jurisdiction types based on country, taxTypeId, taxSubTypeId, and rateTypeId Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The country for which you want to retrieve the jurisdiction information

  • taxTypeId (String) —

    The taxtype for which you want to retrieve the jurisdiction information

  • taxSubTypeId (String) —

    The taxsubtype for which you want to retrieve the jurisdiction information

  • rateTypeId (String) —

    The ratetype for which you want to retrieve the jurisdiction information

  • includeCustomContent (Boolean) —

    Optional query parameter to include custom content jurisdiction types (default: false)

Returns:

  • (string[]) 


468
469
 
# File 'lib/avatax/client/definitions.rb', line 468

def list_jurisdiction_types_by_rate_type_tax_type_mapping(country, taxTypeId, taxSubTypeId, options={})        path = "/api/v2/definitions/jurisdictionTypes/countries/#{country}/taxtypes/#{taxTypeId}/taxsubtypes/#{taxSubTypeId}"
get(path, options, AvaTax::VERSION)      end

#list_jurisdictions(options = {}) ⇒ FetchResult

List jurisdictions based on the filter provided

Returns a list of all Avalara-supported taxing jurisdictions.

This API allows you to examine all Avalara-supported jurisdictions. You can filter your search by supplying SQL-like query for fetching only the ones you concerned about. For example: effectiveDate > '2016-01-01'

The rate, salesRate, and useRate fields are not available on the JurisdictionModels returned by this API. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: rate, salesRate, signatureCode, useRate, isAcm, isSst, createDate, isLocalAdmin, taxAuthorityTypeId

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • companyId (Integer) —

    Optional query parameter; when set, the result set is restricted to jurisdictions in regions where the company has nexus. When omitted, all jurisdiction rows are eligible before filter is applied.

Returns:

  • (FetchResult) 


357
358
 
# File 'lib/avatax/client/definitions.rb', line 357

def list_jurisdictions(options={})        path = "/api/v2/definitions/jurisdictions"
get(path, options, AvaTax::VERSION)      end

#list_jurisdictions_by_address(options = {}) ⇒ FetchResult

List jurisdictions near a specific address

Returns a list of all Avalara-supported taxing jurisdictions that apply to this address.

This API allows you to identify which jurisdictions are nearby a specific address according to the best available geocoding information. It is intended to allow you to create a "Jurisdiction Override", which allows an address to be configured as belonging to a nearby jurisdiction in AvaTax.

You can widen the search by supplying the optional radius parameter (in miles). Supported values are 5 (default), 10, 20, 30, and 40. If the desired tax region is not found at 5 miles, retry with a larger radius. This only affects tax-region retrieval for this request; it does not change tax calculation once a region is selected.

The results of this API call can be passed to the CreateJurisdictionOverride API call. Swagger Name: AvaTaxClient

Parameters:

  • line1 (String) —

    The first address line portion of this address.

  • line2 (String) —

    The second address line portion of this address.

  • line3 (String) —

    The third address line portion of this address.

  • city (String) —

    The city portion of this address.

  • region (String) —

    The region, state, or province code portion of this address.

  • postalCode (String) —

    The postal code or zip code portion of this address.

  • country (String) —

    The two-character ISO-3166 code of the country portion of this address.

  • radius (Integer) —

    Optional. The search radius in miles used to find nearby tax regions. Allowed values are 5, 10, 20, 30, and 40; when omitted the default of 5 miles is used. A larger radius widens the search for this request only and does not change the default behavior for other requests. Any other value is rejected with a validation error.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: country, Jurisdictions

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


387
388
 
# File 'lib/avatax/client/definitions.rb', line 387

def list_jurisdictions_by_address(options={})        path = "/api/v2/definitions/jurisdictionsnearaddress"
get(path, options, AvaTax::VERSION)      end

#list_jurisdictions_by_rate_type_tax_type_mapping(country, taxTypeId, taxSubTypeId, options = {}) ⇒ FetchResult

List jurisdictions based on the provided taxTypeId, taxSubTypeId, country, and rateTypeId

Returns a list of all Avalara-supported taxing jurisdictions filtered by taxTypeId, taxSubTypeId, country, and rateTypeId.

You can optionally pass region as a query parameter to retrieve jurisdictions that are under that region.

This API allows you to examine all Avalara-supported jurisdictions. You can filter your search by supplying SQL-like query for fetching only the ones you concerned about. For example: effectiveDate > '2016-01-01'

The jurisdictionType, effectiveDate, and endDate are filterable fields available on the JurisdictionRateTypeTaxTypeMappingModels returned by this API. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The country for which you want to retrieve the jurisdiction information

  • taxTypeId (String) —

    The taxtype for which you want to retrieve the jurisdiction information

  • taxSubTypeId (String) —

    The taxsubtype for which you want to retrieve the jurisdiction information

  • rateTypeId (Integer) —

    The ratetype for which you want to retrieve the jurisdiction information

  • region (String) —

    The region for which you want to retrieve the jurisdiction information

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: id, country, state, jurisdictionCode, longName, taxTypeId, taxSubTypeId, taxTypeGroupId, rateTypeId, stateFips

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • includeCustomContent (Boolean) —

    Optional query parameter to include custom content jurisdictions (default: false)

Returns:

  • (FetchResult) 


412
413
 
# File 'lib/avatax/client/definitions.rb', line 412

def list_jurisdictions_by_rate_type_tax_type_mapping(country, taxTypeId, taxSubTypeId, options={})        path = "/api/v2/definitions/jurisdictions/countries/#{country}/taxtypes/#{taxTypeId}/taxsubtypes/#{taxSubTypeId}"
get(path, options, AvaTax::VERSION)      end

#list_jurisdictions_hierarchy(options = {}) ⇒ FetchResult

List jurisdictions hierarchy based on the filter provided

Returns a list of all Avalara-supported taxing jurisdictions hirearchy.

This API Lists the hierarchical relationship of jurisdictions for US states, identifying the cities and special taxing jurisdictions (STJs) for a given county within a state.

The rate, salesRate, and useRate fields are not available on the JurisdictionHirearchyModels returned by this API. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: parentId, nexus, rate, salesRate, signatureCode, useRate, isAcm, isSst, createDate, isLocalAdmin, taxAuthorityTypeId

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


428
429
 
# File 'lib/avatax/client/definitions.rb', line 428

def list_jurisdictions_hierarchy(options={})        path = "/api/v2/definitions/jurisdictions/hierarchy"
get(path, options, AvaTax::VERSION)      end

#list_location_questions_by_address(options = {}) ⇒ FetchResult

Retrieve the list of questions that are required for a tax location

Returns the list of additional questions you must answer when declaring a location in certain taxing jurisdictions. Some tax jurisdictions require that you register or provide additional information to configure each physical place where your company does business. This information is not usually required in order to calculate tax correctly, but is almost always required to file your tax correctly. You can call this API call for any address and obtain information about what questions must be answered in order to properly file tax in that location. Swagger Name: AvaTaxClient

Parameters:

  • line1 (String) —

    The first line of this location's address.

  • line2 (String) —

    The second line of this location's address.

  • line3 (String) —

    The third line of this location's address.

  • city (String) —

    The city part of this location's address.

  • region (String) —

    The region, state, or province part of this location's address.

  • postalCode (String) —

    The postal code of this location's address.

  • country (String) —

    The country part of this location's address.

  • latitude (BigDecimal) —

    Optionally identify the location via latitude/longitude instead of via address.

  • longitude (BigDecimal) —

    Optionally identify the location via latitude/longitude instead of via address.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


494
495
 
# File 'lib/avatax/client/definitions.rb', line 494

def list_location_questions_by_address(options={})        path = "/api/v2/definitions/locationquestions"
get(path, options, AvaTax::VERSION)      end

#list_marketplace_locations(options = {}) ⇒ FetchResult

Retrieve the list of locations for a marketplace.

Retrieves the list of suggested locations for a marketplace. Swagger Name: AvaTaxClient

Parameters:

  • marketplaceId (String) —

    MarketplaceId of a marketplace

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


506
507
 
# File 'lib/avatax/client/definitions.rb', line 506

def list_marketplace_locations(options={})        path = "/api/v2/definitions/marketplacelocations"
get(path, options, AvaTax::VERSION)      end

#list_nexus(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported nexus for all countries and regions.

Returns the full list of all Avalara-supported nexus for all countries and regions.

This API is intended to be useful if your user interface needs to display a selectable list of nexus. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


520
521
 
# File 'lib/avatax/client/definitions.rb', line 520

def list_nexus(options={})        path = "/api/v2/definitions/nexus"
get(path, options, AvaTax::VERSION)      end

#list_nexus_by_address(options = {}) ⇒ FetchResult

List all nexus that apply to a specific address.

Returns a list of all Avalara-supported taxing jurisdictions that apply to this address. This API allows you to identify which tax authorities apply to a physical location, salesperson address, or point of sale. In general, it is usually expected that a company will declare nexus in all the jurisdictions that apply to each physical address where the company does business. The results of this API call can be passed to the 'Create Nexus' API call to declare nexus for this address. Swagger Name: AvaTaxClient

Parameters:

  • line1 (String) —

    The first address line portion of this address.

  • line2 (String) —

    The first address line portion of this address.

  • line3 (String) —

    The first address line portion of this address.

  • city (String) —

    The city portion of this address.

  • region (String) —

    Name or ISO 3166 code identifying the region portion of the address. This field supports many different region identifiers: * Two and three character ISO 3166 region codes * Fully spelled out names of the region in ISO supported languages * Common alternative spellings for many regions For a full list of all supported codes and names, please see the Definitions API ListRegions.

  • postalCode (String) —

    The postal code or zip code portion of this address.

  • country (String) —

    Name or ISO 3166 code identifying the country portion of this address. This field supports many different country identifiers: * Two character ISO 3166 codes * Three character ISO 3166 codes * Fully spelled out names of the country in ISO supported languages * Common alternative spellings for many countries For a full list of all supported codes and names, please see the Definitions API ListCountries.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


543
544
 
# File 'lib/avatax/client/definitions.rb', line 543

def list_nexus_by_address(options={})        path = "/api/v2/definitions/nexus/byaddress"
get(path, options, AvaTax::VERSION)      end

#list_nexus_by_country(country, options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported nexus for a country.

Returns all Avalara-supported nexus for the specified country.

This API is intended to be useful if your user interface needs to display a selectable list of nexus filtered by country. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The country in which you want to fetch the system nexus

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


558
559
 
# File 'lib/avatax/client/definitions.rb', line 558

def list_nexus_by_country(country, options={})        path = "/api/v2/definitions/nexus/#{country}"
get(path, options, AvaTax::VERSION)      end

#list_nexus_by_country_and_region(country, region, options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported nexus for a country and region.

Returns all Avalara-supported nexus for the specified country and region.

This API is intended to be useful if your user interface needs to display a selectable list of nexus filtered by country and region. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The two-character ISO-3166 code for the country.

  • region (String) —

    The two or three character region code for the region.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


574
575
 
# File 'lib/avatax/client/definitions.rb', line 574

def list_nexus_by_country_and_region(country, region, options={})        path = "/api/v2/definitions/nexus/#{country}/#{region}"
get(path, options, AvaTax::VERSION)      end

#list_nexus_by_form_code(formCode) ⇒ Object

List nexus related to a tax form

Retrieves a list of nexus related to a tax form.

The concept of Nexus indicates a place where your company has sufficient physical presence and is obligated to collect and remit transaction-based taxes.

When defining companies in AvaTax, you must declare nexus for your company in order to correctly calculate tax in all jurisdictions affected by your transactions.

This API is intended to provide useful information when examining a tax form. If you are about to begin filing a tax form, you may want to know whether you have declared nexus in all the jurisdictions related to that tax form in order to better understand how the form will be filled out.

Security Policies

  • This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, AvaTaxOnlyAccountAdmin, AvaTaxOnlyAccountUser, AvaTaxOnlyCompanyAdmin, AvaTaxOnlyCompanyUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, Compliance Root User, ComplianceAdmin, ComplianceUser, CSPAdmin, CSPTester, FirmAdmin, FirmUser, ReturnsOnlyAccountAdmin, ReturnsOnlyAccountUser, ReturnsOnlyCompanyAdmin, ReturnsOnlyCompanyUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. Swagger Name: AvaTaxClient

Parameters:

  • formCode (String) —

    The form code that we are looking up the nexus for

Returns:

  • (Object) 


597
598
 
# File 'lib/avatax/client/definitions.rb', line 597

def list_nexus_by_form_code(formCode)        path = "/api/v2/definitions/nexus/byform/#{formCode}"
get(path, {}, AvaTax::VERSION)      end

#list_nexus_by_tax_type_group(taxTypeGroup, options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported nexus for a tax type group.

Returns all Avalara-supported nexus for the specified specified tax type group.

This API is intended to be useful if your user interface needs to display a selectable list of nexus filtered by tax type group. Swagger Name: AvaTaxClient

Parameters:

  • taxTypeGroup (String) —

    The tax type group to fetch the supporting system nexus for.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: streamlinedSalesTax, isSSTActive, taxTypeGroup, taxAuthorityId, taxName, parameters

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


612
613
 
# File 'lib/avatax/client/definitions.rb', line 612

def list_nexus_by_tax_type_group(taxTypeGroup, options={})        path = "/api/v2/definitions/nexus/bytaxtypegroup/#{taxTypeGroup}"
get(path, options, AvaTax::VERSION)      end

#list_nexus_tax_type_groups(options = {}) ⇒ FetchResult

Retrieve the full list of nexus tax type groups

Returns the full list of Avalara-supported nexus tax type groups This API is intended to be useful to identify all the different tax sub-types. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: subscriptionTypeId, subscriptionDescription, tabName, showColumn

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


625
626
 
# File 'lib/avatax/client/definitions.rb', line 625

def list_nexus_tax_type_groups(options={})        path = "/api/v2/definitions/nexustaxtypegroups"
get(path, options, AvaTax::VERSION)      end

#list_notice_customer_funding_options(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax notice customer funding options.

Returns the full list of Avalara-supported tax notice customer funding options. This API is intended to be useful to identify all the different notice customer funding options that can be used in notices. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: activeFlag, sortOrder

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


638
639
 
# File 'lib/avatax/client/definitions.rb', line 638

def list_notice_customer_funding_options(options={})        path = "/api/v2/definitions/noticecustomerfundingoptions"
get(path, options, AvaTax::VERSION)      end

#list_notice_customer_types(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax notice customer types.

Returns the full list of Avalara-supported tax notice customer types. This API is intended to be useful to identify all the different notice customer types. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: activeFlag, sortOrder

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


651
652
 
# File 'lib/avatax/client/definitions.rb', line 651

def list_notice_customer_types(options={})        path = "/api/v2/definitions/noticecustomertypes"
get(path, options, AvaTax::VERSION)      end

#list_notice_filingtypes(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax notice filing types.

Returns the full list of Avalara-supported tax notice filing types. This API is intended to be useful to identify all the different notice filing types that can be used in notices. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: description, activeFlag, sortOrder

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


664
665
 
# File 'lib/avatax/client/definitions.rb', line 664

def list_notice_filingtypes(options={})        path = "/api/v2/definitions/noticefilingtypes"
get(path, options, AvaTax::VERSION)      end

#list_notice_priorities(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax notice priorities.

Returns the full list of Avalara-supported tax notice priorities. This API is intended to be useful to identify all the different notice priorities that can be used in notices. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: activeFlag, sortOrder

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


677
678
 
# File 'lib/avatax/client/definitions.rb', line 677

def list_notice_priorities(options={})        path = "/api/v2/definitions/noticepriorities"
get(path, options, AvaTax::VERSION)      end

#list_notice_reasons(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax notice reasons.

Returns the full list of Avalara-supported tax notice reasons. This API is intended to be useful to identify all the different tax notice reasons. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: description, activeFlag, sortOrder

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


690
691
 
# File 'lib/avatax/client/definitions.rb', line 690

def list_notice_reasons(options={})        path = "/api/v2/definitions/noticereasons"
get(path, options, AvaTax::VERSION)      end

#list_notice_responsibilities(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax notice responsibility ids

Returns the full list of Avalara-supported tax notice responsibility ids This API is intended to be useful to identify all the different tax notice responsibilities. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: sortOrder

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


703
704
 
# File 'lib/avatax/client/definitions.rb', line 703

def list_notice_responsibilities(options={})        path = "/api/v2/definitions/noticeresponsibilities"
get(path, options, AvaTax::VERSION)      end

#list_notice_root_causes(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax notice root causes

Returns the full list of Avalara-supported tax notice root causes This API is intended to be useful to identify all the different tax notice root causes. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: sortOrder

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


716
717
 
# File 'lib/avatax/client/definitions.rb', line 716

def list_notice_root_causes(options={})        path = "/api/v2/definitions/noticerootcauses"
get(path, options, AvaTax::VERSION)      end

#list_notice_statuses(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax notice statuses.

Returns the full list of Avalara-supported tax notice statuses. This API is intended to be useful to identify all the different tax notice statuses. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: isOpen, sortOrder, activeFlag

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


729
730
 
# File 'lib/avatax/client/definitions.rb', line 729

def list_notice_statuses(options={})        path = "/api/v2/definitions/noticestatuses"
get(path, options, AvaTax::VERSION)      end

#list_notice_types(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax notice types.

Returns the full list of Avalara-supported tax notice types. This API is intended to be useful to identify all the different notice types that can be used in notices. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: activeFlag, sortOrder

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


742
743
 
# File 'lib/avatax/client/definitions.rb', line 742

def list_notice_types(options={})        path = "/api/v2/definitions/noticetypes"
get(path, options, AvaTax::VERSION)      end

#list_parameters(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported extra parameters for creating transactions.

Returns the full list of Avalara-supported extra parameters for the 'Create Transaction' API call. This list of parameters is available for use when configuring your transaction. Some parameters are only available for use if you have subscribed to certain features of AvaTax. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: serviceTypes, regularExpression, attributeSubType, values

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


756
757
 
# File 'lib/avatax/client/definitions.rb', line 756

def list_parameters(options={})        path = "/api/v2/definitions/parameters"
get(path, options, AvaTax::VERSION)      end

#list_parameters_by_account(accountId, options = {}) ⇒ FetchResult

Retrieve the list of Avalara-supported parameters based on account subscriptions.

Returns the list of Avalara-supported parameters based on account subscriptions. Swagger Name: AvaTaxClient

Parameters:

  • accountId (Integer) —

    The ID of the account to retrieve the parameters.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: serviceTypes, regularExpression, attributeSubType, values

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


769
770
 
# File 'lib/avatax/client/definitions.rb', line 769

def (accountId, options={})        path = "/api/v2/definitions/accounts/#{accountId}/parameters"
get(path, options, AvaTax::VERSION)      end

#list_parameters_by_item(companyCode, itemCode, options = {}) ⇒ FetchResult

Retrieve the parameters by companyCode and itemCode.

Returns the list of parameters based on the company's service types and the item code. Ignores nexus if a service type is configured in the 'IgnoreNexusForServiceTypes' configuration section. Ignores nexus for the AvaAlcohol service type.

NOTE: If your company code or item code contains any of these characters /, +, ? or a space, please use the following encoding before making a request:

  • Replace '/' with '_-ava2f-_' For example: 'Company/Code' becomes 'Company_-ava2f-_Code'
  • Replace '+' with '_-ava2b-_' For example: 'Company+Code' becomes 'Company_-ava2b-_Code'
  • Replace '?' with '_-ava3f-_' For example: 'Company?Code' becomes 'Company_-ava3f-_Code'
  • Replace '%' with '_-ava25-_' For example: 'Company%Code' becomes 'Company_-ava25-_Code'
  • Replace '#' with '_-ava23-_' For example: 'Company#Code' becomes 'Company_-ava23-_Code'

For Item Code other than the five given above below two should also be used

  • Replace ''' with '_-ava27-_' For example: 'Item'Code' becomes 'Item_-ava27-_Code'
  • Replace '"' with '_-ava22-_' For example: 'Item"Code' becomes 'Item_-ava22-_Code'

Security Policies

  • This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, AvaTaxOnlyAccountAdmin, AvaTaxOnlyAccountUser, AvaTaxOnlyCompanyAdmin, AvaTaxOnlyCompanyUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ReturnsOnlyAccountAdmin, ReturnsOnlyAccountUser, ReturnsOnlyCompanyAdmin, ReturnsOnlyCompanyUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. Swagger Name: AvaTaxClient

Parameters:

  • companyCode (String) —

    Company code.

  • itemCode (String) —

    Item code.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: serviceTypes, regularExpression, attributeSubType, values

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


800
801
 
# File 'lib/avatax/client/definitions.rb', line 800

def list_parameters_by_item(companyCode, itemCode, options={})        path = "/api/v2/definitions/parameters/byitem/#{companyCode}/#{itemCode}"
get(path, options, AvaTax::VERSION)      end

#list_parameters_usage(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported usage of extra parameters for creating transactions.

Returns the full list of Avalara-supported usage of extra parameters for the 'Create Transaction' API call. This list of parameters is available for use when configuring your transaction. Some parameters are only available for use if you have subscribed to certain features of AvaTax. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: attributeSubType, values, valueDescriptions

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


814
815
 
# File 'lib/avatax/client/definitions.rb', line 814

def list_parameters_usage(options={})        path = "/api/v2/definitions/parametersusage"
get(path, options, AvaTax::VERSION)      end

#list_permissions(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported permissions

Returns the full list of Avalara-supported permission types. This API is intended to be useful to identify the capabilities of a particular user logon. Swagger Name: AvaTaxClient

Parameters:

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

Returns:

  • (FetchResult) 


825
826
 
# File 'lib/avatax/client/definitions.rb', line 825

def list_permissions(options={})        path = "/api/v2/definitions/permissions"
get(path, options, AvaTax::VERSION)      end

#list_postal_codes(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported postal codes.

Retrieves the list of Avalara-supported postal codes. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • includeExpiredPostalCodes (Boolean) —

    If set to true, returns expired postal codes. Defaults to false

Returns:

  • (FetchResult) 


838
839
 
# File 'lib/avatax/client/definitions.rb', line 838

def list_postal_codes(options={})        path = "/api/v2/definitions/postalcodes"
get(path, options, AvaTax::VERSION)      end

#list_preferred_programs(options = {}) ⇒ FetchResult

List all customs duty programs recognized by AvaTax

List all preferred customs duty programs recognized by AvaTax.

A customs duty program is an optional program you can use to obtain favorable treatment from customs and duty agents. An example of a preferred program is NAFTA, which provides preferential rates for products being shipped from neighboring countries.

To select a preferred program for calculating customs and duty rates, call this API to find the appropriate code for your preferred program. Next, set the parameter AvaTax.LC.PreferredProgram in your CreateTransaction call to the code of the program. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: effectiveDate, endDate

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


858
859
 
# File 'lib/avatax/client/definitions.rb', line 858

def list_preferred_programs(options={})        path = "/api/v2/definitions/preferredprograms"
get(path, options, AvaTax::VERSION)      end

#list_product_classification_systems(options = {}) ⇒ FetchResult

List all available product classification systems.

List all available product classification systems.

Tax authorities use product classification systems as a way to identify products and associate them with a tax rate. More than one tax authority might use the same product classification system, but they might charge different tax rates for products. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: countries

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • countryCode (String) —

    If not null, return all records with this code.

Returns:

  • (FetchResult) 


874
875
 
# File 'lib/avatax/client/definitions.rb', line 874

def list_product_classification_systems(options={})        path = "/api/v2/definitions/productclassificationsystems"
get(path, options, AvaTax::VERSION)      end

#list_product_classification_systems_by_company(companyCode, options = {}) ⇒ FetchResult

List all product classification systems available to a company based on its nexus.

Lists all product classification systems available to a company based on its nexus.

Tax authorities use product classification systems as a way to identify products and associate them with a tax rate. More than one tax authority might use the same product classification system, but they might charge different tax rates for products.

NOTE: If your company code contains any of these characters /, +, ? or a space, please use the following encoding before making a request:

  • Replace '/' with '_-ava2f-_' For example: 'Company/Code' becomes 'Company_-ava2f-_Code'
  • Replace '+' with '_-ava2b-_' For example: 'Company+Code' becomes 'Company_-ava2b-_Code'
  • Replace '?' with '_-ava3f-_' For example: 'Company?Code' becomes 'Company_-ava3f-_Code'
  • Replace '%' with '_-ava25-_' For example: 'Company%Code' becomes 'Company_-ava25-_Code'
  • Replace '#' with '_-ava23-_' For example: 'Company#Code' becomes 'Company_-ava23-_Code' Swagger Name: AvaTaxClient

Parameters:

  • companyCode (String) —

    The company code.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: countries

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • countryCode (String) —

    If not null, return all records with this code.

Returns:

  • (FetchResult) 


899
900
 
# File 'lib/avatax/client/definitions.rb', line 899

def list_product_classification_systems_by_company(companyCode, options={})        path = "/api/v2/definitions/productclassificationsystems/bycompany/#{companyCode}"
get(path, options, AvaTax::VERSION)      end

#list_rate_types_by_country(country, options = {}) ⇒ FetchResult

Retrieve the full list of rate types for each country

Returns the full list of Avalara-supported rate type file types This API is intended to be useful to identify all the different rate types. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The country to examine for rate types

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: country

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


913
914
 
# File 'lib/avatax/client/definitions.rb', line 913

def list_rate_types_by_country(country, options={})        path = "/api/v2/definitions/countries/#{country}/ratetypes"
get(path, options, AvaTax::VERSION)      end

#list_rate_types_by_country_tax_type_tax_sub_type(country, taxTypeId, taxSubTypeId, options = {}) ⇒ FetchResult

Retrieve the list of rate types by country, TaxType and by TaxSubType

Returns the list of Avalara-supported rate type file types This API is intended to be useful to identify all the different rate types. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The country to examine for rate types

  • taxTypeId (String) —

    The taxType for the country to examine for rate types

  • taxSubTypeId (String) —

    The taxSubType for the country and taxType to examine for rate types

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: id, rateType, description

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • includeCustomContent (Boolean) —

    Optional query parameter to include custom content rate types (default: false)

Returns:

  • (FetchResult) 


930
931
 
# File 'lib/avatax/client/definitions.rb', line 930

def list_rate_types_by_country_tax_type_tax_sub_type(country, taxTypeId, taxSubTypeId, options={})        path = "/api/v2/definitions/countries/#{country}/taxtypes/#{taxTypeId}/taxsubtypes/#{taxSubTypeId}/ratetypes"
get(path, options, AvaTax::VERSION)      end

#list_regions(options = {}) ⇒ FetchResult

List all ISO 3166 regions

Returns a list of all ISO 3166 region codes and their US English friendly names. This API is intended to be useful when presenting a dropdown box in your website to allow customers to select a region within the country for a shipping addresses. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: localizedNames

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


944
945
 
# File 'lib/avatax/client/definitions.rb', line 944

def list_regions(options={})        path = "/api/v2/definitions/regions"
get(path, options, AvaTax::VERSION)      end

#list_regions_by_country(country, options = {}) ⇒ FetchResult

List all ISO 3166 regions for a country

Returns a list of all ISO 3166 region codes for a specific country code, and their US English friendly names. This API is intended to be useful when presenting a dropdown box in your website to allow customers to select a region within the country for a shipping addresses. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The country of which you want to fetch ISO 3166 regions

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: localizedNames

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


959
960
 
# File 'lib/avatax/client/definitions.rb', line 959

def list_regions_by_country(country, options={})        path = "/api/v2/definitions/countries/#{country}/regions"
get(path, options, AvaTax::VERSION)      end

#list_regions_by_country_and_tax_type_and_tax_sub_type_and_rate_type(companyId, country, taxTypeId, taxSubTypeId, rateTypeId, jurisdictionTypeId, options = {}) ⇒ FetchResult

Retrieve the list of applicable regions by country tax type, tax sub type, and rate type for a given JurisdictionTypeId

Returns a list of all ISO 3166 region codes for a specific country code and their US English friendly names. This API is intended to be used as a way to provide a dropdown box in your website to allow customers to select a region within the country for shipping addresses. Swagger Name: AvaTaxClient

Parameters:

  • companyId (Integer) —

    The ID of the company for which you want to retrieve the applicable regions

  • country (String) —

    The country for which you want to retrieve the regions

  • taxTypeId (String) —

    The taxTypeId for which you want to retrieve the regions. Example values include Autimotive, tires, Lodging, S, U, I, O, All, etc. Run the "/api/v2/definitions/taxtypes/countries/country?companyId=" endpoint for a list of taxTypeId values.

  • taxSubTypeId (String) —

    The taxSubType for which you want to retrieve the regions. Example values include Accommodations, BikeTax, IGST, S, U, All, etc. Run the "api/v2/definitions/taxsubtypes" endpoint for a list of taxSubTypes values.

  • rateTypeId (Integer) —

    The rateTypeId for which you want to retrieve the regions. Note: The rateTypeId is an integer. Run the "/api/v2/definitions/countries/country/taxtypes/taxTypeId/taxsubtypes/taxSubTypeId/ratetypes" endpoint for a list of rateTypeId values."

  • jurisdictionTypeId (String) —

    The JurisdictionTypeId for which you want to retrieve the regions. This is a three-character string. Accepted values are CNT (country), STA (state), CTY (county), CIT (city), or STJ (special jurisdiction).

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • scope (String) —

    Optional query parameter to filter system, custom content or all regions (default: System) (See ContentScope::* for a list of allowable values)

Returns:

  • (FetchResult) 


979
980
 
# File 'lib/avatax/client/definitions.rb', line 979

def list_regions_by_country_and_tax_type_and_tax_sub_type_and_rate_type(companyId, country, taxTypeId, taxSubTypeId, rateTypeId, jurisdictionTypeId, options={})        path = "/api/v2/definitions/companies/#{companyId}/countries/#{country}/regions/taxtypes/#{taxTypeId}/taxsubtypes/#{taxSubTypeId}/rateTypeId/#{rateTypeId}/jurisdictionTypeId/#{jurisdictionTypeId}"
get(path, options, AvaTax::VERSION)      end

#list_returns_parameters_usage(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported usage of parameters used for returns.

Returns the full list of Avalara-supported usage of extra parameters for the returns. This list of parameters is available for use with Returns. Some parameters are only available for use if you have subscribed to certain features of AvaTax. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: attributeSubType, values

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


993
994
 
# File 'lib/avatax/client/definitions.rb', line 993

def list_returns_parameters_usage(options={})        path = "/api/v2/definitions/returns/parametersusage"
get(path, options, AvaTax::VERSION)      end

#list_security_roles(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported permissions

Returns the full list of Avalara-supported permission types. This API is intended to be useful when designing a user interface for selecting the security role of a user account. Some security roles are restricted for Avalara internal use. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1007
1008
 
# File 'lib/avatax/client/definitions.rb', line 1007

def list_security_roles(options={})        path = "/api/v2/definitions/securityroles"
get(path, options, AvaTax::VERSION)      end

#list_subscription_types(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported subscription types

Returns the full list of Avalara-supported subscription types. This API is intended to be useful for identifying which features you have added to your account. You may always contact Avalara's sales department for information on available products or services. You cannot change your subscriptions directly through the API. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: system, taxTypeGroupIdSK

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1022
1023
 
# File 'lib/avatax/client/definitions.rb', line 1022

def list_subscription_types(options={})        path = "/api/v2/definitions/subscriptiontypes"
get(path, options, AvaTax::VERSION)      end

#list_tags(options = {}) ⇒ FetchResult

Retrieve the list all tags supported by avalara

Retrieves the list of suggested locations for a marketplace. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1034
1035
 
# File 'lib/avatax/client/definitions.rb', line 1034

def list_tags(options={})        path = "/api/v2/definitions/tags"
get(path, options, AvaTax::VERSION)      end

#list_tax_authorities(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax authorities.

Returns the full list of Avalara-supported tax authorities. This API is intended to be useful to identify all the different authorities that receive tax. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1047
1048
 
# File 'lib/avatax/client/definitions.rb', line 1047

def list_tax_authorities(options={})        path = "/api/v2/definitions/taxauthorities"
get(path, options, AvaTax::VERSION)      end

#list_tax_authority_forms(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported forms for each tax authority.

Returns the full list of Avalara-supported forms for each tax authority. This list represents tax forms that Avalara recognizes. Customers who subscribe to Avalara Managed Returns Service can request these forms to be filed automatically based on the customer's AvaTax data. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1062
1063
 
# File 'lib/avatax/client/definitions.rb', line 1062

def list_tax_authority_forms(options={})        path = "/api/v2/definitions/taxauthorityforms"
get(path, options, AvaTax::VERSION)      end

#list_tax_authority_types(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax authority types.

Returns the full list of Avalara-supported tax authority types. This API is intended to be useful to identify all the different authority types. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1075
1076
 
# File 'lib/avatax/client/definitions.rb', line 1075

def list_tax_authority_types(options={})        path = "/api/v2/definitions/taxauthoritytypes"
get(path, options, AvaTax::VERSION)      end

#list_tax_code_types(options = {}) ⇒ Object

Retrieve the full list of Avalara-supported tax code types.

Returns the full list of recognized tax code types. A 'Tax Code Type' represents a broad category of tax codes, and is less detailed than a single TaxCode. This API is intended to be useful for broadly searching for tax codes by tax code type. Swagger Name: AvaTaxClient

Parameters:

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

Returns:

  • (Object) 


1107
1108
 
# File 'lib/avatax/client/definitions.rb', line 1107

def list_tax_code_types(options={})        path = "/api/v2/definitions/taxcodetypes"
get(path, options, AvaTax::VERSION)      end

#list_tax_codes(options = {}) ⇒ FetchResult

Retrieve the full list of Avalara-supported tax codes.

Retrieves the list of Avalara-supported system tax codes. A 'TaxCode' represents a uniquely identified type of product, good, or service. Avalara supports correct tax rates and taxability rules for all TaxCodes in all supported jurisdictions. If you identify your products by tax code in your 'Create Transaction' API calls, Avalara will correctly calculate tax rates and taxability rules for this product in all supported jurisdictions.

Security Policies

  • This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, AvaTaxOnlyAccountAdmin, AvaTaxOnlyAccountUser, AvaTaxOnlyCompanyAdmin, AvaTaxOnlyCompanyUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ECMAccountUser, ECMCompanyUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1095
1096
 
# File 'lib/avatax/client/definitions.rb', line 1095

def list_tax_codes(options={})        path = "/api/v2/definitions/taxcodes"
get(path, options, AvaTax::VERSION)      end

#list_tax_forms(options = {}) ⇒ FetchResult

Retrieve the full list of the Tax Forms available

Returns the full list of Avalara-supported Tax Forms This API is intended to be useful to identify all the different Tax Forms Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1120
1121
 
# File 'lib/avatax/client/definitions.rb', line 1120

def list_tax_forms(options={})        path = "/api/v2/definitions/taxforms"
get(path, options, AvaTax::VERSION)      end

#list_tax_sub_types(options = {}) ⇒ FetchResult

Retrieve the full list of tax sub types

Returns the full list of Avalara-supported tax sub-types This API is intended to be useful to identify all the different tax sub-types. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1133
1134
 
# File 'lib/avatax/client/definitions.rb', line 1133

def list_tax_sub_types(options={})        path = "/api/v2/definitions/taxsubtypes"
get(path, options, AvaTax::VERSION)      end

#list_tax_sub_types_by_country_and_tax_type(country, taxTypeId, options = {}) ⇒ FetchResult

Retrieve the full list of tax sub types by Country and TaxType

Returns the full list of Avalara-supported tax sub-types This API is intended to be useful to identify all the different tax sub-types for given country and TaxType. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The country to examine for taxsubtype

  • taxTypeId (String) —

    The taxType for the country to examine for taxsubtype

  • companyId (Integer) —

    Id of the company the user wish to fetch the applicable tax sub types

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • scope (String) —

    Optional query parameter to filter by System, Custom or All tax sub types (default: System) (See ContentScope::* for a list of allowable values)

Returns:

  • (FetchResult) 


1150
1151
 
# File 'lib/avatax/client/definitions.rb', line 1150

def list_tax_sub_types_by_country_and_tax_type(country, taxTypeId, options={})        path = "/api/v2/definitions/taxsubtypes/countries/#{country}/taxtypes/#{taxTypeId}"
get(path, options, AvaTax::VERSION)      end

#list_tax_sub_types_by_jurisdiction_and_region(jurisdictionCode, region, options = {}) ⇒ FetchResult

Retrieve the full list of tax sub types by jurisdiction code and region

Returns the full list of Avalara-supported tax sub-types by jurisdiction and region This API is intended to be useful to identify all the different tax sub-types. Swagger Name: AvaTaxClient

Parameters:

  • jurisdictionCode (String) —

    The jurisdiction code of the tax sub type.

  • region (String) —

    The region of the tax sub type.

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1165
1166
 
# File 'lib/avatax/client/definitions.rb', line 1165

def list_tax_sub_types_by_jurisdiction_and_region(jurisdictionCode, region, options={})        path = "/api/v2/definitions/taxsubtypes/#{jurisdictionCode}/#{region}"
get(path, options, AvaTax::VERSION)      end

#list_tax_type_groups(options = {}) ⇒ FetchResult

Retrieve the full list of tax type groups

Returns the full list of Avalara-supported tax type groups This API is intended to be useful to identify all the different tax type groups. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: subscriptionTypeId, subscriptionDescription, tabName, showColumn, displaySequence

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1178
1179
 
# File 'lib/avatax/client/definitions.rb', line 1178

def list_tax_type_groups(options={})        path = "/api/v2/definitions/taxtypegroups"
get(path, options, AvaTax::VERSION)      end

#list_tax_types_by_nexus_and_country(country, options = {}) ⇒ FetchResult

Retrieve the list of applicable TaxTypes

Retrieves the list of applicable TaxTypes based on Nexus of the company. Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The country for which you want to retrieve the unitofbasis information

  • companyId (Integer) —

    Your companyId to retrieve the applicable taxtypes

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

  • scope (String) —

    Optional query parameter to filter by System, Custom or All tax types (default: System) (See ContentScope::* for a list of allowable values)

Returns:

  • (FetchResult) 


1192
1193
 
# File 'lib/avatax/client/definitions.rb', line 1192

def list_tax_types_by_nexus_and_country(country, options={})        path = "/api/v2/definitions/taxtypes/countries/#{country}"
get(path, options, AvaTax::VERSION)      end

#list_unit_of_basis_by_country_and_tax_type_and_tax_sub_type_and_rate_type(country, taxTypeId, taxSubTypeId, options = {}) ⇒ FetchResult

Retrieve the list of applicable UnitOfBasis

Retrieves the list of applicable UnitOfBasis Swagger Name: AvaTaxClient

Parameters:

  • country (String) —

    The country for which you want to retrieve the unitofbasis information

  • taxTypeId (String) —

    The taxtype for which you want to retrieve the unitofbasis information

  • taxSubTypeId (String) —

    The taxsubtype for which you want to retrieve the unitofbasis information

  • rateTypeId (String) —

    The ratetype for which you want to retrieve the unitofbasis information

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1207
1208
 
# File 'lib/avatax/client/definitions.rb', line 1207

def list_unit_of_basis_by_country_and_tax_type_and_tax_sub_type_and_rate_type(country, taxTypeId, taxSubTypeId, options={})        path = "/api/v2/definitions/unitofbasis/countries/#{country}/taxtypes/#{taxTypeId}/taxsubtypes/#{taxSubTypeId}"
get(path, options, AvaTax::VERSION)      end

#list_unit_of_measurement(options = {}) ⇒ FetchResult

List all defined units of measurement

List all units of measurement systems defined by Avalara.

A unit of measurement system is a method of measuring a quantity, such as distance, mass, or others. Swagger Name: AvaTaxClient

Parameters:

  • filter (String) —

    A filter statement to identify specific records to retrieve. For more information on filtering, see Filtering in REST.
    Not filterable: id

  • 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.

  • skip (Integer) —

    If nonzero, skip this number of results before returning data. Used with $top to provide pagination for large datasets.

  • orderBy (String) —

    A comma separated list of sort statements in the format (fieldname) [ASC|DESC], for example id ASC.

Returns:

  • (FetchResult) 


1221
1222
 
# File 'lib/avatax/client/definitions.rb', line 1221

def list_unit_of_measurement(options={})        path = "/api/v2/definitions/unitofmeasurements"
get(path, options, AvaTax::VERSION)      end