lib/avatax/client/contacts.rb in avatax-20.1.0 vs lib/avatax/client/contacts.rb in avatax-20.5.0
- old
+ new
@@ -3,103 +3,103 @@
module Contacts
# Create a new contact
#
- # Create one or more new contact objects.
- # A 'contact' is a person associated with a company who is designated to handle certain responsibilities of
- # a tax collecting and filing entity.
- #
- # ### Security Policies
- #
+ # Create one or more new contact objects.
+ # A 'contact' is a person associated with a company who is designated to handle certain responsibilities of
+ # a tax collecting and filing entity.
+ #
+ # ### Security Policies
+ #
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin.
- # @param companyId [Integer] The ID of the company that owns this contact.
- # @param model [ContactModel[]] The contacts you wish to create.
+ # @param companyId [Integer] The ID of the company that owns this contact.
+ # @param model [ContactModel[]] The contacts you wish to create.
# @return [ContactModel[]]
def create_contacts(companyId, model) path = "/api/v2/companies/#{companyId}/contacts"
post(path, model) end
# Delete a single contact
#
- # Mark the existing contact object at this URL as deleted.
- #
- # ### Security Policies
- #
+ # Mark the existing contact object at this URL as deleted.
+ #
+ # ### Security Policies
+ #
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin.
- # @param companyId [Integer] The ID of the company that owns this contact.
- # @param id [Integer] The ID of the contact you wish to delete.
+ # @param companyId [Integer] The ID of the company that owns this contact.
+ # @param id [Integer] The ID of the contact you wish to delete.
# @return [ErrorDetail[]]
def delete_contact(companyId, id) path = "/api/v2/companies/#{companyId}/contacts/#{id}"
delete(path) end
# Retrieve a single contact
#
- # Get the contact object identified by this URL.
- # A 'contact' is a person associated with a company who is designated to handle certain responsibilities of
- # a tax collecting and filing entity.
- #
- # ### Security Policies
- #
+ # Get the contact object identified by this URL.
+ # A 'contact' is a person associated with a company who is designated to handle certain responsibilities of
+ # a tax collecting and filing entity.
+ #
+ # ### Security Policies
+ #
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
- # @param companyId [Integer] The ID of the company for this contact
- # @param id [Integer] The primary key of this contact
+ # @param companyId [Integer] The ID of the company for this contact
+ # @param id [Integer] The primary key of this contact
# @return [Object]
def get_contact(companyId, id) path = "/api/v2/companies/#{companyId}/contacts/#{id}"
get(path) end
# Retrieve contacts for this company
#
- # List all contact objects assigned to this company.
- #
- # Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
- # Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
- #
- # ### Security Policies
- #
+ # List all contact objects assigned to this company.
+ #
+ # Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
+ # Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
+ #
+ # ### Security Policies
+ #
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
- # @param companyId [Integer] The ID of the company that owns these contacts
- # @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
- # @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
- # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
- # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
+ # @param companyId [Integer] The ID of the company that owns these contacts
+ # @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
+ # @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
+ # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
+ # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
# @return [FetchResult]
def list_contacts_by_company(companyId, options={}) path = "/api/v2/companies/#{companyId}/contacts"
get(path, options) end
# Retrieve all contacts
#
- # Get multiple contact objects across all companies.
- # A 'contact' is a person associated with a company who is designated to handle certain responsibilities of
- # a tax collecting and filing entity.
- #
- # Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
- # Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
- #
- # ### Security Policies
- #
+ # Get multiple contact objects across all companies.
+ # A 'contact' is a person associated with a company who is designated to handle certain responsibilities of
+ # a tax collecting and filing entity.
+ #
+ # Search for specific objects using the criteria in the `$filter` parameter; full documentation is available on [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/) .
+ # Paginate your results using the `$top`, `$skip`, and `$orderby` parameters.
+ #
+ # ### Security Policies
+ #
# * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser.
- # @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
- # @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
- # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
- # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
+ # @param filter [String] A filter statement to identify specific records to retrieve. For more information on filtering, see [Filtering in REST](http://developer.avalara.com/avatax/filtering-in-rest/).
+ # @param top [Integer] If nonzero, return no more than this number of results. Used with `$skip` to provide pagination for large datasets. Unless otherwise specified, the maximum number of records that can be returned from an API call is 1,000 records.
+ # @param skip [Integer] If nonzero, skip this number of results before returning data. Used with `$top` to provide pagination for large datasets.
+ # @param orderBy [String] A comma separated list of sort statements in the format `(fieldname) [ASC|DESC]`, for example `id ASC`.
# @return [FetchResult]
def query_contacts(options={}) path = "/api/v2/contacts"
get(path, options) end
# Update a single contact
#
- # Replace the existing contact object at this URL with an updated object.
- # A 'contact' is a person associated with a company who is designated to handle certain responsibilities of
- # a tax collecting and filing entity.
- # All data from the existing object will be replaced with data in the object you PUT.
- # To set a field's value to null, you may either set its value to null or omit that field from the object you post.
- #
- # ### Security Policies
- #
+ # Replace the existing contact object at this URL with an updated object.
+ # A 'contact' is a person associated with a company who is designated to handle certain responsibilities of
+ # a tax collecting and filing entity.
+ # All data from the existing object will be replaced with data in the object you PUT.
+ # To set a field's value to null, you may either set its value to null or omit that field from the object you post.
+ #
+ # ### Security Policies
+ #
# * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin.
- # @param companyId [Integer] The ID of the company that this contact belongs to.
- # @param id [Integer] The ID of the contact you wish to update
- # @param model [Object] The contact you wish to update.
+ # @param companyId [Integer] The ID of the company that this contact belongs to.
+ # @param id [Integer] The ID of the contact you wish to update
+ # @param model [Object] The contact you wish to update.
# @return [Object]
def update_contact(companyId, id, model) path = "/api/v2/companies/#{companyId}/contacts/#{id}"
put(path, model) end
end
end
\ No newline at end of file