Przesyłanie produktów z Subiekt GT do Apilo (ErpBox)
Kod wtyczki: SGT_CAI_COM_PRD_ERB_100
Użyta wersja wtyczki: VER_PRESTD_v109.0
Co powinieneś wiedzieć na początku?
Wtyczka pozwala Ci na synchronizację danych o produktach między programem systemu źródłowego (ERP) Subiekt GT i programem systemu docelowego (E-commerce) Apilo. 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.
Instancje
Dla tej wtyczki dostępne są instancje. Instancja to zdublowana wtyczka, która pozwala na połączenie dwóch różnych e-commerce z jednym systemem ERP.
Więcej informacji na temat instancji |
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
Punkt odpowiedzialny jest za połączenie z Apilo.
Dane do połączenia należy pobrać bezpośrednio z Apilo wchodząc w Administracja Klucze API Apilo Nowa aplikacja REST API.
Po dodaniu nowej aplikacji pojawią nam się wszystkie dane potrzebne do połączenia, które należy zweryfikować przyciskiem Połącz z Apilo
4. Kategorie produktów w Apilo
Funkcjonalność daje nam możliwość wyznaczenia kategorii w Apilo, na którym będą wykonywane operacje. Weryfikacja, czy produkt już istnieje w Apilo może polegać na sprawdzaniu wszystkich kategorii lub jedynie tych wyznaczonych. Dodatkowo należy wskazać jedną kategorię w Apilo, w której pojawi się dodany produkt.
Dostępne opcje:
a) Chcę, by produkty były pobierane z wszystkich kategorii
Integracja będzie weryfikować we wszystkich kategoriach, czy dany produkt istnieje w Apilo.
b) Chcę wybrać kategorie z których będą pobierane produkty
Integracja zweryfikuje tylko produkty znajdujące się w wybranych kategoriach docelowych.
Podgląd dostępnych kategorii znajdziemy wybierając z górnego menu w Apilo: Towary i usługi -> Kategorie.
- Wybierz kategorie, w których zostaną utworzone produkty nie istniejące w Apilo
Opcja pozwala na wybranie kategorii, w której mają zostać utworzone produkty, które nie istnieją w Apilo.
UWAGA
Pozostawianie pola z kategorią w której mają tworzyć się produkty nie istniejące w Apilo pustego spowoduje że nowe produkty będą się tworzyły bez kategorii
c) Traktuj grupę produktu w Subiekt GT jako kategorię produktu w Apilo
5. Czy wszystkie produkty z Subiekt GT mają zostać przeniesione?
Funkcjonalność ta pozwala na filtrowanie produktów, które chcemy przesyłać do Apilo.
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 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 aktywne jak i nieaktywne.
b) Tak (prześlij jedynie aktywne produkty)
Integracja prześle wyłącznie produkty oznaczone jako aktywne.
6. Czy chcesz usuwać niepowiązane produkty?
Integracja usunie z Apilo produkty, które nie znajdą swojego powiązanego produktu po stronie Subiekt GT (wybór mapowania określamy w pkt. 11 konfiguracji).
Dostępne opcje:
a) Nie (ustawienie domyślne)
Integracja nie usunie z wyznaczonej kategorii w Apilo produktów, które nie znajdują się na wyznaczonym magazynie Subiekt GT.
b) Tak
Wszystkie produkty z wybranego katalogu/kategorii w Apilo nie zmapowane według wartości wybranej w pkt.11 z wybranym magazynem w Subiekt GT zostaną usunięte.
UWAGA
Wybierając TAK usunie wszystkie produkty z wybranej kategorii z Apilo jeśli nie znajdą swojego odpowiednika w wybranym magazynie Subiekt GT.
7. Czy chcesz usuwać zduplikowane produkty?
a) Nie (ustawienie domyślne)
Integracja nie będzie usuwać zduplikowanych produktów.
b) Tak, usuń zduplikowane produkty po wskazanym polu
W przypadku, gdy integracja odnajdzie dwa lub więcej produktów po wskazanym polu, usunie wszystkie produkty tak, aby został tylko ten z najniższym ID.
8. Czy chcesz filtrować produkty po wartości pól własnych?
a) Nie
Integracja nie będzie filtrować produktów po polu własnym
b) Pobieraj z Subiekt GT tylko produkty które w danym polu własnym mają określoną wartość:
Integracja będzie filtrowała produkty według ustawionego mapowania.
Mapowanie:
Pole własne z Subiekt GT
Wartość pola własnego z Subiekt GT
9. 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. Apilo 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.
10. Magazyny w Subiekt GT
Funkcjonalność ta pozwala integracji na odnalezienie produktów w systemie źródłowym.
Wskaż, z którego magazynu Subiekt GT mają być pobierane stany magazynowe:
Należy wpisać SYMBOL magazynu w Subiekt GT
PAMIĘTAJ
Wpisanie kilku symboli magazynów po przecinku spowoduje zsumowanie stanów z tych magazynów.
11. W jaki sposób chcesz powiązać produkty z Subiekt GT z produktami w magazynie Apilo ?:
Funkcjonalność umożliwia wybór mapowania produktów pomiędzy magazynami Subiekt GT a Apilo.
Dostępne opcje:
a) Apilo
W Apilo (ErpBox) potrzebne informacje możesz znaleźć w kartotece produktu Towary i usługi -> Kategorie.
b) Subiekt GT
- Symbol
- Nazwa
- Podstawowy kod kreskowy
- Pola własne 1-8
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.
12. Jakie zadania chcesz wykonać w trakcie synchronizacji produktów?
Funkcjonalność umożliwia wybór wykonywanych zadań z każdą pętlą programu.
Dostępne opcje:
a) Dodaj produkty
UWAGA
Jeżeli w punkcie 11 mapowanie produktów będzie oznaczone jako EAN=EAN, a ten punkt nie zostanie zaznaczony, to integracja za każdą pętlą będzie dodawała nowe produkty, ponieważ w Apilo klucz mapowania będzie pozostawał pusty
- Dodaj atrybuty - opcja doda atrybuty produktów, które są na kartotece produktu w Subiekt GT.
PODPOWIEDŹ
Wymaga konfiguracji w pytaniu Przenieś pola własne do Apilo zgodnie z mapowaniem.
b) Aktualizuj produkty
- Aktualizuj nazwy produktów - opcja zaktualizuje nazwy produktów, które zostały zmienione po stronie Subiekt GT.
- Aktualizuj EAN - opcja zaktualizuje EAN produktów, które zostały zmienione po stronie Subiekt GT.
- Aktualizuj zdjęcia - opcja zaktualizuje zdjęcia produktów, które zostały zmienione po stronie Subiekt GT.
- Aktualizuj Symbole produktów - opcja zaktualizuje symbole produktów, które zostały zmienione po stronie Subiekt GT.
- Aktualizuj atrybuty - opcja zaktualizuje atrybuty produktów, które zostały zmienione po stronie Subiekt GT.
PODPOWIEDŹ
Wymaga konfiguracji w pytaniu Przenieś pola własne do Apilo zgodnie z mapowaniem.
- Aktualizuj wagę produktów - opcja zaktualizuje wagę produktów, które zostały zmienione po stronie Subiekt GT.
- Aktualizuj opisy produktów - opcja umożliwia aktualizację pola opisu produktów, które są na kartotece produktu w Subiekt GT. Do pola ‘Krótki opis’ w Apilo zostanie dodany opis z pola ‘Opis’ z Subiekta GT, do pola ‘Opis’ w Apilo zostanie dodany opis z pola ‘Pełna charakterystyka pozycji’ z Subiekta GT
UWAGA!
Należy pamiętać, aby przy wyborze checkboxa aktualizacji produktów -> Aktualizuj EAN/Symbol zwrócić uwagę jakie mapowanie produktów ustawiliśmy w pkt. 12. Jeżeli ustawimy mapowanie po SKU-Symbol, oraz ustawimy aktualizację Symbolu, to wtyczka doda nowy produkt, ponieważ nie zmapuje starego.
13. Przenieś pola własne do Apilo zgodnie z mapowaniem
Funkcjonalność ta pozwala na przeniesienie danego pola własnego zdefiniowanego w Subiekt GT do utworzonego pola w Apilo.
Dostępne opcje:
a) Pole w Subiekt GT
- Pole własne od 1 do 8
Należy w Subiekt GT dodać i zdefiniować pola własne dla asortymentu.
Dostępne pola własne oraz ich wartości możemy zweryfikować/edytować w Subiekt GT wpisując w pole Lista modułów -> Administracja -> Parametry -> Pola własne -> Towar i usługa -> Popraw
- Waga
- Kod CN
- Symbol
- Nazwa
- Jednostka miary
- Kod PLU
- Podstawowy kod kreskowy
- Producent
b) Typ pola w Apilo
Wybieramy typ pola w Apilo, do którego mają zostać przesłane informacje.
c) Nazwa pola dodatkowego w Apilo
- Po wybraniu “lupki” wybieramy wartość pola Atrybut z Apilo w którą integracja przepisze dane z Subiekt GT.