Creating Tech Appointments

Introduction

Posting to SecurityTrax is done via raw http post. In order to perform this action you will need the following information:

URL	https://secure.securitytrax.com/site...tionposter.php
Partner ID	This is the unique ID that SecurityTrax assigns to the partner company. Source ID Provided by the company using SecurityTrax.
Username	Set by company using SecurityTrax. Provided by them.
Password	Set by company using SecurityTrax. Provided by them.
SecurityTraxUniqueID	The unique SecurityTrax ID of the customer you wish to update.
Tech ID	Optional. The ID of the tech being scheduled. This should be left null when working with slot scheduling.
Start Time	Start time of the appointment in the customer’s time zone. 24 Hr format.
End Time	End time of the appointment in the customer’s time zone. 24 Hr format.
Service Type	1 = Install, 2 = Service, 3 = Rip-out
Service Detail Type	Optional. Values defined by the company using SecurityTrax.
Notes	Optional. Notes to be associated with the appointment.

Sample Request

The following is an example of a valid request.

<?xml version='1.0'?>
<root>
	<requests>
		<request type='GetSystemAuthentication'>
			<attribute name='Username'>Username</attribute>
			<attribute name='Password'>Password</attribute>
			<attribute name='PartnerID'>PartnerID</attribute>
		</request>
		<request type="CreateTechScheduleBySecurityTraxUniqueID">
			<attribute name='SecurityTraxUniqueID'>9710</attribute>
			<attribute name='TechID'></attribute>
			<attribute name="StartTime">01/23/2014 7:30</attribute>
			<attribute name="EndTime">01/23/2014 9:00</attribute>
			<attribute name='ServiceType'>1</attribute>
			<attribute name='ServiceDetailType'></attribute>
			<attribute name='Notes'></attribute>
		</request>
	</requests>
</root>

Sample Response

The following is an example of a successful response.

	<?xml version="1.0"?>
<root>
	<responses>
		<response type="GetSystemAuthentication" success="true">
	  		<data>
				<message>Authenticated To System</message>
	  		</data>
		</response>
		<response type="CreateTechScheduleBySecurityTraxUniqueID" success="true">
	  		<data>
				<TechSchedule>
			  		<TechID/>
			  		<TechName></TechName>
			  		<TechScheduleID>698998</TechScheduleID>
			  		<StartTime>1390487400</StartTime>
				  	<Duration>5400</Duration>
				  	<ServiceNotes/>
				  	<CustomerID>9710</CustomerID>
				  	<VisitType>1</VisitType>
				  	<ConfirmationStatusID>1</ConfirmationStatusID>
				  	<ConfirmationStatusName>Not Confirmed</ConfirmationStatusName>
				</TechSchedule>
	  		</data>
		</response>
  	</responses>
</root>