SWS CancelInsurance Method
Cancels insurance on a rental item, with the option to send insurance cancellation letter.
Parameters
Name | DataType | Is Required |
---|---|---|
InsuranceRentalID | Long | Required |
Description | The insurance policy’s ID number. Can be retrieved with the GetAppliedInsurance method. | |
ParentRentalID | 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. | |
SendLetter | Boolean | Optional |
Description | Indicates whether a cancellation letter will be sent (“True”) or not (“False”). |
Returned Parameters
Name | DataType |
---|---|
RefundAmount | Decimal |
Description | Indicates the amount that will be refunded to the customer. |
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We’ll assume you’ve got a web reference, let’s name it SWS, in your Visual Studio project. At this point we need to our objects. We’ll need the standard service object, a CancelInsurance request object and a CancelInsurance response object. We can define and create those like this:
// Create request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.CancelInsurance_Request request = new SWS.CancelInsurance_Request();
SWS.CancelInsurance_Response response;
Here’s my sample code of the Request object.
// CancelInsurance Request
request.InsuranceRentalID = 123456;
request.ParentRentalID = 123456;
request.SendLetter = true;
Finally we can call the method and pass across the login object and the request object to cancel the insurance. 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.CancelInsurance(user_request, request);
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
Note that if something goes wrong the service will respond with an exception. You’ll want to take a look at that message returned in that exception so it can be debugged.
For a full list of methods see SWS Methods.