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. Select "Account", in the top navigation bar.
    3. 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. Login 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.
    4. https://orderport.freshdesk.com/support/solutions/articles/72000607902-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 head to the 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 overriden 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 your 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 overriden 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

  • For in-state transactions or transactions where the producer is the permit holder:
    • The fee structure is 1.85% of product selling price plus $0.75 per item for shipped items or $0.15 for pick up items.  There is no fee in Vinoshipper for credit card processing as that happens within OrderPort. 
  • For states provided by Vinoshipper
    • The fee structure is 9.75% of the product selling prices plus $0.75 per item.  

back to top


Frequently asked questions

  1. From which platform does the customer receive an order notification? 
    • All customer notifications will be sent from the OrderPort Platform.
  2. 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.
  3. 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.  
  4. 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.
  5. Do I need an account with both Vinoshipper and OrderPort?
    • Yes, you must sign up and be approved with both platforms.
  6. 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.
  7. What if I cancel an order in OrderPort? 
    • You must also go into Vinoshipper and cancel the order.
  8. The order number looks different in the two systems. Why?
    • In Vinoshipper, we add a pre-fix order number as default by our system to identify it as an OrderPort transaction.
  9. 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. 
  10. 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 you customer.

back to top

Getting Started Products Orders Customers Clubs Reports Help