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

• Download the App

• 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.”

• • 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.

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:

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:write 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. 
  
  Example: reverbsync-condition:Excellent
  
  
• 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. 
  
  Example: reverbsync-shipping-profile:Guitars
  
  
• 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.
  

Multi-Locations Configuration Options

If you are using Multi-Locations in Shopify, please review the following information. 

For context, as we review the potential configurations you can choose, we’ll refer to the Multi-location Toggle, which is a toggle found on the integration app’s Settings page and that you can turn on/off at any time. Also, we’ll talk about the Manual location override, which is a tool that the Reverb team has that allows us to point the integration to a specific Shopify location to set it as the primary location.

There are three possibilities in terms of how multi-locations can be configured:

1. Multi-location Toggle ON + Manual location override Inactive:

• With this setup, the integration will sync the sum of stock of all Shopify locations and bring them over to Reverb to the corresponding listing.
  
  
• As Reverb orders come in, the integration will decrease the quantity of the location with the most stock. Because the manual override is inactive, the location that is adjusted will depend on the quantities assigned to each location at the moment the Reverb order comes in. Meaning, it can jump back and forth between locations.  
  
  

2. Multi-location Toggle ON + Manual location override Active:

• With this setup, the integration will sync the sum of stock of all Shopify locations and bring them over to Reverb to the corresponding listing.
  
  
• As Reverb orders come in, the integration will first decrease the quantity of the location that was set as the primary location with the manual override. Once that primary location is depleted, it will continue to the 2nd location. 
  
  
• If you have a 2nd and 3rd location, after the primary location is depleted, the app will adjust the location with the most stock at the time of the order. This means that it can jump back and forth between the 2nd and 3rd location once the first location is at zero. 
  
  

3. Multi-location Toggle OFF + Manual location override Active:

• Finally, with this setup, the integration will only sync the quantities assigned to the primary location selected with the manual override. 
  
  
• As Reverb orders come in, only the primary location quantities will be adjusted.

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.

Order Syncing

• In your Shopify Reverb App, turn on this feature using the Sync orders from Reverb toggle.
  
  
  
• After this is enabled, Reverb orders will begin syncing with your Shopify shop. Within each order, you can see relevant details. 
  
  

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. Also, keep in mind, not tracking quantity in Shopify will end a Reverb listing.
  
  
• 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. 
  
  
• Shopify Product Status and Channel Availability: A Shopify listing in a Draft or Archived status (instead of Active) will result in an ended listing with zero inventory on Reverb. A Shopify listing made unavailable in the "Online Store" under "Sales channels and apps" will also result in an ended listing with zero inventory on Reverb.