Commerce7 and Vinoshipper integration: user guide :

Overview

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

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

Prerequisites

Before proceeding with the integration, please ensure the following:

You have an active account with both Vinoshipper and Commerce7.
- Vinoshipper
- Commerce7
Your products are uploaded and approved in both Vinoshipper and Commerce7.
IMPORTANT: The Product SKUs in your Vinoshipper and Commerce7 accounts must match exactly. This is crucial for accurate order matching across both systems.

Setting Up the API Integration

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.
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 Commerce7 for the integration to be complete.
Provide API key and secret key to Commerce7.
Follow the installations instructions provided by Commerce7: Installation Steps

Order matching

For the integration to function, it is essential to have the identical SKU ID’s and product information in Commerce7 and Vinoshipper. The following guidelines should be adhered to:

SKU consistency: Ensure all SKUs in Commerce7 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 Commerce7 account.
Product information: Regularly update product information, such as pricing and availability, in both Commerce7 and Vinoshipper. This will ensure that customers receive accurate product details regardless of which platform is being used.
Inventory: Set starting inventory for products in both Commerce7 and Vinoshipper to the same level.

California CRV setup

If you are sending orders to California through the integration, a product item will need to be setup in Vinoshipper for the CRV. Commerce7 processes CRV as a product item so that will also need to be setup as a product in Vinoshipper.

Log into your Vinoshipper account and go to Products > Product List.
Click on New Product and then select Digital followed by API Fee.
For the SKU in Vinoshipper, use the same SKU as you have for the CRV fee in Commerce7.
Set the price at $0.10 and the inventory level at 10,000 (price will get overridden with what Commerce7 calculates and passes across).
Match the new CA CRV product in Commerce7.

Processing fee setup

If you are charging customers a processing fee as a percentage of the total order value in Commerce7, then that fee will need to be setup in Vinoshipper as a product. Please follow the directions below:

Log into your Vinoshipper account and head to the product list.
Click on New Product and then select Digital followed by Digital (Taxable) or Digital (Non-Taxable).
For the SKU in Vinoshipper, use the same SKU as you have for the processing fee in Commerce7.
Set the price at $1 and the inventory level at 10,000 (price will get overridden with what Commerce7 calculates and passes across).
Match the new processing fee product in Commerce7.

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.

Commerce7 fees

Monthly recurring Commerce7 fees are as provided by Commerce7 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)

Frequently asked questions

Set up & billing

Do I need an account with both Vinoshipper and Commerce7?
- Yes, you must sign up and be approved with both platforms.
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.
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.
Do I need to upload my customer data into Vinoshipper?
- No, however uploading customer information ensures all customers you have previously age verified, do not have to go through age verification again. Best practice is to upload your club member information to Vinoshipper.

Orders

From which platform does the customer receive an order notification?
- All customer notifications will be sent from the Commerce7 platform.
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 Commerce7 transaction.
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.
How do I modify/edit an order?
- You are unable to edit orders pushed to Vinoshipper. You will need to cancel the order in Commerce7, then create a new order.
How do I cancel an order?
- Cancel the order in Commerce7. It will be automatically cancelled in Vinoshipper.
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.
How do I process samples & gifts when using an API?
- Process the order as a cash order in your main platform. Alternatively, process the order directly in Vinoshipper, following our guide - Processing trade sample orders & competition orders
Seeing Vinoshipper errors in your Commerce7 account?
- Please refer to Commerce7 help documents: https://documentation.commerce7.com/vinoshipper-app
I have received a ShipCompliant error message, why?
- You are using both ShipCompliant and Vinoshipper. Make sure ShipCompliant is turned off in Commerce7 for all states that you are using Vinoshipper.
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 Commerce7 for instructions on order processing.

Shipping

Do we need to ship from your warehouse or do we fulfill from our own warehouse?
- You fulfill orders from your warehouse. Please get in touch if you are using a fulfillment center.
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.
How do we manage flat rate shipping on our orders in Commerce7?
- When an order gets sent across to Vinoshipper, Vinoshipper automatically pulls the taxes and shipping rate from UPS. It is necessary to override the shipping rate in Commerce7 to ensure the flat rate for the customer.
What if UPS returns an order that went through the VS 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.
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

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

Getting Started Products Orders Customers Clubs Reports Help