← All guides

    For suppliers

    Bringing your catalogue into Vinius

    The ways your wines get into Vinius: adding them by hand, the Odoo product feed and the other integrations, the integrity check every integration passes before anything is published, the sync schedule, and what buyers see afterwards.

    Quick answer

    • Your catalogue is under Catalogue in the menu on the left. Owners and admins only.
    • To add a wine yourself: Catalogue, Add a wine on the Catalogue tab. This works until Vinius enables an integration for you.
    • To connect your Odoo webshop: Catalogue, the Integrations tab, Connect on the Odoo product feed card. The Excel import and Vinius API cards show Coming next: you cannot connect those yourself.
    • Nothing from an integration is published until it passes the integrity check, you click Submit for review and Vinius enables it.
    • Buyers who already have you as a supplier see your wines, their availability and your list price excl. VAT when they order from you.
    • The supplier portal is in the web app only. The phone app does not have it.

    Open your catalogue

    Owners and admins only: managers and staff do not have Catalogue in the menu.

    On the web

    1. In the menu on the left, click Catalogue.
    2. Pick a tab: Catalogue for the wines venues can order from you, Integrations for your integrations, and, until Vinius enables an integration for you, Ordered through Vinius for the wines venues already ordered from you.
    A supplier's Catalogue page on the web: Catalogue in the menu, the Catalogue, Ordered through Vinius and Integrations tabs, and the wines added by hand with their size, code, price excl. VAT, availability and source

    In the app

    Not in the app: use the web app. In the phone app, an organisation that only supplies sees Your supplier account is on the web, with Open the Vinius web app.

    The Catalogue tab lists each wine with its Size, Code, Price excl. VAT, Availability and Source: the integration that brought it in, or Added by hand. Type in Search by name or code to find one.

    Add a wine to your catalogue by hand

    Owners and admins only. This works until Vinius enables an integration for you: from then on your catalogue comes from that integration, even while it is paused, and the tab says to add a missing wine in your own system, where it appears after the next sync.

    On the web

    1. In the menu on the left, click Catalogue. The Catalogue tab opens.
    2. Click Add a wine.
    3. Search by wine or producer and pick the wine. When it is not listed, click Not in the list? Type it in, fill in the wine as it appears on your price list and click Check wine.
    4. Pick the Bottle size if it is not chosen yet, then fill in Code (optional), Price per bottle excl. VAT (optional) and Availability.
    5. Click Add to offer.
    The Add a wine to the offer window on the web: a wine picked from the Vinius catalogue, with Bottle size, Code (optional), Price per bottle excl. VAT (optional), Availability and Add to offer

    In the app

    Not in the app: use the web app.

    A wine new to Vinius is shown to venues once Vinius has completed its details, within a day at the latest. When a wine is already in your catalogue in that size, the dialog says so: change that one in the list instead.

    Add a wine venues ordered from you

    Owners and admins only. The Ordered through Vinius tab shows only until Vinius enables an integration for you.

    On the web

    1. In the menu on the left, click Catalogue, then the Ordered through Vinius tab. The tab shows how many ordered wines are not in your catalogue yet.
    2. Click Add to offer next to a wine you still sell.
    3. Fill in Code (optional), Price per bottle excl. VAT (optional) and Availability, and click Add to offer.

    In the app

    Not in the app: use the web app.

    Change or unlist a wine you added by hand

    Owners and admins only. Only wines with Added by hand in the Source column change here; the others change at their integration.

    On the web

    1. In the menu on the left, click Catalogue. The Catalogue tab opens.
    2. Find the wine and click Edit.
    3. Change Code (optional), Price per bottle excl. VAT (optional) or Availability, and click Save.
    4. To stop offering a wine, click Unlist next to it. List again offers it again.
    A supplier's Catalogue tab on the web with a wine open for editing: its code, price per bottle excl. VAT and availability, above the list where an unlisted wine is marked as such

    In the app

    Not in the app: use the web app.

    The integrations

    IntegrationSuitsKept up to date byIts card shows
    Odoo product feedSuppliers on Odoo 19 or later (Odoo Online saas~18.3 or later) with the eCommerce appVinius, reading the feed every dayConnect
    Excel importEvery supplier, and the first load of any catalogueYou, uploading the Vinius template againComing next
    Vinius APISuppliers with a developer, another ERP or a PIMYour own systemComing next

    A card that shows Coming next cannot be connected from your portal. Each card links to its guide under How to set it up.

    Odoo product feed

    Odoo can publish the products of your webshop as a product feed, in the format Google Merchant Center reads. You switch the feed on in Odoo, create one for Vinius and paste its link on the Integrations tab. Nothing is installed in Odoo and no developer is needed.

    The feed carries what your webshop publishes. Wines you keep off your shop do not reach Vinius this way.

    Pick your wine categories for the feed. Glassware and accessories can stay out: Vinius does not publish them. Vouchers, tastings, workshops and tickets are always set aside.

    Step by step: Connecting your Odoo product feed.

    Excel import

    You fill in the Vinius template, one row per wine with your own product code, and upload it. Uploading again updates your catalogue. Vinius reads its own template only, not any spreadsheet layout, which keeps the check simple.

    Its card shows Coming next. How it works: Importing your catalogue from Excel.

    Vinius API

    Your own system (an ERP, a PIM, or a tool an agency built for you) sends your catalogue to Vinius with a token and keeps it current.

    Its card shows Coming next too. How it works: Sending your catalogue with the Vinius API.

    Several at once

    Each kind of integration connects once, and several run side by side: for example a feed for the wines on your webshop, and a file for the wines you sell to trade only, or for prices your feed does not carry. When another card shows Connect, Connect another integration on the Integrations tab adds it.

    A code belongs to the integration that first published it. Another integration naming it changes nothing, with one exception: a file or the API may update its price and availability. That is how a price list adds trade prices to the wines your feed brings in.

    Connect an integration

    Owners and admins only.

    On the web

    1. In the menu on the left, click Catalogue, then the Integrations tab.
    2. Click Connect on the integration's card. The notice above the cards, Prices must be standard list prices, not discounted ones, is the rule for every integration.
    3. Follow the integration's steps. For the Odoo product feed: Connecting your Odoo product feed.
    The Integrations tab on the web: the notice that prices must be standard list prices, the Odoo product feed card with Connect, and the Excel import and Vinius API cards marked Coming next

    In the app

    Not in the app: use the web app.

    Nothing is published before the check passes

    A catalogue that enters Vinius wrong reaches buyers wrong. So every integration starts with a quality check, called the integrity check on screen. It has three parts:

    1. A test reading. Vinius reads your catalogue exactly as a sync would, and writes nothing.
    2. The report. Counts first, then six checks on the catalogue as a whole, then the findings on single products, each with the products it concerns.
    3. The spot check. A sample of the wines as Vinius read them, most of them new to Vinius. Vinius marks each one right or wrong when it reviews your integration. A single wrong wine means the reading needs fixing before anything is published.

    All six checks must pass: The feed could be read, The feed has products, At most 5,000 products, Every product code appears once, At least 50% of the drinks are wine and At least 90% of the wines are complete.

    A finding on one product affects that product only. It is left out, set aside as not wine, or published with a warning. You fix what the report finds at the source, in Odoo, and run the check again, or answer it in the report: an answer takes effect on the report at once.

    Every check and finding, with its fix: Reading your integrity check report.

    Submit an integration for review

    Owners and admins only. When you have fixed your catalogue report as far as you can, submit the integration: Vinius reviews and approves every integration before its wines are published.

    On the web

    1. In the menu on the left, click Catalogue, then the Integrations tab.
    2. Read the report of the latest check. Fix what it finds in Odoo and click Run integrity check again, or answer the wines in the report.
    3. When the report is as good as you can make it, type anything Vinius should know in Note for Vinius (optional), for example what you could not fix and why.
    4. Click Submit for review.

    In the app

    Not in the app: use the web app.

    Vinius looks at the report, does the final spot check, chooses the schedule and enables the integration. You get an email once it is active. Until then you can keep fixing what the check finds and click Submit again. When Vinius finds wines read wrong, it sends the integration back with a note: correct those wines, then submit it again.

    The schedule

    When Vinius enables your integration, it chooses when Vinius reads your catalogue:

    • Daily, or Weekly on a set day
    • at a set hour, Brussels time

    The Integrations tab shows the Schedule, the Next sync and the Last successful sync. The first sync starts as soon as the integration is enabled. After that the schedule takes over. To change the schedule, contact Vinius.

    There is nothing faster than daily. Odoo refreshes its feed about once a day, so reading it more often would read the same file.

    A file or the API has no schedule. Vinius publishes it once its check has passed and the review is done, and every later upload or batch is a sync.

    Pause or resume the syncs

    Owners and admins only, once Vinius has enabled the integration.

    On the web

    1. In the menu on the left, click Catalogue, then the Integrations tab.
    2. To stop the syncs, click Pause, then Pause again under Pause this integration?. Your wines stay listed as they are, without updates.
    3. To start them again, click Ask Vinius to resume under This integration is paused. Vinius is told and resumes the syncs.

    In the app

    Not in the app: use the web app.

    Only Vinius resumes an integration. When Vinius paused it, the tab says so and there is no Ask Vinius to resume: contact Vinius.

    Every sync is checked again

    Each sync runs the same checks as the first. A sync that changes much more than usual is held before anything is published: when many of your wines would disappear at once, many wine prices change at once, or one wine price moves sharply. The Integrations tab then shows This sync is on hold, with what changed and the limit it passed.

    Vinius looks at the report and publishes or discards the sync. Until then, buyers keep seeing the previous state.

    Wines that leave your catalogue are no longer listed. Vinius deletes nothing: when a wine comes back, its offer is listed again.

    What happens after a sync

    Vinius links every wine in your catalogue to its shared wine catalogue:

    • A wine and vintage Vinius already knows is visible to buyers as soon as the sync is applied.
    • A new vintage, or a wine new to Vinius, is added to the Vinius catalogue, checked and enriched. Buyers see it once enrichment is done, or 24 hours after the sync, whichever comes first.
    • A wine Vinius cannot place with certainty is not published. The report lists it as Uncertain, and it waits for your answer.

    Your catalogue never creates stock in a buyer's account, and it never sees their orders.

    Glassware and other items

    Your catalogue in Vinius carries wine only. Vinius still sorts the products in your feed that are not wine into three categories, so the report shows what it left out:

    • Glassware
    • Decanters and carafes
    • Other: openers, corkscrews, gift boxes, packaging, coolers and ice buckets

    A title that names a decanter or a carafe counts as a decanter, even when it also says glass. Vouchers, tastings, workshops and tickets are always set aside.

    These items are not published to the venues that buy from you, and you cannot add one by hand. An item your feed published earlier is no longer listed after your next full sync. Vinius never deletes it.

    What buyers see

    Your catalogue reaches the buyers that already have you in their supplier list. When one of them creates an order for you and adds a wine, your wines appear above the rest of the Vinius catalogue, each with its bottle size, its availability and your list price excl. VAT. Picking one fills in the bottle size and the price, less any discount the buyer has recorded for you.

    A supplier's catalogue on the web as a venue sees it from its order: the supplier's wines with their price after the venue's discount and the margin, each with Add

    The price you send is read as your list price: your regular price. What a business pays less is its discount, which you set per customer.

    A wine picked from your catalogue keeps your code on the order line, and the order email, the PDF, your order page and its Excel download show it in a Code column.

    Only the people allowed to see purchase prices in that buyer's account see your price. A business sees your list price less the discount you set for it. When your feed's prices are not used, prices come per order.

    Related guides

    Get the Vinius newsletter

    You will get the Vinius newsletter by email: releases, guides and new articles, a few times a quarter at most. We send one email to confirm your address, and every issue has an unsubscribe link. Read more in our privacy policy.