AIM Web Services

<back to all web services

MatchCustomerRequest

MatchCustomer
Requires active-e Customer Service.

The following routes are available for this service:
GET/api/MatchCustomer
MatchCustomerRequest Parameters:
NameParameterData TypeRequiredDescription
EmailquerystringNo
HomePhonequerystringNo
NamequerystringNo
CityquerystringNo
StatequerystringNo
IncludeNameOnlyMatchesqueryboolNo
BaseSecureRequest Parameters:
NameParameterData TypeRequiredDescription
TokenHeaderstringNo
DeviceIdHeaderstringNo
AppIdHeaderstringYes
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
ApiKeyheaderstringYesThis is your AIM API Key provided by Tri-Tech
OAuthTokenheaderstringNo
MatchCustomerResponse Parameters:
NameParameterData TypeRequiredDescription
PossibleMatchesformList<CustomerSearchRecord>No
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
StatusbodyBaseResponseResultNo
BaseResponseResult Parameters:
NameParameterData TypeRequiredDescription
StatusCodebodystringNo
LoginbodystringNo
ErrorCodebodystringNo
ErrorDisplayTextbodystringNo
ErrorMessagebodystringNo
DomainNamebodystringNo
IpAddressbodystringNo
CustomerSearchRecord Parameters:
NameParameterData TypeRequiredDescription
PkformlongNo
AcctformintNo
LastformstringNo
NameformstringNo
Addr1formstringNo
Addr2formstringNo
CityformstringNo
StformstringNo
ZipformstringNo
PhoneformstringNo
EmailformstringNo
OpenInvoicesformboolNo
RentalActivityformboolNo
StLocformstringNo
HoldformboolNo
BarcodeformstringNo
ColorformintNo
DependantInfoformList<DependantRecord>No
AdditionalDetailsformAdditionalDetailNo
MatchedOnformstringNo
DependantRecord Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
OnlineIdformstringNo
SchoolDistrictformstringNo
SchoolformstringNo
IdformlongNo
AdditionalDetail Parameters:
NameParameterData TypeRequiredDescription
CreationDateformDateTimeNo
LastModifiedDateformDateTimeNo
NotesformstringNo
CustomerDefaultformCustomerDefaultInfoNo
TaxAuthorityformTaxAuthorityInfoNo
CanChargeformboolNo
PopupNotesformstringNo
DlNumberformstringNo
Phone2formstringNo
Phone3formstringNo
Phone4formstringNo
LocationformLocationInfoNo
CustomerDefaultInfo Parameters:
NameParameterData TypeRequiredDescription
IdformlongNo
DescformstringNo
ShortDescformstringNo
TaxAuthorityInfo Parameters:
NameParameterData TypeRequiredDescription
IdformlongNo
DescformstringNo
ShortDescformstringNo
LocationInfo Parameters:
NameParameterData TypeRequiredDescription
IdformlongNo
DescformstringNo
ShortDescformstringNo
RegionformstringNo
LatitudeformdecimalNo
LongitudeformdecimalNo
InStorePickupformstringNo
ActiveformboolNo

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.

GET /api/MatchCustomer HTTP/1.1 
Host: active-ewebservice.biz 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"PossibleMatches":[{"Pk":0,"Acct":0,"Last":"String","Name":"String","Addr1":"String","Addr2":"String","City":"String","St":"String","Zip":"String","Phone":"String","Email":"String","OpenInvoices":false,"RentalActivity":false,"StLoc":"String","Hold":false,"Barcode":"String","Color":0,"DependantInfo":[{"Name":"String","OnlineId":"String","SchoolDistrict":"String","School":"String","Id":0}],"AdditionalDetails":{"Notes":"String","CustomerDefault":{"Id":0,"Desc":"String","ShortDesc":"String"},"TaxAuthority":{"Id":0,"Desc":"String","ShortDesc":"String"},"CanCharge":false,"PopupNotes":"String","DlNumber":"String","Phone2":"String","Phone3":"String","Phone4":"String","Location":{"Id":0,"Desc":"String","ShortDesc":"String","Region":"String","Latitude":0,"Longitude":0,"InStorePickup":"String","Active":false}},"MatchedOn":"String"}],"Status":{"StatusCode":"String","Login":"String","ErrorCode":"String","ErrorDisplayText":"String","ErrorMessage":"String","DomainName":"String","IpAddress":"String"}}