> For the complete documentation index, see [llms.txt](https://crushsuite.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://crushsuite.gitbook.io/docs/compliance/getting-started/connecting-your-vinoshipper-account.md).

# Connecting Your Vinoshipper Account

CrushSuite Compliance integrates with Vinoshipper to handle wine-specific compliance, licensing, and fulfillment. Once connected, your products, orders, inventory, and compliance data sync bidirectionally between Vinoshipper and Shopify through CrushSuite.

***

### Prerequisites

* An **active Vinoshipper merchant account** at [vinoshipper.com](https://vinoshipper.com)
* Your Vinoshipper **API Key** and **Secret Key** (we'll generate these below)

***

### Step 1: Generate API Keys in Vinoshipper

1. Log in to your Vinoshipper merchant account at [vinoshipper.com](https://vinoshipper.com).
2. Click **Account** in the top navigation bar.
3. Select **Integrations** from the menu.
4. Click **Create New Key** to generate a new API key pair.
5. Copy both the **API Key** and the **Secret Key**. You'll need both in the next step.

> 📸 **Screenshot:** Vinoshipper Account → Integrations page showing the "Create New Key" button and the generated API Key / Secret Key fields

{% hint style="warning" %}
**Keep your API keys secure.** These keys provide access to your Vinoshipper account data. Do not share them with anyone who shouldn't have access to your compliance and order information.
{% endhint %}

***

### Step 2: Enter API Keys in CrushSuite

1. Open the **CrushSuite app** in your Shopify Admin.
2. If you're in the onboarding wizard, this step is presented automatically. Otherwise, navigate to **Integrations** in the CrushSuite sidebar.
3. Paste your **API Key** into the API Key field.
4. Paste your **Secret Key** into the Secret Key field.
5. Click **Test Connection** to verify the credentials.
6. Confirm the connection status shows **"Connected"**.

<figure><img src="https://3906158595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FagSKdREExJMSW7WgxBLr%2Fuploads%2F2CFhQtbHQFKPnSo4hsod%2FCleanShot%202026-03-12%20at%2012.44.44.png?alt=media&amp;token=288cf44e-1320-40fc-843a-f20f4319157a" alt=""><figcaption></figcaption></figure>

***

### What Happens After Connection

Once your Vinoshipper account is connected, CrushSuite begins syncing your data:

* **Products** — Your Vinoshipper product catalog imports into Shopify with compliance data (ABV, volume, varietal, vintage) mapped automatically
* **Compliance rules** — State shipping permissions, quantity limits, and restrictions sync from your Vinoshipper configuration
* **Inventory** — Stock levels sync bidirectionally between Vinoshipper and Shopify
* **Orders** — Future Shopify orders route to Vinoshipper for fulfillment automatically
* **Customers** — Customer data (including age verification) syncs for compliance purposes

The initial sync may take a few minutes depending on your catalog size. After that, CrushSuite syncs automatically once every 24 hours and immediately after each purchase.

***

### Troubleshooting

**"Invalid credentials" error** Double-check that you copied both the API Key and Secret Key correctly from Vinoshipper. Regenerate the keys if needed — creating a new key pair in Vinoshipper doesn't invalidate existing connections.

**"Connection timeout" error** This usually means Vinoshipper's servers are temporarily slow. Wait a minute and try again. If the problem persists, check [Vinoshipper's status page](https://vinoshipper.com) or [contact CrushSuite support](https://crushsuite.com/contact).

**"Account not found" error** Verify that your Vinoshipper account is active and in good standing. Log in to Vinoshipper directly to confirm your account status.

***

### Don't Use Vinoshipper?

If you manage your own compliance, licensing, and fulfillment, you don't need to connect a Vinoshipper account. See → Self-Compliance Setup

***