Archive

Archive for the ‘API General’ Category

SWS PhoneSMSEnableStatus Method

January 18, 2018 Leave a comment

This call may be used to GET or SET the SMS enabled status for RentalID/PhoneID record combinations for specified SiteID. This will update only one contact on the specified RentalID. A RentalID, PhoneID or both must be supplied in the parameters. Only records having RENTAL_STATUS of “CURRENT_OCCUPIED”, “DELINQUENT”, “IN_PROCESS”, “RESERVED” or “SOFT_RESERVED” will be reported or affected.

Parameters

Name DataType Is Required
SiteId Long Required
Description The site’s ID number. This can be found using the GetSiteList method.
Get_Set String Optional
Description  Accepted values are “GET” or “SET”, with “GET” being the default value.
RentalID Long Optional*
Description The rental item’s ID number. This is returned when using the MakeReservation method or can be searched for using the SearchBy method.
* Either the RentalID or PhoneID is required.
PhoneID Long Optional*
Description The ID number of the phone. This can be found using the GetContacts method.
* Either the RentalID or PhoneID is required.
Status String Required*
Description Indicates if you are enabling SMS on an account (“SET”) or just getting the current status (“GET”).
* This value is required only for “SET”, otherwise it is ignored.

Returned Parameters

Name DataType
Response String
Description “SUCCESS” indicates that the query was successful, or “FAILURE” if not.
RENTAL_ID Long
Description The ID number of the rental.
PHONE_ID Long
Description The phone’s ID number.
Status String
Description The current SMS enabled status of the Rental/Phone combination. If using “GET”, this is the current status. If using “SET”, returns the status you just added.

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 create our objects. We’ll need the standard service object, a SiteID request object, an GetUpdatePhoneID request object, and a GetUpdateSMS response object. We can define and create those objects like this:

// Create the request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.SiteID_Request siteID_rqst = new SWS.SiteID_Request();
SWS.GetUpdatePhoneID_Request SMSphone_rqst = new
SWS.GetUpdatePhoneID_Request();
SWS.GetUpdateSMS_Response response = new SWS.GetUpdateSMS_Response ();

Now we set up the parameters for our request.

// SiteID Request- this is a required parameter
siteID_rqst.SiteID = 123456;
// Get_Set Request
// this is an optional parameter, “GET” is the default valueSMSphone.Get_Set = “GET”
// PhoneID Request 
// these are required parameters, you must set one or both in each 
elementSMSphone_rqst.PhoneIDs(0).RentalID = 234567;
SMSphone_rqst.PhoneIDs(0).PhoneID = 345678;

Finally we can call the method and pass across the login object and the request objects to get our resultant dataset. 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.PhoneSMSEnabledStatus(user_rqst, siteID_rqst, SMSphone_rqst);}
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.

Categories: API General, Letters, SMS

SWS GetSMSMessageData Method

January 18, 2018 Leave a comment

This method returns SMS message data for a specified SiteID, with available filters based on AccountID, RentalID and/or date range.

Parameters

Name DataType Is Required
SiteID Long Required
Description The site’s ID number. This can be found using the GetSiteList method.
AccountID Long Optional
Description The account’s ID number. This is returned when you use the CreateNewAccount method or can be retrieved with the SearchBy method.
RentalID Long Optional
Description The rental item’s ID number. This is returned when using the MakeReservation method or can be searched for using the SearchBymethod.
BeginDate DateTime Optional
Description The beginning date of the date range for which the SMS text message was scheduled.
EndDate DateTime Optional
Description The end date of the date range for which the SMS text message was scheduled.

Returned Parameters

Name DataType
Response String
Description “SUCCESS” indicates that the query was successful, or “FAILURE” if not. The “FAILURE” message will include additional information about why the method failed.
SMS_ID Long
Description The unique ID number for the SMS message.
SITE_ID Long
Description The site’s ID number.
RENTAL_ID Long
Description The ID number of the rental.
ACCT_ID Long
Description The account’s ID number.
SENT_DATE String
Description The date the message was sent.
SCHEDULED_DATE String
Description The date the message is scheduled to be sent.
SMS_TO String
Description The TO address (phone number) that the message is being sent to.
SMS_FROM String
Description The FROM address (phone number) that the message is being sent from.
SMS_BODY String
Description The body of the message.
SMS_STATUS Integer
Description The numeric value of the delivery status of the message.
Available values:

  • 0 – Not Sent
  • 1 – Accepted
  • 2 – Queued
  • 3 – Sending
  • 4 – Sent
  • 5 – Delivered
  • 6 – Received
  • 7 – Failed
  • 8 – Undelivered
  • 9 – Blacklisted
SMS_STATUS_MEANING String
Description The textual value of the delivery status of the message.
Available values:

  • Not Sent
  • Accepted
  • Queued
  • Sending
  • Sent
  • Delivered
  • Received
  • Failed
  • Undelivered
  • Blacklisted
SCHEDULE_ID String
Description Not currently used.
REGISTER_TYPE Type
Description The indicator of what type of message was sent. This will be “4” to indicate “SMS Message” in all cases.
INCLUDE_URL Boolean
Description Indicates whether a payment URL is to be included with the message (“True”) or not (“False”).
PAYMENT_URL String
Description The sites payment URL that was sent in the message.

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 create our objects. We’ll need the standard service object, a SiteID request object, an AccountRental request object and a GetSMSMessageData response object. We can define and create those objects like this:

// Create the request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.SiteID_Request siteID_rqst = newSWS.SiteID_Request();
SWS.AccountRental_Request acctrental_rqst = new SWS.AccountRental_Request();
SWS.GetSMSMessageData_Response response = new SWS.GetSMSMessageData_Response();

Now we set up the parameters for our request.

// SiteID Request
siteID_rqst.SiteID = 123456;
// Account/Rental Request 
// these are optional parameters, you may set one, both or neither
acctrental_rqst.AccountID = 234567;
acctrental_rqst.RentalID = 345678;

Finally we can call the method and pass across the login object and the request objects to get our resultant dataset. 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.GetSMSMessageData(user_rqst, siteID_rqst,
acctrental_rqst);}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.

Categories: API General, Letters, SMS

SWS GetSMSCandPhoneData Method

January 18, 2018 Leave a comment

This method returns contact, address and phone information for site rentals with optional filtering based upon AccountID and/or RentalID. Candidate records must meet the following criteria:

  • Primary contact is “TRUE”.
  • Phone type is “MOBILE”.
  • Rental status is “CURRENT_OCCUPIED”, “DELINQUENT”, “IN_PROCESS”, “RESERVED” or “SOFT_RESERVED”.

Parameters

Name DataType Is Required
SiteID Long Required
Description The site’s ID number. This can be found using the GetSiteList method.
AccountID Long Optional
Description The account’s ID number. This is returned when you use the CreateNewAccount method or can be retrieved with the SearchBy method.
RentalID Long Optional
Description The rental item’s ID number. This is returned when using the MakeReservation method or can be searched for using the SearchBy method.

Returned Parameters

Name DataType
Response String
Description “SUCCESS” indicates that the query was successful, or “FAILURE” if not.
SITE_ID Long
Description The site’s ID number.
ACCT_ID Long
Description The account’s ID number.
ACCT_NAME String
Description The name on the account. This may differ from the primary contact’s name in some instances, such as a business account or a guardianship account.
ACCT_TYPE Integer
Description The system-defined account type.
Available values:

  • Lead
  • Customer
  • Company Use Acct
  • Other
RENTAL_ID Long
Description The ID number of the rental.
RENTAL_STATUS Integer
Description The rental’s current status.
Available values:

  • 0 – Current
  • 1 – Delinquent
  • 100 – In-Process
  • 101 – Reserved
  • 102 – Soft Reservation
  • 201 – Vacated/Terminated
  • 202 – Voided Rental
  • 203 – In-Transfer
  • 205 – Abandoned Rental
UNIT_ID Long
Description The unit’s ID number. This is maintained through rentals.
PHONE_ID Long
Description The ID number of the phone. This can be found using the GetContacts method.
PHONE String
Description The contact’s phone number.
PHONE_TYPE Integer
Description The numeric value of the phone number type.
Available values:

  • 1 – Home
  • 2 – Office
  • 3 – Mobile
  • 4 – Fax
  • 5 – Other
CONTACT_ID Long
Description The contact’s ID number.
CONTACT_TYPE Integer
Description The numeric value of the contact type.
Available values:

  • 1 – Account Manager
  • 2 – Account User
  • 3 – Account Contact Only
  • 4 – Business Contact Record
FIRST_NAME String
Description The contact’s first name.
LAST_NAME String
Description The contact’s last name.
KNOWN_AS String
Description The name by which the customer prefers to be called.
EMAIL String
Description The contact’s email address. This is the customer’s username if eStore/eCommerce are supported.
ADDR_ID Long
Description The ID number of the primary contacts address.
ADDR1 String
Description The first line of the street address.
ADDR2 String
Description The second line of the street address.
ADDR3 String
Description The third line of the street address.
CITY String
Description The city in which the address is located.
STATE String
Description The state/province in which the address is located.
POSTAL_CODE String
Description The postal/ZIP code for the address.
COUNTRY String
Description The country in which the address is located.
ADDR_TYPE Integer
Description The numeric value for the address type.
Available values:

  • 1 – HOME
  • 2 – OFFICE
  • 3 – MAILING
  • 4 – SHIPPING
  • 5 – OTHER
PRIMARY_FLAG Boolean
Description Indicates if the contact is the primary contact for the rental (“True”) or not (“False”).

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 create our objects. We’ll need the standard service object, a SiteID request object, an AccountRental request object and a GetSMSCandPhoneData response object. We can define and create those objects like this:

// Create the request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.SiteID_Request siteID_rqst = new SWS.SiteID_Request();
SWS.AccountRental_Request acctrental_rqst = new SWS.AccountRental_Request();
SWS.GetSMSCandPhoneData_Response response = new SWS.GetSMSCandPhoneData_Response();

Now we set up the parameters for our request.

// SiteID Request
siteID_rqst.SiteID = 123456;
// Account/Rental Request
// these are optional parameters, you may set one, both or neither
acctrental_rqst.AccountID = 234567;
acctrental_rqst.RentalID = 345678;

Finally we can call the method and pass across the login object and the request objects to get our resultant dataset. It’s a good idea to do this in a Try Catch block.

// Call the method that will load the response objecttry
{
response = service.GetSMSCandPhoneData(user_rqst, siteID_rqst, acctrental_rqst);
}
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.

Categories: API General, Letters, SMS

SWS AddToWaitList Method

October 30, 2017 Leave a comment

This method will add an account to a site’s wait list. If a unit is vacated and someone is on the wait list for that unit, the unit will immediately be put into an “In-Process” status for the first account in the wait list. The rental must be completed to a “Rented” status before close of business or it will be abandoned during nightly processing. Once it is abandoned it will then go to the next person on the wait list. This will occur within five minutes of the rental being terminated and will occur even if the rental was terminated in error. A wait list record can be created for a specific unit, a unit of a specific size, a unit of a maximum price, or a unit of a specific Attribute1 or Attribute2.

Parameters

Name DataType Is Required
SiteID Long  Required
Description The site’s ID number. This can be found using the GetSiteList method.
ACCT_ID Long  Required
Description The account’s ID number.  This can be found using the GetContacts method.
PHONE_ID Long  Required
Description The ID number of the phone. This can be found using the GetContacts method.
ADDR_ID Long  Required
Description The ID number of the address. This can be found using the GetContacts method.
CONTACT_ID Long  Required
Description The ID number of the contact. This can be found using the GetContacts method.
ACCT_EMAIL String  Optional*
Description The email address that will be used to notify the contact when the wait list is triggered. An email address must be supplied if EMAIL_NOTIFY is set to “Y”.
UNIT_ID Long  Optional*
Description The ID number of the unit to place on the wait list. If UNIT_ID is supplied as part of the request, the trigger values are ignored.
TRIGGER_TYPE String  Optional*
Description If the UNIT_ID is not supplied, then one of the following trigger types must be supplied, along with a corresponding TRIGGER_VALUE or TRIGGER_VALUE_ID.

Available trigger types:

  • Minimum_Sq_Ft
  • Max_Price
  • Primary_Attributes
  • Secondary_Attributes
TRIGGER_VALUE String  Optional*
Description Indicates the square footage of the unit or the maximum price for the unit being requested through the wait list.(Example: Trigger type of Minimum_Sq_Ft, trigger value of 1000 will return units of no less than 1000 square feet. Trigger type of Max_Price, trigger value of 50.00 will return units of no more than $50.00 per month for rent.)
TRIGGER_VALUE_ID Decimal  Optional*
Description Indicates the primary or secondary attribute that is being requesting through the wait list. This can be found using eUnitAttr01 for Primary_Attributes and eUnitAttr02 for Secondary_Attributes
EMAIL_NOTIFY String  Optional*
Description Set to “Y” if a email notification is to be sent. If set to “Y” the ACCT_EMAIL parameter must also be set. Defaults to “N”.
PHONE_NOTIFY String  Optional*
Description Set to “Y” if phone notification is to be completed. Default is “N”.
TASK_NOTIFY String  Optional*
Description Set to “Y” if a task is to be created. Defaults to “N”.
NOTE_NOTIFY String  Optional*
Description Set to “Y” if  a note on the account is to be created. Defaults to “N”.
TOP_PRIORITY String  Optional*
Description Set to “Y” if  top priority is desired. Defaults to “N”. This will override the wait list and put this request at the top but it is first come, first served.
NOTES String  Optional
Description Notes relating to the new wait list item.

Returned Parameters

Name DataType
RESPONSE String
Description Returns the message “Successfully added item to wait list.” when the item is added to the wait list. The message “A unit of the type requested is available.” is returned if unit is available based upon the parameters requested.

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 create our objects. We’ll need the standard service object, an AddToWaitlist request object and an AddToWaitlist response object. We can define and create those like this:

// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.AddToWaitList_Request request = new SWS.AddToWaitList_Request();
SWS.AddToWaitList_Response response;

Now we set up the parameters for our request.

// AddToWaitList Request
request.SITE_ID = 123456;
request.ACCT_ID = 123456;
request.PHONE_ID = 123456;
request.ADDR_ID = 123456;
request.CONTACT_ID = 123456;
request.ACCT_EMAIL = "first@co.com";
request.UNIT_ID = 123456;
request.EMAIL_NOTIFY = "Y";
request.PHONE_NOTIFY = "Y";

Finally we can call the method and pass across the login object and the request object to add the account to the waitlist. 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.AddToWaitList(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.