lib/avatax/client/contacts.rb in avatax-20.5.0 vs lib/avatax/client/contacts.rb in avatax-20.6.0

- old
+ new

@@ -1,107 +1,125 @@ -module AvaTax - class Client - module Contacts - - - # Create a new contact - # +module AvaTax + class Client + 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 # - # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin. + # * 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. - # @return [ContactModel[]] - def create_contacts(companyId, model) path = "/api/v2/companies/#{companyId}/contacts" - post(path, model) end - - # Delete a single contact - # + # @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 # - # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin. + # * 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. - # @return [ErrorDetail[]] - def delete_contact(companyId, id) path = "/api/v2/companies/#{companyId}/contacts/#{id}" - delete(path) end - - # Retrieve a single contact - # + # @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 # - # * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + # * 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 - # @return [Object] - def get_contact(companyId, id) path = "/api/v2/companies/#{companyId}/contacts/#{id}" - get(path) end - - # Retrieve contacts for this company - # + # @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 # - # * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + # * 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`. - # @return [FetchResult] - def list_contacts_by_company(companyId, options={}) path = "/api/v2/companies/#{companyId}/contacts" - get(path, options) end - - # Retrieve all contacts - # + # @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 # - # * This API requires one of the following user roles: AccountAdmin, AccountUser, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, FirmAdmin, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser, TreasuryAdmin, TreasuryUser. + # * 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`. - # @return [FetchResult] - def query_contacts(options={}) path = "/api/v2/contacts" - get(path, options) end - - # Update a single contact - # + # @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 # - # * This API requires one of the following user roles: AccountAdmin, CompanyAdmin, CSPTester, FirmAdmin, SSTAdmin, TechnicalSupportAdmin. + # * 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. - # @return [Object] - def update_contact(companyId, id, model) path = "/api/v2/companies/#{companyId}/contacts/#{id}" - put(path, model) end - end - end + # @return [Object] + def update_contact(companyId, id, model) + path = "/api/v2/companies/#{companyId}/contacts/#{id}" + put(path, model) + end + + end + end end \ No newline at end of file