Create Ticket

Creates a service desk ticket in your Vorex account using a ticketObj.

Request

URL	https://vorexlogin.com/CreateTicket

Type	Params	Values
HEAD	WSUserCredentials	Object
PARAM	ticketObj	Object
PARAM	outputMessage	OUTPUT String

WSUserCredentials - A custom authentication SOAP header object consisting of:
- UserName
- Password
- CompanyName
ticketObj (Ticket Object) - The ticket information will be specified in this Ticket Object consisting of the following parameters:
- ClientId (Int)
- Required
ClientName (string) - Links the ticket to a specific client. Soap Action https://vorexlogin.com/GetClientAccounts can be used to get the Accounts and their IDs
ClientSiteId (Int) - Optional. If not specified the Main Location will be automatically specified. Soap Action https://vorexlogin.com/GetAccountLocations can be used to get the locations and their IDs.
ClientContactId (Int) - Optional. Soap Action https://vorexlogin.com/ExportAccountsAndContacts can be used to get contacts information
TicketTitle (string) - Required.
TicketDetails (string) - Required.
TicketTypeId (Int) - Required. Soap Action https://vorexlogin.com/GetTicketTypes can be used to get ticket types.
TicketStatusId (Int) - Required. Soap Action https://vorexlogin.com/GetTicketStatuses can be used to get ticket statuses.
TicketPriorityId (Int) - Required. Soap Action https://vorexlogin.com/GetTicketPriorities can be used to get ticket priorities.
TicketQueueId (Int) - Optional if Primary Assignee is specified. Soap Action https://vorexlogin.com/GetTicketQueues can be used to get ticket Queues.
TicketPrimaryAssigneeId (Int) - Optional if Queue is specified. Soap Action https://vorexlogin.com/GetEmployeesList can be used to Employees User IDs
TicketSourceId (Int) - Required. Soap Action https://vorexlogin.com/GetTicketSources can be used to get Ticket Sources.
TicketOpenDate (datetime) - Required.

Example Request

POST /WS/OpenAPI.asmx HTTP/1.1
Host: vorexlogin.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://vorexlogin.com/CreateTicket"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <WSUserCredentials xmlns="https://vorexlogin.com/">
      <UserName>string</UserName>
      <Password>string</Password>
      <CompanyName>string</CompanyName>
    </WSUserCredentials>
  </soap:Header>
  <soap:Body>
    <CreateTicket xmlns="https://vorexlogin.com/">
      <ticketObj>
        <ClientId>int</ClientId>
        <ClientSiteId>int</ClientSiteId>
        <ClientContactId>int</ClientContactId>
        <TicketTitle>string</TicketTitle>
        <TicketDetails>string</TicketDetails>
        <TicketTypeId>int</TicketTypeId>
        <TicketStatusId>int</TicketStatusId>
        <TicketPriorityId>int</TicketPriorityId>
        <TicketQueueId>int</TicketQueueId>
        <TicketPrimaryAssigneeId>int</TicketPrimaryAssigneeId>
        <TicketSourceId>int</TicketSourceId>
        <TicketOpenDate>dateTime</TicketOpenDate>
      </ticketObj>
    </CreateTicket>
  </soap:Body>
</soap:Envelope>

Response

Status

Response

Success

CreateTicketResult:

Integer representing the new Ticket ID

outputMessage:

"Ticket #ticket_number# created successfully."

Failure

CreateTicketResult:

Returns Null

outputMessage:

"A valid ticket object is required."
"Ticket Title is required!"
"Ticket Details is required!"
"Ticket Assignee or/and Queue must be specified!"
"Failed to Create new Ticket."

Example Response

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CreateTicketResponse xmlns="https://vorexlogin.com/">
      <CreateTicketResult>int</CreateTicketResult>
      <outputMessage>string</outputMessage>
    </CreateTicketResponse>
  </soap:Body>
</soap:Envelope>