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