Marketplaces

How to connect Vivre with easySales: a complete setup guide

How to connect Vivre with easySales: a complete setup guide

Connect Vivre to easySales: every field on the connection form, where Vivre's API credentials live, how category mapping decides whether your offers are sent, and what each offer error means.

What connecting Vivre gives you

With Vivre connected, easySales sends your products to Vivre as offers, keeps their prices and stock in step, brings the orders back into easySales, and lets you invoice and ship them with the couriers and billing software you already use.

Vivre is a home and furniture marketplace, and that shapes the connection: almost everything that goes wrong goes wrong at the category, so this guide spends most of its time there.

Before you start

A Vivre seller account

With the API credentials switched on. They live in the Vivre account under Profile → API credentials, and they are separate from the e-mail and password you sign in with.

One card per country

Vivre Romania, Bulgaria, Hungary, Poland, Greece, Czechia, Slovakia, Croatia and Slovenia are nine separate connections. Know which ones you sell on.

Your categories ready to map

Every category you list from needs a Vivre category behind it. Nothing is sent until it has one, so it is worth having the list to hand before you start.

Size and colour on variation products

Anything you sell in several sizes or colours has to carry Size or Colour, or Vivre cannot tell the variations apart.

Step 1 — Pick the right Vivre card

Go to Integrations → Marketplace and search for vivre.

The Marketplaces page in easySales filtered to Vivre, showing connected Vivre Romania and Vivre Hungary cards with their API usernames, and unconnected cards for Bulgaria, Czechia, Slovakia, Slovenia, Poland and Greece.
Integrations → Marketplace filtered to Vivre. Every country is its own card and its own connection.

Press Connect on the card for the country you sell in, or Edit if you have connected it before.

Step 2 — The main settings

The top of the Vivre connection form in easySales showing Connection Name, New order custom status, Price Addition, Default Tax Rate and Default shipping tax.
The first part of the connection: what it is called, and how prices and VAT are handled.
Field What it is for
Connection Name Your own name for the connection. It never reaches Vivre, and it is what you pick from in the offers and products screens — worth setting when you run more than one Vivre country.
New order custom status Optional. A status of your own that every imported Vivre order is given on arrival, on top of the standard one, so you can route them through your own workflow.
Price Addition A percentage added to the sale price for new offers only. A 100 RON product with a 10% addition is listed at 110 RON. It does not change offers that already exist; price rules cover that case.
Default Tax Rate The VAT rate applied to the products you list, used when the product itself carries no rate.
Default shipping tax The VAT rate applied to the shipping line on imported orders.
Mark the new orders as processing With Yes, an imported order moves from New to Received and Vivre is told you have seen it.
Invoice Series The billing series used when an invoice is generated for a Vivre order.
Implicit package type Envelope or parcel — the default used when an AWB is created for a Vivre order.
Attach product characteristics to offer description Appends the product's characteristics to the description of the offer. Useful on Vivre, which does not demand many attributes of its own.
The main settings, field by field

Step 3 — Credentials and the delivery promise

The Vivre connection form showing Mark the new orders as processing, Invoice Series, Implicit package type, Username, Password, dispatch days, maximum delivery days and the characteristics checkbox.
Vivre's API credentials and the delivery promise that travels with every offer.

Username and Password are not your Vivre sign-in. They are the API credentials Vivre issues, and you find them in your Vivre account under Profile → API credentials. The username has Vivre's own shape — api123@vivre.eu.

Field What it is for
Username The API username from Profile → API credentials in your Vivre account, in the form api123@vivre.eu. It is not the e-mail you sign in to Vivre with.
Password The API password generated in the same place. easySales stores it encrypted and signs each request with it.
The number of days to dispatch an order How long you need to hand the parcel to the courier. Useful if you make to order.
The maximum number of days to deliver an order The total time from order to delivery, so it has to be larger than the dispatch time.
Credentials and delivery times

Step 4 — Additional settings

The second tab holds two settings that decide how stock behaves.

The Additional settings tab of the Vivre connection showing Send offer stock to marketplace set to Yes and Automatically enable offers when products have stock set to No.
The two stock settings on the Additional settings tab.
Setting What it does
Send offer stock to marketplace On by default. Every stock change is pushed to Vivre. Turn it off only if you manage Vivre stock by hand — a brand-new offer still goes out with its stock either way, because Vivre needs a quantity to publish it.
Automatically enable offers when products have stock Off by default. When a product goes from zero back into stock, its offer is switched on again by itself, instead of waiting for you to enable it.
Additional settings

Step 5 — Map your categories

This is the step the rest of the connection depends on. Go to Online Shop → Categories and press Map categories on each of your own categories.

The Categories page in easySales, with a Mapped column showing which marketplaces each category is mapped to and a Map categories button on every row.
Online Shop → Categories. A category with no Vivre mapping cannot send offers.

Step 6 — Send your first offers

If you already sell on Vivre, your existing offers are imported into Marketplace → Offers on the Vivre tab, where you link each one to the matching product so prices and stock start syncing.

For products that are not on Vivre yet, go to Online Shop → Products.

The Products page in easySales with the Without offers on filter open, listing the connected marketplaces including Vivre Demo Store and Vivre HU.
Without offers on, filtered to a Vivre connection — the list of products you have not listed yet.

Then use Add offer on the products you want to list. Offers are sent in batches, so a large catalogue takes a few passes rather than appearing all at once.

Step 7 — Reading the offers list

The Vivre tab of the Offers page in easySales, showing offers with the statuses Approved and In validation, one offer with error 1605 Missing category mapping and one with 1609 Unsupported category.
The offers list: Vivre's own status on the left, and the reason for any refusal on the right.

Two columns tell you where an offer stands.

Column What it means
Status: In validation Vivre has your offer but has not finished checking it. New offers and edited ones pass through this state; it clears by itself.
Status: Approved Vivre has accepted the offer as it stands.
Activated / Valid to Dates Vivre returns for the listing: when it went live and, where it applies, when it stops.
Enabled / Disabled Your own switch. A disabled offer is not sent and not updated.
Errors Why an offer was refused. Almost all of them are checked in easySales before anything is sent.
What the offers list tells you

When an offer is refused, the reason is in the Errors column. Most of them never reach Vivre at all — easySales checks the offer first and stops it.

Error What to do
1605 Missing category mapping The product's category has no Vivre category mapped to it. Map it under Online Shop → Categories, then re-send the offer.
1609 Unsupported category Vivre no longer lists the category you mapped to. Open Map categories and pick a current one.
1607 Mandatory characteristics missing A product in a family with no Size and no Colour. Add one of them to the category mapping or to the offer.
1608 Product reject by Vivre Vivre itself refused the offer; the reason it gave is shown next to the error.
1602 Invalid product price The sale price is below the minimum Vivre accepts. Check the price and the price addition.
1604 Missing product images / 1603 Invalid images data The product has no usable images. Vivre will not publish an offer without at least one.
1600 Missing product name / 1601 Missing product url The product is missing a field the offer needs. Fill it in on the product, not on the offer.
1606 Product has more than one mapped category The product's category resolves to two Vivre categories. Leave one mapping in place.
What each offer error means

Orders, invoices and shipping

Vivre orders arrive in Orders like any other channel, with the invoice series you set on the connection, and you invoice and ship them with your usual connections.

Frequently asked questions

In your Vivre account, under Profile → API credentials. They are API credentials, not the e-mail and password you sign in to Vivre with, and the username has Vivre's own shape — api123@vivre.eu. The password is generated in the same place.

No. Each Vivre country is a separate connection with its own credentials, its own category tree and its own offers. To sell in a second country you connect that country's card as well and map your categories on it.

That is easySales stopping the offer before it is sent, because the product's category has no Vivre category behind it. Go to Online Shop → Categories, press Map categories on the category concerned, choose the Vivre category and save. The offers go out on the next send.

Vivre has stopped listing that category. Its category list changes over time, and a category that is no longer in it will not take offers, even though the mapping you made is still on screen. Open Map categories, pick a category that is in the current list, and re-send.

Because they belong to a family — the same item in several sizes or colours. Vivre uses Size and Colour to tell the variations apart, so an offer in a family without either is refused with 1607 Mandatory characteristics missing. Add the attribute to the category mapping so it covers everything in that category, or to the individual offer.

In validation means Vivre has the offer and is still checking it — new offers and edits pass through this state and it clears by itself. Approved means Vivre has accepted the offer as it stands. Both come from Vivre, not from easySales.

On the Products page, use the Without offers on filter and choose your Vivre connection. It leaves only the products that have no offer on that connection, and those are the ones to add. Existing Vivre offers should instead be linked to their products on the Offers page, so that prices and stock start syncing.

Yes, as long as Send offer stock to marketplace is on in Additional settings — it is on by default. A product that runs out is sent as zero rather than being withdrawn. If you also want offers to switch themselves back on when stock returns, turn on Automatically enable offers when products have stock.

For Vivre Romania orders, yes. Connect Vivre under Integrations → Couriers — the form only asks for a connection name and the number of parcels, because it reuses the credentials of the marketplace connection. The service has to be enabled on your Vivre account first.

It adds a percentage to the sale price of new offers only: a 100 RON product with a 10% addition is listed at 110 RON. Offers that already exist keep their price. To change prices on existing offers, use price rules instead.

Was this guide helpful?