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.
Press Connect on the card for the country you sell in, or Edit if you have connected it before.
Step 2 — The main settings
| 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. |
Step 3 — Credentials and the delivery promise
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. |
Step 4 — Additional settings
The second tab holds two settings that decide how stock behaves.
| 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. |
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.
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.
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
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. |
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. |
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.