Instrukcja do wtyczki "Integracja z AliExpress"
Pełna instrukcja korzystania z wtyczki
1. Jakie jest przeznaczenie wtyczki?
Ten moduł umożliwia przesyłanie informacji o zamówieniach złożonych w marketplace Aliexpress do panelu administracyjnego witryny w aplikacji "Sklep". Wtyczka żąda informacji o zamówieniach z wymaganą częstotliwością i aktualizuje je w aplikacji "Sklep" w przypadku jakichkolwiek zmian. Pozwala to wygodniej kontrolować resztki towarów i etapy zamówienia według statusu.
W liście zamówień wyświetlana jest ikona marketplace i numer zamówienia. Wewnątrz zamówienia znajduje się blok informacyjny z dodatkowymi przydatnymi informacjami - numerem zamówienia, datą wysyłki i dostawy.
Czy wtyczka przesyła towary do Marketplace?
Nie, wtyczka nie przesyła produktów do Marketplace, powinieneś użyć do tego innego rozwiązania.
Z jakimi modelami dostaw współpracuje wtyczka?
Z FBS Cainiao, usługami innych firm FBS lub niezależnie.
Czy możliwe jest tworzenie zleceń logistycznych dla FBS Cainiao?
Nie ma takiej możliwości i nie ma planów rozwoju w tym kierunku.
2. Instalacja i ogólne ustawienia
Wtyczkę instaluje się jak zwykle, za pomocą instalatora. Do jej ustawień potrzebny będzie dostęp do konta sprzedawcy na Aliexpress. Wszystkie ustawienia są dostępne w samej wtyczce, w sekcji Wtyczki -> "Integracja z AliExpress".
Pokaż numer zamówienia Aliexpress na liście ogólnej - pozwala włączyć lub wyłączyć wyświetlanie numerów zamówień z marketplace na ogólnej liście zamówień.Pokaż filtr zamówień według statusu na zakładce Zamówienia - umożliwia wyłączenie lub włączenie wyświetlania filtra według statusów w lewej części strony zamówień.Pokaż filtr zamówień według daty wysyłki na zakładce Zamówienia - pozwala wyłączyć lub włączyć filtr według daty wysyłki w lewej części strony zamówień.Tryb Debug - gdy ten tryb jest włączony, wiele przychodzących i wychodzących żądań oraz odpowiedzi na nie będzie rejestrowanych w plikach dziennika witryny. Może to być przydatne podczas diagnozowania problemów.
3. Profile sklepów
Aby móc pracować z wieloma sklepami, wtyczka posiada funkcję profilów. Dla każdego sklepu można ustawić własne warunki. Nowy profil można dodać, klikając zielony krzyżyk.
Zostaniesz poproszony o podanie nazwy profilu i wybranie modelu pracy:
Nie zapomnij aktywować pola wyboru obok "Profil aktywny", aby zamówienia trafiały do panelu administracyjnego.
4. Ustawienia ogólne
4.1. Kanał sprzedaży
W tym polu można wpisać nazwę kanału sprzedaży, która będzie wyświetlana na liście zamówień. Będzie ona inna dla każdego profilu. W przyszłości wygodnie będzie filtrować zamówienia według niego.
4.2. ID dla dopasowania produktów
W tym punkcie musisz wybrać, co dokładnie masz w towarze w polu SKU ID (SKU CODE) w Aliexpress, aby dopasować tę wartość do towarów w sklepie (znajdź produkty w sklepie), może to być: ID produktu / ID artykułu / "Kod artykułu" / ID artykułu + s + ID artykułu.
Więcej informacji o nich:
ID produktu i ID artykułu to wartości systemowe aplikacji "Sklep", są one generowane podczas tworzenia produktu i nigdy nie są zmieniane.
ID produktu
Wyświetlany na stronie edycji produktu:
ID artykułu
Wyświetlany podczas edycji artykułów:
Kod artykułu
Jest to dowolna wartość, którą można wprowadzić w edycji produktu:
ID produktu + s + ID artykułu
Ten format jest używany podczas przesyłania produktów za pośrednictwem wtyczki Yandex.Market. W tym przypadku używany jest offerID dla artykułów, na przykład: 1234s4567. Jeśli produkt nie ma artykułów, wystarczy ID produktu - 1234.
Wybrane wartości muszą być zgodne z tymi, które zostały już wcześniej przesłane na Aliexpress.
4.3. Metody dostawy i płatności do wyboru w zamówieniu
W tym ustawieniu można określić wewnętrzną metodę dostawy i metodę płatności, które zostaną wybrane podczas tworzenia zamówienia w panelu administracyjnym. Może to być konieczne do pracy z innymi systemami. Jeśli to pole jest puste w zamówieniu, może powodować błędy podczas synchronizacji z tymi platformami. Ta czynność nie jest konieczna, puste pola nie są krytyczne dla większości sklepów.
4.4. Dodanie numeru zamówienia w komentarzu
Gdy ta opcja jest aktywna, numer zamówienia z marketplace Aliexpress zostanie dodany do komentarza do zamówienia. Może to być przydatne do przesyłania do innych systemów lub drukowania.
4.5. Dodanie daty wysyłki do komentarza
Jeśli ta opcja jest aktywna, do komentarza do zamówienia zostanie dodana data - termin wysyłki zamówienia. Może to być przydatne przy przesyłaniu do innych systemów lub drukowaniu.
5. Autoryzacja (Globalny API)
1. Uzyskiwanie kluczej dostępu do globalnego API.
Aby uzyskać klucze dostępu do konta sprzedawcy AliExpress, musisz zarejestrować swoją "API aplikacji", dzięki czemu będziesz mieć indywidualny limit 1 miliona żądań dziennie, a token dostępu będzie ważny przez 1 rok.
Aby zarejestrować swoją "API aplikacji", zapoznaj się z tą instrukcją.
2. Uzyskanie tokenu dostępu do globalnego API.
Autoryzacja jest wymagana, aby uzyskać dostęp do danych sklepu na Aliexpress. Aby to zrobić, kliknij ten link w nowej karcie, autoryzuj na swoim koncie sprzedawcy Aliexpress:
Po wprowadzeniu nazwy użytkownika i hasła zostanie wyświetlona informacja w języku angielskim, że udzielasz autoryzacji wtyczce "Integracja z AliExpress":
Kliknij przycisk "Authorize". Spowoduje to przejście do strony, na której zostanie wyświetlony "Kod autoryzacji":
Skopiuj go, klikając odpowiednią ikonę. Wróć do ustawień wtyczki i wklej kod w polu "Kod autoryzacji", a następnie kliknij przycisk "Uzyskaj token":
Jeśli kod jest poprawny, poniżej pojawi się kod tokena i jego okres ważności:
Uwaga! Zgodnie z zasadami pracy z API Aliexpress, token jest ważny przez 1 rok, jeśli korzystasz z aplikacji "self-developer".
6. Zamówienia
6.1. Data rozpoczęcia synchronizacji
Począwszy od tej daty, wszystkie zamówienia złożone w tym dniu i później zostaną przesłane do panelu administracyjnego witryny. Domyślnie jest to data instalacji aplikacji. Możesz wybrać dowolną inną datę.
6.2. Automatyczna aktualizacja zamówień
Sama zasada działania API Aliexpress nie zakłada wysyłania żadnych danych do sklepu. Sklep sam musi stale pytać Aliexpress, czy coś się zmieniło w zamówieniach.
"Pytać" można za pomocą jednorazowego skryptu uruchamianego za pomocą przycisku "Otrzymuj zamówienia" lub skonfigurować regularne automatyczne uruchamianie poleceń za pomocą harmonogramu CRON w "Centrum Klienta" Web Systems Pro.
Jak skonfigurować CRON?
Skopiuj polecenie CRON z ustawień aplikacji:
Dodaj zadanie do harmonogramu CRON swojej witryny. Przeczytaj więcej o tym, jak dodać polecenie CRON tutaj.
7. Resztki
W tej sekcji można ustawić regularne przesyłanie aktualnej dostępności produktów na Aliexpress.
7.1. Wybór towarów
W tym punkcie można wybrać grupę produktów, których dostępność będzie określana dla tego sklepu. Mogą to być kategorie / listy / typy produktów. Jeśli AliExpress zażąda dostępności produktu, który nie znajduje się wśród wybranych pozycji, nie zostaną dla niego wysłane żadne resztki. Tylko wybrana tablica produktów będzie również brana pod uwagę przy wysyłaniu reszt wychodzących.
7.2. Wybór magazynów
W tym punkcie można wybrać magazyny, które będą używane do określania dostępności towarów dla tego sklepu.
Po aktywacji opcji "Po utworzeniu zamówienia, spisanie z tych samych magazynów" podczas tworzenia zamówienia towary będą odpisywane dokładnie z magazynów wybranych w tym punkcie.
7.3. Ustawienia odpowiedzi o dostępności
W tym punkcie można określić dowolną wartość "w magazynie" zamiast wartości rzeczywistych. Podczas wysyłania stanów magazynowych za pośrednictwem interfejsu API do Aliexpress, rzeczywista dostępność zostanie zastąpiona podanymi wartościami. Na przykład zamiast 5 możesz wysłać 0. Lub, jeśli dostępność produktu wynosi "nieskończoność", ale zdajesz sobie sprawę, że nie możesz sprzedać więcej niż 30 sztuk. Podaj inf = 30.
7.4. Wysyłanie reszt
Ten punkt ustawień jest odpowiedzialny za niezależne wysyłanie resztek do Aliexpress.
Możliwe są dwie metody:
- Ręczne wysyłanie, poprzez kliknięcie przycisku "Zaktualizuj teraz". Nie zamykaj strony, dopóki proces nie zostanie zakończony.
- Automatyczne regularne wysyłanie za pomocą harmonogramu CRON. Skopiuj polecenie i dodaj je do CRON swojej witryny.
Uwaga: ze względu na ograniczenia API Aliexpress, szybkość aktualizacji reszt: 60-100 punktów na minutę. Drugie i kolejne uruchomienia są nieco szybsze. Nie zaleca się zbyt częstego uruchamiania.
Data ostatniego uruchomienia jest wyświetlana poniżej.
- "Wybrane" - liczba towarów wybranych powyżej.
- "Przetworzone" - towary, dla których podjęto próbę dopasowania i wysłania reszt.
- "Znaleziono dopasowanie" - towary, dla których znaleziono Product ID w Aliexpress. Zażądano i zapisano raz (dopasowanie jest wyszukiwane według offerID / SKU ID).
- "Zaktualizowano z sukcesem" - produkty, dla których znaleziono ich ID w Aliexpress, dla których wysłano dostępność, a Aliexpress odpowiedział, że wszystko się powiodło.
Przycisk "Zresetuj wszystkie powiązane produkty" usuwa z bazy danych wszystkie wcześniej znalezione powiązane ID w sklepie = Product ID produktu w Aliexpress. Przycisk może być potrzebny w przypadku znaczącej zmiany asortymentu w marketplace lub w przypadku jakichkolwiek usterek.
8. Dopasowanie działań i statusów sklepu
Możesz skonfigurować wykonywanie pewnych działań z zamówieniami w swoim sklepie, gdy status zmieni się na Aliexpress (nie jest to obowiązkowe):
Przykład: chcesz, aby zamówienie zmieniło status na "Wykonane" w Twoim sklepie, gdy klient otrzyma produkt. Wybierz akcję w ustawieniach, która ustawi zamówienie na status "Wykonane", na przykład w ten sposób:
Jeśli twój model pracy "Usługi innych firm FBS lub niezależnie", ten punkt daje ci możliwość wybrania wewnętrznej akcji, która wyśle informację do Aliexpress, że zamówienie zostało wysłane:
9. Przetwarzanie zamówienia
9.1. FBS Cainiao
Niestety, w tej chwili nie ma metod Api do przetwarzania zamówień zgodnie z najpopularniejszym modelem pracy, więc musisz pracować z takimi zamówieniami w swoim koncie osobistym Aliexpress, a informacje w panelu administracyjnym mają charakter czysto informacyjny, przychodzący.
Po otrzymaniu zamówienia jest ono oznaczone między innymi ikoną marketplace:
Blok informacyjny jest obecny wewnątrz zamówienia:
Statusy Aliexpress są wyświetlane zgodnie z kontem osobistym, a maksymalna data dostawy pojawia się po wysłaniu zamówienia.
Linki "Zobacz zamówienie" i "Arkusze transferowe" umożliwiają szybki dostęp do konta Aliexpress.
9.2. Usługi innych firm FBS lub niezależnie
W przypadku pracy w modelu "Usługi innych firm FBS lub niezależnie" masz możliwość przetworzenia zamówienia bezpośrednio w panelu administracyjnym witryny.
W tym celu należy:
1) W rozwijanym polu bloku informacyjnego wybrać metodę dostawy spośród oferowanych opcji:
2) Wprowadzić numer przesyłki za pomocą odpowiedniego przycisku:
3) Kliknąć przycisk "Wyślij" lub wykonać czynność z zamówieniem określoną w ustawieniach. Aliexpress otrzyma informację, że zamówienie zostało przekazane do dostawy.