Jak połączyć Okazii z easySales: kompletny przewodnik konfiguracji
Podłącz Okazii do easySales: ustawienia połączenia, Twój Feed URL i jego konfiguracja po stronie Okazii, które oferty faktycznie trafiają do feedu oraz jak wracają zamówienia, faktury i numery przesyłek.
Jak działa integracja z Okazii
Okazii nie łączy się tak, jak większość marketplace'ów, a świadomość tego oszczędza później sporo zamieszania.
Twoje oferty nigdy nie są wysyłane do Okazii. easySales buduje plik XML — feed — i publikuje go pod prywatnym adresem. Okazii samo pobiera ten plik według własnego harmonogramu i importuje wszystko, co w nim znajdzie. To jedyna droga, jaką pokonują Twoje produkty, ceny i stany magazynowe.
Zamówienia wracają drugą drogą, przez API Okazii, przy użyciu tokenu z Twojego konta Okazii. easySales odsyła też fakturę i numer listu przewozowego dla każdego zamówienia.
Konfiguracja ma więc dwie połowy: jedną w easySales, drugą w panelu Okazii. Żadna nie działa bez drugiej.
Zanim zaczniesz
Konto sprzedawcy na Okazii
Z dostępem do obszaru administracji sklepem, bo połowa tej konfiguracji dzieje się właśnie tam.
Twój Token API z Okazii
W panelu Okazii, w obszarze administracji sklepem, w ustawieniach API. Skopiuj wyłącznie część numeryczną. Bez niego easySales nie odczyta ani jednego zamówienia.
Produkty gotowe do sprzedaży
Każdy potrzebuje nazwy, SKU, co najmniej jednego zdjęcia, ceny od 0,10 w górę i zapasu większego od zera. Cokolwiek brakuje, trzyma produkt poza feedem — patrz kontrole opisane niżej.
Decyzja w sprawie VAT
Domyślna stawka VAT na połączeniu decyduje o tym, czy Twoje ceny na Okazii zawierają VAT. Ustal to, zanim zapiszesz.
Krok 1 — Połącz Okazii w easySales
Przejdź do Konfiguracja → Integracje → Marketplace, wyszukaj Okazii i otwórz kafelek.
Wypełnij formularz po prawej stronie.
| Pole | Co w nim wpisać |
|---|---|
| Alias | Wymagane. Twoja własna nazwa dla tego konta Okazii. Przy więcej niż jednym koncie to właśnie te nazwy stają się zakładkami. |
| Domyślny status indywidualny | Opcjonalne. Twój własny status, do którego ma trafiać każde przychodzące zamówienie z Okazii. |
| Dodatek do ceny | Wymagane. Procent doliczany do ceny produktu w momencie tworzenia oferty. Zostaje zapisany na ofercie w tej chwili, więc późniejsza zmiana nie przecenia ofert, które już istnieją. |
| Domyślny podatek od wysyłki | Stawka VAT stosowana do pozycji dostawy w zaimportowanym zamówieniu. |
| Domyślna stawka VAT | Wymagane i ważniejsze, niż wygląda — patrz niżej. |
| Seria faktur | Wymagane. Seria używana przy tworzeniu faktury do zamówienia z Okazii. Nadal można ją zmienić przy pojedynczym zamówieniu. |
| Domyślny typ paczki | Koperta albo Paczka, używane jako domyślne na listach przewozowych do tych zamówień. |
| Typ opisu | Czy feed niesie Twój opis produktu, czy opis wygenerowany z parametrów produktu. Okazii nie akceptuje kodu HTML. |
| Token API | Wymagane. Z Twojego konta Okazii, w obszarze administracji sklepem, w ustawieniach API — skopiuj wyłącznie część numeryczną. |
Reszta formularza decyduje o tym, jak Twoje produkty są opisane w feedzie.
- Atrybuty rozmiaru i Atrybut koloru mówią easySales, które z parametrów Twoich produktów niosą rozmiar i kolor, dzięki czemu warianty są grupowane w jedno ogłoszenie na Okazii, a nie w kilka.
- Wprowadź parametry do feedu dodaje do pliku wszystkie parametry produktu.
- Automatycznie aktywuj oferty, kiedy produkty mają zapas samo włącza ofertę z powrotem, gdy produkt wraca na stan.
Krok 2 — Skopiuj swój Feed URL
Po zapisaniu połączenia lewa kolumna pokazuje Feed URL. Wygląda tak: https://app.easy-sales.com/feed/12345/487213904/okazii.xml, a każde podłączone konto Okazii ma własny adres.
Zarówno Odśwież URL, jak i Dodaj konto — dla drugiego konta Okazii, z własnymi ustawieniami i własnym Feed URL — znajdziesz w menu ⋮ kafelka.
Krok 3 — Wskaż Okazii Twój feed
Ta połowa dzieje się w panelu Okazii, którego interfejs jest po rumuńsku, więc nazwy menu poniżej podajemy tak, jak je zobaczysz.
- Otwórz Meniu → Administrează Magazin (Menu → Zarządzaj sklepem) lub Setări → Magazin → Administrare (Ustawienia → Sklep → Administracja).
- Przejdź do Administrează articole → Import Produse (Zarządzaj artykułami → Import produktów) i wybierz Import Automat (Import automatyczny).
- Wklej swój Feed URL w polu Adaugă URL-ul Feedului (Dodaj adres URL feedu).
- Zaznacz Elimină din okazii produsele care nu apar în feed (Usuń z Okazii produkty, których nie ma w feedzie).
- Zapisz przyciskiem Salvează Opțiunile (Zapisz opcje).
Krok 4 — Utwórz swoje oferty
Ofertę Okazii tworzy się z produktu, który masz już w easySales. Otwórz Produkty, zaznacz wybrane produkty i użyj Dodaj oferty na na pasku narzędzi — albo Dodaj ofertę w pojedynczym wierszu — a następnie wybierz Okazii.
Które z Twoich ofert faktycznie trafiają na Okazii
To pytanie stoi za niemal każdym problemem typu „Okazii zaimportowało tylko kilka moich produktów”. Oferta trafia do pliku feedu tylko wtedy, gdy wszystkie cztery warunki są spełnione:
| Warunek | Gdzie to widzisz |
|---|---|
| Oferta ma status Aktywne | Przełącznik statusu w wierszu oferty. |
| Oferta jest Połączony, czyli powiązana z produktem | Wiersz Połączony pod nazwą oferty. |
| Ten produkt ma zapas większy od zera | Wiersz Zapas pod nazwą oferty. |
| Oferta nie ma blokującego błędu | Kolumna Błędy. |
Wszystkie cztery zobaczysz od razu w Marketplace → Oferty → Okazii.
Oferta, która nie przejdzie walidacji, zostaje wyłączona, a powód pokazuje się w kolumnie Błędy.
| Błąd | Co poprawić |
|---|---|
1000 Missing product name
|
Produkt nie ma nazwy. |
1001 Missing product sku
|
Produkt nie ma SKU. |
1004 Invalid product price
|
Cena sprzedaży jest niższa niż 0,10. |
1005 Invalid images data
|
Zdjęcia oferty nie są w użytecznej postaci. Zapisz zdjęcia na produkcie jeszcze raz. |
1006 Missing product images
|
Produkt nie ma żadnego zdjęcia. To zdecydowanie najczęstszy przypadek. |
Ile trwa, zanim zmiana będzie widoczna
easySales przebudowuje plik feedu najwyżej raz na godzinę i zwykle dopiero po tym, jak Okazii odczyta poprzednią wersję. Następnie Okazii musi uruchomić własny import. W praktyce nowo dodana oferta pojawia się zazwyczaj po dwukrotnym pobraniu pliku przez Okazii, więc daj temu kilka godzin, zamiast oczekiwać efektu natychmiast.
Kategorie
Kategoria na ofercie to zwykły tekst, pobrany jednorazowo z pierwszej kategorii, do której należy produkt. easySales nie przechowuje drzewa kategorii Okazii, więc dopasowanie nazw Twoich kategorii do kategorii Okazii odbywa się w Okazii, w Administrare Articole → Administrare Catalog (Zarządzanie artykułami → Zarządzanie katalogiem).
Aby zmienić tekst, który wysyła easySales, edytuj go w easySales — na samej ofercie (Marketplace → Oferty → Okazii → Edytuj) albo, dla wielu ofert naraz, przez Masowa edycja → Edytuj kategorię i parametry. Kategoria zostaje zapisana w momencie tworzenia oferty i nie jest później odświeżana, więc późniejsza zmiana kategorii produktu nie zmienia tego, co jest w feedzie.
Zamówienia
Nowe zamówienia z Okazii są pobierane mniej więcej raz na minutę, a kilka razy dziennie uruchamia się szersze przejście nadrabiające zaległości. Jeśli potrzebujesz sięgnąć dalej wstecz, na stronie połączenia masz Opcje → Zsynchronizuj zamówienia, które przyjmuje zakres do 30 dni.
| Co | Kierunek | Jak |
|---|---|---|
| Produkty, ceny, zapasy | easySales → Okazii | Feed XML, który Okazii pobiera. |
| Zamówienia | Okazii → easySales | API Okazii, przy użyciu Twojego Tokenu API. |
| Faktura PDF | easySales → Okazii | Wysyłana automatycznie, gdy tylko faktura zostanie utworzona. |
| Numer listu przewozowego | easySales → Okazii | Wysyłany, gdy tworzysz etykietę wysyłkową. Jej utworzenie oznacza też zamówienie jako sfinalizowane w easySales. |
| Status zamówienia | nic | Statusy nigdy nie są odsyłane. |
| Istniejące ogłoszenia na Okazii | nic | Nigdy nie są importowane do easySales. |
Kiedy zamówienia przestają przychodzić
Jeśli nie ma żadnego komunikatu o błędzie, a zamówienia po prostu nie przychodzą, sprawdź najpierw Token API na połączeniu. Połączenie zapisane, zanim token stał się obowiązkowy, wygląda całkowicie normalnie — pokazuje się jako połączone, feed nadal działa — ale żadne zamówienie nie jest pobierane i nic Cię o tym nie ostrzega.
Następnie przejdź po tej liście dla produktu, którego nie ma na Okazii:
- Czy oferta ma status Aktywne?
- Czy jest oznaczona jako Połączony, czyli powiązana z produktem?
- Czy ten produkt ma zapas większy od zera?
- Czy oferta pokazuje błąd?
- Czy Feed URL wpisany w Okazii jest tym aktualnym?