Archive
SWS getTenantLeaseList Method
Retrieves tenant lease document information for an entire site, account and/or rental item.
Parameters
Name | DataType | Is Required |
---|---|---|
AcctID | 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. * Either account ID or rental ID are required. |
|
EndDate | DateTime | Required |
Description | The end date of the date range for which you are requesting the lease list. | |
RentalID | Long | Optional* |
Description | The rental item’s ID number. Adds a filter to only return leases for the specifed rental. This is returned when using the MakeReservation method or can be searched for using the SearchBy method. * Either account ID or rental ID are required. |
|
SiteID | Long | Required |
Description | The site’s ID number. Adds a filter for all leases at the site. This can be found using the GetSiteList method. | |
StartDate | DateTime | Required |
Description | The first date of the date range for which you are requesting the lease list. |
Returned Parameters
Name | DataType |
---|---|
ACCT_ID | Long |
Description | The account’s ID number. |
CREATED | DateTime |
Description | The date and time the lease was created. |
LEASE_DEF_ID | Long |
Description | The lease template ID that was used to create the lease. |
LEASE_ID | Long |
Description | The specific ID for the generated lease. |
LEASE_VERSION | Integer |
Description | The version of the lease. Will be “1” unless modifications have been made to the template. |
RENTAL_ID | Long |
Description | The rental item’s ID number. |
SITE_ID | Long |
Description | The site’s ID number. |
WHO_CREATED | String |
Description | The name of the person that generated the lease for the customer. |
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’ll need the standard service object, a getTenantDocList request object, and a getTenantLeaseList response object. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.getTenantDocList_Request request = new SWS.getTenantDocList_Request();
SWS.getTenantLeaseList_Response response;
Here is a sample code of the request object getting all items for an account:
// GetTenantLeaseList Request
request.SiteID = 123456;
request.AcctID = 123456;
request.StartDate = DateTime.Today.AddDays(-30);
request.EndDate = DateTime.Today;
Finally we can call the method and pass across the login object and the request object to retrieve the lease(s) for that specified account and rental. 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.getTenantLeaseList(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.
SWS GetReceiptTemplateInfo Method
Retrieves information regarding the available receipt templates at a site, org or system level.
Parameters
Name | DataType | Is Required |
---|---|---|
OrgID | Long | Required |
Description | The organization’s ID number. | |
SiteID | Long | Required |
Description | The site’s ID number. This can be found using the GetSiteList method. | |
TemplateLevel | TemplateLevelVals | Required |
Description | The type of receipt template you wish to retrieve. Available values: SITE_ONLY |
Returned Parameters
Name | DataType |
---|---|
POST_LTR_TEMPLATE_INFO | POST_LTR_TEMPLATE_INFO |
Description | The object containing all data for the method response. |
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, a getLtrTemplateInfo request object, and a getLtrTemplateInfo response object. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.getLtrTemplateInfo_Request request = new SWS.getLtrTemplateInfo_Request();
SWS.getLtrTemplateInfo_Response response;
Here’s a sample code of the request object:
// GetReceiptTemplateInfo Request
request.OrgID = 123456;
request.SiteID = 123456;
request.TemplateLevel = SWS.templateLevelVals.SITE_ORG;
Finally we can call the method and pass across the login object and the request object to retrieve our 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.getReceiptTemplateInfo(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 returned in that exception so it can be debugged.
For a full list of methods see SWS Methods.
SWS getLeaseTemplateInfo Method
Retrieves a list of lease template/documents to be created/printed for a specific rental.
Parameters
Name | DataType | Is Required |
---|---|---|
OrgID | Long | Required |
Description | The organization’s ID number. | |
SiteID | Long | Required |
Description | The site’s ID number. This can be found using the GetSiteList method. | |
TemplateLevel | templateLevelVals | Required |
Description | Document filter for available letters. Available values:
|
Returned Parameters
Name | DataType |
---|---|
CREATED | DateTime |
Description | The creation date and time. |
CURR_VERSION | Integer |
Description | The version of the letter if updates have occurred. |
LANGUAGE_ID | Integer |
Description | The numeric value for the language ID. Indicates the language of the specific lease. |
LANGUAGE_MEANING | String |
Description | The textual value of the LANGUAGE_ID. Indicates the language of the specific lease. |
LEASE_DEF_ID | Long |
Description | The lease document’s lease ID. |
LEASE_NAME | String |
Description | The lease document name. |
ORG_ID | Long |
Description | The organization’s ID number that owns the document. The org ID number 1 indicates a generic lease that was created by Store. |
SITE_ID | Long |
Description | The site’s ID number. |
STATE_ID | Integer |
Description | The system assigned numeric value of the state/province in which the rental is located. |
STATE_MEANING | String |
Description | The state/province code in which the rental is located. (I.E., Alabama = AL, New Brunswick = NB or Armed Forces Africa = AE) |
STATUS | Integer |
Description | The numeric value of the lease status. |
STATUS_MEANING | String |
Description | The textual value of the lease status. |
UPDATED | DateTime |
Description | The date that the lease was last updated. |
WHO_CREATED | String |
Description | The name of the user that created the lease. |
WHO_UPDATED | String |
Description | The name of the user that last updated the lease. |
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, a GetLeaseTemplateInfo request object, and a GetLeaseTemplateInfo response object. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.getLeaseTemplateInfo_Request request = new SWS.getLeaseTemplateInfo_Request();
SWS.getLeaseTemplateInfo_Response response;
Here’s a sample code of the request object:
// GetLeaseTemplateInfo Request
request.OrgID = 123456;
request.SiteID = 123456;
request.TemplateLevel = SWS.templateLevelVals.SITE_ONLY;
Finally we can call the method and pass across the login object and the request object to retrieve the specified lease 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.getLeaseTemplateInfo(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 returned in that exception so it can be debugged.
For a full list of methods see SWS Methods.
SWS getLeaseGroupTemplateInfo Method
Retrieves the lease template data via the rental item’s ID number.
Parameters
Name | DataType | Is Required |
---|---|---|
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. |
Returned Parameters
Name | DataType |
---|---|
ACCT_ID | Long |
Description | The account’s ID number. |
COPIES | Integer |
Description | The number of copies to print for each lease document in the lease group. |
DESCRIPTION | String |
Description | A brief description of the lease group’s documents. |
DOC_ACTIVE | Boolean |
Description | Indicates if the document in the lease group is active for the site (“True”) or not (“False”). |
GROUP_ACTIVE | Boolean |
Description | Indicates if the lease group is active at the organization (“True”) or not (“False”). |
GROUP_DOC_ID | Long |
Description | The lease group’s ID number. |
GROUP_NAME | String |
Description | The lease group’s name. |
LANG_VAL | String |
Description | The textual value of the LANGUAGE_ID. Available values:
|
LANGUAGE_ID | Integer |
Description | The numeric value for the language used in the lease group. Available values:
|
LEASE_DEF_ID | Long |
Description | The lease document’s lease definition number. |
LEASE_GROUP_ID | Long |
Description | The lease group’s ID number. |
LEASE_NAME | String |
Description | The lease’s name. |
ORG_ID | Long |
Description | The organization’s ID number. |
RENTAL_ID | Long |
Description | The rental item’s ID number. |
SITE_ID | Long |
Description | The site’s ID number. |
STATE_ID | Integer |
Description | The system assigned numeric value of the state/province in which the rental is located. |
STATE_VAL | String |
Description | The state/province code for which the rental is located. |
STATUS | Integer |
Description | The numeric value of the current rental status of the unit. |
UNIT_ID | Long |
Description | The unit’s ID number. This is maintained through rentals. |
UNIT_NUMBER | String |
Description | The unit’s number as assigned by the organization. This is not the UnitID. |
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, a GetLeaseGroupTemplateInfo request object, and a GetLeaseGroupTemplateInfo response object. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.getLeaseGroupTemplateInfo_Request request = new SWS.getLeaseGroupTemplateInfo_Request();
SWS.getLeaseGroupTemplateInfo_Response response;
Here’s a sample code of the request object:
// GetLeaseGroupTemplateInfo Request
request.RentalID = 123456;
Finally we can call the method and pass across the login object and the request object to retrieve the lease group template 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.getLeaseGroupTemplateInfo(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 returned in that exception so it can be debugged.
For a full list of methods see SWS Methods.