Marketplace'y

Jak połączyć Infinity z easySales: pełny przewodnik konfiguracji

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

Jak połączyć Infinity z easySales: pełny przewodnik konfiguracji

Podłącz marketplace Infinity do easySales: klucz aplikacji VTEX, dlaczego ID referencyjny decyduje o utworzeniu ofert, mapowanie kategorii, powiązanie istniejących ofert i znaczenie każdego błędu.

Co daje Ci połączenie Infinity

Z podłączonym Infinity easySales wysyła Twoje produkty na marketplace, utrzymuje ich ceny i stany w zgodzie, importuje zamówienia i fakturuje je przez Twój program księgowy — z tych samych ekranów, których używasz dla każdego innego kanału.

Zanim zaczniesz

✓

Konto sprzedawcy w Infinity

Infinity działa na VTEX, a integracja rozmawia z Twoim własnym kontem Infinity — musisz już tam sprzedawać albo mieć zgodę.

✓

Klucz aplikacji z rolami

Wygenerowany w Twoim koncie Infinity: klucz i token. Klucz bez ról uwierzytelnia się jako nikt i każde wywołanie zawodzi.

✓

Nazwa konta

Pierwszy człon adresu panelu Infinity — easysales429 w easysales429.myvtex.com.

✓

Zmapowane kategorie, zanim wyślesz oferty

Oferty bez kategorii Infinity nie da się utworzyć. Kategoria i jej mapowanie to dwa największe powody, dla których oferty stoją w miejscu — większe niż wszystkie pozostałe razem.

Krok 1 — Utwórz klucz aplikacji w Infinity

Infinity działa na VTEX, więc danymi dostępowymi jest klucz aplikacji VTEX: klucz i token wygenerowane w Twoim własnym koncie Infinity, a nie nazwa użytkownika i hasło.

W panelu Infinity otwórz ustawienia konta i znajdź Klucze aplikacji. Utwórz klucz dla easySales, nadaj mu role potrzebne do odczytu i zapisu produktów oraz zamówień, a następnie wygeneruj go. Otrzymasz dwie wartości — Klucz aplikacji i Token aplikacji — i potrzebujesz obu.

Potrzebna jest też nazwa konta: pierwszy człon adresu panelu Infinity. W https://easysales429.myvtex.com nazwa konta to easysales429.

Krok 2 — Połącz w easySales

Wejdź w Integracje → Marketplace i wyszukaj infinity.

Strona Marketplace w easySales przefiltrowana do Infinity, z kartą Infinity w stanie połączonym.
Karta Infinity w Integracje → Marketplace.

Kliknij Połącz na karcie Infinity. Formularz ma dwie zakładki, Główne ustawienia i Dodatkowe ustawienia.

Formularz połączenia Infinity w easySales z Aliasem, niestandardowym statusem nowego zamówienia, Dodatkiem do ceny, Domyślnym podatkiem od wysyłki, Serią faktur, Płatnikiem VAT i polem Wyślij jako ID referencyjny.
Główne ustawienia. Wyślij jako ID referencyjny to pole, nad którym warto pomyśleć przed zapisem.
Pole Do czego służy
Alias Twoja własna nazwa tego połączenia. Nigdy nie trafia do Infinity.
Niestandardowy status nowego zamówienia Opcjonalny. Umieszcza zaimportowane zamówienia z Infinity na statusie, który sam zdefiniowałeś, zamiast na domyślnym.
Dodatek do ceny Procent doliczany do ceny produktu przed wysyłką. 10% przy produkcie za 100 RON wysyła 110 RON.
Domyślny podatek od wysyłki Stawka VAT stosowana do pozycji dostawy w zamówieniach Infinity.
Seria faktur Seria, na której wystawiane są faktury do zamówień Infinity.
Płatnik VAT Tak, jeśli Twoja firma nalicza VAT, w przeciwnym razie Nie. Wybór ustawia stawkę wysyłaną z ofertami.
Wyślij jako ID referencyjny Wewnętrzne ID albo SKU — to, co Infinity zapisuje jako referencję każdej oferty. Zobacz krok poniżej, zanim wybierzesz.
Nazwa konta Pierwszy człon adresu panelu Infinity: w easysales429.myvtex.com to easysales429.
Klucz aplikacji i Token aplikacji Klucz aplikacji wygenerowany w Twoim koncie Infinity. Oba są wymagane.
Połączenie, pole po polu
Część formularza Infinity z danymi dostępowymi: Nazwa konta, Klucz aplikacji i Token aplikacji.
Trzy wartości z Twojego konta Infinity: nazwa konta z adresu panelu oraz para klucz–token.

Krok 3 — Ustal ID referencyjny, zanim cokolwiek wyślesz

Wyślij jako ID referencyjny to pole, którego stara dokumentacja w ogóle nie wymieniała, i to ono decyduje, czy Twoje oferty w ogóle da się utworzyć.

Krok 4 — Dodatkowe ustawienia

Zakładka Dodatkowe ustawienia połączenia Infinity: wysyłanie cen, wysyłanie stanów i automatyczna aktywacja ofert, gdy produkty mają zapas.
Dodatkowe ustawienia decydują, co easySales wysyła dalej, gdy oferta już istnieje.
Ustawienie Co robi
Wyślij ceny oferty do marketplace Wysyła zmiany cen z easySales do Infinity. Wyłącz, jeśli ceny prowadzisz po stronie Infinity.
Wysyłaj stany do marketplace Wysyła zmiany stanów magazynowych z easySales do Infinity.
Automatycznie aktywuj oferty, kiedy produkty mają zapas Sama włącza ofertę z powrotem, gdy jej produkt przechodzi z zerowego stanu na dodatni. Domyślnie wyłączone; warto włączyć, jeśli często wyprzedajesz się i uzupełniasz zapas.
Dodatkowe ustawienia

Krok 5 — Zmapuj kategorie, zanim wyślesz oferty

Oferta opuszcza easySales dopiero wtedy, gdy ma kategorię Infinity. Problemy z kategoriami są zdecydowanie największą przyczyną zablokowanych ofert: produkt bez kategorii Infinity albo taki, którego kategoria nigdy nie została zmapowana.

Otwórz Marketplace → Kategorie, wybierz Infinity i zmapuj kategorie, w których leżą Twoje produkty, na kategorie Infinity. Potem sprawdź wagę, kolejną co do częstości przyczynę po tych dwóch.

Krok 6 — Oferty, które już masz na Infinity

Jeśli sprzedawałeś na Infinity jeszcze przed połączeniem, te oferty zostaną zaimportowane do Marketplace → Oferty, na zakładkę Infinity, i trafią tam niepowiązane. Powiązanie oferty z produktem w easySales jest tym, co pozwala aktualizacjom ceny i stanu przepływać.

Lista ofert w easySales na zakładce Infinity, z ofertami, powiązanymi produktami, cenami, stanami, statusem Włączona lub Wyłączona oraz kolumną Błędy.
Zakładka Infinity na liście ofert. Każda oferta pokazuje powiązany produkt i to, co ją blokuje.

Krok 7 — Wysyłanie nowych produktów

W Produktach filtruj po Bez ofert na → Infinity, żeby widzieć tylko produkty, których nie ma jeszcze na marketplace, a potem użyj Dodaj ofertę na tych, które chcesz wysłać.

Strona Produkty w easySales z otwartym filtrem Bez ofert na, wymieniającym marketplace'y, w tym Infinity Demo Store.
Filtruj po Bez ofert na → Infinity, zanim wyślesz produkty, żeby nie wysłać żadnego dwa razy.

Zamówienia i faktury

Nowe zamówienia z Infinity trafiają do Zamówień jak z każdego innego kanału. Dwa ustawienia połączenia decydują o tym, co się z nimi stanie: Seria faktur wyznacza serię, na której wystawiane są faktury, a niestandardowy status nowego zamówienia pozwala umieścić je na Twoim własnym statusie zamiast domyślnego.

Kiedy połączenie przestaje działać

Co widzisz Co zrobić
Brak kategorii / Brak mapowania kategorii Produkt nie ma kategorii Infinity albo kategoria, w której leży, nie została zmapowana. Zmapuj ją w Marketplace → Kategorie. Razem odpowiadają za większość zablokowanych ofert.
Nieprawidłowa waga Infinity nie przyjmuje wagi produktu. Popraw ją na produkcie.
Tytuł jest za długi (maks. 120 znaków) Skróć nazwę produktu albo nazwę wysyłaną na ten marketplace.
Opis nie może być pusty Dodaj opis do produktu.
Brak marki produktu Produkt nie ma marki, a Infinity jej wymaga.
Brak obowiązkowych cech Kategoria Infinity oczekuje cech, których produkt nie ma. Uzupełnij je z ekranu edycji oferty.
Produkt odrzucony przez marketplace Infinity odrzuciło samą ofertę. Szczegół jest przy ofercie; zwykle to reguła katalogowa po ich stronie.
A product with external id "…" already exists. Oferta jest już na Infinity. Powiąż zaimportowaną ofertę ze swoim produktem, zamiast wysyłać nową.
Cannot authenticate request: failed to authenticate with provided credentials Klucz aplikacji przestał działać — został usunięty albo odebrano mu role. Wygeneruj nowy w Infinity i zaktualizuj połączenie.
Price Variation Not Allowed: BasePrice Variation: Price exceeds allowed limits Infinity ogranicza, o ile cena może się zmienić za jednym razem. Zmieniaj ją mniejszymi krokami albo podnieś limit po ich stronie.
Co znaczą najczęstsze błędy Infinity

Często zadawane pytania

Produkt jest już na Infinity pod tą referencją, prawie zawsze dlatego, że sprzedawałeś go tam przed podłączeniem easySales. Nie ponawiaj — wejdź w Marketplace → Oferty, otwórz zakładkę Infinity, znajdź zaimportowaną ofertę i powiąż ją ze swoim produktem. Od tej pory aktualizacje ceny i stanu trafiają do oferty, która już istnieje. To najczęstszy błąd Infinity.

SKU to zwykły wybór, bo pasuje do tego, czego sprzedawcy już używają na Infinity. Ważniejsze jest, żeby wybrać przed wysłaniem pierwszych ofert: zmiana później sprawia, że easySales przepisuje referencję we wszystkich ofertach już istniejących na tym połączeniu.

Najpierw sprawdź klucz aplikacji w Infinity. Klucz usunięty albo pozbawiony ról sprawia, że każde wywołanie kończy się błędem uwierzytelnienia, podczas gdy oferty po prostu się nie zmieniają. Potem zobacz kartę Infinity w easySales: jeśli połączenie zostało dezaktywowane po serii błędów, zobaczysz baner z przyciskiem Odnów połączenie.

Czyści flagę dezaktywacji, żeby synchronizacja ruszyła dalej. Nie naprawia przyczyny błędów — jeśli dane dostępowe albo dane produktów nadal są złe, połączenie znowu samo się wyłączy. Najpierw usuń przyczynę.

Trzy największe przyczyny są niemal zawsze te same: brak kategorii Infinity, brak mapowania kategorii i nieprawidłowa waga. Zmapuj kategorie w Marketplace → Kategorie, a potem przejdź kolumnę Błędy na liście ofert — każda poprawka działa przy następnej wysyłce.

Podstawą jest cena produktu. Dodatek do ceny na połączeniu dolicza do niej procent dla tego marketplace'u, a cenę można nadpisać na pojedynczej ofercie z listy ofert. Wyłączenie wysyłania cen całkowicie zatrzymuje ich przesyłanie z easySales.

Tego pola już nie ma w formularzu. Czas dostawy dla zamówień Infinity nie jest dziś czymś, co przechowuje połączenie.

To zdarza się przy połączeniach utworzonych przed zmianą rumuńskiej stawki VAT: nadal trzymają starą stawkę, której pole już nie oferuje. Wybierz ponownie Tak albo Nie i zapisz — pole jest wymagane, więc nic innego się nie zapisze, dopóki tego nie zrobisz.

Nie, jeśli włączysz Automatycznie aktywuj oferty, kiedy produkty mają zapas na zakładce Dodatkowe ustawienia. Przy wyłączonej opcji oferta wyłączona w czasie braku towaru zostaje wyłączona, dopóki sam jej nie włączysz.

Ta ustawiona jako Seria faktur na połączeniu. Musi to być seria, którą zna Twój program księgowy — jeśli nie, faktura zawiedzie w momencie wystawiania, a nie przy imporcie zamówienia.

Czy ten przewodnik był pomocny?