On this page

Overview

The integration between OrderPort and Vinoshipper provides a connection between the two systems, enabling OrderPort 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.

The integration occurs via an API, created by Vinoshipper, that once plugged into OrderPort allows the platforms to communicate.

back to top


Prerequisites

Before proceeding with the integration, please ensure the following: 

  1. You have an active account with both Vinoshipper and OrderPort. 
  2. Your products are uploaded and approved in both Vinoshipper and OrderPort.
    IMPORTANT: The Product SKUs in your Vinoshipper and OrderPort accounts must match exactly. This is crucial for accurate order matching across both systems. 
  3. In OrderPort you must have the Vinoshipper Module activated by emailing traci@orderport.net.

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 OrderPort for the integration to be complete.
  3. Provide API key and secret key to OrderPort: 
    1. Log in to OrderPort and navigate to the Vinoshipper module.
    2. Input the API key and Secret Key.
    3. Follow the steps provided by OrderPort to complete the setup of the integration: Vinoshipper Setup

back to top


Order matching

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

  1. SKU consistency: Ensure all SKUs in OrderPort are identical to the SKUs in Vinoshipper. Any discrepancies in SKU will cause the order to fail. 
  2. Product information: Regularly update product information, such as pricing and availability, in both OrderPort and Vinoshipper. This will ensure that customers receive accurate product details regardless of which platform is being used. 
  3. Inventory: Set starting inventory for products in both OrderPort 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. OrderPort processes CRV as a product item so that will also need to be setup as a product in Vinoshipper.

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


Processing fee setup

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

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

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.

OrderPort fees

  • Monthly recurring OrderPort fees are as provided by OrderPort 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 OrderPort?
    • 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 OrderPort Platform.
  2. The order number looks different in the two systems. Why?
    • In Vinoshipper, we add a pre-fix to order numbers to identify it as an OrderPort 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. 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.
  5. How do I process samples & gifts when using an API? 
  6. An order failed because of insufficient inventory in Vinoshipper, what do I do? 
    • Adjust the inventory in Vinoshipper. Orders will not automatically process when inventory is added retroactively.  Please reach out to your main provider for instructions on order processing. 

Shipping

  1. 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.
  2. Where do I access packing slips and shipping labels?
    • The packing slips and shipping labels can be found in OrderPort.
  3. How do we manage flat rate shipping on our orders in OrderPort?
    • 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 OrderPort to ensure the flat rate for the customer.
  4. 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.
  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

Getting Started Products Orders Customers Clubs Reports Help