How to use Zapier with your website.
Use Zapier to connect you Online Store with more than 2,000 apps! Easy to install and simple to use!
Vivino Feed Integration
As the world’s largest online wine marketplace and most downloaded wine app, the Vivino community is made up of millions of wine drinkers from around the world, coming together to make buying the right wine simple, straightforward, and fun. Vivino uses crowd-sourced data to personalize wine recommendations so that every community member feels confident about their wine choices. Created for everyone who likes wine—from the wine curious to the wine enthusiast—the Vivino app is available for free on both Apple and Android devices.
After signing up to your VIVINO account, you can create a feed of your wine products to connect the catalog to the VIVINO app.
Create a feed of your wine products to connect the catalog to the VIVINO app.
How to generate the feed
Step 1: Create a category called Vivino.
Step 2: Add products to this category. If the category is not added to the navigation menu, it will be invisible in most themes. If in your case it is not invisible let us know and we can edit the code of the template.
Step 3: Vivino requires some mandatory fields that are not part of Jumpseller’s base settings, so you will need to create custom fields. Watch the video below to learn how to work with these fields.
Mandatory Custom Fields
| Attribute | Instructions | Example |
|---|---|---|
| product-name | The product name must be a combination of: [Producer] + [Wine Name and Appellation] + [Vintage] + [Wine Color]. If it is not White or Rosé, you may omit the color. If the wine is non-vintage (NV), use NV. | Famille Perrin Côtes du Rhône 2014 Rosé |
| price | Final price after all discounts. For sellers outside the USA/Canada, include taxes. Do not include the currency. | 12.50 |
| bottle-quantity | The number of bottles sold at the product price. | 1 |
| quantity-is-minimum | A true/false variable used to flag quantity-based discounts when quantities are not fixed. Set as true when a wine offers a lower price per bottle if the customer buys more than a specific quantity, usually 6 or 12 bottles. Set to false in all other cases. | False |
| bottle-size | Bottle volume, preferably in milliliters (ml). Supported volumes: 375 ml, 500 ml, 750 ml, 1000 ml, 1500 ml. | 750ml |
| link | The product URL on your website. | http://www.yourwebsite.com/category/wine-12345/ |
| inventory-count | The number of bottles available in stock. | 35 |
| product-id | A unique identifier for each wine (Jumpseller ID or product SKU). | 2714 |
Optional Custom Fields
| Attribute | Instructions | Example |
|---|---|---|
| producer | Wine producer name and sub-brand, if applicable. | |
| wine-name | Wine name. | |
| appellation | Region where the wine was produced (Appellation). | |
| vintage | Harvest year. For non-vintage wines, submit NV. | |
| country | Country of origin. | |
| color | Wine color. | |
| image | Bottle image link. | |
| description | Wine description, according to the producer. | |
| GTIN | Global Trade Item Number. Accepted formats: | |
| varietal | Grape variety percentages. | |
| producer-address | Producer’s address. | |
| importer-address | Importer’s address. | |
| ageing | Wine ageing process. | |
| alcohol | Alcohol percentage. | |
| closure | Closure type. | |
| winemaker | Winemaker’s name. | |
| production-size | Number of bottles produced. | |
| acidity | Acidity (unit=”g/l”). | |
| ph | pH value. | |
| non-alcoholic | Non-alcoholic. Yes/No. |
Product settings should look like this:
In your Product Settings it should look like this:
Recommended Additional Custom Fields — EU Electronic Label (e-Label) Attributes
This section lists the mandatory data for the electronic label (e-Label) for wines sold in the EU (required after 08/12/2023).
| Attribute | Instructions | Example |
|---|---|---|
| elabel | URL pointing to the electronic label with full information. | http://www.rotuloeletronico.com/produtor/nome_vinho_2024_750ml/ |
| residual-sugar | Residual sugar in grams per liter (unit=”g/l”). | 2.9 |
| fat | Fat content per 100 ml (unit=”g/100ml”). | 6 |
| protein | Protein content per 100 ml (unit=”g/100ml”). | 3 |
| salt | Salt content per 100 ml (unit=”g/100ml”). | 2 |
| energy | Energy value in kilojoules per 100 ml (unit=”kJ/100ml”). | 351 |
| ingredients | Ingredients list in descending order by weight. | Grapes, Water, Yeast, Sulfur Dioxide |
| contains-milk-allergens | Contains milk allergens (yes/no). | no |
| contains-egg-allergens | Contains egg allergens (yes/no). | yes |
| contains-gluten-allergens | Contains gluten allergens (yes/no). | no |
| contains-crustacean-allergens | Contains crustacean allergens (yes/no). | yes |
| contains-fish-allergens | Contains fish allergens (yes/no). | no |
| contains-peanut-allergens | Contains peanut allergens (yes/no). | no |
| contains-soybean-allergens | Contains soybean allergens (yes/no). | |
| contains-nut-allergens | Contains tree nut allergens (yes/no). | no |
| contains-celery-allergens | Contains celery allergens (yes/no). | no |
| contains-mustard-allergens | Contains mustard allergens (yes/no). | no |
| contains-sesame-seed-allergens | Contains sesame seed allergens (yes/no). | no |
| contains-lupin-allergens | Contains lupin allergens (yes/no). | no |
| contains-mollusc-allergens | Contains mollusc allergens (yes/no). | no |
Feed Example
<product>
<product-name>Famille Perrin Réserve Côtes-du-Rhône 2024 Rosé</product-name>
<price>15.00</price>
<quantity-is-minimum>false</quantity-is-minimum>
<bottle_size>750 ml</bottle_size>
<bottle_quantity>1</bottle_quantity>
<link>https://www.fantasticwines.com/product/123/</link>
<inventory-count>17</inventory-count>
<product-id>123</product-id>
<extras>
<alcohol>14.5%</alcohol>
<!-- the data points below are mandatory for wines to be sold in the EU
and bottled past 08/12/2023 while optional but recommended for other markets -->
<elabel>http://www.elabelhost.com/producername/wine_name_2024_750ml/</elabel>
<residual-sugar unit="g/l">2.9</residual-sugar>
<fat unit="g/100ml">6</fat>
<protein unit="g/100ml">3</protein>
<salt unit="g/100ml">2</salt>
<energy unit="kJ/100ml">351</energy>
<ingredients>Grapes, Water, Yeast, Sulfur Dioxide</ingredients>
<contains-milk-allergens>no</contains-milk-allergens>
<contains-egg-allergens>yes</contains-egg-allergens>
<contains-gluten-allergens>no</contains-gluten-allergens>
<contains-crustacean-allergens>yes</contains-crustacean-allergens>
<contains-fish-allergens>no</contains-fish-allergens>
<contains-peanut-allergens>no</contains-peanut-allergens>
<contains-soybean-allergens></contains-soybean-allergens>
<contains-nut-allergens>no</contains-nut-allergens>
<contains-celery-allergens>no</contains-celery-allergens>
<contains-mustard-allergens>no</contains-mustard-allergens>
<contains-sesame-seed-allergens>no</contains-sesame-seed-allergens>
<contains-lupin-allergens>no</contains-lupin-allergens>
<contains-mollusc-allergens>no</contains-mollusc-allergens>
<!-- the data points below are optional but recommended in all markets,
as additional product information supports customer purchashing decisions -->
<producer>Famille Perrin</producer>
<wine-name>Réserve</wine-name>
<appellation>Côtes-du-Rhône</appellation>
<vintage>2024</vintage>
<country>France</country>
<color>Rosé</color>
<varietal>40% Grenache, 40% Mourvèdre, 20% Syrah</varietal>
<acidity unit="g/l">5.5</acidity>
<ph>3.5</ph>
<non-alcoholic>no</non-alcoholic>
<ean>9334612000037</ean>
<image>http://www.wayback-wines.com/wp-content/uploads/img/2535550.jpg</image>
<description>This is a great wine from Famille Perrin with good value.</description>
<producer-address>3333 Route de Jonquières, 84100 Orange, France</producer-address>
<importer-address>Moet Hennessy Deutschland GmbH, 80335 München, Deutschland</importer-address>
<ageing>12 months in oak</ageing>
<closure>natural cork</closure>
<winemaker>Dorne Waters</winemaker>
<production-size unit="bottles">14000</production-size>
</extras>
</product>
Step 4: Wait for the feed to update. The frequency of product feed updates depends on the type of app installation:
-
Paid Version installations: Merchants who install the paid version of the app will have their feeds automatically updated every 3 hours.
-
Legacy installations: Merchants who installed the app before the transition to the paid model will retain access, but their feeds will only be updated once per week.
Step 5: Get your feed, if the URL of your store is www.mystore.com, your feed will be located in www.mystore.com/vivinofeed.xml
