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.
Ask your fulfillment house for its list of shipping method codes
Go to Settings > Fulfillment Methods & Rates
Select a shipping method to open it
In the Method Details section, select Wine Shipping or Vinfillment and enter the matching Method Code
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.
Go to the main Orders page.
Check the box next to each order you want to send. Only send orders with a shipping status of Not Shipped.
Open the Choose an Action menu at the bottom of the screen.
Select Wine Shipping Export [API] or Vinfillment Export [API].
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.
