SWS UpdateRentalSettings Method
Allows you to change the primary contact, secondary contact, tax exempt status, delinquency schedule, delinquency step and overlock status of the specified rental.
Parameters
Name | DataType | Is Required |
---|---|---|
DelExempt | Boolean | Optional |
Description | Sets the unit to exempt for the delinquency processing (“True”) or to be processed normally (“False”). Default is “False”. | |
DelScheduleID | Long | Optional |
Description | Changes the delinquency schedule that is assigned to the unit. You can get the ID, name and description using the GetDelinqSchedule method. | |
DelStep | Integer | Optional |
Description | Set the delinquency step number of the unit. This is the level of delinquency that applies to the unit’s delinquency status. This cannot be a negative number. | |
OverlockStatus | OverlockStatus | Optional |
Description | Sets the overlock status of the rental. Available values:
|
|
PrimaryContact | Long | Optional |
Description | Assigns an existing contact as the primary rental contact to the rental via the contact ID. | |
PrimaryContactAddressID | Long | Optional |
Description | The address’s ID number for the address that should be assigned to the new primary contact. This is required if the PrimaryContact parameter is used. | |
PrimaryContactPhoneID | Long | Optional |
Description | The ID of the phone number you wish to add to the primary contact. This is required if the PrimaryContact parameter is used. | |
RentalId | Long | Required |
Description | The rental item’s ID number. This is returned when using the MakeReservation method or can be searched for using the SearchBy method. | |
SecondaryContact | Long | Optional |
Description | Assigns an existing contact as the secondary rental contact to the rental via the contact ID. | |
SecondaryContactAddressID | Long | Optional |
Description | The address’s ID number for the address that should be assigned to the secondary contact. This is required if the SecondaryContact parameter is used. | |
SecondaryContactPhoneID | Long | Optional |
Description | The ID of the phone number you wish to add to the secondary contact. This is required if the SecondaryContact parameter is used. | |
TaxExempt | Boolean | Optional |
Description | Indicates if the rental should not be charged taxes (“True”) of if taxes should apply normally (“False”). The default is “False”. This applies per rental so each rental that is tax exempt needs to be updated. This does not apply to retail that is handled separately. | |
TaxInfo | String | Optional |
Description | The tax id, if the rental should be tax exempt. This is required if you use the TaxExempt parameter. |
Returned Parameters
Name | DataType |
---|---|
AccountID | Long |
Description | The account’s ID number. |
DelExempt | Boolean |
Description | Indicates that the unit is set to be exempt from delinquency processing (“True”) or if it will process normally (“False”). The default is “False”. |
DelSchedule | Long |
Description | The delinquency schedule’s ID number. |
DelStep | Integer |
Description | The current step number within the delinquency schedule that applies to the unit’s delinquency status. This cannot be a negative number. |
EndDate | DateTime |
Description | The date the rental was terminated and the customer moved out. |
LTD | DateTime |
Description | The date that the customer has leased |
MoveOutDate | DateTime |
Description | The date the customer vacated the rental. |
OverlockStatus | OverlockStatus |
Description | The current overlock status of the rental. Available values:
|
PrimaryContactUpdated | Boolean |
Description | Indicates if the primary contact was updated successfully (“True”) or not (“False”). |
PTD | DateTime |
Description | The date through which the customer has paid on their rental. |
RentalID | Long |
Description | The rental item’s ID number. |
SecondaryContactUpdated | Boolean |
Description | Indicates if the secondary contact was updated successfully (“True”) or not (“False”). |
StartDate | DateTime |
Description | The date the customer first moved into the unit. |
TaxExempt | Boolean |
Description | Indicates that the unit is set to be exempt from taxes (“True”) or if it will be taxed normally (“False”). The default is “False”. |
TaxExemptInfo | String |
Description | The tax ID number if the rental is tax exempt. |
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We will assume you have a web reference, let us name it SWS, in your Visual Studio project. At this point we need to define our objects. We will need the standard service object, an UpdateRentalSettings request object, and an UpdateRentalSettings response object. We can define and create those like this:
' Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.UpdateRentalSettings_Request request = new SWS.UpdateRentalSettings_Request();
SWS.UpdateRentalSettings_Response response;
Here is a sample code of the request object:
// UpdateRentalSettings Request
request.RentalId = 123546;
request.PrimaryContact = 123456;
request.PrimaryContactAddressID = 123456;
request.PrimaryContactPhoneID = 123456;
Finally we can call the method and pass across the login object and the request object to retrieve our requested information. It’s a good idea to do this in a Try Catch block.
// Call the method that will load the response object
try
{
response = service.UpdateRentalSettings(user_request, request);
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
Note that if something goes wrong the service will respond with an exception. You will want to capture the message in the exception so it can be debugged.
For a full list of methods see SWS Methods.