How Can We Help You?

How Can I Integrate Reverb With My Shopify?

Before you get started, please note: The Shopify<>Reverb integration we offer will not work with Shopify's Multiple Inventory Locations feature as the integration works on a 1 Shopify shop--1 Reverb shop basis. We have the ability to point the app to one of your locations, but it is not possible to integrate both. After installation, if you would like to choose a specific location, please contact integrations@reverb.com.

1. Installation
2. General Product Setup
3. Category Mapping
4. Basic Custom Tags
5. Product Syncing
6. Tips and Quirks

This Shopify app’s main functions are:

  • Draft Creation (Please note: draft creation is unidirectional. You can only create drafts from Shopify to Reverb, but not from Reverb to Shopify)
  • Bidirectional inventory syncing (Inventory changes resulting from orders on either platform will be reflected on both platforms)
  • Automatically publish drafts on Reverb once listings have been integrated.
  • Sync over all or specific listing info (title, descriptions, price, etc.)

 

Installation

Screen_Shot_2018-10-17_at_3.13.35_PM.png

  • The shop URL required on this step is your default Shopify store URL that Shopify originally assigned to you, not a tied custom domain you may have. Typically, they are in this type of format: exampleshopname.myshopify.com

  • Connect your Reverb Account:

    • After you enter your shop URL, you will be redirected to Reverb to enter your Reverb account credentials. Once you enter them, you will be brought back to Shopify to confirm the installation. At this point, click “Install unlisted app.”

Screen_Shot_2018-10-17_at_3.42.15_PM.png

    • Once installed, you can access your Shopify Reverb App in the “Apps” section of your Shopify account.

General Product Setup

Before syncing, there are a few steps we need to implement:

    • Set up Shop Policies
    • Set up Shipping Profiles. This is an important step to complete before your first sync. Shipping costs set in Shopify are not brought over to Reverb by our integration. Having shipping profiles will allow you to assign the shipping costs to your items more efficiently by using Shopify custom tags. (To learn how to use custom tags you can visit this guide). 
    • Have unique SKUs for products in Shopify. The SKU code is the unique identifier that connects the products between the two platforms. You must have your own SKUs in order for products to match. If you are hoping to sync products that are already present on both Reverb and Shopify, the SKUs need to be aligned. Meaning, the same SKU should be assigned to the same listing on both platforms. If it is not so, you may create duplicate listings on Reverb when the first sync happens. Snip20181017_13.png

Category Mapping

  • After downloading the app, you will need to match up your Shopify Product Types to Reverb’s Categories. This can be done in the “Category Mapping” tab within the Shopify Reverb App. 

  • Product Types: This term refers to Shopify’s version of “Categories.” Contrary to Reverb’s predetermined categories, Shopify users can name their Product Types whatever they want. The Product Type field can be found on the right side column of the Shopify listing editing page:

shopify.png

To map categories: 

  • First, click the "Category Mapping" header, then click the "Re-sync Shopify Product Types" button (1). Once the blue bar is finished loading, you will have to refresh the page for the Product Types to show up. 

  • Next, a list of your Shopify product categories will be generated with a corresponding drop down menu of Reverb product categories shown on the right column. Select the nearest matching category (2). For reference, you can find the entire Reverb Category map tree here.



Basic Custom Tags

There are a few custom tags that can help you during the initial setup. (To learn more about how to use custom tags you can visit this guide).

  • reverbsync-condition:[insert condition here] - This tag will allow you to set the condition on products that sync from Shopify to Reverb. If you don’t use a condition tag, the integration will automatically set the condition to Brand New. 
  • reverbsync-shipping-profile:[insert shipping profile name here] - This tag will allow you to assign shipping profiles via the integration. Without this tag, listings will be integrated without a shipping cost. 
  • reverbsync-upc-does-not-apply:on - This tag will be required for any Brand New, B-Stock, or Mint (with inventory) listings that you do not have UPC data for. UPC data is required on these listings, but, if you don't have that information, you can bypass the publishing requirement by adding this tag to the Shopify product.

Product Syncing 

  • To turn on the integration after your categories have been mapped, go to the "Settings" tab and toggle the switch in the top left: "Automatically sync existing listings" (1).

  • If you also want to create new listings, turn on the switch below that, labeled "Create drafts" (2).

  • If you are new to the integration, we recommend keeping the Automatically publish drafts toggle OFF so that you can get used to the app and are able to review new integrated listings on Reverb before publishing. 

  • Once the integration is running, Shopify will be your source of truth. Meaning, any manual inventory changes made in Shopify will sync to and overwrite the information on Reverb. The same applies for synced fields within a listing, such as the description, title or price. To control these specific fields, use the toggles on the right-hand column (3).
  •  



    • Once you’ve configured the integration to your liking, go to the "Sync Status" tab and click "Re-sync Everything" to start your first sync.

After the sync is complete, a list of sync logs will appear on the Sync Status page. Each row will correspond to a SKU. The Sync Status column will show you if the sync for a SKU was successful or not. If an error prevents a SKU from syncing, you will have to make the necessary adjustments before trying to resync. Some of the most common errors are:

  • missing_categories - Categories are not mapped correctly on the category mapping tab or a Product Type has not been assigned to the Shopify listing. Review listing Product Type and the app’s Category Mappings tab settings.
  • missing_shopify_data - Listings are missing a piece of crucial information, such as SKU code, title, price, images or description. Review Shopify listings and adjust accordingly. 
  • sku_not_on_reverb - The app has not been instructed to create new drafts for new SKUs. To adjust this, go to the Settings tab and turn the toggle "Create drafts (for new SKUs) from Shopify to Reverb" ON. Then, re-sync. 
  • duplicate_sku - This SKU already exists within the Shopify or Reverb inventory. All SKUs must be unique, so it needs to be altered.

Tips & Quirks 

  • Shopify Track Quantity: Shopify allows sellers to publish listings with zero inventory. This is not allowed on Reverb. Make sure the Track Quantity checkbox is checked in the Shopify listing and that it indicates a quantity of at least 1 in order to be able to publish on Reverb. 

  • Currency: Our app does not have currency conversion. This means that if your Shopify store is in Yens and your Reverb shop in USD, the integration will simply assign the same number on both platforms regardless of the currency. For example, if Shopify shows the listing for 10 Yens, the same integrated listing will be 10 USD on Reverb. To avoid this issue, you will need to assign the same currency to both your Shopify and Reverb shops. 

Please note: We do not access or store your customers’ names, email addresses or phone numbers and we do not use your customers’ orders information. However, in order to connect to Shopify’s API and be able to troubleshoot any issues with your shop’s integration, our app will require your authorization to access certain store information and IP address. You will be asked to clear this authorization during the installation process.

More questions? Just shoot an email to integrations@reverb.com.