Shipping Configuration

This guide explains how to set up and manage shipping for your wine club — including where you ship, which carriers you use, how labels are generated, and how shipping costs are handled for your members.

Getting to Shipping Settings

Navigate to Dashboard → Shipping in the sidebar (under the Business section). This is where you manage all shipping-related settings for your business.

Shipping Setup Overview

Shipping configuration in WineView covers three things: which states you can ship to, which carriers and services you use, and how shipping costs are split between you and your members.

Allowed Shipping States

You set the U.S. states your business ships to at the business group level. This is the single source of truth for shipping eligibility across your entire business — all locations, all listings, all clubs. This is critical for alcohol shipping compliance.

When a member enters a shipping address, it is checked against your allowed states. If their state is not on the list, they cannot complete an order that requires shipping. This means:

Members can only sign up with shipping addresses in your approved states
If your compliance or licensing situation changes, update the list and eligibility updates immediately
This setting applies uniformly across all your locations and listings

Manage your allowed states from the Shipping page. Use the search bar to find a state, toggle states on/off, and save changes.

Default Shipping Location

One of your locations is designated as the default origin for shipping orders. When the system generates a label or calculates rates and no specific location is assigned to the order, it uses this default location as the sender address.

To set your default shipping location:

Go to Dashboard → Shipping
Find the Default Shipping Location selector
Choose which location should be the default — pick the location that handles the majority of your shipping volume

You can always override the origin on individual orders when needed.

Carriers and Services

WineView supports a wide range of carriers and service levels. In the dashboard, carrier services display with friendly names.

UPS

Service
UPS Ground
UPS 2nd Day Air
UPS Next Day Air
UPS 3 Day Select

USPS

Service
USPS Ground Advantage
USPS Priority Mail
USPS Priority Mail Express

FedEx

Service
FedEx Ground
FedEx 2 Day
FedEx Overnight
FedEx Express Saver

DHL

Service
DHL Express
DHL Express Worldwide

Vinoshipper

Service
Ground
Expedited
2 Day

Other / Manual

Service
Other

For any carrier or method not listed above, you can enter tracking information manually. This covers local couriers, personal delivery, or any other shipping method you use.

Shipping Configuration Hierarchy

Shipping options can be configured at two levels, and the system resolves which one applies via ShippingService.resolveShippingOption:

Business group level — Default shipping settings that apply across all your tiers and listings
Tier level — Override settings on a specific tier that take priority over the business group defaults

When both exist, tier-specific settings always win. This means you can set a general shipping policy for your business, then customize it for specific tiers — for example, offering free shipping on your top-tier club while using flat-rate shipping everywhere else.

Shipping Costs and Who Pays

How shipping costs are handled is configured per shipping speed on each tier within your listings. Each tier defines options for up to three speeds — Standard, Expedited, and Next Day — and for each speed you choose a cost type that determines how the shipping cost is split between you and the member.

Shipping Speeds

Speed	What It Means
Standard	Ground-level service. Typically the most affordable option with the longest transit time.
Expedited	Faster transit, usually 2–3 day delivery depending on carrier and distance.
Next Day	Overnight or next-business-day delivery. The fastest and most expensive option.

You can enable one, two, or all three speeds on a given tier. Members choose from the enabled speeds at checkout.

Cost Types

For each enabled speed, you choose one of these cost types:

Cost Type	How It Works
Free	The business absorbs the full shipping cost. The member pays nothing for shipping.
Flat Rate	The member pays a fixed dollar amount you set, regardless of the actual carrier cost. Your business covers any difference.
Cover Up To	Your business covers shipping up to a set dollar amount. If the actual cost exceeds that cap, the member pays the difference. For example, if you set a $15 cap and shipping costs $22, the member pays $7.
Customer Pays	The member pays the actual shipping rate. No portion is covered by your business.

This per-speed configuration gives you fine-grained control — for example, you might offer free Standard shipping, a flat rate for Expedited, and have the customer pay full cost for Next Day.

Shipping Integrations

WineView connects with shipping providers to generate labels, calculate real-time rates, and provide tracking to your members. Two integrations are available:

Shippo

Shippo is a general-purpose shipping integration that supports UPS, USPS, FedEx, and DHL. When connected, you can:

Generate shipping labels directly from WineView
Get real-time shipping rate quotes from multiple carriers before purchasing a label
Automatically generate tracking URLs that are sent to members
Use bulk label generation for batch fulfillment during cycles and releases

Connect Shippo from Dashboard → Integrations → Shippo. You'll need your Shippo API token. See the Integrations guide for the exact setup steps.

Vinoshipper

Vinoshipper is a wine-specific shipping provider built for the wine industry. It handles:

Compliance checking for state-by-state shipping regulations
Age verification and adult signature requirements
Ground, Expedited, and 2 Day service levels
Direct-to-consumer wine shipping

Vinoshipper is particularly useful if you ship to states with strict wine shipping laws, as it handles the regulatory requirements for you. Connect Vinoshipper from Dashboard → Integrations → Vinoshipper. See the Integrations guide for the exact setup steps.

Shipping Labels

Shipping labels can be generated in three ways: through Shippo, through Vinoshipper, or entered manually.

When viewing a member's details in the fulfillment sidebar, you can generate a shipping label for their individual order. Select the carrier and service level, and the label is created right from the sidebar.

Generating Labels Through Integrations

When you generate a label through Shippo or Vinoshipper, the system handles everything:

Rates are calculated based on package weight, dimensions, origin, and destination
You select the carrier and service level
The label is generated and a tracking number is assigned
A downloadable label file is created for printing
A tracking URL is generated and shared with the member

Manual Shipments

If you ship through a method not connected to WineView, you can enter the tracking number manually. This updates the order status and notifies the member with tracking information, even though the label was not generated inside WineView.

Label Statuses

Labels move through these statuses as the shipment progresses:

Status	What It Means
Pending Label	A label has been requested but not yet generated by the shipping provider.
Created	The label has been generated but the package has not been shipped yet.
Printed	The label has been printed and is ready for handoff to the carrier.
Shipped	The package is in transit with the carrier.
Delivered	The package has been delivered to the member.
Exception	Something went wrong during transit (returned to sender, delivery attempt failed, etc.).
Cancelled	The label was cancelled before the package was shipped.

State Restrictions

Shipping wine is regulated state by state. WineView enforces your allowed-states list at every point where a shipping address is entered:

Member signup — Address must be in an allowed state to complete checkout with shipping selected
Address changes — If a member changes their shipping address, the new state is validated
Order creation — Orders to disallowed states are blocked

Keep your allowed-states list up to date as your licensing and compliance situation changes.

Item-Level Shipping Readiness

Before an inventory item can be included in a shipping order, it must meet two requirements:

Enabled for Shipping — The item must have shipping enabled. Items that are not enabled for shipping can only be used in pickup orders.
Weight — A weight must be set on the item. Shipping providers require package weight to calculate rates and generate labels.

If an item is missing either of these, it will not appear as available when preparing shipping orders. Make sure to configure both fields when adding or editing inventory items you intend to ship.

Bulk Operations

For large fulfillment runs — like a quarterly shipment cycle or a release — WineView supports bulk shipping operations:

Bulk label generation Generate shipping labels for all orders in a cycle or release at once, rather than one at a time. The system uses each order's destination address, your configured carrier preferences, and the fulfillment location to create labels in batch.

Bulk label printing After generating labels in bulk, you can download and print them all together for efficient batch processing. This streamlines the packing and shipping workflow when you are sending out dozens or hundreds of shipments at once.