Yardi Store Developer eXchange

Allows you to create a rental, create a quote/reservation or convert an existing quote/reservation to a rental. Improvements include: the gate timezone has been added to the contacts object, the PCD field requirements have been significantly reduced, flex fields are available, as are Market Code and Market Source, Inquiry Source will now accept all values including custom values and tax exempt information is also available. We have also improved the performance of the process over the SWS MakeReservation method.

See the New Rental/Reservation Workflow Chart for additional information on creating new rentals and reservations.

Parameters

Returned Parameters

Example

We’ll assume you’ve got a web reference, let’s name it Store, in your Visual Studio project. At this point we need to reference our objects. We’ll need the standard service object, a MakeReservation_Request request object and at least one MakeReservationContacts object. We can define and create those like this:

// Create a request and response objects
StoreServiceClient client = new StoreServiceClient();
MakeReservation_Request request = new MakeReservation_Request();
MakeReservationContacts contact = new MakeReservationContacts();

As with every method we need to pass in credentials. We also set up the parameters for our request.

client.ChannelFactory.Credentials.UserName.UserName = "user";
client.ChannelFactory.Credentials.UserName.Password = "pass";
client.ChannelFactory.Credentials.SupportInteractive = true;

contact.ContactID = 123456;
contact.AddressID = 123456;
contact.PhoneID = 123456;
contact.GateCode = "1234";
contact.GateTimezone = "0";
contact.PrimaryFlag = true;

request.SiteID = 123456;
request.AcctID = 123456;
request.Channel = 999;
request.Contacts = new MakeReservationContacts[] { contact };
request.InquirySource = 2;
request.Price = 50m;
request.QuoteType = 1;
request.RentNow = true;
request.UnitID = 123456;
request.Version = 34;

Finally we can call the method and pass across the login object and the request object to create the reservation. It’s a good idea to do this in a Try Catch block.

try
{
    // Call the method that will load the response object
    MakeReservation_Response resp;
    resp = client.MakeReservation(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 SWS2 Methods.