On this page

Overview

The integration between Winehub and Vinoshipper provides a connection between the two systems, enabling Winehub and Shopify users to leverage a robust set of Vinoshipper tools from including sales tax and compliance.

To see all Vinoshipper has to offer please visit Vinoshipper.com.

back to top


Prerequisites

Before proceeding with the integration, please ensure the following: 

  1. You have an active account with both Vinoshipper and Winehub. 
  2. Your products are uploaded and approved in both Vinoshipper and WineHub.

    Important: The Product SKUs in your Vinoshipper and Winehub accounts must match exactly. This is crucial for accurate order matching across both systems. 

back to top


Setting Up the API Integration

  1. Access the API key:
    1. Log in to your Vinoshipper account.
    2. An ACH form is required to be on file with Vinoshipper prior to transactions being processed.
    3. Select Account, in the top navigation bar.
    4. Click Integrations and select API Keys.  
  2. Generate and save an API key:
    1. Click on the Create New Key.
    2. Save the API Key and Secret Key in a secure place as you will need to provide them to Winehub for the integration to be complete.
  3. Provide API key and secret key to Winehub.
  4. Follow the installations instructions provided by Winehub: Installation Steps


back to top


Order matching

For the integration to function, it is essential to have the identical products and SKUs in Winehub and Vinoshipper. The following guidelines should be adhered to:

  1. SKU consistency: Ensure all SKUs in Winehub are identical to the SKUs in Vinoshipper. Any discrepancies in SKU will cause the order to fail. Please copy and paste the SKUs directly from your WineHub account to Vinoshipper products. 
  2. Product information: Regularly update product information in both systems, such as new wine and non-wine products.
  3. Inventory: Set starting inventory for products in both Winehub and Vinoshipper to the same level.

SKU mapping

SKU mapping takes place in Winehub. All products in your Vinoshipper account will be populated into the Winehub SKU Mapping and they are to be matched to the products held in Winehub.

back to top


Fees

Vinoshipper fees will be withdrawn from your bank account by ACH debit once a month, or for existing Vinoshipper clients with sales, they will be netted off the funds payable to you to the extent available. The balance being debited to your account.

An ACH form is required to be on file with Vinoshipper prior to transactions being processed.

Winehub fees

  • Monthly recurring fees and integration setep fees are provided by Winehub upon joining.

Vinoshipper fees

  • In-state transactions or transactions where the producer is the permit holder:
    • 1.85% of product selling price + unit fee
      • $0.15/unit for pick up orders
      • $0.75/unit for shipped order 
    • 2.9% credit card fee (only applies when using Vinoshipper directly. Does not apply to orders from a 3rd party integration)
  • Transactions to states provided by Vinoshipper
    • 7.75% + $0.75/unit
  • Transactions directly through Vinoshipper
    • 9.75% + $0.75/unit or $0.15 (credit card fee is included)

back to top


Frequently asked questions

Set up & billing

  1. Do I need an account with both Vinoshipper and Winehub?
    • Yes, you must sign up and be approved with both platforms.
  2. Do we need to setup a UPS account?
    • When you open an account with Vinoshipper we open a UPS account for transactions done through the platform. We have negotiated rates with UPS that you benefit from.  
  3. How are we billed for orders through Vinoshipper?
    • Vinoshipper fees, including taxes, shipping, and software fees, will be withdrawn from your bank account by ACH debit once a month. If you are an existing Vinoshipper client, fees will be netted off the funds payable to you. Please contact customerservice@vinoshipper.com for an ACH form.

Orders

  1. From which platform does the customer receive an order notification? 
    • All customer notifications will be sent from the Winehub platform.
  2. The order number looks different in the two systems. Why?
    • In Vinoshipper, we add a pre-fix (your VS account number) to order numbers to identify it as an Winehub transaction.
  3. Why do I get an email from both Vinoshipper when I process an order?
    • This is normal and serves as a crosscheck that the order was confirmed in both systems.
  4. How do I modify/edit an order?
    • You are unable to edit orders pushed to Vinoshipper. You will need to cancel the order in Winehub, then create a new order.
  5. How do I cancel an order?
    • Cancel the order in Winehub and then login to Vinoshipper and cancel the order.
  6. What happens if a customer’s order is damaged or lost in transit?
    • Vinoshipper will submit a damage refund order. We will refund the producer (you) and cancel the order on our side. You will need to communicate with your customer to decide the next steps.
  7. How do I process samples & gifts when using an API? 
  8. Seeing Vinoshipper errors in your Winehub account?  
  9. An order failed because of insufficient inventory in Vinoshipper, what do I do? 
    1. Adjust the inventory in Vinoshipper. Orders will not automatically process when inventory is added retroactively. Please reach out to Winehub for instructions on re-processing.  

Shipping

  1. Do we need to ship from your warehouse or do we fulfill from our own warehouse?
    • You fulfill orders from your own warehouse or facility. Please get in touch if you are using a fulfillment center.
  2. Where do I access packing slips and shipping labels?
    • In order to access the packing slip and shipping label for an order, you will need to go into your Vinoshipper account. They are found in Orders > Open Shipments. If you are just printing one at a time, you can use the search bar on the left side of this page to find the correct order.
    • To receive order notifications from Vinoshipper, update the notification email in your Vinoshipper account under Account > Notifications > New Order Received and Orders Cancelled.
  3. How do we manage flat rate shipping on our orders in Winehub?
    • When an order gets sent across to Vinoshipper, Vinoshipper automatically pulls the taxes and shipping rate from UPS. It is necessary to setup the shipping rate in Winehub to ensure the flat rate for the customer.
  4. What if UPS returns an order that went through the Vinoshipper integration? 
    • If UPS does everything it is required to do to attempt delivery, Vinoshipper will cancel the order on our side and charge the producer (you) any shipping fees for the order. You will need to communicate with your customer to decide the next steps.
    • If UPS incorrectly returns the package, we will cancel and refund the order to the producer in full and you will need to communicate with your customer to decide next steps.
  5. The return address on the UPS label states Zerolink instead of our winery name and details. Why?
    • For compliance purposes, when Vinoshipper is the shipper, the return label will say zerolinkmarkets - which is our corporate name. We cannot change that for compliance purposes. If shipping on your producers permit, it will show your name.

Compliance

  1. What compliance checks does Vinoshipper do?
    • Vinoshipper age verifies all buyers, buyer volume limits, dry ZIP code exclusions, 9 digit ZIP tax calculations, alcohol tax variations, alcohol type restrictions, state specific taxes, state exclusions, state exempt products
  2. Who sends in the state compliance reports? 
    • For all orders passed to Vinoshipper for the states where you do not hold a license, you do not have any state compliance requirements. 
    • If you are using Vinoshipper for your home states or additional states where you are licensed, you are responsible for the compliance reports. 
    • If you are interested in Vinoshipper filing state reports on your behalf, please contact customerservice@vinoshipper.com to inquire about our Compliance Management Services (CMS).

back to top