Miniaturka artykułu
18-06-2024, Kamil

Instrukcja eCommerce



5. Dodawanie nowego konta

W sekcji konta należy dodać nowe konto (odpowiednik konta na platformie e-commerce).
W tym celu w sekcji Konta należy kliknąć przycisk Nowy (Konto):


Otworzy się okno definiowania nowego konta.



5.1. Zakładka Ogólne


W sekcji Ogólne należy podać unikalną dowolną nazwę konta oraz wybrać typ platformy e-commerce. Obsługiwanych jest 8 typów: Baselinker, Shoper, PrestaShop, WooCommerce, Magento, Erpit B2B, Sellasist oraz Apilo.
Obsługiwane funkcje dla wszystkich typów kont przedstawia tabela w pkt IV.
 
Dodatkowo można zarządzać flagą Aktywne, czyli szybko włączyć lub wyłączyć obsługę zdefiniowanego konta, bez potrzeby usuwania jego konfiguracji.
Opcja Tryb uproszczony (podmiot obcy) pozwala jedynie na pobieranie zamówień, dla każdego z nich ustawiając tego samego kontrahenta. Jeżeli synchronizacja towarów, cen i stanów jest niepotrzebna, można skorzystać z tej opcji.
 

Wszystkie pola w poszczególnych zakładkach formularza konta przechowujące nazwy cech zostaną uzupełnione automatycznie, ale cechy te należy najpierw wygenerować.
Służy do tego przycisk "Dodaj brakujące cechy". Po jego kliknięciu zostanie wygenerowany cały komplet cech dla nowego konta, lub zostaną dodane tylko brakujące cechy dla konta już zdefiniowanego, niezbędne do działania dodatku (np. przy aktualizacji dodatku). Po kliknięciu na przycisk i potwierdzeniu pojawi się okienko w którym należy wprowadzić opcjonalny prefiks oraz opcjonalny sufiks dla nazw cech. Nazwy wygenerowanych cech zostaną automatycznie ustawione jako wartości pól konfiguracyjnych dla bieżącego konta. 
W przypadku definiowania wielu kont ważne jest, aby dla każdego konta powielić cechy, szczególnie te, które są odpowiedzialne za przechowywanie wartości identyfikatorów.



Następnie w sekcji Komunikacja należy podać wszystkie dane niezbędne do podpięcia się pod API danej platformy. Można sprawdzić działanie połączenia klikając przycisk Sprawdź połączenie.


5.1.1. Baselinker

Baselinker wymaga podania następujących danych:
  • API URL: wartość zostanie domyślnie podstawiona i nie należy jej zmieniać.
  • Token: klucz, który należy wygenerować w platformie e-commerce.
Ustawienia:
  • Nowe API dla produktów: konto Baselinker może mieć włączony nowy tryb magazynowania towarów oparty na katalogach, magazynach, grupach cenowych itd. Jeżeli konto ma włączony ten tryb, należy zaznaczyć to pole.
  • Storage: wybór obsługiwanego magazynu (można mieć ich wiele, np. wiążąc z Baselinkerem inną platformą e-commerce). Pole widoczne tylko wtedy, jeśli nie jest zaznaczone pole Nowe API dla produktów.
  • Katalog: wybór obsługiwanego katalogu zdefiniowanego w Baselinkerze. Pole widoczne tylko wtedy, jeśli jest zaznaczone pole Nowe API dla produktów.
  • Po osiągnięciu limitu żądań: w trakcie synchronizacji dużej ilości danych aplikacja może natrafić na limit żądań do Baselinkera. Pole to definiuje jak taki limit ma zostać obsłużony.

Opcja Przerwij przerywa synchronizację ze skutkiem natychmiastowym. Dzięki temu można operować w aplikacji enova365 i poczekać aż blokada czasowa (domyślnie 10 minut) zostanie zniesiona.

Opcja Opóźnij nie przerywa synchronizacji, ale czeka tyle sekund, ile jest zdefiniowanych w polu Opóźnienie (sekundy). W tej sytuacji niemożliwe jest korzystanie z aplikacji enova365, ale synchronizacja po odczekaniu wskazanych sekund będzie kontynuowana automatycznie.
  • Opóźnienie (sekundy): wyjaśnienie w polu Po osiągnięciu limitu żądań, opcja Opóźnij.



5.1.2. Shoper

Shoper wymaga podania następujących danych:
  • API URL: należy podać domenę na której działa sklep w platformie e-commerce, zakończoną adresem: /webapi/rest/
  • URL katalog administratora: należy wprowadzić fragment adresu URL odpowiadający katalogowi administratora, aby prawidłowo działał worker otwierający dokument w przeglądarce. Patrz pkt III.3.2.
  • Client ID: login do platformy e-commerce
  • Client Secret: hasło do platformy e-commerce
Ustawienia:
  • Język w sekcji Ustawienia: ustawienie specyficzne dla Shopera, który umożliwia wielojęzyczność nazw towarów, kategorii itp. Należy wybrać jeden z nich (domyślny).



5.1.3. PrestaShop

PrestaShop wymaga podania następujących danych:
  • API URL: należy podać domenę na której działa sklep w platformie e-commerce, zakończoną adresem: /api/
  • URL katalog administratora: należy wprowadzić fragment adresu URL odpowiadający katalogowi administratora, aby prawidłowo działał worker otwierający dokument w przeglądarce. Patrz pkt III.3.2.
  • Token: klucz, który należy wygenerować w platformie e-commerce



5.1.4. WooCommerce

WooCommerce wymaga podania następujących danych:
  • API URL: należy podać domenę na której działa sklep w platformie e-commerce, zakończoną adresem: /wp-json/wc/v3/
  • URL katalog administratora: należy wprowadzić fragment adresu URL odpowiadający katalogowi administratora, aby prawidłowo działał worker otwierający dokument w przeglądarce. Patrz pkt III.3.2.
  • Client ID: wygenerowany klucz Client ID
  • Client Secret: wygenerowany klucz Client Secret



5.1.5. Magento

Magento wymaga podania następujących danych:
  • API URL: należy podać domenę na której działa sklep w platformie e-commerce, zakończoną adresem: /rest/V1/
  • URL katalog administratora: należy wprowadzić fragment adresu URL odpowiadający katalogowi administratora, aby prawidłowo działał worker otwierający dokument w przeglądarce. Patrz pkt III.3.2.
  • Client ID: login do konta Magento
  • Client Secret: hasło do konta Magento
Ustawienia:
  • Zestaw atrybutów: domyślny zestaw atrybutów dla wszystkich towarów (Attribute Set)



5.1.6. Erpit B2B

Erpit B2B wymaga podania następujących danych:
  • API URL: należy podać domenę, na której działa B2B, zakończoną adresem: /api/
  • URL katalog administratora: należy wprowadzić fragment adresu URL odpowiadający katalogowi administratora, aby prawidłowo działał worker otwierający dokument w przeglądarce. Patrz pkt III.3.2.
  • Client ID: login do konta B2B
  • Client Secret: hasło do konta B2B



5.1.7. Sellasist

Sellasist wymaga podania następujących danych:
  • API URL: należy podać domenę na której działa Sellasist, zakończoną adresem: /api/v1/
  • Token: klucz, który należy wygenerować w platformie e-commerce
Ustawienia:
  • Język w sekcji Ustawienia: ustawienie specyficzne dla Sellasist, który umożliwia wielojęzyczność nazw towarów, kategorii itp. Należy wybrać jeden z nich (domyślny).



5.1.8. Apilo

Apilo wymaga podania następujących danych:
  • API URL: należy podać domenę na której działa sklep w platformie e-commerce, zakończoną adresem: /rest/
  • Kod autoryzacji
  • Client ID: login do platformy e-commerce
  • Client Secret: hasło do platformy e-commerce



5.1.9. Ustawienia
Kod towaru prefiks i Kod towaru sufiks: dotyczy pól SKU towarów. Jeżeli w platformie e-commerce znajdują się powielone towary w różnych wersjach językowych (nazwy, opisy), to mają one różne identyfikatory oraz różne SKU. Poprzez użycie pól Kod towaru prefiks i/lub Kod towaru sufiks można ujednolicić te towary w enovie.
Np. w Shoperze znajdują się towary o następujących SKU: SKU1, SKU1e, gdzie e sugeruje wersję językową. Wprowadzając w pole Kod towaru sufiks wartość e w enova365 będzie się znajdował jeden towar, nie powielony.