Vinoshipper is a third-party compliance solution that can be integrated with Winehub to ensure orders meet the legal shipping requirements across the United States. Once activated, Winehub will validate order compliance directly through Vinoshipper and provide detailed tools to resolve any flagged orders, including those placed into “quarantine.”

Setup the Vinshipper integration

To activate the Vinoshipper integration:

1. Go to Settings > Third Party Integrations.

2. Locate the Vinoshipper section.

3. Enter your API Key and API Secret (provided by Vinoshipper).

4. Click Validate Production Credentials.

Once validated, you’ll be able to choose which states to apply compliance checks for.

• Click the lock icon to unlock state selection.

• Manually select individual states or choose Select All.

Configuration Options

After enabling Vinoshipper, several additional settings can be toggled depending on your business needs:

• Enable Vinoshipper Integration (Required)

• Use Vinoshipper for Batch Orders

• Auto-Check and Commit Orders

• Send Email Notifications for Quarantined Orders

• Automatically Check Compliance for Club Run Orders

You’ll also be able to assign a fulfilment house and define your Shipping Classes. Be sure to Save Settings to complete setup.

Managing Compliance in Winehub

Once active, a Quarantine Orders section will become available in the Administration section of Winehub.

In this view, you’ll find a list of affected orders, along with action buttons that help you resolve issues quickly:

• Edit Order: Opens the order in Shopify.

• View Quarantined Details: Shows error messages and resolution steps.

Available Actions

For each quarantined order, you’ll see several options:

• Check Compliance – Re-checks compliance.

• Commit Order – Sends a compliant order to Vinoshipper.

• Check & Commit – Runs a new check, then commits if passed.

• Force Commit – Commits regardless of compliance status (will be flagged as “Compliance Unverified”).

• Cancel Order – Cancels the order in both Winehub and Vinoshipper.

Quarantined orders will be flagged on the customer profile page. When viewing a customer’s detail view, you’ll see:

• A warning banner if one or more orders are in quarantine.

• A list of affected orders.

Orders processed through Vinoshipper are automatically tagged in Shopify:

• vinoshipper-compliance-passed

• vinoshipper-compliance-failed

• vinoshipper-quarantined

These tags make it easy to identify and filter orders based on compliance status within Shopify. These tags will be automatically updated if the order is updated. 

You can resolve compliance issues directly from the Winehub quarantine interface or via the Shopify Orders UI. Once a quarantined order has been updated and verified, you can re-commit it or cancel it as needed.

Orders that have been forced through without compliance will be clearly labelled within your Vinoshipper dashboard.