Marketplace'y

Jak połączyć Vivre z easySales: kompletny przewodnik konfiguracji

Zespół easySales · Zaktualizowano 11 września 2026 · 2 min czytania

Jak połączyć Vivre z easySales: kompletny przewodnik konfiguracji

Podłącz Vivre do easySales: każde pole formularza, gdzie są poświadczenia API Vivre, jak mapowanie kategorii decyduje o wysyłce ofert i co oznacza każdy błąd oferty.

Co daje podłączenie Vivre

Z podłączonym Vivre easySales wysyła Twoje produkty na Vivre jako oferty, utrzymuje ich ceny i stany w zgodzie, przywraca zamówienia do easySales i pozwala fakturować je oraz wysyłać kurierami i programem do faktur, których już używasz.

Vivre to marketplace z kategorii dom i meble, i to kształtuje całe połączenie: prawie wszystko, co idzie nie tak, idzie nie tak na kategorii — dlatego ten przewodnik spędza tam najwięcej czasu.

Zanim zaczniesz

✓

Konto sprzedawcy Vivre

Z włączonymi poświadczeniami API. Są na koncie Vivre w Profil → API credentials i są czymś innym niż e-mail i hasło, którymi się logujesz.

✓

Jedna karta na kraj

Vivre Rumunia, Bułgaria, Węgry, Polska, Grecja, Czechy, Słowacja, Chorwacja i Słowenia to dziewięć osobnych połączeń. Wiedz, na których sprzedajesz.

✓

Kategorie gotowe do mapowania

Każda kategoria, z której wystawiasz, potrzebuje za sobą kategorii Vivre. Nic nie wyjdzie, dopóki jej nie ma, więc warto mieć listę pod ręką.

✓

Rozmiar i kolor na produktach z wariantami

Wszystko, co sprzedajesz w kilku rozmiarach lub kolorach, musi nieść rozmiar albo kolor, inaczej Vivre nie odróżni wariantów.

Krok 1 — Wybierz właściwą kartę Vivre

Wejdź w Integracje → Marketplace i wyszukaj vivre.

Strona Marketplace w easySales przefiltrowana po Vivre, z podłączoną kartą Vivre Polska pokazującą nazwę użytkownika API oraz niepodłączonymi kartami dla Rumunii, Bułgarii, Węgier, Czech, Słowacji, Słowenii i Grecji.
Integracje → Marketplace z filtrem Vivre. Karta z polską flagą to Vivre Polska; każdy kraj to osobne połączenie.

Naciśnij Połącz na karcie kraju, w którym sprzedajesz, albo Edytuj, jeśli łączyłeś ją wcześniej.

Krok 2 — Główne ustawienia

Górna część formularza połączenia Vivre w easySales z Aliasem, niestandardowym statusem nowego zamówienia, Dodatkiem do ceny, Domyślną stawką VAT i Domyślnym podatkiem od wysyłki.
Pierwsza część połączenia Vivre Polska: jak się nazywa i jak traktowane są ceny oraz VAT.
Pole Do czego służy
Alias Twoja nazwa połączenia. Nigdy nie trafia do Vivre, a to ją wybierasz na ekranach ofert i produktów — przydatna zwłaszcza przy kilku krajach Vivre.
Niestandardowy status nowego zamówienia Opcjonalne. Własny status, który dostaje każde zaimportowane zamówienie Vivre, obok standardowego, żebyś mógł prowadzić je swoim obiegiem.
Dodatek do ceny Procent doliczany do ceny sprzedaży, tylko dla nowych ofert. Produkt za 100 PLN z dodatkiem 10% wystawia się za 110 PLN. Nie zmienia istniejących ofert; od tego są reguły cenowe.
Domyślna stawka VAT Stawka VAT stosowana do wystawianych produktów, używana, gdy produkt nie ma własnej.
Domyślny podatek od wysyłki Stawka VAT stosowana do pozycji wysyłki w importowanych zamówieniach.
Potwierdzaj zamówienia Przy Tak zaimportowane zamówienie przechodzi z Nowe do Odebrane, a Vivre dowiaduje się, że je widziałeś.
Seria faktur Seria używana przy generowaniu faktury do zamówienia z Vivre.
Domyślny typ paczki Koperta albo paczka — wartość domyślna przy tworzeniu listu przewozowego do zamówienia z Vivre.
Załącz parametry do opisu oferty Dokleja parametry produktu do opisu oferty. Przydatne na Vivre, które nie wymaga wielu własnych atrybutów.
Główne ustawienia, pole po polu

Krok 3 — Dane logowania i obietnica dostawy

Formularz połączenia Vivre Polska z Krajem podatkowym ustawionym na Polska, Potwierdzaj zamówienia, Serią faktur, Domyślnym typem paczki, Nazwą użytkownika, Hasłem oraz dniami na wysyłkę i dostawę.
Kraj podatkowy, poświadczenia API Vivre i obietnica dostawy, która jedzie z każdą ofertą.

Nazwa użytkownika i Hasło to nie są dane, którymi logujesz się do Vivre. To poświadczenia API wydane przez Vivre, a znajdziesz je na koncie Vivre w Profil → API credentials. Nazwa użytkownika ma własny format Vivre — api123@vivre.eu.

Pole Do czego służy
Nazwa użytkownika Nazwa użytkownika API z Profil → API credentials na koncie Vivre, w formie api123@vivre.eu. To nie jest e-mail, którym logujesz się do Vivre.
Hasło Hasło API wygenerowane w tym samym miejscu. easySales przechowuje je zaszyfrowane i podpisuje nim każde żądanie.
Liczba dni na wysyłkę zamówienie Ile czasu potrzebujesz, by przekazać paczkę kurierowi. Przydatne przy produkcji na zamówienie.
Maksymalna liczba dni na dostarczenie zamówienia Całkowity czas od zamówienia do dostawy, więc musi być większy niż czas wysyłki.
Poświadczenia i czasy dostawy

Krok 4 — Dodatkowe ustawienia

Druga zakładka zawiera dwa ustawienia decydujące o tym, jak zachowuje się stan magazynowy.

Zakładka Dodatkowe ustawienia połączenia Vivre z Wysyłaj stany do marketplace ustawionym na Tak i Automatycznie aktywuj oferty ustawionym na Nie.
Dwa ustawienia stanów magazynowych na zakładce Dodatkowe ustawienia.
Ustawienie Co robi
Wysyłaj stany do marketplace Domyślnie włączone. Każda zmiana stanu trafia do Vivre. Wyłącz je tylko, jeśli prowadzisz stany Vivre ręcznie — zupełnie nowa oferta i tak wychodzi ze swoim stanem, bo Vivre potrzebuje ilości, żeby ją opublikować.
Automatycznie aktywuj oferty, kiedy produkty mają zapas Domyślnie wyłączone. Gdy produkt wraca z zera na stan, jego oferta włącza się sama, zamiast czekać, aż zrobisz to Ty.
Dodatkowe ustawienia

Krok 5 — Zmapuj kategorie

To krok, od którego zależy cała reszta połączenia. Wejdź w Sklep Wirtualny → Kategorie i naciśnij Mapuj kategorie przy każdej ze swoich kategorii.

Strona Kategorie w easySales z kolumną Mapowane pokazującą, na jakie marketplace'y zmapowana jest każda kategoria, i przyciskiem Mapuj kategorie w każdym wierszu.
Sklep Wirtualny → Kategorie. Kategoria bez mapowania na Vivre Polska nie może wysyłać ofert.

Krok 6 — Wyślij pierwsze oferty

Jeśli już sprzedajesz na Vivre, istniejące oferty zostaną zaimportowane do Marketplace → Oferty na zakładce Vivre, gdzie łączysz każdą z odpowiednim produktem, aby ruszyła synchronizacja ceny i stanu.

Dla produktów, których jeszcze nie ma na Vivre, wejdź w Sklep Wirtualny → Produkty.

Strona Produkty w easySales z otwartym filtrem Bez ofert na, wymieniającym podłączone połączenia, w tym Vivre Polska.
Bez ofert na, zawężone do połączenia Vivre Polska — lista produktów, których jeszcze nie wystawiłeś.

Potem użyj Dodaj ofertę na produktach, które chcesz wystawić. Oferty wychodzą partiami, więc duży katalog wysyła się w kilku turach, a nie naraz.

Krok 7 — Jak czytać listę ofert

Zakładka VivrePL na stronie Oferty w easySales, z cenami w PLN, ofertami o statusach Zaakceptowany i W walidacji, jedną z błędem 1605 Missing category mapping i jedną z 1609 Unsupported category.
Lista ofert Vivre Polska: status od Vivre po lewej, powód odrzucenia po prawej.

O stanie oferty mówią dwie kolumny.

Kolumna Co oznacza
Status: W walidacji Vivre ma Twoją ofertę, ale nie skończyło jej sprawdzać. Nowe i edytowane oferty przechodzą przez ten stan; mija sam.
Status: Zaakceptowany Vivre przyjęło ofertę w obecnej postaci.
Aktywowany / Ważny do Daty zwracane przez Vivre dla wystawienia: kiedy ruszyło i — tam, gdzie to ma zastosowanie — kiedy się kończy.
Włączona / Wyłączona Twój własny przełącznik. Wyłączona oferta nie jest wysyłana ani aktualizowana.
Błędy Dlaczego oferta została odrzucona. Niemal wszystkie sprawdzane są w easySales, zanim cokolwiek wyjdzie.
Co mówi lista ofert

Kiedy oferta zostaje odrzucona, powód jest w kolumnie Błędy. Większość z nich w ogóle nie dociera do Vivre — easySales sprawdza ofertę wcześniej i ją zatrzymuje.

Błąd Co zrobić
1605 Missing category mapping Kategoria produktu nie ma zmapowanej żadnej kategorii Vivre. Zmapuj ją w Sklep Wirtualny → Kategorie i wyślij ofertę ponownie.
1609 Unsupported category Vivre nie prowadzi już kategorii, którą zmapowałeś. Otwórz Mapuj kategorie i wybierz aktualną.
1607 Mandatory characteristics missing Produkt z rodziny bez rozmiaru i bez koloru. Dodaj jedno z nich do mapowania kategorii albo do oferty.
1608 Product reject by Vivre To samo Vivre odrzuciło ofertę; podany przez nich powód jest obok błędu.
1602 Invalid product price Cena sprzedaży jest poniżej minimum akceptowanego przez Vivre. Sprawdź cenę i dodatek do ceny.
1604 Missing product images / 1603 Invalid images data Produkt nie ma użytecznych zdjęć. Vivre nie opublikuje oferty bez co najmniej jednego.
1600 Missing product name / 1601 Missing product url Produktowi brakuje pola, którego potrzebuje oferta. Uzupełnij je na produkcie, nie na ofercie.
1606 Product has more than one mapped category Kategoria produktu prowadzi do dwóch kategorii Vivre. Zostaw jedno mapowanie.
Co znaczy każdy błąd oferty

Zamówienia, faktury i wysyłka

Zamówienia z Vivre trafiają do Zamówień jak z każdego innego kanału, z serią faktur ustawioną na połączeniu, a Ty fakturujesz je i wysyłasz swoimi zwykłymi połączeniami.

Często zadawane pytania

Na koncie Vivre, w Profil → API credentials. To poświadczenia API, a nie e-mail i hasło, którymi logujesz się do Vivre, a nazwa użytkownika ma własny format Vivre — api123@vivre.eu. Hasło generuje się w tym samym miejscu.

Nie. Każdy kraj Vivre to osobne połączenie z własnymi poświadczeniami, własnym drzewem kategorii i własnymi ofertami. Aby sprzedawać w drugim kraju, podłączasz także kartę tego kraju i mapujesz na niej swoje kategorie.

To easySales zatrzymuje ofertę przed wysłaniem, bo kategoria produktu nie ma za sobą kategorii Vivre. Wejdź w Sklep Wirtualny → Kategorie, naciśnij Mapuj kategorie przy tej kategorii, wybierz kategorię Vivre i zapisz. Oferty wyjdą przy kolejnym wysłaniu.

Vivre przestało prowadzić tę kategorię. Ich lista zmienia się w czasie, a kategoria, której już na niej nie ma, nie przyjmie oferty, nawet jeśli zrobione przez Ciebie mapowanie wciąż widać na ekranie. Otwórz Mapuj kategorie, wybierz kategorię z aktualnej listy i wyślij ponownie.

Bo należą do rodziny — ten sam artykuł w kilku rozmiarach lub kolorach. Vivre rozróżnia po nich warianty, więc oferta z rodziny bez żadnego z nich jest odrzucana z 1607 Mandatory characteristics missing. Dodaj atrybut do mapowania kategorii, żeby objął wszystko w tej kategorii, albo do pojedynczej oferty.

W walidacji znaczy, że Vivre ma ofertę i wciąż ją sprawdza — nowe oferty i edycje przechodzą przez ten stan i mija on sam. Zaakceptowany znaczy, że Vivre przyjęło ofertę w obecnej postaci. Oba pochodzą od Vivre, nie z easySales.

Na stronie Produkty użyj filtra Bez ofert na i wybierz swoje połączenie Vivre. Zostaną tylko produkty, które nie mają oferty na tym połączeniu, i to je należy dodać. Istniejące oferty Vivre łączy się natomiast z produktami na stronie Oferty, żeby ruszyła synchronizacja ceny i stanu.

Tak, o ile Wysyłaj stany do marketplace jest włączone w Dodatkowych ustawieniach — domyślnie jest. Produkt, który się kończy, wysyłany jest jako zero, a nie wycofywany. Jeśli chcesz, by oferty włączały się same, gdy stan wraca, włącz także Automatycznie aktywuj oferty, kiedy produkty mają zapas.

Dla zamówień z Vivre Rumunia tak. Podłącz Vivre w Integracje → Kurierzy — formularz pyta tylko o nazwę połączenia i liczbę paczek, bo korzysta z poświadczeń połączenia marketplace. Usługa musi być wcześniej włączona na Twoim koncie Vivre.

Dolicza procent do ceny sprzedaży, wyłącznie dla nowych ofert: produkt za 100 PLN z dodatkiem 10% wystawia się za 110 PLN. Istniejące oferty zachowują swoją cenę. Aby zmienić ceny istniejących ofert, użyj reguł cenowych.

Czy ten przewodnik był pomocny?