Integracja z BaseLinker z AtomStore (etap I)

 

BaseLinker to oprogramowanie, które zdobyło wielu zwolenników w sklepach internetowych. Jego największą zaletą jest możliwość zarządzania zamówieniami z wielu różnych źródeł, jak Allegro, marketplaces itp. a następnie przesłać je do systemu ERP.

 

Jako AtomStore dołączamy do platform e-commerce, które są zintegrowane z tym dostawcą. Integrator będziemy rozbudowywać o kolejne funkcje, reagując na potrzeby naszych Klientów. Dlatego integracja z narzędziem będzie przebiegać etapowo. W Q4.2020 udostępniamy możliwość:

• przesyłania zamówień z AtomStore do BaseLinker,
• przesyłanie produktów z BaseLinker do AtomStore.

 

Jak włączyć integrację z BaseLinker?

Integracja jest w wersji testowej, dlatego prosimy o kontakt z naszym BOK, który uruchomi ją dla danego sklepu. Aby uruchomić integrator należy:

• posiadać aktywne konto w BaseLinker
• token API od BaseLinker (Moje konto → API)

 

0. Skontaktuj się z naszym BOK w celu aktywowania modułu integracji z BaseLinker.

 

1. W AtomStore przejdź do zakładki Ustawienia → Konfiguracja sklepu → API i integracje FK/ERP → BaseLinker. Następnie Włącz integrację. 

 

2. Uzupełnij wymagane informacje jak token od BaseLinker (wspomniany wyżej) czy ID dostępnych magazynów (tę informację wypełnij jeśli chcesz importować produkty z BaseLinker do AtomStore, w dalszej części tłumaczymy jak uzyskać ID magazynu).

 

3. Pole Numer ID loga, od którego mają być pobierane logi uzupełni się automatycznie.

 

 Panel ustawień dla integracji w BaseLinker w systemie AtomStore

 

Przesyłanie zamówień z AtomStore do BaseLinker

Ustawienia integracji

Aby włączyć przesyłanie zamówień do BaseLinker, należy ustawić następujące opcje:

• datę, od kiedy AtomStore ma importować zamówienia do zewnętrznego narzędzia - możesz wybrać datę wstecz z dokładnością co do minuty;
• czy zamówienia mają być eksportowane - wybierz TAK, jeśli mają być wysyłane do zewnętrznego systemu;
• wybierz z jakim statusem zamówienia AtomStore ma wysyłać zamówienia do BaseLinker - mogą to być wszystkie dostępne statusy zamówień lub tylko wybrane np. W trakcie realizacji.

 

Mapowanie statusów zamówień

Aby eksport zamówień przebiegał poprawnie konieczne jest zmapowanie statusów zamówień. W tym celu:

 

1. Przejdź do panelu zarządzania w BaseLinker, a następnie przejdź do Moje konto → API. Skopiuj swój token do schowka.

 

2. Przjedź na stronę https://api.baselinker.com, a następnie wybierz Testowanie wywołań.

 

 

3. W zakładce Token wklej skopiowany ciąg liczb. Następnie z listy Metod wybierz metodę getOrderStatusList. Kliknij Wyślij. Po chwili system wygeneruje listę statusów zamówień z indywidualnym ID.

 

4. Przejdź do systemu AtomStore i wybierz Ustawienia → Mapowanie obiektów → Dodaj wpis.

 

5. W zakładce Moduł / integracja wybierz z listy BaseLinker. Następnie wskaż Typ obiektu, w tym przypadku jest to Status zamówienia.

 

6. Wybierz status zamówienia, który chcesz zmapować (= zamówienia z tym statusem mają być eksportowane z AtomStore do BaseLinker). Wpisz jego nazwę w polu Obiekt wewnętrzny. Możesz podać jego nazwę zewnętrzną.

 

 Opcja mapowania obiektów w AtomStore

 

7. W polu ID zewnętrzne wpisz wygenerowane przez BaseLinker ID wybranego zamówienia, które ma odpowiadać mapowanemu statusowi w AtomStore (wartość zaznaczona na czerwono w rys. z pkt. 3). Zapisz nowe mapowanie.

 

8. Powtórz czynność dla wszystkich statusów zamówienia, które mają być wysyłane do zewnętrznego systemu.

 

Po poprawnej integracji, wybrane zamówienia będę przesyłane do BaseLinker do zakładki Manager zamówień → Zamówienia. AtomStore przesyła również aktualizację statusów zamówień oraz numery listów przewozowych.

 

Wysyłanie produktów z BaseLinker do AtomStore

Druga możliwa akcje w ramach integracji to przesyłanie produktów do AtomStore. W ramach tej integracji wymieniane są dane na temat:

• ceny produktu;
• stan magazynowy;
• producent;
• warianty produktu.

 

1. W celu uruchomienia wysyłania produktów do AtomStore w zakładce Ustawienia → Konfiguracja sklepu → Katalog i magazyn → BaseLinker należy uzupełnić informacje o ID dostępnych magazynów.

 

Instrukcja uzyskania ID dostępnych magazynów w BaseLinker:

Zaloguj się do BaseLinker i przejdź do strony https://api.baselinker.com/index.php?tester.Z listy metod wybierz getStoragesList, a następnie kliknij Wyślij. Numer ID magazynu znajdziesz bok nazwy “storage_id”. Należy skopiować wartość po dwukropku - w tym przypadku jest to bl_1 i przenieść ją do ustawień w AtomStore. Jeżeli magazynów jest więcej niż 1, wpisz ich ID oddzielając je przecinkiem np. bl_1, bl_2.

 

 

2. Wybierz opcję Import kategorii. To ustawienie dotyczy pobierania produktów z BaseLinker. Możesz wybrać jedną z czterech opcji:

• Nie - produkty będą przesłane do Atoma, ale nie będą widniały w żadnej kategorii w sklepie. W efekcie będą widoczne w panelu zarządzania, ale nie zostaną wyświetlone w sklepie.
• Nie + przypisz produkty do stałej kategorii - wszystkie produkty zimportowane z BaseLinker zostaną dodane do jednej kategorii, którą trzeba określić w ustawieniu poniżej “Stała kategoria dla wszystkich produktów (ID w AtomStore)”.
• Nie + przypisz produkty do kategorii zmapowanych - wybierając to ustawienie konieczne będzie wykonanie mapowania kategorii (instrukcję opisujemy dalej)
• Tak - produkty zostaną dodane i utworzą nową kategorię w AtomStore.

 

3. W przypadku wybrania opcji Nie + przypisz produkty do kategorii zmapowanych przejdź do BaseLinker na stronę https://api.baselinker.com/index.php?tester. Z listy metod wybierz getCategories.

 

4. W polu Parametry wpisz uzyskany wcześniej ID magazynu w BaseLinker np.

{

"storage_id": "bl_1"

}

 

Nie zapomnij o { }! Następnie kliknij polecenie Wyślij, aby wywołać ID dodanych wcześniej kategorii produktów w BaseLinker.

 

Na poniższym przykładzie widzimy, że Kategoria A (stworzona w BaseLinker) ma ID o numerze 280067 (category_id).

 

 

5. Mapowanie kategorii wygląda podobnie jak w przypadku statusów zamówień. Przejdź do systemu AtomStore i wybierz Ustawienia → Mapowanie obiektów → Dodaj wpis.

 

6. W zakładce Moduł / integracja wybierz z listy BaseLinker. Następnie wskaż Typ obiektu, w tym przypadku jest to Kategoria.

 

7. Wybierz kategorię, którą chcesz zmapować (= kategoria, do której mają być importowane produkty z BaseLinker do AtomStore). Wpisz jej nazwę w polu Obiekt wewnętrzny.

 

8. Podaj ID zewnętrzne mapowanej kategorii z wygenerowanej wcześniej listy (pkt. 4).

 

 

Przypisz (zmapuj) tyle kategorii ile uznasz to za stosowne.

 

Zarówno eksport zamówień, jak i import produktów z BaseLinker do AtomStore następuje automatycznie. Aby uzyskać informacje włączyć integrację z narzędziem, prosimy o kontakt z BOK. Integracja jest dodatkowo płatna (szczegóły podczas kontaktu z naszym zespołem). Jednocześnie informujemy, że integrator będzie sukcesywnie rozwijany w 2021 roku :)

Autor: Diana Drobniak