AIM Web Services

<back to all web services

SearchInventoryRequest

SearchInventory
Requires active-e Inventory Service

The following routes are available for this service:
POST, GET/api/SearchInventory
SearchInventoryRequest Parameters:
NameParameterData TypeRequiredDescription
LocFkbodyintegerNoIf sent, only items from the passed location will be returned
MfgFkbodyintegerNoFor Internal Use Only
CatFkbodyintegerNoFor Internal Use Only
SubFkbodyintegerNoFor Internal Use Only
SelFkbodyintegerNoFor Internal Use Only
CatbodyintegerNoIf sent, only items from the passed category# will be returned
SubbodyintegerNoIf sent, only items from the passed subcategory# will be returned. Must be used in conjunction with the Cat parameter.
SelectionCodebodystringNoIf sent, only items with the passed selection code will be returned
MfgbodystringNoIf sent, only items with the passed mfg code will be returned
IncludeSerialsbodybooleanNoSerialized Items will be included in the search results
IncludeMediabodybooleanNoMedia Items will be included in the search results
IncludeAccessoriesbodybooleanNoNon-Serialized, Non-Media Items will be included in the search results
IncludePackagesbodybooleanNoPackage Deal Items will be included in the search results
SearchStrbodystringNoThe string to be searched for
ExactModelbodybooleanNoIf set, only items with the exact model contained in the search string will be returned
StartOffsetbodyintegerNoThe Starting Offse
RecordCountbodyintegerNoThe # of records to be returned
IncludeIconImagebodybooleanNoIf set, Icon Image Urls will be included in the result, if available
CatIdListbodyList<long>NoIf sent, only items from the passed category IDs will be returned
SubIdListbodyList<long>NoIf sent, only items from the passed subcategory IDs will be returned
MfgIdListbodyList<long>NoIf sent, only items from the passed mfg IDs will be returned
SelIdListbodyList<long>NoIf sent, only items from the passed selection code IDs will be returned
IncludeDeletedbodybooleanNoDeleted Items will be included in the search results
ChangedDatequerystringNoIf sent, only inventory changed on or after this date/time will be included
IncludePackageLineItemsbodybooleanNoPackage Deal Line Items will be included
IncludeDetailsbodybooleanNoIf set, the InventoryDetails object for each item will also be returned. This is much slower.
MinimumAvailableQuantitybodyintegerNoIf sent, only items with an Available Quantity greater then or equal to the sent value will be returned. Use of this parameter requires that the LocFk parameter also be sent.
BaseSecureRequest Parameters:
NameParameterData TypeRequiredDescription
TokenHeaderstringNo
DeviceIdHeaderstringNo
AppIdHeaderstringYes
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
ApiKeyheaderstringYesThis is your AIM API Key provided by Tri-Tech
OAuthTokenheaderstringNo
SearchInventoryResponse Parameters:
NameParameterData TypeRequiredDescription
StartOffsetformlongNo
RecordCountformlongNo
RemainingRecordsformlongNo
TotalRecordsformlongNo
RecordsbodyList<SearchInventoryApiResult>No
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
StatusbodyBaseResponseResultNo
BaseResponseResult Parameters:
NameParameterData TypeRequiredDescription
StatusCodebodystringNo
LoginbodystringNo
ErrorCodebodystringNo
ErrorDisplayTextbodystringNo
ErrorMessagebodystringNo
DomainNamebodystringNo
IpAddressbodystringNo
SearchInventoryApiResult Parameters:
NameParameterData TypeRequiredDescription
DetailformInventoryDetailNo
IconImageformImageInfoNo
CustomerPriceformdecimalNo
SearchInventoryResultSet Parameters:
NameParameterData TypeRequiredDescription
PkformlongNo
DescriptionformstringNo
InventoryTypeformstringNo
ManufacturerformstringNo
ModelformstringNo
Categoryformdecimal?No
CategoryDescriptionformstringNo
SubCategoryformdecimal?No
SubCategoryDescriptionformstringNo
SelectionCodeformstringNo
SelectionCodeDescriptionformstringNo
SkuformstringNo
Discontinuedformbool?No
Attribute1formstringNo
Attribute2formstringNo
Attribute3formstringNo
Attribute4formstringNo
Attribute5formstringNo
Attribute6formstringNo
Attribute7formstringNo
Attribute8formstringNo
Attribute9formstringNo
Attribute10formstringNo
Attribute11formstringNo
Attribute12formstringNo
Attribute13formstringNo
Attribute14formstringNo
Attribute15formstringNo
Attribute16formstringNo
Attribute17formstringNo
Attribute18formstringNo
Attribute19formstringNo
Attribute20formstringNo
ComputerQuantityformdecimalNo
OurPriceformdecimalNo
RetailPriceformdecimalNo
ActiveePriceformdecimalNo
PriceAformdecimalNo
PriceBformdecimalNo
PriceCformdecimalNo
MinPriceformdecimalNo
AvailableQuantityformdecimalNo
IsMediaformboolNo
IsPackageformboolNo
HasImageformboolNo
SearchTermformstringNo
KeywordsformstringNo
KeywordsOriginformstringNo
DeletedformboolNo
TimeStampformDateTimeNo
InventoryDetail Parameters:
NameParameterData TypeRequiredDescription
SadPkformlongNo
InvTypeformstringNo
ModelformstringNo
DescriptionformstringNo
MfgformstringNo
CategoryformintNo
CategoryDescriptionformstringNo
SubCategoryformintNo
SubCategoryDescriptionformstringNo
SelectionCodeformstringNo
SelectionCodeDescriptionformstringNo
SellSerialsOnlineformboolNo
NotesformstringNo
ImagesformList<ImageInfo>No
HasImagesformboolNo
VariantDetailsformList<InventoryDetailByVariant>No
AddOnsformList<AddOnDetail>No
ActiveEInfoformActiveEInfoNo
WeightformdecimalNo
UnitformstringNo
ImageInfo Parameters:
NameParameterData TypeRequiredDescription
UrlformstringNo
ImageStreamformstringNo
ImageSizeformstringNo
ErrorMessageformstringNo
UriPkformlong?No
InventoryDetailByVariant Parameters:
NameParameterData TypeRequiredDescription
SkuPkformlongNo
SkuformstringNo
VendorCostformdecimal?No
VendorNameformstringNo
AttributesformList<InventoryDetailAttribute>No
LocationDetailsformList<InventoryDetailByLocation>No
ImagesformList<ImageInfo>No
HasImagesformboolNo
BarcodesformList<string>No
InventoryDetailAttribute Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
ValueformstringNo
PriorityformintNo
WebTypequeryintNo1 is 'Don't Send to Web', 2 is 'Guided Navigation'
InventoryDetailByLocation Parameters:
NameParameterData TypeRequiredDescription
SaqPkformlongNo
LocationInfoformLocationInfoNo
SerialsformList<InventoryDetailBySerial>No
SubstitutesformList<InventoryDetailSubstitute>No
RetailformdecimalNo
OurPriceformdecimalNo
SalePriceformdecimal?No
SaleInfoformstringNo
PriceAformdecimalNo
PriceBformdecimalNo
PriceCformdecimalNo
MinPriceformdecimalNo
CustomerPriceformdecimalNo
AllowPriceChangeformboolNo
QtyformdecimalNo
QtyAvailformdecimalNo
ActiveeHoldbackQtyformdecimalNo
ReorderMinformintNo
ReorderMaxformintNo
AverageCostformdecimal?No
WeightedCostformdecimal?No
LocatorformstringNo
SelectionCodeformstringNo
SelectionCodeDescriptionformstringNo
SpiffformdecimalNo
CurrentSpotCheckQtyformdecimal?No
QtyOutformdecimalNo
QtyOnOrderformdecimalNo
AvailableForSTRformdecimalNo
LocationInfo Parameters:
NameParameterData TypeRequiredDescription
IdformlongNo
DescformstringNo
ShortDescformstringNo
RegionformstringNo
LatitudeformdecimalNo
LongitudeformdecimalNo
InStorePickupformstringNo
ActiveformboolNo
InventoryDetailBySerial Parameters:
NameParameterData TypeRequiredDescription
SasPkformlongNo
SerialformstringNo
RetailformdecimalNo
OurPriceformdecimalNo
SalePriceformdecimal?No
StatusformstringNo
SaleInfoformstringNo
PriceAformdecimalNo
PriceBformdecimalNo
PriceCformdecimalNo
MinPriceformdecimalNo
AllowPriceChangeformboolNo
Costformdecimal?No
WeightedCostformdecimal?No
NotesformstringNo
AttributesformList<InventoryDetailAttribute>No
ImagesformList<ImageInfo>No
HasImagesformboolNo
IsActiveeHoldbackformboolNo
CustomerAcctformint?No
AvailableForSTRformboolNo
InventoryDetailSubstitute Parameters:
NameParameterData TypeRequiredDescription
ModelformstringNo
SkuformstringNo
MfgformstringNo
DescriptionformstringNo
PriceformdecimalNo
AvailableQtyformdecimalNo
AddOnDetail Parameters:
NameParameterData TypeRequiredDescription
SadPkformlongNo
SkuPkformlongNo
CatPkformlongNo
SubPkformlongNo
ItemformstringNo
DescriptionformstringNo
PriceformdecimalNo
ActiveEInfo Parameters:
NameParameterData TypeRequiredDescription
DimensionformstringNo
WebDescriptionformstringNo
SummaryformstringNo
SETitleformstringNo
SEDescriptionformstringNo
SEKeywordsformstringNo
SEAltTextformstringNo
SEHtmlFreeTextformstringNo
UnpublishedformboolNo
FreeShippingformboolNo
IsFeaturedformboolNo
WebCategoryIdsformList<long>No

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/SearchInventory HTTP/1.1 
Host: active-ewebservice.biz 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"LocFk":0,"MfgFk":0,"CatFk":0,"SubFk":0,"SelFk":0,"Cat":0,"Sub":0,"SelectionCode":"String","Mfg":"String","IncludeSerials":false,"IncludeMedia":false,"IncludeAccessories":false,"IncludePackages":false,"SearchStr":"String","ExactModel":false,"StartOffset":0,"RecordCount":0,"IncludeIconImage":false,"CatIdList":[0],"SubIdList":[0],"MfgIdList":[0],"SelIdList":[0],"IncludeDeleted":false,"ChangedDate":"0001-01-01T00:00:00.0000000","IncludePackageLineItems":false,"IncludeDetails":false,"MinimumAvailableQuantity":0,"Token":"String","DeviceId":"String","AppId":"String","ApiKey":"String","OAuthToken":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"StartOffset":0,"RecordCount":0,"RemainingRecords":0,"TotalRecords":0,"Records":[{"Detail":{"SadPk":0,"InvType":"String","Model":"String","Description":"String","Mfg":"String","Category":0,"CategoryDescription":"String","SubCategory":0,"SubCategoryDescription":"String","SelectionCode":"String","SelectionCodeDescription":"String","SellSerialsOnline":false,"Notes":"String","Images":[{"Url":"String","ImageStream":"String","ImageSize":"String","ErrorMessage":"String","UriPk":0}],"HasImages":true,"VariantDetails":[{}],"AddOns":[{}],"ActiveEInfo":{"Dimension":"String","WebDescription":"String","Summary":"String","SETitle":"String","SEDescription":"String","SEKeywords":"String","SEAltText":"String","SEHtmlFreeText":"String","Unpublished":false,"FreeShipping":false,"IsFeatured":false,"WebCategoryIds":[0]},"Weight":0,"Unit":"String"},"IconImage":{"Url":"String","ImageStream":"String","ImageSize":"String","ErrorMessage":"String","UriPk":0},"CustomerPrice":0,"Pk":0,"Description":"String","InventoryType":"String","Manufacturer":"String","Model":"String","Category":0,"CategoryDescription":"String","SubCategory":0,"SubCategoryDescription":"String","SelectionCode":"String","SelectionCodeDescription":"String","Sku":"String","Discontinued":false,"Attribute1":"String","Attribute2":"String","Attribute3":"String","Attribute4":"String","Attribute5":"String","Attribute6":"String","Attribute7":"String","Attribute8":"String","Attribute9":"String","Attribute10":"String","Attribute11":"String","Attribute12":"String","Attribute13":"String","Attribute14":"String","Attribute15":"String","Attribute16":"String","Attribute17":"String","Attribute18":"String","Attribute19":"String","Attribute20":"String","ComputerQuantity":0,"OurPrice":0,"RetailPrice":0,"ActiveePrice":0,"PriceA":0,"PriceB":0,"PriceC":0,"MinPrice":0,"AvailableQuantity":0,"IsMedia":false,"IsPackage":false,"HasImage":false,"SearchTerm":"String","Keywords":"String","KeywordsOrigin":"String","Deleted":false,"PackageLineItems":[{"Model":"String","Cat":0,"Sub":0,"Description":"String","Quantity":0,"Amount":0,"Discount":0,"ItemType":"String"}]}],"Status":{"StatusCode":"String","Login":"String","ErrorCode":"String","ErrorDisplayText":"String","ErrorMessage":"String","DomainName":"String","IpAddress":"String"}}