Raises a ticket in predatar portal (using authentication key)
Requires authentication? | Yes (Predatar agent authentication key only) |
Post content type | application/json |
Response formats | JSON |
{
"authenticationKey":"EE0DAB49-D43C-4552-AEDA-D281ECF872EA",
"nodeKey":"TSM-ABC-01",
"priorityId":"2",
"statusId":"3",
"synopsis":"Ticket synopsis",
"detail":"Ticket details",
"assignedToName":"",
"assignedToType":"",
"incidentContactName":"User Name A",
"incidentContactType":"U"
}
IncidentContactType can be "U" (for user) or "G" (for group).
Name | Description |
---|---|
authenticationKey required |
Authentication key for the predatar agent against which a ticket is to be raised. |
nodeKey required |
Predatar agent name against which a ticket is to be raised. |
synopsis required |
Short description of the ticket. |
detail required |
Detailed description of the ticket. |
priorityId required |
Priority id referes to urgency to raise the ticket. It can be 1, 2, 3 or 4 1 - critical 2 - severe 3 - moderate 4 - query |
statusId required |
StatusId refers to current status of the ticket. It can be 2,3 or 9 2- Customer: In progress 3 - Triage 9 - Customer: Unassigned |
assignedToName required |
Name of the User or Group to whom the ticket is initially assigned. If an invalid “AssignedtoName” group or user is specified then “AssignedtoName” field to be set to: (a) The companies “Default Incident User” (if one exists) or “Default Incident Group” (if one exists). If both are set, the “Default Incident User” takes precedence. (b) If neither of these are set then the “assigned to” field must be set to the group called "Default Group" Note: AssignedtoName is an empty string when status identifier of the ticket is 3 or 9 that is ticket is in Triage status or Customer: Unassigned status respectively. |
assignedToType required |
AssignedtoType can be "U" (for user) or "G" (for group). Note: AssignedtoType is an empty string when status identifier of the ticket is 3 or 9 that is ticket is in Triage status or Customer: Unassigned status respectively. |
incidentContactName required |
Name of User or Group who sets the incidentcontact field of Inc_Incident table. If an invalid "IncidentcontactName" group or user is specified I would like the "incident contact" field to be set to (a) The companies "Default Incident User" (if one exists) or "Default Incident Group" (if one exists). If both are set the "Default Incident User" takes precedence. (b) If neither of these are set then the "incident contact" field must be se to the group called "Default Group" |
incidentContactType required |
IncidentContactType can be "U" (for user) or "G" (for group). |
1548
If the call is successful then a ticket number is retured, otherwise an negative number indicating an error will be returned.
One of the following error codes can be returend:
-1002 | Returned when no authentication key is supplied to the soap header. |
-1003 | Returned when invalid authentication key is passed to the soap header. |
-2001 | Returned when no synopsis is provided to the function. |
-2002 | Returned when Priority Identifier is other than 1 to 4. |
-2003 | Returned when Status identifier is not equal to 2 or 3. |
-2004 | Returned when AssignedtoName is not an empty string (for StatusId 3 or 9 i.e. Triage status or Customer: Unassigned status). |
-2005 | Returned when AssignedtoName is an empty string (for StatusId 2 i.e. Customer: In Progress status). |
-2006 | Returned when AssignedtoType is not an empty string (for StatusId 3 or 9 i.e. Triage status or Customer: Unassigned status). |
-2007 | Returned when AssignedtoType is not equal to "U" or "G" (for StatusId 2 i.e. Customer: In Progress status). |
-2008 | Returned when IncidentContactType is not equal to "U" or "G". |
-2009 | Returned when IncidentContactName is an empty string. |
-2010 | Returned when invalid node key is supplied. |
-2011 | Returned when no node key is supplied. |