Get Product

The details of a specific product can be retrieved with the Get Product API, and passed from the front-end provider and catalog to the Customer Care UI to be displayed as part of an order. These details include not only the expected identifiers like UPC codes and pricing information, but also the inventory data and addition group or variants that the product is related to.

Version	1.0
Call	https://integration.shopatron.com/api/snap/v1/product/{productID}
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 Product ID is added to the endpoint to specify the product data being retrieved, as noted in the table above by {productID}.

Example

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

• Product ID VRX33151
• Order Item is Part Number VRX33151
• Addition item WPP34015 in group tpp5000

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

General Information

The product details that will be returned include:

• Product Identifiers (ID, SKU, UPC, etc.)
• Pricing Information
• Availability, inventory quantity, and in stock date
• Addition Groups
• Variants

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

The Full Request

This is the entire request that will retrieve the product of ID VRX33151.

https://integration.shopatron.com/api/snap/v1/product/VRX33151

The Full Response

The response will contain the following information:

{
    "productID": "VRX33151",
    "name": "18K Yellow Gold and Stainless Steel Datejust Automatic",
    "partNumber": "VRX33151",
    "imageUrl": "url.com/images/image.png",
    "availability": "yes",
    "totalInventoryQuantity": 1,
    "price": 3650.0,
    "currency": "USD",
    "additionGroups": [{
        "additionGroupID": "tpp5000",
        "name": "Timepiece Protection Plan ($2500 - $4999.99)",
        "additions": [{
            "additionID": "000",
            "name": "None",
            "price": 0.0
        }, {
            "additionID": "WPP34015",
            "name": "Timepiece Protection Plan",
            "price": 425.0
        }]
    }]
}