Shippo Integration

Shippo gives WineView access to discounted, multi-carrier shipping rates (USPS, UPS, FedEx, and 50+ others), label generation, and tracking updates. Shippo is the right choice when you want broad carrier coverage and aren't restricted to wine-specific compliance flows. For wine-specific shipping (state-by-state compliance, adult signature, temperature-controlled options), use Vinoshipper instead — or both.

Shippo is a business-group-wide integration. You connect it once and it covers shipping for every location in your business.

The Shippo page lives at Dashboard → Integrations → Shippo (/dashboard/integrations/shippo). Use Learn more in the page header to return to this article.

What Shippo Enables

Real-time rates from 50+ carriers, calculated from your origin location, the destination address, and the package dimensions.
Discounted USPS, UPS, and FedEx rates through Shippo's negotiated pricing.
Label generation — Print shipping labels directly from a fulfillment cycle or release.
Automatic tracking updates — As packages move through the carrier network, WineView updates each reservation's tracking status.
Wine shipping compliance support — Shippo provides carrier-level adult-signature and alcohol options when supported by the carrier.

For end-to-end label workflow, see Fulfillment cycles. For configuring shipping options at the tier and listing level, see Shipping configuration.

Connecting Shippo

When the integration is not connected, the page shows Connect Shippo with two cards.

Step 1: Choose the integration scope

The first card, Integration Scope, has two radio options laid out side-by-side:

Business-wide (with a building icon) — "Use the same Shippo account for all locations." Marked with a blue Recommended badge. This is the default selection.
This Location Only (with a map-pin icon) — "Use a separate Shippo account for this location." Marked with a gray Coming soon badge and disabled.

For now, leave Business-wide selected.

Step 2: Enter your API token

The second card, API Credentials, contains:

API Token field — A password-type input with the placeholder shippo_live_xxxxxxxxxxxxxxxx.
A help line: "Find your API token in your Shippo Settings."

Below the input, a green What you get info box lists:

Real-time shipping rates from 50+ carriers
Discounted USPS, UPS, and FedEx rates
Automatic tracking updates
Wine shipping compliance support

Below a separator, two buttons:

Connect Shippo — A primary green button. Disabled until the API Token field is filled. Reads "Connecting…" while processing.
Create Account — Outline button that opens goshippo.com/signup in a new tab if you don't have a Shippo account yet.

WineView accepts both shippo_live_* and shippo_test_* tokens. Use a test token only while you're evaluating the integration — labels generated with a test token are not real shipments.

Where to find your API token

Sign in to Shippo.
Open Settings → API.
Click Generate Token (or copy an existing Live token).
Paste the token into WineView and click Connect Shippo.

Connected View

Once Shippo is linked, the page header changes to Shippo with the integration name as the description. A Learn more button and a status badge (Active / Inactive / Error) appear in the upper right.

Connection Details

Field	Description
API Token	Masked token (e.g., `••••••••`). Read-only. To rotate, disconnect and reconnect with a new token.
Connected Since	The date the integration was first connected (formatted as full date).

If a recent rate or label call failed, an inline error alert appears below the fields with the failure message.

Below a separator, action buttons:

Activate / Deactivate — Toggles the integration's active state without removing the credentials.
- Activate enables label generation and rate calculation.
- Deactivate disables it without disconnecting; you can re-activate later in one click.
Open Shippo — Opens apps.goshippo.com in a new tab.

Activate / Deactivate is the right choice when you're switching providers temporarily or pausing fulfillment. Disconnect (covered below) is for permanently removing the credentials.

Day-to-Day Use

Once Shippo is Active, WineView uses it automatically wherever shipping is configured.

Rate display — When members choose a shipping option on a tier configured for Shippo, rates are pulled live and displayed inclusive of any discounts.
Label printing — Inside a fulfillment cycle, generate a label from a release or reservation. The label PDF is fetched from Shippo and stored against the reservation.
Tracking — Once a label is generated, WineView polls Shippo for tracking updates and surfaces the latest carrier event on the reservation.

For the per-tier shipping configuration (which carrier is used, package presets, etc.) see Shipping configuration.

Troubleshooting

Symptom	What to check
Status: Error	Open the error alert on the Connection Details card. Most failures come from token rotation, a Shippo plan limit, or invalid origin address.
No rates returned for a destination	Check that the destination state is allowed by your business shipping rules and that your origin location has a valid address. See Shipping configuration.
Label generation fails	Confirm the package weight and dimensions are present on the listing tier. Shippo rejects label requests with missing parcel data.
Tracking stuck on "Pre-transit"	The carrier hasn't scanned the package yet. Once the first scan happens, WineView updates within a few minutes of the next polling cycle.
I rotated my Shippo API token and now it's failing	Disconnect and reconnect with the new token. Activating / deactivating doesn't update credentials.

Disconnecting Shippo

To remove the connection, click Deactivate first if you want to keep the credentials on file but pause shipping. To remove permanently, contact support — Shippo disconnect is currently a server-side cleanup to ensure in-flight labels are not orphaned.

When disconnected:

The connection to Shippo is removed; future label / rate calls fall back to other providers if configured.
Existing labels and tracking remain on each reservation.
Reconnecting later requires re-entering your API token.

See also

Integrations overview
Vinoshipper integration (wine-specific compliance shipping)
Shipping configuration
Fulfillment cycles