Miniaturka artykułu
18-06-2024, Kamil

Instrukcja eCommerce

III. Działanie dodatku

1. Zakładka wariantowości w kartotece towaru

Jeżeli aktywowano wariantowość, to w kartotece każdego towaru będzie widoczna zakładka
e-commerce: Wariantowość.


Można w niej zdefiniować:
  • Wariantowy: czy towar ma być towarem wariantowym (głównym lub podrzędnym)
  • Główny: czy towar wariantowy jest towarem głównym
  • Kod: kod, który definiuje zależność wariantów od towaru głównego. Szerzej zostało to opisane w pkt II.1.
Podczas tworzenia nowego towaru głównego można wykorzystać przycisk Generuj, który namierzy towar główny o najwyższym kodzie i podstawi jego kod powiększony o 1.
Po wprowadzeniu wartości kodu można wykorzystać przycisk Waliduj, który pokaże komunikat czy dany kod jest wolny i czy można go wykorzystać.
Jeżeli zakładka zostanie otwarta na towarze wariantowym, ale nie głównym, to będzie widoczny przycisk Towar główny, który otworzy nadrzędny towar wariantu.


2. Zakładki kont w kartotece towaru

Dla każdego zdefiniowanego konta w konfiguracji dodatku, widoczna będzie zakładka w kartotece towaru w której można definiować różne opcje do synchronizacji.


Opis poszczególnych pól znajduje się w punkcie II, w podpunkcie 2.2.
W sekcji Ilości dla konta typu Baselinker będzie widoczny grid z listą magazynów w sekcji Magazyny, jeśli na koncie zdefiniowano wiele magazynów oraz w konfiguracji przypisano dla każdego magazynu inną cechę z ilością i lokalizacją.
Sekcja Pola dodatkowe jest uzupełniona, jeśli w konfiguracji w zakładce Cechy dodatkowe powiązano pola dodatkowe z cechami na towarze.
Niektóre platformy e-commerce umożliwiają wprowadzenie kilku wartości dla pola dodatkowego – należy je wtedy rozdzielić znakiem „|”.
Sekcja Parametry jest widoczna tylko dla konta Baselinker. Umożliwia ona zdefiniowanie wartości cech, które są eksportowane do Baselinkera jako parametry towaru. Więcej informacji na temat mechanizmu działania znajduje się w pkt II.5.4 w śródtytule pola dodatkowe.
Sekcja Parametry JSON jest widoczna tylko dla konta Baselinker. Umożliwia ona zdefiniowanie nazw i wartości parametrów produktu, które będą eksportowane do Baselinkera. Więcej informacji na temat mechanizmu działania znajduje się w pkt II.5.4 w śródtytule pola dodatkowe.

3. Workery

Workery są głównym mechanizmem, który umożliwia synchronizację danych między enova365 a platformami
e-commerce.
Zanim workery zostaną uruchomione pojawi się okienko potwierdzające.
Jeżeli zdefiniowano tylko jedno konto, to okienko będzie tylko potwierdzeniem operacji (opcje Tak i Nie).
Jeżeli zdefiniowano więcej niż jedno konto, to okienko będzie posiadało parametr definiujący, które konto należy zsynchronizować. Wybranie wartości „Wszystkie” zsynchronizuje wszystkie zdefiniowane konta.
 

3.1. Towary

Na liście towarów widoczne są następujące workery:

  • Zaznacz e-SKLEP: dla zaznaczonych towarów aktywuje synchronizację
  • Zaznacz AKTYWNY na e-sklep: dla zaznaczonych towarów zaznacza cechę odpowiedzialną za aktywność towaru w e-commerce
  • Zaznacz DO EKSPORTU: dla zaznaczonych towarów aktywuje synchronizację w najbliższej sesji
  • Odznacz e-SKLEP: dla zaznaczonych towarów dezaktywuje synchronizację
  • Odznacz AKTYWNY na e-sklep: dla zaznaczonych towarów odznacza cechę odpowiedzialną za aktywność towaru w e-commerce
  • Odznacz DO EKSPORTU: dla zaznaczonych towarów dezaktywuje synchronizację w najbliższej sesji
  • Eksportuj towary: zostanie wykonany eksport towarów, które mają włączoną synchronizację w najbliższej sesji. Po zakończeniu eksportu flaga zostanie odznaczona. Nie zostaną wyeksportowane tylko zdjęcia, bo służy do tego inny worker.
  • Eksportuj tylko ilości (zaznaczone): zostanie wykonany eksport tylko stanu magazynowego (wartość pobrana z cechy) towarów, które mają włączoną synchronizację w najbliższej sesji. Po zakończeniu eksportu flaga zostanie odznaczona.
  • Eksportuj tylko ilości (wszystkie): zostanie wykonany eksport tylko stanu magazynowego (wartość pobrana z cechy) wszystkich towarów, które są synchronizowane z e-commerce. Flaga Do synchronizacji nie ma znaczenia. Dodatkowo operacja ta ma przypisany skrót klawiszowy: Ctrl + Shift + S.
  • Eksportuj tylko ceny (zaznaczone)tylko Baselinker. Zostanie wykonany eksport tylko cen towarów, które mają włączoną synchronizację w najbliższej sesji. Po zakończeniu eksportu flaga zostanie odznaczona.
  • Eksportuj tylko ceny (wszystkie)tylko Baselinker. Zostanie wykonany eksport tylko cen wszystkich towarów, które są synchronizowane z e-commerce. Flaga Do synchronizacji nie ma znaczenia. Dodatkowo operacja ta ma przypisany skrót klawiszowy: Ctrl + Shift + C.
  • Eksportuj tylko ilości i ceny (zaznaczone)tylko Baselinker. Zostanie wykonany eksport tylko cen i ilości towarów, które mają włączoną synchronizację w najbliższej sesji. Po zakończeniu eksportu flaga zostanie odznaczona.
  • Eksportuj tylko ilości i ceny (wszystkie)tylko Baselinker. Zostanie wykonany eksport tylko cen i ilości wszystkich towarów, które są synchronizowane z e-commerce. Flaga Do synchronizacji nie ma znaczenia. Dodatkowo operacja ta ma przypisany skrót klawiszowy: Ctrl + Shift + A.
  • Eksportuj tylko zdjęcia: zostanie wykonany eksport tylko zdjęć towarów, które mają włączoną synchronizację w najbliższej sesji. Po zakończeniu eksportu flaga zostanie odznaczona.
  • Importuj: Po wybraniu parametrów importu w nowym okienku, zostanie wykonany import towarów z e-commerce. Import posiada różne tryby (Wszystkie, Tylko aktywne, Tylko brakujące w enova365 i Jeden), pozwalające zaimportować konkretną pulę towarów. Towary będą szukane wg ustawienia w konfiguracji dodatku Towary -> Synchronizacja Import -> Parowanie towarów. Można również w okienku parametrów importu zaznaczyć opcję Dodaj brakujące towary, dzięki czemu, gdy towar nie zostanie znaleziony w enova365, to zostanie utworzony nowy.
  • Dezaktywuj w ecommerce niepowiązane produkty: zostanie wykonana dezaktywacja flagi aktywności dla tych towarów, których nie ma w enova365
  • Utwórz wariant produktu: worker, który dla zaznaczonego towaru głównego pomoże dodać towar wariantowy odpowiednio uzupełniając niezbędne cechy

Operator serwisowy:
Wyczyść ID produktu i wariantu: cechy z identyfikatorami produktu i wariantu zostaną wyczyszczone. Worker ma cel serwisowy.
Zanim workery zostaną uruchomione pojawi się okienko potwierdzające.
Jeżeli zdefiniowano tylko jedno konto, to okienko będzie tylko potwierdzeniem operacji (opcje Tak i Nie).
Jeżeli zdefiniowano więcej niż jedno konto, to okienko będzie posiadało parametr definiujący, które konto należy zsynchronizować. Wybranie wartości „Wszystkie” zsynchronizuje wszystkie zdefiniowane konta.

3.2. Zamówienia od odbiorców

Na liście zamówień od odbiorców widoczne są następujące workery:

  • Importuj zamówienia: zostanie uruchomiony import zamówień. Dla konta typu Baselinker importer posiada 2 tryby (Od wybranej daty i Jeden), pozwalające zaimportować konkretną pulę dokumentów.
  • Eksportuj zamówienia (zaznaczone): Tylko Baselinker. Zaznaczone zamówienia zostaną wyeksportowane do e-commerce, a na cechę zostanie przypisany identyfikator z e-commerce otrzymany po dodaniu.
  • Zmień status zamówień (zaznaczone): worker, który zmieni wartość cechy ze statusem aktualnym oraz zmieni status w e-commerce na wybrany w wyskakującym okienku w e-commerce. Aby zmienić status, należy w konfiguracji dodatku dodać reguły statusów, czyli ustalić jakie statusy docelowe są możliwe dla statusów źródłowych. Zaznaczenie flagi Tylko z pokryciem zmieni status tylko tym zamówieniom, których wszystkie towary na pozycjach mają stan magazynowy większy lub równy cesze Ilość dostępna.
  • Zmień status zamówień SERWIS (zaznaczone): worker, który zmieni wartość cechy ze statusem aktualnym oraz zmieni status w e-commerce na wybrany w wyskakującym okienku w e-commerce. Worker widoczny tylko dla operatora serwisowego. Worker nie bierze pod uwagę reguł statusów, dlatego należy zachować ostrożność. Zaznaczenie flagi Tylko z pokryciem zmieni status tylko tym zamówieniom, których wszystkie towary na pozycjach mają stan magazynowy większy lub równy cesze Ilość dostępna.
  • Eksportuj pola dodatkowe zamówień (zaznaczone): Tylko Baselinker. Worker, który wyeksportuje pola dodatkowe (pole dodatkowe 1, pole dodatkowe 2 i Uwagi). W okienku parametrów zaznaczenie flagi Doklej do istniejących spowoduje dodanie wartości pól dodatkowych do już istniejących wartości. Nie zaznaczenie tej flagi spowoduje nadpisanie danych. Pola dodatkowe zostaną wyeksportowane tylko wtedy, kiedy zostanie wprowadzona jakakolwiek wartość. Jeżeli pole będzie puste, nie zostanie wyeksportowane i nie nadpisze istniejącej wartości w e-commerce.
  • Utwórz paczkę (zaznaczone): Tylko Baselinker. Worker, który utworzy paczkę w Baselinkerze dla zaznaczonych zamówień. Pojawi się okienko z parametrami na którym można wybrać kuriera (przewoźnika). W przypadku wybrania wartości DYNAMICZNY, przewoźnik zostanie wybrany na podstawie cechy algorytmicznej na dokumencie, która powinna zwracać identyfikator przewoźnika z Baselinkera. Cechę tę należy wybrać w konfiguracji konta w zakładce Zamówienia w polu Cecha ID kuriera.
  • Utwórz paczkę (wszystkie): Tylko Baselinker. Worker, który utworzy paczkę w Baselinkerze dla wszystkich zamówień, które nie mają wypełnionej cechy z ID paczki (pole Cecha ID paczki), mają wypełnioną cechę z ID zamówienia oraz mają wypełnioną cechę z Nr przesyłki. Pojawi się okienko z parametrami na którym można wybrać kuriera (przewoźnika). W przypadku wybrania wartości DYNAMICZNY, przewoźnik zostanie wybrany na podstawie cechy algorytmicznej na dokumencie, która powinna zwracać identyfikator przewoźnika z Baselinkera. Cechę tę należy wybrać w konfiguracji konta w zakładce Zamówienia w polu Cecha ID kuriera.
  • Otwórz w przeglądarce: worker, który otworzy w przeglądarce adres URL odnoszący do zaznaczonego dokumentu w platformie e-commerce

3.3. Faktury sprzedaży

  • Importuj faktury i paragony: zostanie uruchomiony import faktur/paragonów (w konfiguracji można włączyć pobieranie tylko faktur lub tylko paragonów). Dla konta typu Baselinker importer posiada 2 tryby (Od wybranej daty i Jeden), pozwalające zaimportować konkretną pulę dokumentów.
  • Eksportuj faktury i paragony (zaznaczone): zostanie uruchomiony eksport numerów i wydruków dla zaznaczonych dokumentów. W okienku z parametrami należy tylko wybrać serię numeracji, jeśli nie zaznaczono flagi do rozpoznawania serii i nie zdefiniowano serii dla szablonu dokumentu. Worker widoczny jeśli w konfiguracji zamówień zaznaczono pole Przesyłaj FV do e-commerce
  • Eksportuj faktury i paragony (wszystkie): zostanie uruchomiony eksport numerów i wydruków dla dokumentów, które mają pustą cechę z ID dokumentu (w konfiguracji: FV i PAR do e-commerce > Cecha ID FV). W okienku z parametrami należy tylko wybrać serię numeracji, jeśli nie zaznaczono flagi do rozpoznawania serii i nie zdefiniowano serii dla szablonu dokumentu. Worker widoczny jeśli w konfiguracji zamówień zaznaczono pole Przesyłaj FV do e-commerce

3.4. Kontrahenci

Na liście kontrahentów (tylko konto Erpit B2B) widoczne są następujące workery:

  • Eksportuj (zaznaczeni): Worker, który dokona eksportu zaznaczonych kontrahentów na liście do B2B
  • Eksportuj (zmodfyikowani): Worker, który dokona eksportu kontrahentów do B2B, którzy zostali zmodyfikowani w enova365 później niż data wprowadzona w konfiguracji konta w polu "Kontrahenci > Eksportuj od daty"
  • Eksportuj cenniki indywidualne: Worker, który dokona eksportu cenników indywidualnych kontrahentów dla produktów, które są synchronizowane z e-commerce oraz mają ustawiony identyfikator e-commerce (czyli zostały już zsynchronizowane)
  • Importuj: Worker, który dokona importu kontrahentów z B2B; nastąpi próba znalezienia istniejącego kontrahenta wg ustawienia pola "Kontrahenci > Parowanie kontrahentów"
  • Eksportuj identyfikatory (zaznaczeni): Worker, który dokona eksportu identyfikatorów enova kontrahentów do B2B dla zaznaczonych kontrahentów na liście
  • Eksportuj identyfikatory (wszyscy): Worker, który dokona eksportu identyfikatorów enova kontrahentów do B2B dla wszystkich kontrahentów w bazie danych, którzy mają wypełnioną cechę z zewnętrznym ID

3.5. Wydania magazynowe

Na liście WZ (tylko konto Erpit B2B) widoczne są następujące workery:

  • Importuj WZ: Worker, który dokona importu WZ z B2B do enova365; jeżeli zaznaczono opcję zamówień wewnętrznych, to zostaną również pobrane dokumenty MM

4.Towary wirtualne

Od wersji 1.93 nasz dodatek pozwala na dodawanie towarów wirtualnych, dzięki czemu jeden towar możemy wyeksportować do Baselinkera jako różne towary z różnymi cenami itd.
Wpierw musimy przeprowadzić dodatkową konfigurację:
  • Założyć nową cechę tekstową i ją podpiąć w konfiguracji:
  • Przechodzimy do Narzędzia > Opcje > Handel > Cechy > Towary
  • Klikamy 'Nowy (Definicja cechy)'
  • Podajemy nazwę cechy, w naszym przypadku jest to TowarWirtualny i upewniamy się, że typ cechy jest tekstowy

  • Po dodaniu cechy póki jesteśmy na liście należy otworzyć cechę: ErptEcommerceIloscExport , następnie w zakładce algorytm usunąć treść i wstawić kod:  public double Feature_ErptEcommerceIloscExport{ get { var guidNadrzednego = Row.Features.GetString("TowarWirtualny"); if (string.IsNullOrEmpty(guidNadrzednego)) { var mm = MagazynyModule.GetInstance( Session ); var worker = new StanMagazynuWorker(); worker.Towar = Row; worker.Magazyn = mm.Magazyny.Firma; return worker.StanRazem.Value; } else { var hm = HandelModule.GetInstance(Session); var nadrzedny = hm.Towary.Towary[Guid.Parse(guidNadrzednego)]; return nadrzedny.Features.GetDouble("ErptEcommerceIloscExport"); } } } 
  • Jeżeli stworzona wcześniej cecha nazywa się inaczej niż TowarWirtualny, należy w wklejonym kodzie znaleźć TowarWirtualny i zamiast niego wpisać nazwę cechy stworzonej
  • Po wklejeniu kodu klikamy OK, dzięki tej zmianie towary wirtualne będą miały synchronizowany stan z towarem nadrzędnym.
  • Następnie z listy po lewej wybieramy konfigurację dodatku eCommerce (końcu listy wybieramy Erpit>e-commerce>konfiguracja).
  • Przechodzimy do konfiguracji konta w tabelce na dole, klikamy 'Otwórz' na koncie, w zakładce Towary odnajdujemy pole 'Cecha towar nadrzędny' i wybieramy cechę którą stworzyliśmy chwilę wcześniej, w naszym przypadku TowarWirtualny

  • Dzięki temu powiązaniu każdy towar wirtualny będzie przechowywał informacje o towarze od którego pochodzi
  • Po wykonaniu powyższych kroków możemy kliknąć OK żeby zapisać zmiany w koncie. Nie należy zamykać okna konfiguracji dodatku ponieważ zaraz będzie potrzebne.
  • W zakładce Ogólne należy włączyć 'Nowe API dla produktów'. Bez tego nie pojawi się parę opcji eksportu do Baselinkera.
  • Wchodzimy w towar który będzie bazą dla naszych towarów wirtualnych, w zakładce Dodatkowe na końcu listy, zaznaczamy 'Dozwolona edycja opisu towaru na dokumencie' bez tego przy imporcie zamówień do enovy, wystąpi błąd o próbie modyfikacji pola tylko do odczytu.
Po wykonaniu powyższych kroków, na liście towarów w czynnościach>e-commerce pojawi się opcja 'Utwórz towar wirtualny'. Następnie poprosi nas o wybranie dla którego konta Baselinker będzie dokonywać zmian. Wyświetli się okno dodawania towaru które należy uzupełnić tak samo jak w pozostałych przypadkach. Należy pamiętać, że domyślnie kod kreskowy czyli EAN powinien być ten sam dla towarów wirtualnych i nadrzędnego, z racji że jest to ten sam towar, ale sprzedajemy go w różnych cenach/wariantach itp. Żeby je odróżnić np.: w Baselinkerze możemy w zakładce e-commerce:Baselinker nadać im różne SKU.
Tak jak normalny towar, towary wirtualne należy oznaczyć do eksportu (czynności>e-commerce>Zaznacz do Eksportu), po czym w tym samym menu 'Eksportuj towary'. Towary pojawią się w Baselinkerze i będzie można je wystawić jako każdy z osobna.
W przypadku importu zamówień, zamówienie w enovie będzie wyświetlać towar nadrzędny ale z poprawionymi cenami itd. Na każdej pozycji opis dodatkowy będzie zawierał informacje jako który towar wirtualny dana pozycja się sprzedała.