AIM Web Services

<back to all web services

PostServiceTicketRequest

PostServiceTicket
Requires active-e Service Tickets Service

The following routes are available for this service:
POST/api/PostServiceTicket
PostServiceTicketRequest Parameters:
NameParameterData TypeRequiredDescription
RefNumberquerystringNoOnline reference number of this appointment
SerialNumberquerystringNoSerial number of the item to be serviced
CustomerAcctqueryintegerNoThe AIM customer account # of the customer. Optional.
CustomerInfoqueryobjectNoCustomer Information
FormInputListqueryarrayNoAdditional Customer or Appointment info
CcInfoqueryobjectNoCredit Card info of the customer for this appointment
NotesquerystringNoNotes on this appointment
VoiceRecordingbodystringNo
ItemDescriptionquerystringNoDescription of the item to be serviced
BaseSecureRequest Parameters:
NameParameterData TypeRequiredDescription
TokenHeaderstringNo
DeviceIdHeaderstringNo
AppIdHeaderstringYes
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
ApiKeyheaderstringYesThis is your AIM API Key provided by Tri-Tech
OAuthTokenheaderstringNo
CustomerInfo Parameters:
NameParameterData TypeRequiredDescription
WebIdqueryintegerYesThe WebId of the customer. Optional.
NamequerystringYesName of the customer.
Addr1querystringNoAddress line 1 of the customer
Addr2querystringNoAddress line 2 of the customer
CityquerystringNoCity of the customer
StquerystringNoState/Province of the customer
ZipquerystringNoZip code of the customer
CountryquerystringNoCountry of the customer
PhonequerystringNoPhone number of the customer
EmailquerystringYesEmail address of the customer. Required.
FormInput Parameters:
NameParameterData TypeRequiredDescription
KeyquerystringYesField Name of the Input Field
ValuequerystringYesValue of the Input Field.
EncryptedquerybooleanYesWhether or not the field is encryped with the C2B encryption key.
CcInfo Parameters:
NameParameterData TypeRequiredDescription
TokenStrquerystringYesToken returned from processor
CardTypequerystringYesCard Type (VISA, MCARD, AMEX, DSCVR)
LastFourquerystringYesLast four of the card
ExpirationquerystringNoExpiration Date of the Card. (MM/YY)
ReasonOnFilequerystringNoReason the card is on file.
TokenPkqueryintegerNoID of the existing Token Record in AIM, if applicable
PrimaryquerybooleanNoIs this the customer's primary card? Defaults to false.
PostServiceTicketResponse Parameters:
NameParameterData TypeRequiredDescription
WebRefformstringNo
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
StatusbodyBaseResponseResultNo
BaseResponseResult Parameters:
NameParameterData TypeRequiredDescription
StatusCodebodystringNo
LoginbodystringNo
ErrorCodebodystringNo
ErrorDisplayTextbodystringNo
ErrorMessagebodystringNo
DomainNamebodystringNo
IpAddressbodystringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/PostServiceTicket HTTP/1.1 
Host: active-ewebservice.biz 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"RefNumber":"String","SerialNumber":"String","CustomerAcct":0,"CustomerInfo":{"WebId":0,"Name":"String","Addr1":"String","Addr2":"String","City":"String","St":"String","Zip":"String","Country":"String","Phone":"String","Email":"String"},"FormInputList":[{"Key":"String","Value":"String","Encrypted":false}],"CcInfo":{"TokenStr":"String","CardType":"String","LastFour":"String","Expiration":"String","ReasonOnFile":"String","TokenPk":0,"Primary":false},"Notes":"String","VoiceRecording":"String","ItemDescription":"String","Token":"String","DeviceId":"String","AppId":"String","ApiKey":"String","OAuthToken":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"WebRef":"String","Status":{"StatusCode":"String","Login":"String","ErrorCode":"String","ErrorDisplayText":"String","ErrorMessage":"String","DomainName":"String","IpAddress":"String"}}