Przesyłanie produktów z Subiekt GT do Apilo
Kod wtyczki: SGT_CAI_COM_PRD_ERB_100
Użyta wersja wtyczki: VER_RTM_v143.0
Co powinieneś wiedzieć na początku?
Wtyczka pozwala Ci na synchronizację danych o produktach między programem systemu źródłowego (ERP) Subiekt Subiekt GT i programem systemu docelowego (E-commerce) Apilo (ErpBox). Jest dostosowana do samodzielnej konfiguracji w oparciu o scenariusz złożony z szeregu pytań. Wtyczka umożliwia Ci zaktualizowanie bazy produktów o nowe kartoteki w momencie, kiedy zostaną dodane w ERP. Wtyczka zapewnia by wszelkie informacje na temat kartotek były spójnie między systemami.
Scenariusz konfiguracyjny
- Punkt pierwszy jest to informacja znacząca dla klientów. Może przydać się m.in w kontakcie z działem wsparcia.
- Każdy z naszych klientów posiada własne ID. W zależności od źródła uruchomienia integracji posiada on różne przedrostki.
- Wersja integracji, którą Państwo posiadają. Więcej informacji tutaj.
2. Czy chcesz, żeby integracja uruchamiała się automatycznie?
Funkcjonalność ta daje możliwość wyboru uruchomienia integracji w zależności od potrzeb:
Dostępne opcje:
a) Tak, tylko automatycznie uruchomienie
Funkcjonalność ta pozwala również na:
- Ustawienie przerwy między uruchomieniami wtyczki.
- Wybranie zakresu godziny w których wtyczka ma działać (od 1:00 do 23:00).
- Wybranie dni tygodnia w których wtyczka ma działać.
b) Nie, tylko uruchom ręcznie
Funkcjonalność ta wymaga naciśnięcia przycisku Uruchom teraz w głównym panelu wtyczki.
PAMIĘTAJ
Ustaw wtyczkę na uruchamianie z taką częstotliwością jakiej realnie potrzebujesz do aktualizacji. W zależności od ilości posiadanych danych do przetworzenia możesz uniknąć obciążania twojego serwera, jak i systemu źródłowego oraz docelowego.
3. Połączenie z Apilo (ErpBox)
W tym punkcie widzimy swoje tokeny (klucze API) odpowiadające za połączenie z Apilo (ErpBox) oraz ostatnią aktualizacje tokenów w formie daty i godziny.

UWAGA
Autoryzacja API odbywa się za pomocą access tokenu ważnego 21 dni. Przed lub po wygasnieciu access tokenu - należy go odnowić korzystając z refresh tokenu (ważnego 2 miesiące). Aby pobrać parę kluczy access token oraz refresh token - należy utworzyć nową aplikację REST API w systemie Apilo (ErpBox) w zakładce Administracja/API Apilo (ErpBox). W zakładce API Apilo (ErpBox) możemy sprawdzić także date ważności tokenów.

UWAGA
Jeżeli nie masz jeszcze zainstalowanego i skonfigurwanego integratora na serwerze, po poprawnym uzupełnieniu i zapisaniu scenariusza konfiguracyjnego wtyczki otrzymasz możliwość pobrania integratora (1) oraz wygenerowania tokena rejestracyjnego (2) w celu połączenia integratora z kontem SellIntegro.

4. Kategoria w Apilo (ErpBox)
Wybieramy kategorię w Apilo (ErpBox), która będzie weryfikować czy dany produkt z systemu ERP istnieje już w systemie docelowym.
Podgląd dostępnych kategorii znajdziemy w Apilo (ErpBox) Towary i usługi -> Kategorie

UWAGA
Jeśli przeniesiesz już wcześniej przesłany produkt do innej ktegorii w Apilo (ErpBox) i niezostanie ona wybrana w kategoriach, z których będą pobierane produkty to integracja doda jeszcze raz ten sam produkt.
Podaj nazwę kategorii docelowej w Apilo (ErpBox)
Integracja przeniesie produkty z systemu ERP do wskazanej kategorii w Apilo (ErpBox).
PAMIĘTAJ
Kategoria docelowa w Apilo (ErpBox), w której mają zostać utworzone produkty nie może być pusta przed rozpoczęciem przenoszenia produktów. Jeśli w kategorii nie ma żadnego produktu, przed uruchomieniem wtyczki należy dodać produkt testowy. Po synchronizacji produkt testowy można usunąć.
5. Czy wszystkie produkty z Subiekt GT mają zostać przeniesione?
Funkcjonalność ta pozwala na filtrowanie produktów, które chcemy przesyłać do Apilo (ErpBox).
Prześlij tylko produkty oznaczone jako:
Dostępne opcje:
a) Pozycja do sklepu internetowego.
Integracja prześle tylko produkty oznaczone w ERP jako sklep internetowy.
b) Pozycja do sprzedaży mobilnej.
Integracja prześle tylko produkty oznaczone w ERP jako sprzedaż mobilna.
c) Pozycja do serwisu aukcyjnego.
Integracja prześle tylko produkty oznaczone w ERP jako sklep serwis aukcyjny.
d) Przesyłaj wszystkie produkty
Przy zaznaczeniu tej opcji do Apilo (ErpBox) będą przesyłane wszystkie typy produktów.

PODPOWIEDŹ
Oznaczenie produktu można zweryfikować wchodząc w Asortyment -> kliknięcie 2x na produkcie -> Opis
Czy dodatkowo filtrować po statusie aktywności produktu?
Dostępne opcje:
a) Nie (przesyłaj aktywne oraz nieaktywne produkty)
Integracja prześle produkty zarówno aktyne jak i nieaktywne.
b) Tak (prześlij jedynie aktywne produkty)
Integracja prześle wyłącznie produkty oznaczone jako aktywne.

6. W jaki sposób chcesz powiązać produkty z Subiekt GT z produktami w magazynie Apilo (ErpBox)?
Funkcjonalność umożliwia wybór mapowania produktów pomiedzy magazynami Subiekt GT a Apilo (ErpBox).
Dostępne opcje:
a) Po stronie Apilo (ErpBox)
- EAN
- Id produktu (system ERP)
- SKU
- Nazwa
W Apilo (ErpBox) potrzebne informacje możesz znaleźć w kartotece produktu Towary i usługi -> Kategorie.

b) Po stronie Subiekt GT
- Symbol
- Id produktu
- Nazwa
- Podstawowy kod kreskowy
W Subiekt GT potrzebne informacje możesz znaleźć w kartotece towaru.

UWAGA
Wartości w wybranym mapowaniu muszą mieć identyczną zawartość, ponieważ w innym wypadku integracja nie odnajdzie i nie powiąże ze sobą dwóch produktów.
7. Jaką cenę chcesz użyć?
Funkcjonalność umożliwia wybór istniejącego cennika w Subiekt GT. Cena we wskazanym cenniku będzie przesłana razem z produktem do Apilo (ErpBox). Apilo (ErpBox) udostępnia tylko jedno miejsce na cenę.
Listę dostępnych cenników znajdziemy w Subiekt GT po lewej stronie Lista modułów -> Polityka cenowa -> Cenniki

UWAGA!
Należy wprowadzić dokładną nazwę cennika z Subiekt GT, znaczenie ma tutaj również wielkość liter i znaki specjalne.
8. Aktualizacja produktów
Funkcjonalność umożliwia wybór wykonywanych aktualizacji produktów z każdą pętlą programu.
Dostępne opcje:
a) Czy aktualizować krótkie opisy produktów?
- Tak - opcja zaktualizuje opisy produktów, które zostały zmienione po stronie Subiekt GT.
- Nie
b) Czy aktualizować nazwy produktów?
- Tak - opcja zaktualizuje nazwy produktów, które zostały zmienione po stronie Subiekt GT.
- Nie
c) Czy aktualizować ean-y produktów?
- Tak - opcja zaktualizuje EAN-y produktów, które zostały zmienione po stronie Subiekt GT.
- Nie
UWAGA!
Należy pamiętać, aby przy wyborze aktualizacji EAN-ów produktów zwrócić uwagę jakie mapowanie produktów ustawiliśmy w pkt. 6. Jeżeli ustawimy mapowanie po EAN-Kod kreskowy, oraz ustawimy aktualizację EAN-ów, to wtyczka doda nowy produkt, ponieważ nie zmapuje starego.