Query Product

Products can be searched for through PerfectSync based on a search term. Different orders, only the product itself from the catalog. The results supply identifiers, availability information, and pricing for each product related to the search term. However, note that data parameters such as availability cannot be used as search criteria. Only a generic search term may be provided by the user, and the results will include all potentially related products.

This API is triggered during the create order flow within the Customer Care UI. To add a product to the cart, it is searched for on the Find Product screen and the Query Product API returns the results and their product details.

Version	1.0
Call	https://integration.shopatron.com/api/snap/v1/product/?{search term}
Supported Formats	JSON
HTTP Method	GET
Schema	https://integration.shopatron.com/api/snap/v1/product.json

The .json address above can be used to access the schema within Postman.

The request itself is built within the URL by adding a “/?” to the call followed by specific parameters joined by the “&” symbol. For instance, searching for orders related to “shoes” would use the following format:

• https://integration.shopatron.com/api/snap/v1/product/?term=shoes

GET calls that support pagination for numerous results, such as when searching, also accept a perPage parameter that defines how many results can be returned on each page. The default is 10 and the maximum is 100. Switch between pages of results by appending the page parameter to the call. For example:

• https://integration.shopatron.com/api/snap/v1/product/?term=shoes&perPage=2&page=2

Additionally, “sortBy=relevance” can also be appended to sort by the closest matching value to the search term. This is the only value of sortBy that is supported by Customer Care at this time.

Example

The example case creates an API call to search for a product that has the following properties:

• Search term = “rolex”

This guide will demonstrate how to put together each section of the request.

Header

Note that all PerfectSync integration APIs use Basic Authorization, a Base64 encoded string of the username and password combination separated by a colon. This authorization will be included in the header for every API call, along with the following:

Header Name	Description	Data Type
Kibo-Manufacturer-Id	This contains the Kibo OMS manufacturer identifier	Integer
Kibo-Catalog-Id	This contains the Kibo OMS product catalog identifier	Integer
Kibo-Currency-Code	The product catalog currency ISO code	String
Kibo-Locale	The product catalog locale ISO code	String

Required Parameters

Unlike the REST APIs for order management outside of PerfectSync, querying is done only by a generic search time. A specific parameter of the product or order data cannot be searched for, but sortBy can be used to improve the results as explained above.

Parameter	Type	Description
term	string	Search term or terms to query products by. The minimum length is “1” and the maximum length is “100”.

Optional Parameters

The following parameters do not have to be provided because they are either optional or they have a default value that may not need to be changed.

Parameter	Type	Description
page	integer	The page number to begin listing the results from. The default and minimum value is “1”. While this parameter is technically required, this default means that it does not have to be provided in the request unless a different page is specifically desired.
perPage	integer	The (max) number of items to return per results page. The minimum value is “1” and the maximum value is “100”. The default is “10”.
sortBy	string	The field(s) to sort results by, use a minus (-) in front of field name for descending, a plus (+) for ascending. The minimum length is 1.

The Full Request

This is the entire request that will search for “rolex” products.

https://integration.shopatron.com/api/snap/v1/product/?term=rolex

The Full Response

The response will provide a list of all appropriate results and their blocks of product data.

{
    "totalCount": 380,
    "nextPage": 2,
    "perPage": 10,
    "collection": [{
        "productID": "VRX33151",
        "partNumber": "VRX33151",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 3650.0,
        "currency": "USD",
        "name": "18K Yellow Gold and Stainless Steel Datejust Automatic"
    }, {
        "productID": "VRX9706744",
        "partNumber": "VRX9706744",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 13500.0,
        "currency": "USD",
        "name": "18K Yellow Gold and Stainless Steel Daytona Automatic"
    }, {
        "productID": "VRX33175",
        "partNumber": "VRX33175",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 7495.0,
        "currency": "USD",
        "name": "18K Yellow Gold and Stainless Steel Datejust Automatic "
    }, {
        "productID": "VRX33063",
        "partNumber": "VRX33063",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 5650.0,
        "currency": "USD",
        "name": "18K Yellow Gold and Stainless Steel Datejust Automatic "
    }, {
        "productID": "VRX9706783",
        "partNumber": "VRX9706783",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 65000.0,
        "currency": "USD",
        "name": "Platinum Day-Date Special Edition Automatic"
    }, {
        "productID": "VRX33154",
        "partNumber": "VRX33154",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 3650.0,
        "currency": "USD",
        "name": "18K Yellow Gold and Stainless Steel Datejust Automatic"
    }, {
        "productID": "VRX9706635",
        "partNumber": "VRX9706635",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 3650.0,
        "currency": "USD",
        "name": "18K Yellow Gold and Stainless Steel Datejust Automatic"
    }, {
        "productID": "VRX9706738",
        "partNumber": "VRX9706738",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 5450.0,
        "currency": "USD",
        "name": "18K Yellow Gold and Stainless Steel Datejust Automatic "
    }, {
        "productID": "VRX33144",
        "partNumber": "VRX33144",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 5100.0,
        "currency": "USD",
        "name": "18K Rose Gold Cellini Cestello Manual"
    }, {
        "productID": "VRX9706735",
        "partNumber": "VRX9706735",
        "availability": "yes",
        "imageUrl": "url.com/images/image.png",
        "price": 17995.0,
        "currency": "USD",
        "name": "18K Yellow Gold Daytona Automatic"
    }],
}