- Zanim podejmiesz jakiekolwiek działania, sprawdź, czy na Twoim koncie działa API baselinkera. W tym celu, zaloguj się do panelu, przejdź w zakładkę „Moje konto -> API”, następnie skopiuj Token.
- Przejdź na stronę https://api.baselinker.com/index.php?tester, w polu „Token” wklej wprowadzony token, następnie kliknij przycisk „Send”. Jeżeli otrzymałeś taką wiadomość:
API nie działa w Twoim przypadku. Poczekaj na uruchomienie API przez baselinkera.
Konto SellPander
Aby skorzystać z funkcji, musisz posiadać konto w systemie SellPander, oraz podpięte do niego konta Allegro. Jeżeli masz już konto i podpiąłeś konta Allegro, pomiń ten krok. Jeżeli nie, przejdź pod adres https://panel.sellpander.pl/Register/Index aby założyć konto.
W formularzu pierwszej konfiguracji, uzupełnij swój Token baselinker.
Następnie, po zakończeniu rejestracji, zaloguj się do systemu i przejdź do zakładki „Allegro -> konta”
Kliknij przycisk „Dodaj konto”, następnie wprowadź nazwę i połącz konto z panelem poprzez Allegro. Operację powtórz dla wszystkich swoich kont Allegro
Następnie przejdź do zakładki „Ustawienia -> Baselinker”. Znajdziesz tam swoje ID konta. Jest ono potrzebne do prawidłowego uzupełnienia linku:
Uzupełnianie adresu
Adres https://fire.sellpander.pl/api/BLResetOrdersv2?
należy uzupełnić w następujący sposób:
[PARAMETRY OBOWIĄZKOWE]
user -> Id konta z systemu SellPander
account -> Nazwa konta Allegro, taka jak wprowadzona w panelu SellPander
[Parametry opcjonalne]
to -> Pozwala wybrać, gdzie wpisywana będzie informacja o statusie allegro. Dozwolone wartości:
1 -> pole dodatkowe 1
2 -> pole dodatkowe 2
r -> uwagi sprzedawcy
Domyślnie stosowane jest pole dodatkowe 1
add -> pozwala wybrać, czy wartość w danym polu powinna zostać nadpisana czy też nie
Dozwolone wartości:
t -> Status allegro zostanie dopisany do aktualnej wartości pola
f -> Status allegro nadpisze aktualną wartość w danym polu
last -> Wykorzystywany przy dużej liczbie zamówień (patrz niżej)
Uwaga: parametry powinny być wpisywane ze znakiem = oddzielone znakiem & np. user=1&account=konto, po znaku ? (zobacz przykłady)
Przykłady:
Id konta SellPander: 112
Nazwa konta Allegro: Implemo
Domyślne działanie:
https://fire.sellpander.pl/api/BLResetOrdersv2?user=112&account=Implemo
Wpisywanie informacji do uwag, z zachowaniem aktualnej treści
https://fire.sellpander.pl/api/BLResetOrdersv2?user=112&account=Implemo&to=r&add=t
Duża liczba zamówień (<700)
W przypadku dużej liczby zamówień, ograniczają nas limity API baselinkera. W związku z tym należy postępować zgodnie z poniższymi informacjami:
- Wywołaj zapytanie jak opisano powyżej
- Po kilku minutach, przefiltruj baselinkera wg. wzoru:
– Dla każdego statusu Allegro (możliwe statusy):
NEWPROCESSINGREADY_FOR_SHIPMENTSENTCANCELLED.
W ten sposób:
Każdorazowo sprawdź datę pierwszego (najnowszego) zamówienia.
Po przefiltrowaniu wszystkich 5 statusów, wybierz to zamówienie, w którym data była najnowsza, a następnie wywołaj zapytanie z parametrem last, podając ID tego zamówienia. Wg powyższych przykładów byłoby to:
https://fire.sellpander.pl/api/BLResetOrdersv2?user=112&account=Implemo&last=32492348
Dzięki temu system pobierze kolejną paczkę zamówień.
Jeżeli ilość zamówień nadal nie będzie wystarczająca, powtórz proces.
UWAGA: WYWOŁANIE Z PARAMETREM LAST (I KAŻDE KOLEJNE WYWOŁANIA) NALEŻY WYKONYWAĆ Z MINIMUM 10 MINUTOWYM ODSTĘPEM CZASU. W PRZECIWNYM WYPADKU DOJDZIE DO ZABLOKOWANIA API I FUNKCJA NIE BĘDZIE DZIAŁAĆ.
