Tickets

Tickets_Create

Create a ticket on a customer.

Input

• Ticket – Ticket object.
  • ID As Integer – Prohibited for this API function.
  • CustomerID As Integer – Rev.io customer ID. Required.
  • ContactPhone As String – Phone number of contact. Validated against phone number on contact if Contact ID is specified (must match if both are specified).
  • ContactName As String – Name of contact. Validated against name on contact if Contact ID is specified (must match if both are specified).
  • ContactID As Integer – Rev.io contact ID. Must be a contact associated with customer specified.
  • Description As String – Ticket description.
  • Resolution As String – Ticket resolution.
  • Status As Enum_Ticket_Status – Current status of ticket. Valid values are:
    • OPEN – General open status.
    • INWORK – Currently being worked.
    • CLOSED – Ticket is closed.
    • PENDING_CANCELLATION – Ticket is in the process of being canceled.
    • CANCELED – Ticket has been canceled.
  • CreatedDate As Date – Prohibited in this API function.
  • LastModifiedDate As Date – Prohibited in this API function.
  • ClosedDate As Date – Date ticket was closed. May only be specified if ticket status is "CLOSED".
  • LineID As Integer – The Rev.io Service ID that this ticket affects. Required.
  • DueDate As Date – The due date of the ticket.
  • Type As String – Ticket type (In Rev.io, Settings > Drop Down Editor > Ticket Type)
  • Journals – List of ticket journals
    • Journal – Individual journal item
      • ID As Integer – Prohibited in this API function.
      • Message As String – Message to be added to ticket journal.
      • CreatedDate As Date – Prohibited in this API function

Output

• ID As Integer – The ID of the ticket that was created.

Tickets_Query

Gets details of a ticket.

Required Input

• ID As Integer – Rev.io Ticket ID.

Output

• Ticket – Ticket object.
  • ID* As Integer** – Rev.io Ticket ID.
  • CustomerID As Integer – Rev.io customer ID.
  • ContactPhone As String – Phone number of contact. Validated against phone number on contact if Contact ID is specified (must match if both are specified).
  • ContactName**As String** – Name of contact. Validated against name on contact if Contact ID is specified (must match if both are specified).
  • ContactID**As Integer** – Rev.io contact ID. Must be a contact associated with customer specified.
  • Description As String – Ticket description.
  • Resolution As String – Ticket resolution.
  • Status As Enum_Ticket_Status – Current status of ticket. Valid values are:
    • OPEN – General open status.
    • INWORK – Currently being worked.
    • CLOSED – Ticket is closed.
    • PENDING_CANCELLATION – Ticket is in the process of being canceled.
    • CANCELED – Ticket has been canceled.
  • CreatedDate As Date – May be specified, however must match current CreatedDate.
  • LastModifiedDate As Date – May be specified, however must match current LastModifiedDate.
  • ClosedDate As Date – Date ticket was closed. May only be specified if ticket status is "CLOSED".
  • LineID As Integer – The Rev.io Service ID that this ticket affects. Required.
  • DueDate As Date – The due date of the ticket.
  • Type As String – Ticket type (In Rev.io, Settings > Drop Down Editor > Ticket Type)
  • Journals – List of ticket journals
    • Journal – Individual journal item
      • ID As Integer – Internal Rev.io Journal ID
      • Message As String – Journal Message
      • CreatedDate As Date – Date journal was created

Tickets_Search

Search for tickets and return one or more results if found.

Optional Input

• ID As List (Of Integer) – Rev.io Ticket ID.
• CreatedBy As List (Of Integer) – ID of the user who created the Rev.io ticket.
• Status As List (Of Enum_Tickets_Status) – Rev.io ticket status, will be one of the values from Standard Values: Enum_Ticket_Status.
• CustomerID As List (Of Integer) – ID of the customer to which the Rev.io ticket belongs.
• AssignedTo As List (Of Integer) – ID of the user to which the Rev.io ticket is assigned.
• RequiresRouteDecision As Boolean – returns orders that need to have a process route chosen (Settings > Processes)

Output

• Ticket – Ticket object.
  • ID As Integer – Rev.io Ticket ID.
  • CustomerID As Integer – Rev.io customer ID.
  • ContactPhone As String – Phone number of contact. Validated against phone number on contact if Contact ID is specified (must match if both are specified).
  • ContactName As String – Name of contact. Validated against name on contact if Contact ID is specified (must match if both are specified).
  • ContactID As Integer – Rev.io contact ID. Must be a contact associated with customer specified.
  • Description As String – Ticket description.
  • Resolution As String – Ticket resolution.
  • Status As Enum_Ticket_Status – current Rev.io ticket status, will be one of the values from Standard Values: Enum_Ticket_Status.
  • CreatedDateAs Date** – May be specified, however must match current CreatedDate.
  • LastModifiedDate As Date – May be specified, however must match current LastModifiedDate.
  • ClosedDate As Date – Date ticket was closed. May only be specified if ticket status is "CLOSED".
  • LineID As Integer – The Rev.io Service ID that this ticket affects. Required.
  • DueDate As Date – The due date of the ticket.
  • Journals – List of ticket journals
    • Journal – Individual journal item
      • ID As Integer – Internal Rev.io Journal ID
      • Message As String – Journal Message
      • CreatedDate As Date – Date journal was created
  • CreatedBy As Integer – The user ID of the user in Rev.io who created the ticket.
  • Type As String – Ticket type (In Rev.io, Settings > Drop Down Editor > Ticket Type)
  • Routes – process routes that can be selected for this ticket (Settings > Processes > Routes).
    • Route (repeats)
      • ID As Integer – Refers to a Process Route ID (Settings > Processes > Routes). This can be used with Tickets_Update to choose a route for the order.
      • Description As String – Text description of the process route for reference.

Tickets_Update

Updates an existing ticket.

Required Input

• Ticket – Ticket object.
  • ID As Integer – Rev.io Ticket ID. Required.
  • CustomerID As Integer2 – Rev.io customer ID.
  • ContactPhone As String – Phone number of contact. Validated against phone number on contact if Contact ID is specified (must match if both are specified).
  • ContactName As String – Name of contact. Validated against name on contact if Contact ID is specified (must match if both are specified).
  • ContactID As Integer – Rev.io contact ID. Must be a contact associated with customer specified.
  • Description As String String – Ticket description.
  • Resolution As String – Ticket resolution.
  • Status As Enum_Ticket_Status – Current status of ticket. Valid values are:
    • OPEN – General open status.
    • INWORK – Currently being worked.
    • CLOSED – Ticket is closed.
    • PENDING_CANCELLATION – Ticket is in the process of being canceled.
    • CANCELED – Ticket has been canceled.
  • CreatedDate As Date – The date the ticket was created.
  • LastModifiedDate As Date – The date the ticket was last modified.
  • ClosedDate As Date – Date ticket was closed. May only be specified if ticket status is "CLOSED".
  • LineID As Integer – The Rev.io Service ID that this ticket affects. Required.
  • DueDate As Date – The due date of the ticket.
  • ProcessRouteID As Integer – Selects a route for the ticket (if necessary). Values can be searched / found with Tickets_Search.
  • Type As String – Ticket type (In Rev.io, Settings > Drop Down Editor > Ticket Type)
  • Journals – List of ticket journals
    • Journal – Individual journal item
      • ID As Integer – Prohibited in this API function.
      • Message As String – Message to be added to ticket journal.
      • CreatedDate As Date – Prohibited in this API function.

Output

None