Sklep internetowy

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

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

Podłącz sklep na Magento 1 lub Magento 2 do easySales: wypełnij formularz połączenia, zainstaluj moduł, wklej token i sprawdź, co synchronizuje się w każdą stronę i jak często.

Co daje ci połączenie Magento

easySales czyta twój katalog Magento — produkty, ceny, stany magazynowe, kategorie i atrybuty — i na tej podstawie tworzy oraz utrzymuje oferty na marketplace'ach, na których sprzedajesz. Zamówienia wracają w drugą stronę, do jednej listy, gdzie je fakturujesz i generujesz listy przewozowe, bez dodawania czegokolwiek do sklepu.

Nie chodzi o pierwszy import. Chodzi o to, że połączenie działa dalej: stan magazynowy zmienia się w miarę sprzedaży, statusy zamówień wracają do Magento, a oferty wyłączają się, gdy czegoś zabraknie.

Zanim zaczniesz

Dostęp administracyjny do twojego sklepu Magento

Musisz dotrzeć do Stores → Configuration (Magento 2) albo System → Configuration (Magento 1), żeby wkleić token.

Sposób na wgranie plików na serwer

SFTP, SSH albo menedżer plików twojego hostingu. Magento 2 wymaga dodatkowo SSH do jednego polecenia; Magento 1 nie.

Unikalne SKU w całym katalogu

SKU to sposób, w jaki easySales dopasowuje produkt z Magento do własnego. Dwa produkty z tym samym SKU nie zostaną zaimportowane oba.

Stan magazynowy zapisany jako liczba

Produkty, których stan jest tekstem lub pustym polem, zostają pominięte.

Twoje stawki VAT pod ręką

Podczas łączenia ustawiasz domyślny VAT produktu i VAT dostawy.

Krok 1 — Dodaj sklep w easySales

Przejdź do Integracje → Strony internetowe i kliknij Połącz do strony internetowej.

Formularz Połącz do strony internetowej w easySales, z polami Nazwa strony internetowej, URL strony internetowej, Kraj, VAT ceny, VAT dostawy, Język, Waluta, Status niestandardowy dla nowego zamówienia, Źródło zapasów, Implicit package type i Seria faktury, nad siatką logotypów platform sklepowych.
Formularz połączenia. Te same pola obsługują każdą platformę; siatka logotypów pod spodem to miejsce, w którym wybierasz Magento.

Nic w tym formularzu nie jest specyficzne dla Magento — to ten sam formularz, którego używa każda platforma sklepowa. Trzech pól nie da się później zmienić, więc warto wypełnić je poprawnie za pierwszym razem.

Pole Co robi
Nazwa strony internetowej Twoja własna etykieta sklepu. Pojawia się wszędzie tam, gdzie easySales musi odróżnić twoje sklepy, co ma znaczenie od chwili podłączenia drugiego.
URL strony internetowej Adres twojego sklepu. Wybierz http:// albo https:// zgodnie z tym, co strona faktycznie serwuje, i dodaj www, jeśli strona tego wymaga — przekierowanie w tym miejscu oznacza nieudany test połączenia.
Kraj Kraj sklepu. Decyduje o tym, jakie stawki VAT zaproponuje kolejne pole. Nie da się później zmienić.
VAT ceny Stawka VAT stosowana do produktów, które przychodzą bez niej. Wybierana ze stawek twojego kraju, nie wpisywana ręcznie.
VAT dostawy Stawka VAT stosowana do dostawy, gdy zamówienie jej nie zawiera.
Język Język sklepu. Nie da się później zmienić.
Waluta Waluta, w której podane są twoje ceny w Magento. Nie da się później zmienić.
Status niestandardowy dla nowego zamówienia Opcjonalne. Wprowadza każde zaimportowane zamówienie od razu w jeden z twoich własnych statusów zamiast domyślnego.
Źródło zapasów Gdzie znajduje się wiążący stan magazynowy. Zobacz uwagę pod tabelą.
Implicit package type Koperta lub paczka, używane jako wartość domyślna przy generowaniu listów przewozowych dla tych zamówień.
Seria faktury Seria używana dla zamówień z tego sklepu, gdy Magento jej nie przekazuje.
Co robi każde pole formularza połączenia

Krok 2 — Wybierz Magento, a potem wersję

Pod formularzem znajduje się siatka z logotypami platform. Wybierz Magento, a pojawi się drugi rząd z pytaniem, na jakiej wersji działa twój sklep.

Siatka logotypów platform z zaznaczonym kafelkiem Magento i zielonym znacznikiem, a pod nią rząd zatytułowany Wybierz wersję platformy, którą używa twoja strona, z dwiema kartami: Magento 2 i Magento 1.7 - 1.9.
Jeden kafelek Magento, dwie wersje. Obie są wspierane.

Obie wersje są wspierane i oba moduły można pobrać:

Wersja Instalacja przez Wysyłanie zamówień Odczyt dokumentów
Magento 2 Wgranie do app/code/, potem setup:upgrade Tak, z aktualnym modułem Tak
Magento 1.7 – 1.9 Magento Connect Manager Nie Nie
Dwa moduły Magento

Krok 3 — Zainstaluj moduł

Wybór wersji otwiera trzyetapowy kreator: Pobierz moduł, Wgraj moduł, Konfiguracja.

Magento 2

Pobierz archiwum, rozpakuj je i wgraj folder na serwer do app/code/. Wynik musi być dokładnie taką ścieżką:

app/code/EasySales/Integrari/

Następnie połącz się przez SSH i włącz moduł:

php bin/magento setup:upgrade

Na koniec wyczyść cache w System → Cache Management → Flush Magento Cache.

Krok Wgraj moduł w kreatorze easySales, ze ścieżką app/code/EasySales/Integrari/, poleceniem SSH włączającym moduł i instrukcją wyczyszczenia cache Magento.
Instrukcja instalacji. Uwaga: polecenie na tym ekranie ma zabłąkany wykrzyknik — wpisz je jako setup:upgrade.

Magento 1

Moduł dla Magento 1 instaluje się przez Magento Connect. W panelu administracyjnym sklepu przejdź do System → Magento Connect → Magento Connect Manager, zaloguj się ponownie i użyj Direct package file upload, aby wgrać pobrane archiwum.

Następnie wyczyść cache w System → Cache Management i — ten krok jest naprawdę wymagany — wyloguj się z panelu Magento i zaloguj ponownie. Menu modułu nie pojawi się, dopóki tego nie zrobisz.

Krok 4 — Skonfiguruj moduł w Magento

Otwórz ustawienia modułu w panelu sklepu. W Magento 2 znajdują się w Stores → Configuration, w sekcji easySales; w Magento 1 w System → Configuration, blisko dołu listy.

Wklej token z kroku Konfiguracja kreatora w pole Token strony internetowej.

Krok Konfiguracja w kreatorze easySales, pokazujący, gdzie w Magento znajdują się ustawienia modułu, oraz token strony internetowej tylko do odczytu z przyciskiem kopiowania do schowka.
Token do wklejenia w Magento. Użyj przycisku kopiowania, zamiast przepisywać go ręcznie.
Ustawienie Co robi
Token strony internetowej Musi dokładnie odpowiadać tokenowi pokazanemu w kreatorze easySales. To on uwierzytelnia każde wywołanie między oboma systemami.
Zakres sklepu Który widok sklepu Magento eksportuje swoje produkty i zamówienia. Domyślnie pierwszy — ustaw go świadomie, jeśli masz więcej niż jeden.
Źródło stanu magazynowego Z którego źródła zapasów Magento easySales czyta ilości.
Seria faktury Seria przekazywana do easySales wraz z każdym zamówieniem.
EAN / Marka / Lokalizacja magazynowa Który atrybut produktu w Magento zawiera każdą z tych informacji. Zostaw puste, jeśli ich nie używasz.
Waga i wymiary Które atrybuty przechowują wagę i rozmiar oraz w jakich jednostkach. Potrzebne, jeśli twoi kurierzy liczą według objętości.
Co wypełnić w Magento

Zapisz w Magento, a następnie kliknij Zapisz w easySales. easySales odpyta twój sklep, żeby zweryfikować token, i powie ci, co się stało.

Krok 5 — Potwierdź połączenie

Połączony sklep pokazuje się jako karta w Integracje → Strony internetowe, z platformą, tokenem, zgłoszoną wersją modułu i przełącznikiem Aktywne.

Ekran Strony internetowe w easySales z kartą połączonego sklepu Magento 2 — jego adresem URL, stawką VAT ceny, tokenem strony internetowej, zgłoszoną wersją modułu i przełącznikiem Aktywne — obok karty Połącz do strony internetowej.
Połączony sklep. Wersja w rogu to ta, którą zgłosił twój sklep, a nie ta, którą założył easySales.

Jeśli sklep nie odpowiedział, zapis kończy się czerwonym komunikatem Połączenie nieudane, zamiast zapisać się po cichu. Prawie zawsze oznacza to jedną z trzech rzeczy: token w Magento nie zgadza się z tym w easySales, moduł nie jest włączony albo sklep nie jest dostępny z internetu pod podanym adresem.

Co się synchronizuje i jak często

Niczego z tego nie planujesz i nie ma żadnego ustawienia częstotliwości do skonfigurowania.

Co Kierunek Jak często
Zamówienia Magento → easySales Co minutę
Stany magazynowe Magento → easySales Co 30 minut
Ceny Magento → easySales Co 30 minut
Produkty Magento → easySales Co 6 godzin
Kategorie i atrybuty Magento → easySales Co 6 godzin
Status zamówienia, wysyłka, list przewozowy easySales → Magento Co minutę
Stan magazynowy easySales → Magento Co minutę
Jak często sprawdzane jest każde z tych danych

Co wraca do Magento

Trzy rzeczy i tylko trzy: status zamówienia (wraz z wysyłką i numerem listu przewozowego, gdy zamówienie zostanie zrealizowane), stan magazynowy oraz — w Magento 2 z aktualnym modułem — całe nowe zamówienia.

Nazwy produktów, opisy, zdjęcia, ceny i kategorie nie są zapisywane z powrotem. easySales czyta je z Magento i ich nie nadpisuje, więc Magento pozostaje jedynym miejscem, w którym edytujesz katalog.

Jak utrzymać połączenie w dobrej formie

Pilnuj wersji modułu. Karta pokazuje wersję zgłoszoną przez twój sklep. Gdy pojawi się nowsza, karta zmienia kolor na czerwony i wyświetla Wymagana aktualizacja. W Magento 2 instalujesz nowe archiwum na starym i ponownie uruchamiasz setup:upgrade; w Magento 1 najpierw odinstalowujesz stare rozszerzenie w Magento Connect Manager, a potem instalujesz nowe. Ustawienia zostają zachowane w obu przypadkach.

Błędy pojawiają się w jednym miejscu. Produkty → Sklepy Online → Błędy strony internetowej wypisuje wszystko, czego nie udało się zapisać w którymkolwiek kierunku, z akcją ponowienia i odrzucenia w każdym wierszu oraz zbiorczym ponownym wysłaniem dla każdego sklepu.

SKU są kluczem, więc niech pozostaną stabilne

easySales dopasowuje produkty Magento po SKU, a dopasowanie jest trwałe. Zmienisz SKU produktu w Magento, a easySales zaimportuje go jako nowy produkt — stary pozostanie, razem ze swoimi ofertami.

Jeśli musisz znaleźć duplikaty, użyj przycisku pobierania w Produkty → Sklepy Online → Produkty i sprawdź w eksporcie powtarzające się SKU.

Często zadawane pytania

Tak. Magento 1.7 – 1.9 nadal jest dostępne w wyborze wersji, a jego moduł nadal można pobrać, więc istniejący sklep na Magento 1 da się dziś podłączyć. To jednak starsza ścieżka: Magento 1 nie ma wysyłania zamówień ani odczytu faktur, a jego moduł zmienia się znacznie rzadziej niż ten dla Magento 2. Jeśli planujesz przejście na Magento 2, żaden powód po stronie integracji nie każe ci tego odkładać.

Nic. Kreator wypisuje obecnie polecenie z zabłąkanym wykrzyknikiem, jako setup!:upgrade. Poprawne polecenie to php bin/magento setup:upgrade. Wpisz je ręcznie, zamiast kopiować z ekranu.

Przy pierwszym połączeniu pobierany jest tylko mniej więcej jeden dzień historii, a zadanie w tle uzupełnia potem cztery poprzednie tygodnie w ciągu następnej doby. Jeśli twoje ostatnie zamówienia są starsze, same nie przyjdą. Sprawdź też, czy sklep odpowiedział na test połączenia — czerwony komunikat Połączenie nieudane oznacza błędny token albo adres.

Nie. Te trzy pola zostają zablokowane, gdy strona internetowa już istnieje. Ich zmiana oznacza usunięcie połączenia i utworzenie go od nowa, co zrywa też powiązanie między twoimi produktami a ofertami zbudowanymi na ich podstawie, więc warto je sprawdzić przed zapisaniem.

Nie. Nazwy, opisy, zdjęcia, ceny i kategorie są czytane z Magento i nigdy nie są zapisywane z powrotem. W stronę twojego sklepu idą tylko trzy rzeczy: status zamówienia wraz z wysyłką i numerem listu przewozowego, stan magazynowy oraz — w Magento 2 z aktualnym modułem — nowo utworzone zamówienia.

Powtarzające się błędy synchronizacji automatycznie wyłączają sklep, żeby zepsute połączenie nie ponawiało prób w nieskończoność. Zadania stanów magazynowych, cen, kategorii i atrybutów mają niską tolerancję — wystarczy kilka błędów pod rząd. Karta szarzeje i pokazuje przycisk Odnów połączenie; najpierw usuń przyczynę, potem go kliknij.

Tak to działa. SKU jest trwałym kluczem dopasowania, więc zmienione SKU jest odczytywane jako nowy produkt, a stary pozostaje ze swoimi ofertami. Jest ustawienie Automatycznie archiwizuj zastąpione produkty, które sprząta stary produkt, gdy nie ma już stanu ani aktywnych zamówień — domyślnie jest wyłączone.

Do 30 stron internetowych na jednym koncie. Każdy widok sklepu Magento, który chcesz traktować osobno, liczy się jako jeden.

Czy ten przewodnik był pomocny?