Centro de Apoio

Integração Vivino Feed

Sendo o maior marketplace online de vinho do mundo e a app de vinho mais descarregada, a comunidade Vivino é composta por milhões de consumidores de vinho de todo o mundo, que se juntam para tornar a compra do vinho certo simples, direta e divertida. Vivino utiliza dados para personalizar as recomendações de vinho de modo a que cada membro da comunidade se sinta confiante nas suas escolhas de vinho. Criado para todos os que gostam de vinho - desde os curiosos por vinho até aos entusiastas do vinho - a app Vivino está disponível gratuitamente tanto para Apple como Android.

config

Depois de se registar no VIVINO, pode criar um feed dos seus produtos vinícolas e conectar o catálogo à app VIVINO.


Como criar um feed

Passo 1: Crie uma categoria chamada Vivino.

Passo 2: Adicione produtos a esta categoria. Se a categoria não for adicionada ao menu de navegação, esta será invisível na maioria dos temas. Se no seu caso não for invisível, informe-nos e podemos editar o código do seu template.

Passo 3: O Vivino tem alguns campos obrigatórios que não fazem parte das configurações base da Jumpseller, para isso terá de criar campos personalizados. Consulte no video abaixo como pode trabalhar com esses campos.

Campos Personalizados Obrigatórios

Atributo Instruções Exemplo
product-name O nome do produto deve ser a combinação de: [Produtor] + [Nome do Vinho e Denominação] + [Colheita] + [Cor do Vinho]. Se não for Branco ou Rosé, pode evitar a cor. Se for um vinho sem colheita (NV), use NV. Famille Perrin Côtes du Rhône 2014 Rosé
price Preço final após todos os descontos. Para vendedores fora dos EUA/Canadá, inclua os impostos. Não inclua a moeda. 12.50
bottle-quantity O número de garrafas vendidas pelo preço do produto. 1
quantity-is-minimum Este é uma variável verdadeira/falsa utilizada para assinalar descontos baseados na quantidade para quantidades que não são fixas. Deve ser definida como verdadeira quando um vinho oferece um preço mais baixo por garrafa se o cliente comprar mais do que uma quantidade específica de garrafas, normalmente 6 ou 12 garrafas. Para todos os outros casos, deve ser definida como falsa. False
bottle-size O volume da garrafa, de preferência em mililitros (ml). Volumes suportados: 375 ml, 500 ml, 750 ml, 1000 ml, 1500 ml. 750ml
link O URL do produto no seu website. http://www.yourwebsite.com/category/wine-12345/
inventory-count O número de garrafas disponíveis em stock. 35
product-id Um identificador exclusivo para cada vinho (ID do Jumpseller ou SKU do produto). 2714

Campos Personalizados Opcionais

Atributo Instruções Exemplo
producer Nome do produtor do vinho e sub-marca, se houver. Arimia
wine-name O nome do vinho. Verdelho
appellation Região específica onde o vinho foi produzido (Denominação). Margaret River
vintage Refere-se ao ano da colheita (vindima) deste vinho. Para vinhos sem colheita (não-vintage), envie o valor como NV. 2014
country Pode usar este atributo para indicar o país de origem do vinho. Australia
color Serve para indicar a cor do vinho. White Wine
image Link para a imagem da garrafa no seu site. http://www.yourwebsite.com/wp-content/uploads/img/wine-image.jpg
description A descrição do vinho, de acordo com o produtor. The soothing taste of this wine will make you feel the vintage Australian tradition
GTIN Este é um número de identificação exclusivo que todos os produtos têm (Global Trade Item Number). A submissão de um valor GTIN indicará a autoridade de venda de um produto genuíno. O formato pode ser: ..., ..., ... 9334612000037
varietal Pode usar este atributo para definir as percentagens das diferentes castas. 100% Verdelho
producer-address Morada do produtor do vinho. Wildebosch Wines. PO Box 7518 Stellenbosch 7599 South Africa
importer-address Morada do importador do vinho. XYZ GmbH- Gildeweg 18- 45562 Voerde- Deutschland
ageing Descreva o processo de estágio do vinho. 12 months in oak and 12 months in bottle
alcohol Percentagem de álcool. 13.4%
closure Tipo de rolha. Cork
winemaker Nome do enólogo. Jonh Doe
production-size Número de garrafas produzidas. 1000
acidity Valor de acidez (unit=”g/l”). 5.6
ph Valor do pH. 3.64
non-alcoholic Não-Alcoólico. Sim/Não. No

As Definições de Produto devem ter o seguinte aspecto:

configuração

Campos personalizados adicionais recomendados Atributos do Rótulo Eletrónico da UE (e-Label)

Esta secção lista os dados obrigatórios para o rótulo eletrónico (e-Label) de vinhos vendidos na UE (requisito pós-08/12/2023).

Atributo Instruções Exemplo
elabel URL que aponta para o rótulo eletrónico com a informação completa. http://www.rotuloeletronico.com/produtor/nome_vinho_2024_750ml/
residual-sugar Açúcar residual em gramas por litro (unit=”g/l”). 2.9
fat Teor de gordura por 100 ml (unit=”g/100ml”). 6
protein Teor de proteína por 100 ml (unit=”g/100ml”). 3
salt Teor de sal por 100 ml (unit=”g/100ml”). 2
energy Valor energético em kilojoules por 100 ml (unit=”kJ/100ml”). 351
ingredients Lista de ingredientes por ordem decrescente de peso. Uvas, Água, Levedura, Dióxido de Enxofre
contains-milk-allergens Contém alergénios de leite (sim/não). no
contains-egg-allergens Contém alergénios de ovo (sim/não). yes
contains-gluten-allergens Contém alergénios de glúten (sim/não). no
contains-crustacean-allergens Contém alergénios de crustáceos (sim/não). yes
contains-fish-allergens Contém alergénios de peixe (sim/não). no
contains-peanut-allergens Contém alergénios de amendoim (sim/não). no
contains-soybean-allergens Contém alergénios de soja (sim/não).  
contains-nut-allergens Contém alergénios de frutos de casca rija (sim/não). no
contains-celery-allergens Contém alergénios de aipo (sim/não). no
contains-mustard-allergens Contém alergénios de mostarda (sim/não). no
contains-sesame-seed-allergens Contém alergénios de sementes de sésamo (sim/não). no
contains-lupin-allergens Contém alergénios de tremoço (sim/não). no
contains-mollusc-allergens Contém alergénios de moluscos (sim/não). no

Exemplo do feed

<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>

Passo 4: Aguarde que o feed seja atualizado. A frequência de atualização dos feeds de produtos depende do tipo de instalação da aplicação:

  • Instalações com Versão Paga: Os comerciantes que instalarem a versão paga da aplicação terão os seus feeds atualizados automaticamente a cada 3 horas.

  • Instalações Antigas (Legacy): Os comerciantes que instalaram a aplicação antes da transição para o modelo pago manterão acesso à aplicação, mas os seus feeds serão atualizados apenas 1 vez por semana.

Passo 5: Obtenha o seu feed, se o URL da sua loja for www.mystore.com, o seu feed estará disponível em www.mystore.com/vivinofeed.xml


Comece a sua jornada com a gente!

Teste grátis por 7 dias. Não é necessário cartão de crédito.