# Vinoshipper FAQs #### How do I give CrushSuite access to my Vinoshipper account? Once your Vinoshipper account is set up, we need to be added as a partner so we can help with configuration, sync issues, and troubleshooting. The process takes about two minutes. Email your Vinoshipper contact and ask them to add `admin+[yourwinery]@crushsuite.com` as a team member on your account. Replace `[yourwinery]` with a short version of your winery name (for example, `admin+kt@crushsuite.com` for KT Winery). Here is a template you can copy and paste: > Hi \[Vinoshipper contact], > > Could you please add the following account as a partner to our Vinoshipper account? > > `admin+[yourwinery]@crushsuite.com` > > This is for the CrushSuite team to help us with our Shopify integration. > > Thanks! Once they confirm, CrushSuite will receive a partner invitation email and accept it. You do not need to do anything else on your end. *** #### How do I get my Vinoshipper API keys? 1. Log in to your Vinoshipper merchant account at [vinoshipper.com](https://vinoshipper.com). 2. Click **Account** in the top navigation. 3. Select **Integrations**. 4. Click **Create New Key**. 5. Copy the **API Key** and **Secret Key** that are generated. Paste both keys into CrushSuite's Settings page in your Shopify Admin to connect the accounts. *** #### How often do products sync with Vinoshipper? Your product catalog syncs automatically **once every 24 hours**. Inventory also updates **immediately after each purchase** to keep stock levels accurate. If you need to sync sooner, you can trigger a manual sync at any time from the CrushSuite Products page. *** #### Can I manually sync products? Yes. Open CrushSuite in your Shopify Admin, navigate to **Products**, and click the **Sync** button at the top of the page. The sync runs immediately and updates all product data, compliance rules, and inventory from Vinoshipper. *** #### Can I use one Vinoshipper account across two Shopify stores? Technically yes, but we recommend two separate Vinoshipper accounts when you are running two Shopify stores. Here is why. When two Shopify stores share a single Vinoshipper account, there are a few things that can go wrong: * **Order ID collisions.** If both Shopify stores generate an order with the same number (for example, both create order 1001 on the same day), Vinoshipper cannot distinguish them. We have to add custom logic on our side to prevent this, and it is not automatic. * **Product catalog bleeding.** Every product in the Vinoshipper account syncs to both Shopify stores by default. There is currently no way to filter sync to a specific subset of products. The workaround is to mark unwanted products as "draft" in each Shopify store so they do not show to customers, but this is a manual step. * **Customer data mixing.** Vinoshipper stores customers at the account level, so a customer who ordered from Store A will appear in the records for Store B too. If you have a strong reason to share one account (for example, simplified licensing reporting), let us know before you set it up. Otherwise, two accounts is cleaner and safer. *** #### What data syncs between Vinoshipper and CrushSuite? Once connected, the following data flows bidirectionally between Vinoshipper and your Shopify store through CrushSuite: * **Products:** Full catalog with compliance data (ABV, volume, varietal, vintage) imports from Vinoshipper to Shopify. Price and inventory updates flow both ways. * **Inventory:** Vinoshipper is the source of truth. Stock levels sync to Shopify automatically. * **Orders:** New Shopify orders route to Vinoshipper in real time after checkout. * **Customer data:** Name, email, date of birth, and shipping address sync with each order for compliance verification. * **Fulfillment status:** Once Vinoshipper ships an order, tracking info syncs back to Shopify and the customer gets notified. * **Compliance rules:** Your state shipping permissions, quantity limits, and restrictions flow from Vinoshipper's regulatory data into CrushSuite. *** #### Vinoshipper is the source of truth for inventory. What does that mean? It means you should always receive and manage inventory in Vinoshipper, not Shopify. Inventory levels sync from Vinoshipper to Shopify automatically. If you update inventory directly in Shopify, those changes can be overwritten the next time CrushSuite syncs. The most common failure mode we see with new clients: they receive stock in Shopify but not in Vinoshipper, so Vinoshipper thinks inventory is zero. When that happens, our pre-checkout compliance check fails (because there is no stock to ship), and customers get blocked at checkout even in states where you are licensed to ship. If customers are getting blocked unexpectedly, the first thing to check is whether your Vinoshipper product inventory is non-zero. *** #### How does the product sync work if I have multiple brands in one Vinoshipper account? CrushSuite syncs every product in your Vinoshipper catalog to Shopify. There is currently no way to filter the sync to only send specific products to a specific Shopify store. If you have multiple brands in a single Vinoshipper account and only want certain products visible on each Shopify store, the workaround is to mark the unwanted products as "draft" in each Shopify store. Draft products are hidden from customers but still exist in the catalog. A better long-term solution is usually one Vinoshipper account per brand. If you are setting up a new operation, we recommend that path. *** #### My Vinoshipper connection is showing "Invalid credentials." What's wrong? Three things to check: 1. **Copy the keys exactly as shown.** Both the API Key and the Secret Key are case-sensitive and easy to mistype. A single missing character will cause the error. 2. **Make sure you copied both.** Vinoshipper issues an API Key and a separate Secret Key. You need both in CrushSuite. 3. **Check that the Vinoshipper account is active.** Log in to vinoshipper.com directly and confirm your account is in good standing. If you still see "Invalid credentials" after checking all three, regenerate a new key pair in Vinoshipper (Account to Integrations to Create New Key) and paste the new keys in. Regenerating keys does not affect anything else. *** #### Does Vinoshipper or CrushSuite handle state licensing? Vinoshipper handles state licensing and the regulatory filings that go with it. CrushSuite reads your licensing status from Vinoshipper and enforces it at checkout so you only accept orders in states where you are licensed to ship. If you need to add a new state to your shipping permissions, you do that in Vinoshipper first. Once they confirm the license is in place, CrushSuite will sync the update and that state will become available at checkout. *** #### What is the fastest way to test if my Vinoshipper connection is working end-to-end? Place a real test order through your store. It is worth the $20-40. Full test walkthrough: 1. Open your store in an incognito browser window. 2. Add a wine product to your cart. 3. Check out with a real shipping address in a state you are licensed to ship to. 4. Use Shopify's test payment gateway if you want to avoid a real charge. 5. Once the order completes, log in to Vinoshipper and confirm the order appears in the Orders section within a few minutes. If the order shows up in Vinoshipper with the correct products, customer info, and shipping address, your integration is working. If it does not show up within five minutes, something is wrong with the sync. Contact us and we will help diagnose. *** #### What if an order fails in Vinoshipper but exists in Shopify? If you receive an order issue email, it means there was a problem syncing the order to Vinoshipper. Common causes and solutions: **No Vinoshipper Order ID:** The product may not exist in Vinoshipper, or inventory may be unavailable. Check the order in Shopify, verify the product details, and CrushSuite will attempt to sync again. **Vinoshipper Order ID exists but verification failed:** The customer's name, date of birth, or address couldn't be verified. Manually update the customer information in Vinoshipper and resend the order. **Invalid customer address:** Contact the customer to correct their address, update it in Shopify, and the order will auto-resend to Vinoshipper. *A detailed guide for handling failed orders is coming soon in the Orders & Fulfillment section.* If you need immediate help, [contact our support team](https://crushsuite.com/contact). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://crushsuite.gitbook.io/docs/compliance/faqs/vinoshipper-faqs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.