AliExpress: aplikacja Self Developer, OAuth i synchronizacja

Do czego to służy

Konektor AliExpress korzysta z AliExpress Open Platform. Pobiera zamówienia, listę ofert (produkty i SKU), wysyła stany i opcjonalnie ceny oraz zgłasza numer przesyłki.

Czego konektor nie robi: nie obsługuje zwrotów, sporów ani powiadomień push. Działa dla sprzedawców POP (także półpowierniczych) i zamówień zagranicznych z magazynu AliExpress. Przy innych modelach sprzedaży API może zwracać błąd 10002 albo być niedostępne.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „AliExpress”, a w kanale zakładka „Połączenie”. Pola konektora: „App Key” i „App Secret”. Konto sprzedawcy autoryzujesz osobno przyciskiem „Połącz konto” (OAuth), a Zaksio samo odświeża token dostępu.

Aplikacja oznacza ten rodzaj kanału jako „W przygotowaniu”: zakładka „Połączenie” pokazuje na razie uproszczony szkic formularza (z mniejszą liczbą pól i innymi nazwami), a przycisków „Sprawdź połączenie” i „Start” jeszcze w niej nie ma. Klucze zapisane w tym szkicu mogą nie trafić do pól konektora, więc po udostępnieniu pełnego ekranu wpisz je ponownie.

Skąd wziąć klucze

1. Załóż konto sprzedawcy w AliExpress Seller Center, zaloguj się nim w AliExpress Open Platform (openservice.aliexpress.com) i zaakceptuj umowę platformy.
2. W Console, App Management utwórz aplikację typu Self Developer (dane firmy i opis). Poczekaj na zatwierdzenie i przydzielenie pakietów API: zamówień, produktów i logistyki.
3. Po zatwierdzeniu skopiuj App Key i App Secret i wklej je w zakładce „Połączenie”.
4. W ustawieniach aplikacji wpisz adres zwrotny (redirect URL) pokazany w Zaksio przy łączeniu konta. Kod autoryzacji jest ważny tylko 3 minuty.
5. Kliknij „Połącz konto” i zaloguj się jako sprzedawca, który autoryzuje aplikację.

Dokumentacja API: openservice.aliexpress.com/doc/api.htm. Adres zwrotny dla OAuth jest jeszcze otwartą decyzją, więc na razie nie ma go skąd skopiować w aplikacji.

Co synchronizuje

• Zamówienia: wyszukiwane po dacie modyfikacji, oknami do 24 godzin (dzielonymi, gdy mają ponad 20 stron), co 2 minuty. Zamówienia oczekujące na płatność i w kontroli ryzyka są pomijane. API nie podaje stawek VAT ani e-maila kupującego.
• Oferty: produkty i SKU o identyfikatorze „product_id:sku_code”. Lista wymaga osobnego zapytania na każdy produkt, a pozycje bez kodu SKU są pomijane.
• Stany i ceny: zbiorczo po 20 produktów, z wynikiem per produkt, więc błąd jednego SKU oznacza błąd wszystkich SKU tego produktu w zapytaniu. Ceny tylko po włączeniu „syncPrices”, a pominięcie ceny promocyjnej ją kasuje, więc zmiana ceny usuwa aktywną promocję SKU.
• Numer przesyłki: domyślnie usługa „other” ze stroną śledzenia. Nazwę usługi z listy AliExpress ustawisz w „trackingServiceName”.

Czego jeszcze nie ma

• Ekranu połączenia dla tej platformy w aplikacji: backend konektora istnieje i jest przetestowany na atrapach serwera, ale interfejs jest w przygotowaniu (patrz wyżej).
• Pewnego adresu odbiorcy: pobieramy go metodą, którą dokumentacja opisuje dla sprzedawców z Turcji, więc na innych kontach może być niedostępna.
• Powiadomień push o zamówieniach: zamówienia pobieramy odpytywaniem.
• Weryfikacji na żywym koncie: niepewne są m.in. nazwy usług logistycznych, kody błędów w odpowiedzi HTTP 200, limity zapytań i reguła rozpoznawania anulowanych zamówień (status zamknięte bez wysyłki lub bez wpłaty).