Skip to main content

Connect Wine Shipping or Vinfillment to Offset

Connect Offset to Wine Shipping or Vinfillment to send orders directly to fulfillment. This article covers setting up the integration, adjusting method codes, sending orders, and common errors.

Written by Siena Allen

Overview

Wine Shipping and Vinfillment are wine fulfillment houses with their own direct connections to Offset. You can send orders from Offset to either one without exporting and uploading files, or without using ShipCompliant. When your fulfillment house ships an order, its shipping status and tracking number come back to Offset automatically.
​

NOTE: If your fulfillment house gets your orders through ShipCompliant, you don't need this connection. If your fulfillment house runs on FORT, see Connect Your Fulfillment House through FORT instead.


Setting Up the Integration

Get Your Credentials

The first step is to get your API credentials from your fulfillment house. Ask your contact there for:

Fulfillment House

What You'll Need

Wine Shipping

Account Number, User Name and Password

Vinfillment

Client Code

NOTE: The Username and Password from Wine Shipping will appear as a string of numbers and letters. This is not the same username and password you use to log into your Wine Shipping account.

Once you have these, contact support@offsetpartners.com and our team will enter them to complete the integration.

IMPORTANT: Your credentials can gain access to your fulfillment accounts, so share them securely using one of these options:

  • A 1Password vault (preferred): We’ll create a secure vault and add you as a guest. Add your credentials there, then let us know once they’re in.

  • A one-time secret link: If you can’t use 1Password, paste your credentials into a one-time link service such as Yopass, One-Time Secret, or Password Pusher, then send us the link. The link stops working once it’s opened, so your credentials don’t stay in anyone’s inbox.

Don’t send credentials in a regular email or chat message, or put them in Google Sheets or other shared documents.

Once complete, a new option appears in the Choose an Action menu on the Orders page: Wine Shipping Export [API] or Vinfillment Export [API].

Add Your Fulfillment House's Method Codes to Your Shipping Methods

Each fulfillment house uses its own codes to identify shipping services. These codes tell your fulfillment house which carrier and service to use. If a code is missing or wrong, the order will not go through.

  1. Ask your fulfillment house for its list of shipping method codes

  2. Go to Settings > Fulfillment Methods & Rates

  3. Select a shipping method to open it

  4. In the Method Details section, select Wine Shipping or Vinfillment and enter the matching Method Code

  5. Save, then repeat for every shipping method that will go to your fulfillment house, including club-only methods

IMPORTANT: If you're switching fulfillment houses, update the method details on all of your shipping methods before you send any orders through the new connection. Changing a method code doesn't update orders that already exist, since each order keeps the code it had when it was placed.

To update existing orders, re-apply the shipping method so it picks up the new code. You can do this on a single order, or for many orders at once with Bulk Edit > Update the shipping method on the Orders page.

Send a Test Order

Before your first release or club run, send one test order and confirm with your fulfillment house that it arrived with the correct shipping method, products, and address.

Make sure the SKUs on your products in Offset exactly match the SKUs your fulfillment house has on file.


Send Orders to Your Fulfillment House

Once the integration is set up, you're ready to send orders to fulfillment.

  1. Go to the main Orders page.

  2. Check the box next to each order you want to send. Only send orders with a shipping status of Not Shipped.

  3. Open the Choose an Action menu at the bottom of the screen.

  4. Select Wine Shipping Export [API] or Vinfillment Export [API].

  5. The order status changes from Not Shipped to Processing once your fulfillment house receives it.

When your fulfillment house ships the order, Offset updates the status to Shipped and adds the tracking number.


Troubleshooting Common Errors

If your fulfillment house rejects an order, the error appears on the order in Offset, and the Shipping Status changes to Error.

To resend an order after fixing the error, set the order back to Not Shipped first, then resend using your fulfillment house's export option.

Authentication Error or Authorization Failure

The credentials in Offset don't match what your fulfillment house has on file. Ask your fulfillment house to confirm your credentials (Account Number, User Name and Password for Wine Shipping, or Client Code for Vinfillment), and send them to Offset Support through a secure link.

The Order's Shipping Method Isn't Recognized

The shipping method on the order is missing a method code or has a code your fulfillment house doesn't recognize. Correct the method details in Settings > Fulfillment Methods & Rates, update the shipping method on the order, then resend.

The Order Shows Processing but Your Fulfillment House Doesn't See It

Wait up to an hour, then contact Offset Support with the order number.

The Order Shipped but Still Shows Processing in Offset

Contact Offset Support with a few example order numbers so we can check that shipping updates are coming back from your fulfillment house.

Did this answer your question?