Jak połączyć Skroutz z easySales: kompletny przewodnik po integracji

Dlaczego warto połączyć Skroutz z easySales

Skroutz to największy marketplace i platforma porównywania cen w Grecji, a sprzedaż na nim oznacza utrzymywanie porządku w ofertach, zamówieniach i fakturach. easySales włącza Skroutz do jednego panelu obok pozostałych kanałów sprzedaży, dzięki czemu zarządzasz jednym katalogiem i jednym strumieniem zamówień, zamiast przełączać się między ekranami.

Po połączeniu Twoje zamówienia ze Skroutz trafiają do easySales gotowe do zafakturowania, przetworzenia za pomocą procesów automatyzacji i wysłania. Twój katalog płynie w drugą stronę: easySales publikuje Twoje produkty na Skroutz oraz utrzymuje ich ceny i zapasy na bieżąco, więc prowadzisz jeden katalog, zamiast edytować każdą ofertę na Skroutz ręcznie.

Jak działa konektor Skroutz

Skroutz to integracja hybrydowa — częściowo feed, częściowo API na żywo — dlatego warto zrozumieć ten podział, zanim zaczniesz.

• Twój katalog wychodzi przez feed produktowy. easySales buduje feed produktowy w formacie XML z Twoimi ofertami — nazwy, opisy, marki, kody EAN, kategorie, zdjęcia, ceny, VAT, zapasy, waga i charakterystyki — i odświeża go w powtarzalnym harmonogramie. Skroutz odczytuje ten feed, aby tworzyć i aktualizować Twoje oferty.
• Zamówienia przychodzą przez webhook. Skroutz przesyła każde nowe i zaktualizowane zamówienie prosto do easySales, gdzie ląduje w sekcji Zamówienia i Klienci → Zamówienia gotowe do fakturowania i procesów.
• Akcje na zamówieniach wracają przez Twój token Merchant API. Token, który wklejasz w połączeniu, pozwala easySales działać na Twoich zamówieniach ze Skroutz — akceptować je lub odrzucać, wysyłać dane śledzenia oraz przesyłać faktury z powrotem do Skroutz.

Ponieważ strona katalogowa działa na feedzie, kilka rzeczy działa inaczej niż na czystym marketplace opartym na API. Zmiany, które wprowadzasz w easySales, nie są natychmiastowe na Skroutz — podróżują wraz z następnym odświeżeniem feedu. A przepływ jest miejscami jednokierunkowy: easySales nie odczytuje statusu Twoich ofert z powrotem ze Skroutz, a istniejące oferty ze Skroutz nie są importowane do easySales.

Wymagania wstępne — co przygotować, zanim zaczniesz

Kilka rzeczy musi być na swoim miejscu przed pierwszą synchronizacją.

Krok 1 — Połącz Skroutz w easySales

W easySales, z paska bocznego przejdź do Integracje → Marketplace, znajdź kartę Skroutz i kliknij na niej Połącz. Otworzy się formularz ustawień Skroutz z dwiema zakładkami: Główne ustawienia (podstawowa konfiguracja) i Dodatkowe ustawienia (zachowanie synchronizacji). Najpierw popracujesz w Głównych ustawieniach.

W zakładce Główne ustawienia uzupełnij, jak easySales ma budować Twój feed, wyceniać oferty i obsługiwać zamówienia:

• Alias — etykieta, którą wybierasz dla tego połączenia. Widoczna wyłącznie wewnątrz easySales.
• Dodatek do ceny — opcjonalny procent doliczany do ceny produktu, gdy nowa oferta jest publikowana na Skroutz. Dotyczy nowo utworzonych ofert.
• Domyślny podatek od wysyłki — stawka VAT stosowana do pozycji wysyłki w Twoich zamówieniach ze Skroutz.
• Domyślna stawka VAT — domyślny procent VAT stosowany do Twoich ofert i zamówień. Ustaw go na 0, jeśli nie jesteś płatnikiem VAT.
• Token API — Twój token Merchant API Skroutz. Na razie zostaw go pusty; Skroutz wydaje go po zweryfikowaniu Twojego feedu produktowego, a Ty wrócisz, aby go wkleić (patrz Krok 4).
• Seria faktur — domyślna seria rozliczeniowa przypisywana do importowanych zamówień ze Skroutz, zgodna z serią, której używasz w swoim oprogramowaniu do fakturowania.
• Domyślny typ paczki — czy Twoje przesyłki domyślnie są kopertą czy paczką.
• Atrybuty rozmiaru i Atrybut koloru — charakterystyki produktu, które Skroutz odczytuje jako rozmiar i kolor wariantu. Zmapowanie ich pozwala Skroutz zgrupować Twoje warianty w jedną rodzinę (patrz Krok 3).
• Parametry wykluczone z ofert — dowolne charakterystyki, których nie chcesz zapisywać w feedzie Skroutz.
• Wyświetl parametry w opisie produktu i Dokumentacja produktu w języku lokalnym — kontrolują, jak charakterystyki i tekst produktu pojawiają się na Skroutz.
• Dni dostawy — czas obsługi publikowany wraz z Twoimi ofertami.
• Sfinalizuj zamówienie przez wygenerowanie listu przewozowego i opcje wysyłki — omówione w sekcji zamówień poniżej.

Kliknij Zapisz, aby utworzyć połączenie.

Krok 2 — Wystaw produkty i wyślij feedy do Skroutz

Połączenie konta samo w sobie nie umieszcza Twojego katalogu na Skroutz — to Ty wybierasz, które produkty wystawić.

Z paska bocznego przejdź do Sklepy Online → Produkty, zaznacz produkty, które chcesz sprzedawać na Skroutz, i z paska akcji masowych użyj akcji Dodaj oferty na, wybierając swoje połączenie Skroutz. easySales tworzy ofertę Skroutz dla każdego produktu, powiązaną z nim w Twoim katalogu. Od tej chwili oferta podróżuje w Twoim feedzie produktowym, a jej zapas i cena pozostają związane z produktem źródłowym. Do feedu zapisywane są tylko oferty, które są aktywne, zsynchronizowane i powiązane z produktem katalogowym. Twoje opublikowane oferty pojawiają się w sekcji Marketplace → Oferty, na zakładce Skroutz, gdzie możesz je przeglądać i edytować.

Gdy zapiszesz połączenie, easySales generuje dwa feedy, dzięki którym integracja działa. Oba pojawiają się na Twojej karcie Skroutz w Integracje → Marketplace:

• Feed URL — feed produktowy XML, który Skroutz odczytuje, aby budować i aktualizować Twoje oferty.
• Orders URL — adres, na który Skroutz przesyła Twoje zamówienia.

easySales nie rejestruje tych adresów automatycznie — kopiujesz je z karty Skroutz i przekazujesz je Skroutz, a każdy z nich trafia w inne miejsce w Twoim koncie Skroutz Merchants:

• Feed URL — prześlij go w sekcji Services → XML file: zweryfikuj swój feed, a następnie użyj Send XML link. Zespół Skroutz przeprowadza dodatkowe kontrole i finalizuje weryfikację.
• Orders URL — na Skroutz otwórz Services → Skroutz Marketplace i przewiń w dół do Integration with the online store → Order webhooks: wklej adres w polu Webhook URL i zaznacz Enable, aby Skroutz zaczął przesyłać Twoje zamówienia do easySales.

Uruchomienie na żywo to krok operacyjny, który może chwilę potrwać, a nie następuje natychmiast. Połączony feed bez zamówień na razie jest normalny, dopóki Skroutz wciąż wdraża Twój feed.

Grupowanie wariantów w rodzinę

Jeśli sprzedajesz produkt w kilku rozmiarach lub kolorach, Skroutz może pokazać warianty jako jedną ofertę rodzinną zamiast osobnych produktów. easySales buduje to grupowanie w całości na podstawie Twoich własnych danych produktowych — rodziny produktu i jego charakterystyk — plus jedno małe mapowanie, które ustawiasz w połączeniu. Oto jak te elementy do siebie pasują:

• Rodzina pochodzi ze struktury Twojego produktu. Warianty, które należą do siebie, muszą współdzielić produkt nadrzędny w easySales (ta sama rodzina wariantów). easySales przenosi to automatycznie, gdy produkty są już zgrupowane w Twoim sklepie źródłowym; w przeciwnym razie ustawiasz wariant na każdej ofercie ręcznie lub przez import z Excela. Warianty, które nie współdzielą produktu nadrzędnego, są wysyłane do Skroutz jako samodzielne oferty, a oferta rodzinna bierze swoją nazwę z produktu nadrzędnego.
• Wartości rozmiaru i koloru są odczytywane z charakterystyk produktu. Rozmiar każdego wariantu — oraz jego kolor — pochodzi wprost z charakterystyk tego produktu, na przykład charakterystyka „
  ” z wartością „
  ” lub charakterystyka „
  ” z wartością „
  ”. Nie wprowadzasz ich ponownie dla Skroutz; są pobierane z produktu.
• Mapujesz, która charakterystyka jest rozmiarem, a która kolorem. W zakładce Główne ustawienia połączenia użyj Atrybuty rozmiaru, aby wskazać easySales, która charakterystyka zawiera rozmiar, oraz Atrybut koloru dla koloru. To mapowanie zamienia Twoje charakterystyki produktu w wymiary rozmiaru i koloru Skroutz.

O tym, czy rodzina faktycznie się utworzy, decydują dwa warunki:

• Musi być zmapowany atrybut rozmiaru. Rodzina jest budowana wokół wymiaru rozmiaru — jeśli nie zmapowałeś Atrybutu rozmiaru lub produkt nie ma dla niego wartości, ten produkt wychodzi jako samodzielna oferta zamiast dołączać do rodziny. Zmapowanie samego Atrybutu koloru nie tworzy rodziny; dodaje jedynie wymiar koloru do wariantów już zgrupowanych według rozmiaru.
• Wartość rozmiaru lub koloru nie może znajdować się w tytule oferty. Warianty w rodzinie współdzielą tę samą nazwę produktu, a rozmiar znajduje się we własnym polu, więc nie wpisuj „
  ” ani „
  ” do tytułu — w przeciwnym razie Skroutz nie zdoła ich czysto zgrupować.

Zmapowanie atrybutu mówi easySales tylko, którą charakterystykę odczytać — nadal musisz wypełnić wartość tej charakterystyki na każdym produkcie. easySales nigdy nie wymyśla rozmiaru, więc produkt, którego charakterystyka rozmiaru jest pusta, jest wysyłany bez rozmiaru i nie dołączy do rodziny. To najczęstszy powód, dla którego rozmiaru brakuje w feedzie Skroutz. Jeśli kilku produktom brakuje wartości, wypełnij ją zbiorczo za pomocą Mass edit z listy Twoich ofert Skroutz. Dla produktu, który naprawdę nie ma rozmiaru, wpisz dosłowną wartość One Size (po angielsku) w tej charakterystyce — Skroutz oczekuje dokładnie tego tekstu, a easySales wysyła go bez zmian. Gdy wartości są już na miejscu, easySales generuje warianty rozmiarów automatycznie dla produktów, które są już zgrupowane jako warianty — bez dodatkowej konfiguracji.

Krok 3 — Dostrój synchronizację

Zakładka Dodatkowe ustawienia kontroluje, jak easySales synchronizuje się ze Skroutz po uruchomieniu połączenia.

• Wysyłaj MPN — wybierz, co easySales wysyła do Skroutz jako MPN produktu (numer części producenta). Są cztery opcje: nie wysyłać nic, SKU oferty, SKU nadrzędne (SKU produktu nadrzędnego — przydatne dla zgrupowanych wariantów, które powinny współdzielić jeden MPN) lub wartość konkretnej charakterystyki. Jeśli wybierzesz Charakterystyka, pojawi się drugie pole, w którym wybierasz, którą charakterystykę wysłać.
• Automatycznie aktywuj oferty, kiedy produkty mają zapas — automatycznie ponownie aktywuj oferty, gdy produkt wraca na stan powyżej zera.

Krok 4 — Dodaj token API, gdy Skroutz zweryfikuje feed

To część, która sprawia sprzedawcom kłopoty, więc warto ją jasno podkreślić. Skroutz nie wydaje Ci tokena Merchant API z góry — wydaje go po zweryfikowaniu feedu produktowego, który im wysłałeś. Kolejność jest więc taka:

1. Połącz Skroutz w easySales i wystaw swoje oferty (Kroki 1–2).
2. Wyślij swój Feed URL i Orders URL do Skroutz.
3. Gdy Skroutz zatwierdzi Twój feed, wygeneruj token Merchant API w swoim koncie Skroutz Merchants w sekcji Products → API, używając Generate a new API token. Skroutz przechowuje tylko jeden aktywny token naraz, więc wygenerowanie nowego zastępuje każdy poprzedni klucz.
4. Wróć do easySales, otwórz swoje połączenie Skroutz, wklej token w polu Token API w Głównych ustawieniach i zapisz.

Dopóki token nie jest na miejscu, zamówienia mogą wciąż przychodzić, ale easySales nie może ich akceptować ani odsyłać śledzenia i faktur do Skroutz — wszystkie te akcje uwierzytelniają się tokenem. Jeśli widzisz przychodzące zamówienia, które nie są akceptowane, pusty Token API to pierwsza rzecz do sprawdzenia.

Jak działają zamówienia, wysyłka i faktury Skroutz

Zamówienia to część Skroutz, która działa samodzielnie. easySales nie pobiera zamówień ze Skroutz — Skroutz przesyła każde zamówienie na Twój Orders URL, więc to Skroutz kontroluje dostawę. easySales importuje każde z nich, dopasowując produkty po EAN i wyceniając wszystko w euro. Gdy Twój token API jest na miejscu, easySales automatycznie akceptuje zamówienie z powrotem na Skroutz i rezerwuje okno odbioru kuriera. Ustawienie Opóźnienie okresu odbioru decyduje, które okno rezerwuje: włączone domyślnie, wybiera najpóźniejsze dostępne okno; wyłącz je, aby zarezerwować najwcześniejsze.

Ponieważ dostawa opiera się na wypychaniu (push), jeśli zamówienie kiedykolwiek nie dotrze do easySales, możesz wysłać je ponownie samodzielnie ze Skroutz: otwórz to zamówienie w swoim koncie Skroutz Merchants i w jego panelu Webhook kliknij New Request, aby wypchnąć je ponownie.

Wysyłka działa na jeden z dwóch sposobów i wybierasz go per połączenie:

• Skroutz dostarcza etykietę. Włącz Dołącz list przewozowy z marketplace'u, a easySales dołączy list przewozowy, który Skroutz wystawia dla zamówienia, dzięki czemu nie generujesz osobnego AWB.
• Ty generujesz AWB. Wygeneruj etykietę wysyłkową w easySales jak zwykle, a easySales odeśle dane śledzenia do Skroutz. Skroutz rozpoznaje do tego stały zestaw kurierów — DPD, DHL, GLS, ACS, Speedex, ELTA oraz Geniki Taxydromiki — więc użyj jednego z nich, aby śledzenie zarejestrowało się na Skroutz.

Faktury również są odsyłane: gdy generujesz fakturę dla zamówienia ze Skroutz, easySales automatycznie przesyła plik PDF do Skroutz. Sfinalizuj zamówienie przez wygenerowanie listu przewozowego jest włączone domyślnie, więc easySales oznacza również zamówienie jako sfinalizowane po dołączeniu jego etykiety wysyłkowej — wyłącz je, jeśli wolisz zarządzać tym statusem samodzielnie.

Jesteś połączony — co dalej

Gdy zamówienia zaczynają przychodzić, kolejnym krokiem jest automatyzacja: skonfiguruj procesy w sekcji Procesowanie → Procesy, aby generować faktury i przetwarzać zamówienia na bieżąco. Miej oko na swoje oferty w sekcji Marketplace → Oferty, na zakładce Skroutz, gdzie oznaczane są wszystkie, które nie przejdą walidacji — i skontaktuj się ze wsparciem, jeśli coś wygląda nie tak.