Search for Items

This service retrieves items applicable for Purchase Order. Items can be searched by either Item or VPN. Enter an item number, a partial item description, or a VPN in the search string. When the search type is ITEM, the search string can be an item number, a partial item number, an item description, or partial item description. When the search type is VPN, the search string can be a VPN or partial VPN.

Returned items must meet the following criteria:

• Approved status.

• Transaction-level items.

• Orderable items.

• Pack items with an order as type of Pack.

• When a supplier is sent as input:

  • Only items supplied by the input supplier are returned.

  • The item information sent out in the service response is based on the Item/Supplier/Primary Origin Country.

• When supplier is not sent as input, the item information is based on the primary supplier and primary origin country.

• If the Department Level Orders system option is set to "Yes" and the Department is sent in as an input, only items matching the department are returned.

Example URL

Here is an example of the resource URL:

GET

/PurchaseOrders/item?itemSearchType={itemSearchType}&searchString={searchString}&dept={dept}&supplier={supplier}&locations={locations}&pageSize={pageSize}&pageNumber={pageNumber}

Example Response

Here is an example of the response body in JSON format:

{
   ""links"": [],
   ""totalRecordCount"": 1,
   ""results"": [
      {
         ""links"": [],
         ""item"": ""100001887"",
         ""itemDesc"": ""Basic T-Shirt:Black:Medium"",
         ""supplier"": 2200,
         ""originCountry"": ""US"",
         ""suppPackSize"": 1,
         ""unitCost"": 5,
         ""supplierCurrency"": ""USD"",
         ""baseUnitRetail"": 7.26,
         ""retailCurrency"": ""USD"",
         ""baseRetailUnitOfMeasure"": ""EA"",
         ""itemImageUrl"": null,
         ""dept"": 1102,
         ""itemSearchLocRDO"": [
            {
               ""links"": [],
               ""location"": 363640301,
               ""locationType"": ""W"",
               ""unitRetail"": 7.26,
               ""retailCurrency"": ""USD"",
               ""unitRetailUnitOfMeasure"": ""EA"",
               ""itemLocStatus"": ""A"",
               ""hyperMediaContent"": {
                  ""linkRDO"": []
               }
            }
         ],
         ""hyperMediaContent"": {
            ""linkRDO"": []
         }
      }
   ],
   ""hyperMediaContent"": {
   ""linkRDO"": []
   }
}