Shoppable Merchant Setup
What is the Shoppable platform?
Shoppable is a patented commerce platform that enables the integration of e-commerce into editorial content, influencer experiences, CPGs websites, and digital magazines, allowing shoppers more easily purchase products they discover. Shoppable helps remove the friction that exists from discovery to purchase resulting in incremental sales for our merchant partners. Once a merchant joins the Shoppable platform, they tend to stay our partner. Some have partnered with us for over ten years now. Merchants love Shoppable's solution because it is proven to drive incremental revenue and new customers to them. Shoppable also provides merchants the option of a single checkout API partner to help manage integrations into new innovative partnerships without requiring the merchant to invest any new development or valuable resources.
Summary:
- Our platform enables shoppable® experiences on publishers’ websites to display and enable purchasing of products from merchants within native third-party sites.
- The Shoppable platform has a patented universal checkout that enables shopping on their website while our Merchants are remaining the MOR. This enables a better customer experience with regards to returns, exchanges and other customer care workflows.
- Merchants get the benefit of having their products displayed on publisher’s sites, often beside editorial content that is recommending their products.
Product Catalog Integration
In order for merchants to work with Shoppable®, they must expose their product catalog via a data feed in the form of:
- A Rest API (preferably a JSON that lists the metadata for the entire catalog)
- A merchant-hosted product feed file (XML or JSON file) served via HTTP, from your own web server
Shoppable’s platform will ingest the merchant’s product feed dynamically throughout the day depending on their catalog update frequency and query limits. Shoppable normalizes the data into a standard schema and imports it into the Shoppable® database so that the products are available for any users that use the Shoppable platform.
Requirements
Merchants give Shoppable® access to their product catalog using one of the options listed above. In order to integrate your product catalog, Shoppable® has the following requirements:
- UPC codes should be 12-Digits in length, static and consistent over time
- To remove products from the catalog, merchants should simply omit them from the product feed
- You must update your product feeds at least daily, but if your inventory changes frequently you may be required to provide updates several times a day or real-time updates.
- All content must be encoded as UTF-8 and must be valid XML or JSON.
Product Parameters
|
part_number (string) |
Returns the part number passed. |
|
name (string) |
Name of the product. |
|
brand (string) |
Brand of the product. |
|
merchant (string) |
Merchant selling the product and the party handling shipping. |
|
merchant_id (string) |
Id of the merchant. |
|
ship_free_min (string) |
The minimum shipping charge for this product. |
|
delivery_fee (string) |
Delivery fee for this product. |
|
ship_flat_rate (string) shipping_charge (string) |
Shipping flat rate for this product. The shipping charge for the product. |
|
description (string) url (string) category (string) |
Long description of the product. Affiliate link of the product. Nested categories. The category is formatted as''Level 1 category>Level 2 category > ...'' |
|
category_id (string) |
Id of the product category. |
|
merchant_tax_path (string) |
Product category as used by the merchant. |
|
customer_service_url (string) |
string Customer service URL of the merchant. |
|
return_policy_url (string) |
string Return policy URL of the merchant |
|
active (string) |
Availability of the product on a specific size and color. Products may be unavailable due to it being out of stock or poor feed data. |
|
merchant_item_id (string) |
Part number of the product as used by the merchant when available. |
|
merchant_sku (string) colors (string) |
SKU of the product as used by the merchant when available. An array of available colors with a price for a product. Each color also has arrays of images and sizes. |
|
image (string) retail_price (string) sale_price (string) |
General image for the product. The retail price of the product for a specific color of the product. The sale price of the product for a specific color of the product. This attribute will only be present if the product is on sale. |
|
discount_price (string) |
The sale price of the product after coupons are applied. This attribute will only be present if the product is on sale. |
|
price (string) |
The lowest price for the product will either be the retail price, the sale price, or the discounted price. |
|
on_sale (string) |
Determines if the product is on sale. |
|
coupons (string) |
An array of coupons that are acceptable to this product. This array includes the type of coupon($off,%off,free_shipping), threshold (which is the threshold when they are applied, and the amount saved. |
|
weight (string) |
Item weight when available. |
|
dimensions (string) |
Item Dimensions when available. |
|
alt_images (string) |
Alternate images of the product such as from different angles and/or colors. This is highly recommended to be included. |
|
free_shipping (string) |
Whether shipping by the merchant is free. |
|
color (string) |
Available color for a given product. |
|
size (string) |
Size of the product for a specific color. |
upc (string) UPC code for this specific product variation.
id (string) This is the SKU of the product of the specified color and size. This number is the most unique identifier of a
product in a feed.
Product Object:
[
{
"part_number": "string",
"name": "string",
"brand": "string",
"merchant": "string",
"merchant_id": "string",
"ship_free_min": "string",
"delivery_fee": "string",
"ship_flat_rate": "string",
"shipping_charge": "string",
"description": "string",
"url": "string",
"category": "string",
"category_id": "string",
"merchant_tax_path": "string",
"customer_service_url": "string",
"return_policy_url": "string",
"active": "string",
"merchant_item_id": "string",
"merchant_sku": "string",
"colors": "string",
"image": "string",
"retail_price": "string",
"sale_price": "string",
"discount_price": "string",
"price": "string",
"on_sale": "string",
"coupons": "string",
"weight": "string",
"dimensions": "string",
"alt_images": "string",
"free_shipping": "string",
"color": "string",
"size": "string",
"upc": "string",
"id": "string"
}
]
Merchant’s data feeds must not contain any prohibited items such as:
- Illegal Products
- Racist or Hate Symbols or Language
- Guns, Weapons, and Explosives
- Pornography
- Offensive Language
- Stolen Products
- Live animals
- Counterfeit Products
- Second-Hand, Used Products
- Service-Based items
- Unauthorized Reselling
Merchant’s Order API
If you have an API for accepting orders, Shoppable® will gladly integrate with that API. Our preference is to use a REST style API with JSON formatting, but we can integrate other formats as well.