Spis treści

Instrukcja obsługi - Dodatek eCommerce

I. Instalacja dodatku

Instrukcja dla v. 1.47.

1. Import cech

Aby ułatwić instalację dodatku, w paczce z dodatkiem oprócz pliku DLL znajdują się dwa pliki XML, które służą do zaimportowania wszystkich niezbędnych cech oraz usługi o nazwie BRAK TOWARU, które są konieczne do prawidłowego działania dodatku.

Aby je zaimportować należy w enova365 wybrać poniższą opcję:

Następnie należy wczytać obydwa pliki XML dołączone do pliku DLL.

Uwaga!

Do dodatku dołączony jest plik z cechami dla jednego konta. Chcąc założyć wiele kont, należy dodać nowe cechy odpowiadające identyfikatorom produktów, dokumentów itd. Więcej informacji w pkt II.4.

Następnie należy zainstalować sam dodatek oraz wczytać wygenerowaną licencję. Następnie należy ponownie uruchomić enova365. Jeżeli w enova365 w Narzędzia -> Opcje jest widoczna zakładka ERPIT -> e-commerce, to znaczy, że biblioteka z dodatkiem została zainstalowana prawidłowo.

2. Instalacja dodatku

Instrukcję instalacji dodatków do enova365 znajduje się pod linkiem:

Instalacja dodatku w enova365

3. Licencja dodatku

Instrukcję wczytywania licencji do dodatków do enova365 można znaleźć pod linkiem:
Jak zainstalować licencje dodatku w enova365?

II. Konfiguracja dodatku

Aby uruchomić okno konfiguracji należy w enova365 wybrać:
Narzędzia -> Opcje -> ERPIT -> e-commerce

W lewym górnym rogu zakładki znajduje się numer wersji. W przypadku aktualizacji dodatku należy się upewnić, że została zainstalowana wersja z odpowiednim numerem.
Pod numerem wersji znajduje się przycisk za pomocą którego można w dowolnym momencie otworzyć tą instrukcję w domyślnej przeglądarce internetowej.

Uwaga! Po każdej zmianie w konfiguracji dodatku należy odświeżyć aktualny widok w enova365 (przyciskiem Odśwież lub zmieniając widok i wracając do poprzedniego).

1. Logi

Obsługa logów jest opcjonalna, działa tylko w interfejsie desktopowym i ma charakter diagnostyczny. Po zaznaczeniu pola Logi -> Aktywuj należy podać ścieżkę do której logi będą zapisywane.

2. Cechy identyfikujące dokumenty

Należy wybrać cechy na dokumentach handlowych, które zostaną wypełnione typem i nazwą konta z którego z dany dokument został zaimportowany.

3. Warianty towarów

Jeżeli na wykorzystywanej platformie e-commerce jest obsługiwana wariantowość (jeden produkt posiadający kilka wariantów), to należy zaznaczyć pole Aktywuj w sekcji Warianty towarów.

Mechanizm wariantowości w dodatku jest oparty na cesze Kod. Wartość tej cechy powinna składać się z kodu towaru nadrzędnego (głównego) oraz kodu wariantu (po znaku „/”).
Np. towar główny X ma kod o wartości „ABC”. Wtedy warianty towaru X powinny mieć kod o wartości „ABC/DEF”, „ABC/GHI”, „ABC/JKL” itd. Część kodu przed znakiem „/” wskazuje, który towar jest towarem nadrzędnym dla wariantu.

Jeżeli wariantowość nie jest wykorzystywana, to należy przejść do punktu 2.

Po zaznaczeniu opcji Aktywuj pojawi się nowa sekcja Cechy wariantów zawierająca pola, w których należy wybrać cechy odpowiedzialne za konkretne funkcje.

Wykaz cech wariantowości:

Wariantowy: cecha warunkowa, definiująca czy dany towar jest towarem wariantowym (dotyczy zarówno towaru głównego jak i jego wariantów).
Główny: cecha warunkowa, definiująca czy dany towar wariantowy jest towarem głównym (nadrzędnym).
Kod: cecha tekstowa, przechowująca kod służący do identyfikacji towaru głównego dla wariantów.
Zdjęcie towaru głównego: cecha tekstowa. W większości platform e-commerce zdjęcia dodaje się tylko do towarów głównych, a w wariantach wybiera się, które zdjęcie z towaru głównego odpowiada wariantowi. Cecha ta przechowuje odniesienie do zdjęcia z towaru głównego.

4. Opcje

Z listy można wybrać login operatora, który będzie miał dostęp do narzędzi serwisowych, np. do czyszczenia identyfikatorów produktów czy kategorii.

Opcja Waliduj konta powinna być zaznaczona. Dzięki temu sprawdzane będzie potencjalne powielenie cech identyfikujących dla różnych kont, co mogłoby doprowadzić do desynchronizacji produktów i nieporządku w enova365.

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.

Wszystkie pola przechowujące nazwy cech zostaną uzupełnione automatycznie na podstawie zaimportowanych cech z pliku XML. 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.

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 6 typów: Baselinker, Shoper, PrestaShop, WooCommerce, Magento oraz Erpit B2B.

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.

Przycisk Dodaj brakujące cechy służy do wygenerowania całego kompletu cech dla nowego konta, lub dodania brakujących cech dla konta już zdefiniowanego, niezbędnych do działania synchronizacji. 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.

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. 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.

5.2. Zakładka Towary

W sekcjach Synchronizacja Eksport i Synchronizacja Import można włączać i wyłączać konkretne rzeczy, które mają być synchronizowane w synchronizacji towarów.
W zależności od włączonych elementów do synchronizacji pojawią się pola z wyborem definicji cech lub innych ustawień związanych z daną synchronizacją.

Po zaznaczeniu Synchronizuj w sekcji Synchronizacja Import pojawi się również pole Parowanie towarów. Pole to ma taką samą listę wartości jak pole o tej samej nazwie w sekcji Dokumenty. Można wybrać w jaki sposób towary mają być namierzane w enova365 podczas importu towarów z e-commerce, aby odpowiednio do tego dokonać aktualizacji danych namierzonego towaru lub dodać nowy towar.

Pełna lista pól:

Sekcja Konfiguracja cen:

Domyślna definicja ceny: wybór definicji ceny, która będzie ustawiana podczas importu z e-commerce lub wysyłana podczas eksportu do e-commerce
Domyślny rodzaj ceny: wybór czy ma się synchronizować cena netto czy brutto powyższej definicji cen

Baselinker:
Jeżeli w Baselinkerze zdefiniowano grupy cenowe, będzie widoczna sekcja Grupy cenowe zawierająca grid umożliwiający połączenie grupy cenowej z Baselinkera z definicją i rodzajem ceny z enova365.

Sekcja Konfiguracja ilości:

Cecha ilość dostępna: cecha liczbowa (rzeczywista), zawierająca wartość stanu magazynowego wykorzystywanego w workerze do zmiany statusu zamówień przy zaznaczeniu parametru Tylko z pokryciem. Więcej informacji w pkt III.3.2. Domyślnie cecha jest cechą algorytmiczną, wyliczającą stan magazynowy na podstawie stanu magazynowego w enova365.
Cecha ilość import: cecha liczbowa (rzeczywista), do której zostanie zapisany stan magazynowy pobrany podczas importu z e-commerce.
Masowy eksport ilość prod.: pole widoczne tylko na koncie typu Baselinker. Definiuje ilość produktów, które będą wysyłane w jednej paczce podczas eksportu ilości lub cen produktów.
Domyślna cecha ilość eksport: cecha liczbowa (rzeczywista), zawierająca wartość stanu magazynowego wysyłanego do e-commerce. Domyślnie cecha jest cechą algorytmiczną, wyliczającą stan magazynowy na podstawie stanu magazynowego w enova365.
Domyślna cecha lok. mag.: pole widoczne tylko na kontach typu Baselinker i PrestaShop. Cecha tekstowa, zawierająca miejsce w magazynie wysyłane do e-commerce.

Jeżeli konto typu Baselinker ma zdefiniowanych kilka magazynów, będzie widoczna sekcja Magazyny zawierająca grid z listą tych magazynów. Dla każdego magazynu można na tym gridzie przypisać inną cechę do eksportu ilości i lokalizacji na magazynie. Po przypisaniu różnych cech na kartotece towaru będzie widoczny grid zawierający wartości tych cech. Dzięki temu dla każdego magazynu można eksportować inną ilość oraz lokalizację towaru.

Sekcja Konfiguracja zdjęć:

Tryb eksportu zdjęć: pole przyjmuje 2 wartości:

1. URL
  
  Na kartotece towaru będzie widoczna tabela w której będzie możliwość dodawania adresów URL do zdjęć towaru. Niezbędne jest wybranie w polu Cecha dla URLi zdjęć cechy tekstowej, która będzie przechowywała zawartość tej tabeli, czyli zdefiniowane adresy URL.
2. Base64
  
  Zdjęcia będą pobierane z załączników towaru oraz konwertowane do formatu base64.
  
  Rozwiązanie to obciązy bazę danych enova365.
  
  W platformach Shoper, PrestaShop i Magento należy również podać cechę Cecha dla ID, przechowującą identyfikator zdjęcia z e-commerce.
  
  Można też wprowadzić prefiks w polu Prefiks nazwy zdjęć do eksportu, aby podczas eksportu towaru wybierane były tylko te załączniki, które w nazwie zawierają zdefiniowany prefiks.

Na razie możliwy jest tylko eksport zdjęć. Import jest nieobsługiwany w żadnym z kont.

Sekcja Konfiguracja cech:

Podsekcja Towary:

ID: cecha tekstowa, przechowująca identyfikator towaru z e-commerce
Opis: cecha tekstowa, przechowująca opis towaru z e-commerce
Synchronizuj war. konieczny: cecha warunkowa, definiująca czy towar ma być synchronizowany z e-commerce
Synchronizuj war. dostateczny: cecha warunkowa, definiująca czy towar ma być synchronizowany z e-commerce w najbliższej sesji eksportu. Po eksporcie zakończonym sukcesem cecha zostanie automatycznie odznaczona. Po imporcie dokumentów zakończonym sukcesem, jeśli towar znalazł się na jakimś dokumencie, to cecha zostanie automatycznie zaznaczona.
Waga: cecha liczbowa (rzeczywista), zawierająca wagę towaru z e-commerce
Wysokość: cecha liczbowa (rzeczywista), zawierająca wysokość towaru z e-commerce
Szerokość: cecha liczbowa (rzeczywista), zawierająca szerokość towaru z e-commerce
Długość: cecha liczbowa (rzeczywista), zawierająca długość towaru z e-commerce
Kod (SKU): cecha tekstowa, zawierająca unikalny kod identyfikujący towar
Nazwa produktu: cecha tekstowa, przechowująca nazwę produktu z e-commerce: Shoper, PrestaShop, WooCommerce, Magento i Erpit B2B:
Czy aktywny: cecha warunkowa, definiująca czy towar jest oznaczony jako aktywny

Podsekcja Warianty (tylko, jeśli wariantowość została aktywowana):

ID: cecha tekstowa, przechowująca identyfikator wariantu z e-commerce
Nazwa wariantu: cecha tekstowa, przechowująca nazwę wariantu z e-commerce: Shoper, PrestaShop, WooCommerce i Magento:
- Opcja 1: cecha tekstowa, przechowująca identyfikator cechy wariantowej 1 z e-commerce
- Opcja 2: cecha tekstowa, przechowująca identyfikator cechy wariantowej 2 z e-commerce
- Wartość opcji 1: cecha tekstowa, przechowująca identyfikator wartości cechy wariantowej 1 z e-commerce
- Wartość opcji 2: cecha tekstowa, przechowująca identyfikator wartości cechy wariantowej 2 z e-commerce

Sekcja Konfiguracja kategorii:

Cecha grupująca: cecha hierarchiczna lub wielohierarchiczna, posiadająca zdefiniowany słownik wartości, odzwierciedlający drzewo kategorii w e-commerce
Cecha ID kategorii: cecha tekstowa, przechowująca identyfikator kategorii z e-commerce
PrestaShop:
- ID kategorii root: wartość identyfikatora głównej kategorii w PrestaShop (najwyższego poziomu)

Kategorie można zaimportować za pomocą przycisku Pobierz kategorie z e-commerce.
Po imporcie należy zamknąć ustawienia enova365 i ponownie je otworzyć.

Po dodaniu kategorii do słownika można je również wyeksportować za pomocą przycisków:
- Wyślij wszystkie kategorie do e-commerce (cały słownik)
- Wyślij zaznaczone kategorie do e-commerce (zaznaczone na gridzie)
Kategorie zostaną sparowane po identyfikatorze z cechy Cecha ID kategorii.

Operator serwisowy:
Przycisk Wyczyść identyfikatory kategorii usuwa przypisane identyfikatory wszystkich kategorii.

5.3. Zakładka Podatki

Zakładka widoczna tylko w typach Shoper i PrestaShop (pod warunkiem zaznaczenia importu lub eksportu cen towarów).

Zakładka służy do powiązania definicji stawek VAT z enova365 ze stawkami VAT zdefiniowanymi w e-commerce.

Pełna lista pól:

Domyślna: domyślna definicja stawki VAT, która zostanie ustawiona na towarze, jeśli nie zostanie znaleziona żadna inna
Cecha ID definicji stawki VAT: cecha tekstowa, przechowująca identyfikator stawki VAT z e-commerce.

W tabeli z definicjami stawek VAT w kolumnie e-commerce ID można wprowadzać wartość identyfikatora stawki VAT z e-commerce.

5.4. Zakładka Cechy dodatkowe

Zakładka widoczna pod warunkiem zaznaczenia importu lub eksportu producentów towarów lub pól dodatkowych.

Producenci

Sekcja ta umożliwia powiązanie elementów słownika przechowującego producentów z enova365 z producentami zdefiniowanymi w e-commerce.

Pełna lista pól:

Cecha grupująca: cecha hierarchiczna, posiadająca zdefiniowany słownik wartości, odzwierciedlający listę producentów w e-commerce
Cecha ID producenta: cecha tekstowa, przechowująca identyfikator producenta z e-commerce

Producentów można zaimportować za pomocą przycisku Pobierz producentów z e-commerce.
Po imporcie należy zamknąć ustawienia enova365 i ponownie je otworzyć.

Po dodaniu producenta do słownika można ich również wyeksportować za pomocą przycisków
- Wyślij wszystkich producentów do e-commerce (cały słownik)
- Wyślij zaznaczonych producentów do e-commerce (zaznaczone na gridzie).
Producenci zostaną sparowani po identyfikatorze z cechy Cecha ID producenta.

Operator serwisowy:
Przycisk Wyczyść identyfikatory producentów usuwa przypisane identyfikatory wszystkich producentów.

Pola dodatkowe

Sekcja ta umożliwia powiązanie pól dodatkowych zdefiniowanych w e-commerce z konkretną cechą typu tekstowego znajdującą się na towarze.

Dodawanie nowego powiązania:

Pole dodatkowe ecommerce: pole zdefiniowane na platformie ecommerce
Cecha enova365: cecha tekstowa na towarze, która będzie powiązana z wybranym wcześniej polem dodatkowym.

Po wybraniu cechy, która jest cechą tekstową oraz ma zdefiniowany słownik wartości, pojawią się przyciski umożliwiające import wartości z e-commerce (konta innego typu niż Baselinker lub konto typu Baselinker, ale z nowym API) do słownika cechy oraz eksport wartości ze słownika cechy do e-commerce (konta innego typu niż Baselinker), jeżeli pole w e-commerce jest polem słownikowym.

Po powiązaniu pola dodatkowego z cechą na towarze na kartotece towaru widoczny będzie dodatkowy grid z polami dodatkowymi w którym możliwe będzie wprowadzenie wartości dla tych pól, które zostaną wyeksportowane do e-commerce po dokonaniu eksportu, albo zasilone z e-commerce po dokonaniu importu. Import pól dodatkowych działa tylko na towarach głównych.

Baselinker

Prefiks cechy dla parametrów: Baselinker oprócz pól dodatkowych umożliwia definiowanie parametrów dla produktów, bez konieczności definiowania samego pola dodatkowego w ustawieniach Baselinkera. Pole Prefiks cechy dla parametrów przechowuje prefiks dla nazw cech na towarach, które będą wykorzystywane do eksportu parametrów. Podczas eksportu nastąpi iteracja po wszystkich cechach na towarach, których nazwy zaczynają się od wprowadzonego prefiksu i nastąpi eksport parametrów. Nazwą parametru będzie nazwa cechy (po prefiksie), a wartością parametru będzie wartość cechy.

Cecha z JSONem parametrów: Zamiast prefiksu cech oraz definiowania tych cech, można wykorzystać jedną cechę, która będzie przechowywała wszystkie parametry produktów w formacie JSON. Po wprowadzeniu wartości cechy w konfiguracji dodatku, na kartotece towaru będzie widoczny grid Parametry JSON, w którym możliwe będzie definiowanie nazw i wartości parametrów bez konieczności tworzenia cechy dla każdego parametru. Jeżeli jednak każdy parametr ma być zdefiniowany na osobnej cesze, należy użyć powyższej metody z prefiksem cechy.

5.5. Zakładka Dokumenty

Pełna lista pól:

Sekcja Zamówienia:

Synchronizuj: aktywuje pobieranie zamówień z e-commerce; na liście zamówień widoczny będzie worker do importu
Więcej opcji konfiguracyjnych dotyczących zamówień znajduje się w zakładce Zamówienia.
Worker do eksportu: Tylko Baselinker. Aktywuje eksport zamówień do e-commerce; na liście zamówień widoczny będzie worker do eksportu
Przesyłaj FV/PAR do e-commerce: Tylko Baselinker. Aktywuje tworzenie faktur lub paragonów w Baselinkerze oraz dołączanie do nich numeru z enova365 oraz PDF z wydrukiem.
Więcej opcji konfiguracyjnych dotyczących eksportu FV/PAR znajduje się w zakładce FV i PAR do e-commerce.

Sekcja Faktury:

Synchronizuj: aktywuje pobieranie faktur z e-commerce
Tryb importu:

1. Handel: Faktury będą pobierane jako dokumenty handlowe.
2. Ewidencja: Faktury będą pobierane jako dokumenty ewidencji.

Sekcja Paragony:

Synchronizuj: aktywuje pobieranie paragonów z e-commerce
Tryb importu:

1. Handel: Paragony będą pobierane jako dokumenty handlowe.
2. Ewidencja: Paragony będą pobierane jako dokumenty ewidencji.

Sekcja Zamówienia, faktury i paragony:

Domyślny kontrahent dok. han.: w przypadku braku NIPu kontrahenta na dokumencie w e-commerce i nie zaznaczeniu pola Załóż kontrahenta indywidualnego zostanie przypisany kontrahent domyślny
Zawsze podstawiaj domyślnego kontrahenta: warunek, czy zawsze podstawiać domyślnego kontrahenta, bez względu na to jaki kontrahent jest na dokumencie
Parowanie towarów: pole definiujące w jaki sposób mają być znajdowane towary w enova365, znajdujące się na pobieranym dokumencie z e-commerce
Usługa braku towaru: usługa podstawiona na pozycji dokumentu, jeśli towar nie zostanie znaleziony w enova365. Usługa powinna mieć odblokowaną możliwość definiowana opisu, do którego zostaną zapisane wszystkie dane towaru pozycji znajdujące się w e-commerce.
Usługa dostawy: usługa podstawiona na pozycji dokumentu na pozycji dostawy pobranej z e-commerce (jeśli zaznaczono pobieranie pozycji dostawy na zamówieniu lub fakturze)
Cecha ID dokumentu dok. han.: cecha tekstowa przechowująca identyfikator dokumentu z e-commerce
Cecha nr dokumentu dok. han.: cecha tekstowa przechowująca numer dokumentu z e-commerce
Cecha ID pozycji dokumentu dok. han.: cecha tekstowa przechowująca identyfikator pozycji dokumentu z e-commerce
Cecha ID produktu pozycji dok. han.: cecha tekstowa przechowująca identyfikator produktu na pozycji dokumentu z e-commerce
Cecha ID wariantu pozycji dok. han.: cecha tekstowa przechowująca identyfikator wariantu produktu na pozycji dokumentu z e-commerce (jeśli włączona wariantowość)
Zawsze uzupełniaj opis pozycji: podczas importu zawsze opis pozycji będzie uzupełniany nazwą pobraną z e-commerce. Każdy towar powinien mieć odblokowaną możliwość edycji pełnej nazwy pozycji.
Załóż kontrahenta indywidualnego: warunek, czy jeśli na dokumencie w e-commerce nie ma NIPu kontrahenta, to dodawać kontrahenta w enova365
Kontr. indyw. kod równy nazwie (20 znaków): warunek, czy podczas zakładania kontr. indyw. ustawiać kod równy nazwie. Jeżeli nazwa jest dłuższa niż 20 znaków, to kod zostanie odpowiednio docięty.
Pobierz historię płatności: warunek, czy pobierać historię płatności dokumentu. Historia w formacie JSON zostanie zapisana na dokumencie, a identyfikator zewnętrzny pierwszej płatności zostanie zapisany na pierwszej płatności dokumentu
Cecha historii płatności dok. han.: cecha tekstowa przechowująca JSON z historią płatności na dokumencie handlowym
Cecha historii płatności dok. ewi.: cecha tekstowa przechowująca JSON z historią płatności na dokumencie ewidencji
Cecha ID płatności: cecha tekstowa przechowująca zewnętrzny identyfikator pierwszej płatności dokumentu

Sekcja Faktury i paragony:

Na koncie typu Baselinker, mając zdefiniowane integracje z innymi platformami e-commerce, można dla każdej takiej integracji zdefiniować inny dokument i magazyn. Dokumenty z e-commerce pobierane są w kwotach brutto, dlatego definicje dokumentów w enovie powinny mieć VAT liczony od brutto. Służy do tego grid znajdujący się w sekcji Magazyny zewnętrzne. Każdy wiersz odpowiada zdefiniowanej integracji w Baselinkerze. Jeżeli dana integracja nie będzie miała zdefiniowanego dokumentu albo magazynu, to zostanie ustawiona wartość z pól domyślnych, zdefiniowanych w zakładkach Faktury oraz Paragony.

Automatyczna kompletacja: warunek, który tworzy dokument kompletacji, jeśli towar znajdujący się na dokumencie jest typu Produkt w enova365
Symbol dokumentu kompletacji: symbol dokumentu kompletacji jaki zostanie dodany, jeśli zostanie spełniony powyższy warunek
Twórz relację do zamówienia: warunek, czy podczas importu faktury ma być wyszukiwane zamówienie w enova365 i czy faktura ma być związana ze znalezionym zamówieniem relacją
Relacja tylko zatwierdz. ZO: warunek, czy podczas tworzenia relacji do zamówienia podczas importu faktury ma być sprawdzane, czy zamówienie jest zatwierdzone; jeśli zamówienie nie jest zatwierdzone, relacja nie zostanie utworzona, a faktura pominięta
Pobierz pozycję dostawy: oznaczenie czy pozycja dostawy również ma być dodana do dokumentu
Prefiks pozycji dostawy w e-commerce: Baselinker ma zdefiniowany prefiks pozycji dostawy, należy go wprowadzić, aby móc namierzyć która pozycja jest pozycją dostawy na dokumencie
Pobierz od daty z e-commerce: data od której zostaną pobrane wszystkie dokumenty z e-commerce. Data zostanie automatycznie ustawiona na datę najnowszego pobranego dokumentu.
Pobierz dni wstecz z e-commerce: ustawienie ile dni wstecz od powyższej daty mają zostać pobrane dokumenty z e-commerce
Pobierz do daty z e-commerce: data do której zostaną pobrane wszystkie dokumenty z e-commerce. Pełni funkcję serwisową i domyślnie powinna być pusta.
Wprowadź opis na fakturze: warunek, czy ma być dodawany opis na dokumencie. Po zaznaczeniu widoczna jest nowa zakładka w konfiguracji konta Opisy dokumentów.
Nadpisuj opis przy aktualizacji: warunek, czy podczas aktualizacji dokumentu opis ma być nadpisywany. Jeżeli nie, to zawsze będzie dodawany do poprzedniego opisu.
Wprowadź notatkę na fakturze: warunek, czy ma być dodawana notatka na dokumencie. Po zaznaczeniu widoczna jest nowa zakładka w konfiguracji konta Opisy dokumentów.
Nadpisuj notatkę przy aktualizacji: warunek, czy podczas aktualizacji dokumentu notatka ma być nadpisywana. Jeżeli nie, to zawsze będzie dodawana do poprzedniej notatki.

5.6. Zakładka Zamówienia

Sekcja Konfiguracja dokumentów:

Dokument domyślny: definicja dokumentu w enova365, który zostanie dodany do systemu jako zamówienie pobrane z e-commerce. Dokumenty z e-commerce pobierane są w kwotach brutto, dlatego definicje dokumentów w enovie powinny mieć VAT liczony od brutto.
Magazyn domyślny: magazyn, który zostanie ustawiony dla dokumentu zamówienia pobranego z e-commerce.

Na koncie typu Baselinker, mając zdefiniowane integracje z innymi platformami e-commerce, można dla każdej takiej integracji zdefiniować inny dokument i magazyn. Dokumenty z e-commerce pobierane są w kwotach brutto, dlatego definicje dokumentów w enovie powinny mieć VAT liczony od brutto. Służy do tego grid Magazyny zewnętrzne. Każdy wiersz odpowiada zdefiniowanej integracji w Baselinkerze. Jeżeli dana integracja nie będzie miała zdefiniowanego dokumentu albo magazynu, to zostanie ustawiona wartość z pól domyślnych. Na kontach innych typów, grid będzie ukryty.

Stan domyślny enova: stan dokumentu, który zostanie ustawiony dla dokumentu zamówienia pobranego z e-commerce

Sekcja Konfiguracja importu:

Pobierz od daty z e-commerce: data od której zostaną pobrane wszystkie zamówienia z e-commerce. Data zostanie automatycznie ustawiona na datę najnowszego pobranego zamówienia.
Pobierz dni wstecz z e-commerce: ustawienie ile dni wstecz od powyższej daty mają zostać pobrane zamówienia z e-commerce
Pobierz do daty z e-commerce: data do której zostaną pobrane wszystkie zamówienia z e-commerce. Ma funkcję serwisową. Domyślnie powinno być wyczyszczone.
Cecha daty statusu ostatecznego: cecha tekstowa przechowująca datę oraz godzinę ustawienia statusu oznaczonego jako status ostateczny na gridzie ze statusami zamówień
Cecha ID źródła: Tylko Baselinker. Cecha tekstowa przechowująca identyfikator źródła (marketplace) z jakiego zamówienie zostało zaimportowane, np. identyfikator Allegro, Shopee, itd.
Cecha nazwy źródła: Tylko Baselinker. Cecha tekstowa przechowująca nazwę źródła (marketplace) z jakiego zamówienie zostało zaimportowane, np. nazwa Allegro, Shopee, itd.
Cecha zewn. ID: Tylko Baselinker. Cecha tekstowa przechowująca zewnętrzne ID zamówienia zwracane przez Baselinkera.
Cecha czy FV: Cecha warunkowa przechowująca informację, czy klient zamawiający zamówienie chce fakturę.
Cecha login użytkownika: Cecha tekstowa przechowująca login użytkownika składającego zamówienie.
Cecha nazwa odbiorcy: Cecha tekstowa przechowująca nazwę odbiorcy składającego zamówienie.
Cecha email: Cecha tekstowa przechowująca adres e-mail użytkownika składającego zamówienie.
Cecha telefon: Cecha tekstowa przechowująca telefon użytkownika składającego zamówienie.
Cecha ID statusu pobranego: cecha tekstowa przechowująca identyfikator statusu z jakim zamówienie zostało zaimportowane z e-commerce. Wartość cechy nie ulega zmianie.
Cecha nazwy statusu pobranego: cecha tekstowa przechowująca nazwę statusu z jakim zamówienie zostało zaimportowane z e-commerce. Wartość cechy nie ulega zmianie.
Cecha ID statusu aktualnego: cecha tekstowa przechowująca identyfikator statusu aktualnego. Na początku jest to status pobrany, ale można go zmienić za pomocą workera służącego do zmiany statusu zamówień (pkt 3.2).
Cecha nazwy statusu aktualnego: cecha tekstowa przechowująca nazwę statusu aktualnego. Na początku jest to status pobrany, ale można go zmienić za pomocą workera służącego do zmiany statusu zamówień (pkt 3.2).
Cecha pola dodatkowego 1: Tylko Baselinker. Cecha tekstowa przechowująca pole dodatkowe 1 zamówienia zwracane przez Baselinker.
Cecha pola dodatkowego 2: Tylko Baselinker. Cecha tekstowa przechowująca pole dodatkowe 1 zamówienia zwracane przez Baselinker.
Cecha uwag zamawiającego: cecha tekstowa przechowująca uwagi zamawiającego zamówienie.
Cecha storage pozycji: Tylko Baselinker. Cecha tekstowa przechowująca identyfikator storage'a towaru Baselinkera.
Cecha URL: Tylko Baselinker. Cecha tekstowa przechowująca adres URL do zamówienia.
Cecha sposobu dostawy: cecha tekstowa przechowująca sposób dostawy ustawiony na importowanym zamówieniu.
Cecha numeru przesyłki: cecha tekstowa przechowująca numer przesyłki ustawiony na importowanym zamówieniu.
Cecha ID pkt odbioru: cecha tekstowa przechowująca identyfikator punktu odbioru (np. paczkomatu)
Cecha szczegóły pkt odbioru: cecha tekstowa przechowująca dane adresowe punktu odbioru (np. paczkomatu) w formacie JSON.
Pobierz tylko z FV: lista wyboru, czy mają być pobierane tylko zamówienia z wystawioną FV w e-commerce lub tylko bez wystawionej FV.

W tabeli statusów należy dodać statusy z jakimi mają być pobierane zamówienia z e-commerce oraz zdefiniować czy i jaki status ma być ustawiony po pobraniu. Jeżeli tabela będzie pusta, to zamówienia nie zostaną pobrane.
Można również dla danego statusu zaznaczyć flagę Tylko aktualizacja. Wtedy jeśli pobierane zamówienie ma wybrany status, a nie istnieje w enova365, to zostanie pominięte.
Można również dla danego statusu zaznaczyć flagę Ostateczny. Wtedy podczas aktualizacji zamówienia, gdy zamówienie będzie w statusie ostatecznym, zostanie wprowadzona data i godzina na cesze wybieranej w polu Cecha daty statusu ostatecznego.
Można również dla danego statusu zaznaczyć flagę Pomiń parametr 'Pobierz od daty'. Wtedy podczas importu zamówień z danym statusem zostanie pominięty parametr Pobierz od daty z e-commerce. Zostaną pobrane wszystkie zamówienia z danym statusem bez względu na datę potwierdzenia zamówienia (cała dostępna historia).

Dodawaj lokalizację na odbiorcy: oznaczenie, czy adres dostawy na zamówieniu ma zostać dodany jako nowa lokalizacja na kontrahencie. Jeżeli nie zaznaczone, adres dostawy zostanie wprowadzony jako Dane odbiorcy na dokumencie.
Nie szukaj istniejących lokalizacji: pole widoczne, jeśli zaznaczono dodawanie lokalizacji; jeżeli zaznaczone, to lokalizacje będą dodawane za każdym razem, nawet jeśli zawierają adres, który już istnieje na którejś z wcześniej dodanych lokalizacji
Wprowadź opis na zamówieniu: warunek, czy ma być dodawany opis na dokumencie. Po zaznaczeniu widoczna jest nowa zakładka w konfiguracji konta Opisy dokumentów.
Nadpisuj opis przy aktualizacji: warunek, czy podczas aktualizacji dokumentu opis ma być nadpisywany. Jeżeli nie, to zawsze będzie dodawany do poprzedniego opisu.
Wprowadź notatkę na zamówieniu: warunek, czy ma być dodawana notatka na dokumencie. Po zaznaczeniu widoczna jest nowa zakładka w konfiguracji konta Opisy dokumentów.
Nadpisuj notatkę przy aktualizacji: warunek, czy podczas aktualizacji dokumentu notatka ma być nadpisywana. Jeżeli nie, to zawsze będzie dodawana do poprzedniej notatki.
Pobierz pozycję dostawy: oznaczenie czy pozycja dostawy również ma być dodana do dokumentu zamówienia.

Sekcja Konfiguracja eksportu:

Grid Własne źródła zamówień: Tylko Baselinker. Tabela umożliwiająca powiązanie definicji dokumentu zamówienia z enova365 z własnym źródłem zamówienia z Baselinkera.
Grid Reguły statusów zamówień: Mechanizm wykorzystywany w workerze do zmiany statusu zamówienia. Należy ustalić jakie są możliwe statusy docelowe dla danego statusu źródłowego. Dla jednego statusu źródłowego można zdefiniować kilka statusów docelowych. Po zdefiniowaniu reguł statusów, w workerze do zmiany statusu, zostanie odpowiednio zasilona lista możliwych statusów docelowych na podstawie statusu zamówienia. Jeżeli żadna reguła nie zostanie zdefiniowana, worker do zmiany statusu nie będzie działał prawidłowo. Worker do zmiany statusu w trybie serwisowym pomija zdefiniowane reguły i pozwala na ustawienie każdego statusu bez względu na status dokumentu.

5.7. Zakładka FV i PAR do e-commerce

Zakładka widoczna, jeżeli zaznaczono Przesyłaj FV/PAR do e-commerce w zakładce Dokumenty.
Jeżeli zamówienie pobrane z e-commerce ma wystawiony w relacji dokument sprzedaży, to można wyeksportować numer oraz wydruk PDF tego dokumentu sprzedaży do e-commerce.

Cecha ID FV: cecha tekstowa przechowująca identyfikator faktury z e-commerce. Musi to być inna cecha niż cecha przechowująca identyfikator zamówienia. Wartość cechy z identyfikatorem zamówienia jest kopiowana na dokument sprzedaży, dlatego konieczne jest włączenie w konfiguracji relacji kopiowanie cech.
Rozpoznaj serię numeracji: warunek, który umożliwia przypisanie do szablonu wydruku serię numeracji, której nie trzeba potem wybierać podczas eksportu faktur do e-commerce. Seria numeracji zostanie rozpoznana i ustawiona automatycznie na podstawie symbolu dokumentu w enova365.

W tabeli Szablony wydruków można zdefiniować szablony wydruków, czyli ustalić dla każdej definicji sprzedaży, która jest w relacji z zamówieniem inny wydruk.

Dla wszystkich wydruków należy ustawić parametry wydruków.

5.8. Zakładka Faktury

Zakładka widoczna, jeżeli włączono import faktur w trybie Handel.

Dokument domyślny: definicja dokumentu w enova365, który zostanie dodany do systemu jako faktura pobrana z e-commerce. Dokumenty z e-commerce pobierane są w kwotach brutto, dlatego definicje dokumentów w enovie powinny mieć VAT liczony od brutto.
Magazyn domyślny: magazyn, który zostanie ustawiony dla dokumentu pobranego z e-commerce
Stan domyślny enova: stan dokumentu, który zostanie ustawiony dla dokumentu pobranego z e-commerce

Możliwe jest również pobieranie faktur tylko dla zamówień o określonym statusie. Należy do tego wykorzystać grid Pobieraj tylko dla zamówień ze statusami.
Po pobraniu faktury jest również możliwe ustawienie statusu powiązanego z nią zamówienia, należy wtedy wybrać status w polu Ustaw status.
Jeżeli grid nie zawiera żadnych statusów, to pobierane są faktury dla wszystkich zamówień.

5.9. Zakładka Paragony

Zakładka widoczna, jeżeli włączono import paragonów w trybie Handel.

Dokument domyślny: definicja dokumentu w enova365, który zostanie dodany do systemu jako paragon pobrany z e-commerce. Dokumenty z e-commerce pobierane są w kwotach brutto, dlatego definicje dokumentów w enovie powinny mieć VAT liczony od brutto.
Magazyn domyślny: magazyn, który zostanie ustawiony dla dokumentu pobranego z e-commerce
Stan domyślny enova: stan dokumentu, który zostanie ustawiony dla dokumentu pobranego z e-commerce

Możliwe jest również pobieranie paragonów tylko dla zamówień o określonym statusie. Należy do tego wykorzystać grid Pobieraj tylko dla zamówień ze statusami.
Po pobraniu paragonu jest również możliwe ustawienie statusu powiązanego z nim zamówienia, należy wtedy wybrać status w polu Ustaw status.
Jeżeli grid nie zawiera żadnych statusów, to pobierane są paragony dla wszystkich zamówień.

5.10. Zakładka Ewidencja

Zakładka widoczna, jeżeli tryb importu faktur lub paragonów ustawiono na Ewidencja.

Cecha ID dok. ewidencji: cecha tekstowa przechowująca identyfikator dokumentu pobranego z e-commerce
Domyślny kontrahent: w przypadku braku NIPu kontrahenta na dokumencie w e-commerce i nie zaznaczeniu pola Załóż kontrahenta indywidualnego zostanie przypisany kontrahent domyślny
Interpretacja pozycji dostawy: podczas importu dokumentu i napotkania na pozycję dostawy, zostanie ustawiona wartość pola Rodzaj na wartość wybraną w tym polu.
Scal pozycje wg VAT: warunek, czy pozycje dokumentu mają być scalane (grupowane) wg stawki VAT
Domyślne definicje dok. ewidencji: definicje dokumentów ewidencji dla faktur i paragonów dla różnych kontrahentów.
Jeżeli w konfiguracji enova w Narzędzia -> Opcje -> Firma -> Dane o działalności jest wypełnione pole Numer OSS, to importer dokumentów będzie dodawał stawki VAT z innych krajów.

Korzystając z tabeli Definicje dok. ewidencji dla serii numeracji można również dodać indywidualne parowanie definicji dokumentów z seriami numeracji zdefiniowanymi w Baselinkerze. Jeżeli dana definicja nie zostanie znaleziona w konkretnej serii numeracji, to zostanie wybrana domyślna dla danego typu kontrahenta.

5.11. Zakładka Opisy dokumentów

Zakładka służy do zdefiniowania własnego opisu i notatki na importowanym dokumencie.

Zakładka zawiera maksymalnie 4 pola tekstowe według zaznaczonych pól dotyczących opisu i notatki w zakładkach Zamówienia oraz Faktury.

Zarówno w szablonach opisów jak i notatek można umieszczać dynamiczne pola, które zostaną podmienione na faktyczną wartość importowanego dokumentu. Dynamiczne pole należy umieścić w nawiasach klamrowych. Listę możliwych dynamicznych pól można podejrzeć klikając na przycisk Dynamiczne pola. W każdym z pól znajduje się domyślny szablon.

5.12. Zakładka Płatności

Zakładka służy do powiązania sposobów płatności pobranych z e-commerce ze sposobami zapłaty zdefiniowanymi w enova365.

Pełna lista pól:

Synchronizuj: aktywuje wiązanie płatności
Domyślny: domyślny sposób zapłaty, który zostanie ustawiony na dokumencie, jeśli nie zostanie znaleziony żaden inny
Cecha ID sposobu zapłaty: cecha tekstowa, przechowująca identyfikator płatności z e-commerce. Służy do parowania płatności ze sposobem zapłaty.

W tabeli ze sposobami zapłaty w kolumnie e-commerce ID można wprowadzać wartość identyfikatora płatności z e-commerce.
W celu powiązania kilku identyfikatorów płatności z e-commerce z jednym sposobem zapłaty z enova365, można wprowadzić kilka identyfikatorów, oddzielając je średnikiem (;).

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. Dokumenty

Na liście dokumentó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.
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 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.
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
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.
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. Kontrahenci

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

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)

IV. Obsługiwane funkcje z podziałem na konta

V. Aplikacja do harmonogramu zadań Windows

Do paczki z dodatkiem dołączono katalog o nazwie Harmonogram zawierający aplikację, którą można uruchomić w harmonogramie zadań i dokonywać eksportu towarów w każdym z 4 trybów (opisanych w pkt III.3.1) automatycznie, w tle.

Wymagane jest, aby na komputerze na którym uruchamiane będzie zadanie była zainstalowana wersja enovy, zgodna z wersją wymaganą przez pobraną wersję dodatku.

Jeżeli podczas dodawania dokumentów lub towarów wykonywane są jakieś akcje automatyczne w enova365 korzystające z zewnętrznych DLL (np. Soneta.OplataCukrowa), należy te zewnętrzne pliki DLL skopiować i wkleić do katalogu Harmonogram/ExternalDlls.

1. Konfiguracja aplikacji.

W katalogu Harmonogram znajduje się plik XML z rozszerzeniem *.config.
W pliku tym należy ustawić niezbędne dane konfiguracyjne dla aplikacji, która będzie łączyć się bazą danych enova365.

Dane te znajdują się w węźle XML: configuration -> applicationSettings -> enova365.EcommerceSync.TaskSchedule.Properties.Settings

Węzeł ten zawiera węzły o nazwie settings, które posiadają atrybut name, który jest nazwą danej konfiguracyjnej oraz węzeł value, który zawiera wartość danej konfiguracyjnej.
Dane konfiguracyjne:

SonetaPath: ścieżka do instalatorów wszystkich wersji enovy; domyślnie: C:\Program Files (x86)\Soneta
LogsPath: ścieżka do plików z logami, które będą generowane podczas uruchamiania zadania służące do weryfikacji działania aplikacji. Katalog musi wcześniej zostać utworzony; domyślnie: D:\Logs
EnovaDb: nazwa firmy z listy baz danych
EnovaLogin: operator programu enova365
EnovaPassword: hasło operatora do programu enova365
AccountName: nazwa konta ecommerce dodanego w enova365, dla którego ma być wykonywana synchronizacja; jeżeli dla wszystkich dodanych kont, należy wprowadzić wartość Wszystkie

2. Dodawanie zadania.

Aby dodać nowe zadanie, należy uruchomić aplikację Harmonogram zadań i kliknąć na Utwórz zadanie...

Następnie w nowym okienku w zakładce Ogólne należy przypisać dowolną nazwę i ewentualnie opis zadania:

Następnie w zakładce Wyzwalacze należy dodać nowy wyzwalacz za pomocą przycisku Nowy... i w nowym oknie ustawić częstotliwość oraz godziny w jakich zadanie ma być wyzwalane automatycznie. Przykładowa poniższa konfiguracja będzie wyzwalać zadanie od dnia 17.02.2022, od godziny 10:00:00 i będzie je uruchamiać co godzinę:

Należy wyzwalacz zatwierdzić przyciskiem OK i przejść do zakładki Akcje, aby dodać nową akcję za pomocą przycisku Nowa... W nowym oknie należy wybrać typ akcji na Uruchom program, następnie podać ścieżkę do pliku exe z katalogu Harmonogram znajdującego się w paczce dodatku oraz dodać parametr synchronizacji.

W celu eksportu towarów należy podać parametr ExportMode. Parametr ExportMode może przyjmować następujące wartości (bez polskich znaków):
Towary - całe kartoteki towarów (bez zdjęć)
Ilosci - tylko ilości
Ceny - tylko ceny
Zdjecia - tylko zdjęcia
IlosciCeny - tylko ilości i ceny
Zaleca się wykorzystywanie wartości Ilosci, Ceny lub IlosciCeny, resztę zaleca się robić ręcznie z poziomu aplikacji enova365 poprzez workery na towarach służące do eksportu.

W celu importu zamówień należy podać parametr ImportOrders=1.

W celu eksportu faktur należy podać paramet ExportInvoices=1.

Dzięki tym parametrom można dodać wiele zadań przy wykorzystaniu jednej aplikacji. Przykładowo można dodać zadanie z parametrem ExportMode=Ilosci, które będzie uruchamiane co godzinę, oraz zadanie z parametrem ImportOrders=1, które będzie uruchamiane raz dziennie.

Opcjonalnie można dodać parametr /dbconfig="ścieżka_do_pliku_lista_baz_danych.xml" w celu podania ścieżki do pliku Lista baz danych.xml znajdującego się w innym miejscu niż katalog zalogowanego użytkownika.
Przykład: /dbconfig=”D:\prod\ecom\lista baz danych.xml”

Po dodaniu akcji, należy ją zatwierdzić przyciskiem OK, a następnie zatwierdzić zadanie również przyciskiem OK. Od tego momentu zadanie będzie wyzwalane zgodnie z ustawieniami.