Kort antwoord
- Vink in Odoo Google Merchant Center aan in de website-instellingen, maak een feed met de naam Vinius en alleen je wijncategorieën, en kopieer de URL.
- Open in Vinius Catalogus, kies Koppelen op de kaart Odoo-productfeed en plak de link.
- Voer de integriteitscontrole uit en doe de steekproef. Pas aan in Odoo wat ze vinden en voer de controle opnieuw uit tot ze slaagt.
- Kies een planning en activeer. De eerste synchronisatie start meteen.
- Er wordt niets geïnstalleerd in Odoo, en er gaat niets naar Google.
Voor je begint
Je hebt alle vier nodig:
- Odoo 19 of later. Op Odoo Online saas~18.3 of later. Odoo toont zijn versie onder Instellingen.
- De eCommerce-app, zodat je Odoo een webshop heeft.
- Het recht om de instellingen van de website te wijzigen (websitebeheerder).
- Je wijnen gepubliceerd op de webshop. De feed bevat alleen gepubliceerde producten.
Oudere versies van Odoo hebben geen productfeed. Voor hen komt er een bestandsimport in het Vinius-formaat; daar is nog geen datum voor.
Het eerste rapport gaat vlotter als dit in orde is in Odoo:
- een Interne referentie (Internal Reference) op elke productvariant: je eigen productcode
- de EAN in Barcode, waar je er een hebt
- de jaargang en de flesinhoud in de productnaam, of als kenmerken (attributes) van de variant
Odoo beschrijft de feed zelf in zijn handleiding over Google Merchant Center (in het Engels). Vinius leest dezelfde feed, zonder Google.
Stappen
In Odoo
- Ga naar Website › Configuratie › Instellingen. Vink Google Merchant Center aan (in de Engelstalige Odoo onder Tracking & SEO) en sla op. Dat zet alleen de feed aan; er gaat niets naar Google.
- Klik op Feeds beheren (Manage feeds) en maak een nieuwe feed, los van een feed die je voor Google gebruikt:
- Naam: Vinius.
- Prijslijst: laat de standaardprijslijst van de shop staan, tenzij je shop alleen aan professionele klanten verkoopt. Zie Prijzen hieronder.
- Taal: de taal waarin je wijnnamen geschreven zijn.
- Categorieën: alleen je wijncategorieën, zodat glazen, geschenkdozen en sterkedrank erbuiten blijven.
- Klik op URL kopiëren (Copy URL) bij de nieuwe feed.
Behandel deze link als een wachtwoord. Wie hem heeft, kan de catalogus lezen die hij beschrijft, dus plak hem in Vinius en nergens anders. Vinius bewaart hem versleuteld en toont hem nooit meer.
In Vinius
- Open Catalogus en klik op Koppelen op de kaart Odoo-productfeed.
- Plak de link in Feedlink.
- Beantwoord Welke prijs staat in deze feed? (zie Prijzen hieronder). Bij Handelsprijs incl. btw vul je ook Btw-tarief om af te trekken (%) in.
- Controleer de twee regels, Een wijn zonder jaar heeft geen jaargang en Een wijn zonder flesinhoud is een fles van 75 cl (zie De twee regels hieronder), en klik op Bewaren.
- Klik op Integriteitscontrole uitvoeren. Nieuwe wijnen gaan door de titelanalyse, dus een grote catalogus duurt enkele minuten.
- Lees het rapport. Faalt een controle of worden er wijnen weggelaten, pas ze dan aan in Odoo en klik opnieuw op Integriteitscontrole uitvoeren.
- Doe de Steekproef: duid elk van de tien wijnen aan als Juist of Fout en klik op Steekproef bevestigen. Eén foute wijn stuurt je terug naar stap 9.
- Staat de integratie op Klaar, plan dan de synchronisatie: kies Dagelijks of Wekelijks (met de Dag), kies een Tijdstip in Brusselse tijd en klik op Activeren en nu synchroniseren.
De eerste synchronisatie start meteen. Daarna leest Vinius de feed volgens je planning.
Weigert Vinius de link, kopieer hem dan opnieuw met URL kopiëren. Vinius aanvaardt de link precies zoals Odoo hem geeft: hij begint met https://, wijst naar je publieke webshop, eindigt op /gmc.xml en bevat een feed_id en een access_token.
Wat Vinius leest
| In Odoo | In Vinius |
|---|---|
| Interne referentie van de productvariant | Je productcode (SKU). Zonder referentie bevat de feed het eigen productnummer van Odoo, dat verandert als je het product ooit opnieuw aanmaakt |
| Productnaam, met de variant | Producent, wijnnaam, jaargang en flesinhoud |
| Kenmerken van de variant | Jaargang, flesinhoud en producent, als je die als kenmerk bijhoudt |
| Webshopcategorieën en producttags | De stijl, als de naam die niet geeft. Categorieën helpen ook om wijn te onderscheiden van glazen of geschenkdozen |
| Barcode | De EAN, bewaard bij je aanbieding |
| Voorraadstatus op de shop | Beschikbaarheid: op voorraad of niet op voorraad |
| Prijs van de prijslijst van de feed | Je lijstprijs, alleen als je aangeeft dat het een handelsprijs is |
| Productafbeeldingen | Nog niet gebruikt |
Hoe Vinius een productnaam leest
De feed heeft geen veld voor de producent, dus het meeste wat Vinius nodig heeft, komt uit de productnaam. Vinius leest de naam in twee stappen. Vaste regels vinden eerst het jaar en de flesinhoud (2019, 75cl, 0,75 l, 1,5 L, magnum). Een taalmodel splitst daarna de rest in producent en wijnnaam, en herkent de appellatie, het land en de stijl.
Namen die met de producent beginnen en één jaar en één flesinhoud bevatten, lezen het best, bijvoorbeeld Producent Wijn Appellatie 2022 75cl. Schrijf voor een wijn zonder jaargang NV of non-vintage in de naam.
Een kenmerk geeft Vinius het antwoord rechtstreeks. Een kenmerk voor de jaargang of de flesinhoud gaat voor op de naam. Vinius herkent kenmerken met bijvoorbeeld de naam Jaargang, Jaar, Vintage of Millésime voor de jaargang; Inhoud, Volume, Formaat of Size voor de flesinhoud; en Producent, Producer, Domaine of Wijnhuis voor de producent.
Bij deze stap gebeuren de meeste leesfouten, en precies daarvoor dient de steekproef.
De twee regels
- Een wijn zonder jaar heeft geen jaargang staat standaard uit. Zet de regel alleen aan als elke wijn zonder jaar in je feed echt geen jaargang heeft. Staat de regel uit, dan worden die wijnen weggelaten als Jaargang onduidelijk, wat beter is dan een foute jaargang.
- Een wijn zonder flesinhoud is een fles van 75 cl staat standaard aan. Zet de regel uit als je wijnen zonder flesinhoud liever weggelaten ziet (Geen flesinhoud) dan als 75 cl aangeboden.
Prijzen
Een feed bevat de prijzen van één prijslijst. Vinius gebruikt ze alleen als jij aangeeft dat het handelsprijzen zijn:
- Geen handelsprijs (genegeerd) is de standaard. Kies dit als je webshop aan consumenten verkoopt. Prijzen komen dan per bestelling.
- Handelsprijs excl. btw of Handelsprijs incl. btw: kies een van beide alleen als de prijs in de feed is wat je professionele klanten aanrekent, bijvoorbeeld op een shop die alleen aan professionele klanten verkoopt. Kijk in Odoo na of de prijzen van je shop btw bevatten voordat je kiest. Bij Handelsprijs incl. btw trekt Vinius het tarief dat je invult bij Btw-tarief om af te trekken (%) af van elke prijs.
Odoo laat een feed alleen een prijslijst gebruiken die op je website selecteerbaar is. Verkoopt je shop ook aan consumenten, maak dan geen handelsprijslijst speciaal voor de feed: een selecteerbare prijslijst kan binnen bereik liggen van de bezoekers van je shop.
Bevat de feed een verlaagde prijs, dan neemt Vinius de verlaagde prijs. Een opgegeven prijs onder € 1 of boven € 5.000 per fles excl. btw beschouwt Vinius als een vergissing: de wijn wordt zonder prijs gepubliceerd.
Vinius legt elke prijswijziging vast met de datum. Schakel je later over naar Geen handelsprijs (genegeerd), dan houden je wijnen de laatste handelsprijs die Vinius vastlegde. Neem contact op met Vinius om gepubliceerde prijzen te verwijderen.
De kwaliteitscontrole
Het rapport van de integriteitscontrole toont wat ze vond. Dit zijn de bevindingen die een Odoo-feed het vaakst krijgt:
| Bevinding | Oplossing in Odoo |
|---|---|
| Jaargang onduidelijk | Zet het jaar in de productnaam, of als kenmerk van de variant met de naam Jaargang. Schrijf voor een wijn zonder jaargang NV in de naam |
| Twee jaren in één item | Houd één jaar in de naam, of geef de jaargang als kenmerk, dat voorgaat op de naam |
| Geen flesinhoud of 75 cl aangenomen | Zet de flesinhoud in de naam (75cl, 1,5 L, magnum) of als kenmerk met de naam Inhoud |
| SKU komt twee keer voor | Geef elke variant een eigen Interne referentie |
| Geen producent | Zet de producent in de productnaam, of voeg een kenmerk met de naam Producent toe |
| Geen wijn, bij een echte wijn | Haal woorden zoals glas of geschenkdoos uit de naam, en kijk de categorieën na |
| Minstens de helft van de producten is wijn faalt | De feed heeft de verkeerde categorieën: bewerk de Vinius-feed onder Feeds beheren |
Elke controle en elke bevinding, met de oplossing: De integriteitscontrole, controle per controle.
Actueel houden
Vinius leest de feed volgens je planning, en elke synchronisatie doorloopt dezelfde controles als de eerste. Odoo vernieuwt de feed zelf ongeveer één keer per dag, dus een wijziging in Odoo kan tot twee dagen nodig hebben om kopers te bereiken. Nu synchroniseren leest de feed meteen, maar Odoo kan dan nog het bestand geven dat het eerder die dag maakte.
- Wijnen die uit de feed verdwijnen (niet meer gepubliceerd, of uit de categorieën van de feed gehaald) worden niet meer aangeboden. Er wordt niets verwijderd, en een wijn die terugkomt, wordt opnieuw aangeboden.
- Een synchronisatie die veel meer verandert dan gewoonlijk, wordt aangehouden. Dat is meer dan een vijfde van je wijnen weg, meer dan een kwart van de prijzen veranderd, of één prijs die met meer dan de helft verandert. Je ziet Deze synchronisatie is aangehouden; bekijk het rapport en klik op Toch toepassen of Verwerpen. Tot dan zien kopers de vorige toestand.
- Een feed die niet gelezen kan worden, zet de integratie op Mislukt. Je wijnen blijven aangeboden zoals ze waren, en de volgende geslaagde synchronisatie zet ze weer op Actief.
- Zodra een productcode live staat, blijft ze aan dezelfde wijn gekoppeld. Latere synchronisaties wijzigen de beschikbaarheid en de prijs, niet over welke wijn het gaat. Daarom komt de steekproef eerst. Is een code aan de verkeerde wijn gekoppeld, neem dan contact op met Vinius.
- De planning wijzigen: klik op Wijzigen ernaast.
- De link of de instellingen wijzigen: klik op Pauzeren en daarna op Bewerken. Plak een nieuwe link in Feedlink, of laat het veld leeg om de huidige link te behouden, en klik op Bewaren. De integratie gaat terug naar Concept: voer de integriteitscontrole en de steekproef opnieuw uit en activeer daarna. Je wijnen blijven intussen aangeboden zoals ze waren.
De link zelf kun je in Odoo niet wijzigen. Heb je een nieuwe nodig, bijvoorbeeld omdat hij per vergissing gedeeld werd, verwijder dan de Vinius-feed onder Feeds beheren, maak een nieuwe en plak de link zoals hierboven.
Ontkoppelen
- Pauzeren stopt elke synchronisatie. Je wijnen blijven aangeboden zoals bij de laatste synchronisatie, en Hervatten neemt de planning weer op.
- Verwijder je de Vinius-feed in Odoo, of zet je de feed uit, dan kan Vinius hem niet meer lezen. De integratie toont dan Mislukt, en je wijnen blijven aangeboden zoals ze waren.
- Voordat je een integratie activeert, verwijdert Verwijderen haar samen met haar integriteitscontroles.
- Wil je je wijnen helemaal uit Vinius halen, neem dan contact op met Vinius. Daar is nog geen knop voor.