Przesyłanie produktów z Comarch ERP Optima do Apilo
Kod wtyczki: OPT_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) Comarch Optima 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
Należy wprowadzić dane wymagane do połączenia Apilo.

UWAGA
Aby pobrać wymagane dane należy utworzyć nową aplikację REST API w systemie Apilo (ERPBox) w zakładce Administracja > Klucze API Apilo . W zakładce API Apilo możemy sprawdzić także datę ważności tokenów.
Skąd pobrać dane do połączenia z Apilo?
4. Kategorie produktów w Apilo
Funkcjonalność daje nam możliwość wyznaczenia kategorii w Apilo, na których będą wykonywane operacje. Weryfikacja, czy produkt już istnieje w Apilo może polegać na sprawdzaniu wszystkich kategorii jedynie tych wyznaczonych. Dodatkowo należy wskazać jedną kategorię w Apilo, w której pojawi się dodany produkt (wcześniej nie istniejący w apilo).
Standardowe przetwarzenie kategorii:
a) Chcę, by produkty były pobierane z wszystkich kategorii
Integracja będzie weryfikować we wszystkich kategoriach, czy dany produkt istnieje.
b) Chcę wybrać kategorie z których będą pobierane produkty:
Integracja zweryfikuje tylko produkty znajdujące się w wybranych kategoriach docelowych.
UWAGA
Jeśli przeniesiesz już wcześniej przesłany produkt do innej ktegorii w Apilo i niezostanie ona wybrana w kategoriach, z których będą pobierane produkty to integracja doda jeszcze raz ten sam produkt.
Wybierz kategorię, w której zostaną utworzone produkty nie istniejące w Apilo:
Integracja przeniesie produkty z systemu ERP do wskazanej kategorii w Apilo.
PAMIĘTAJ
Kategoria docelowa w Apilo, 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ąć.
Traktuj grupę produktu w Subiekt nexo PRO jako kategorię produktu w Apilo
Integracja przesyłając produkty utworzy w Apilo nowe kategorie, bliźniacze do tych znajdujących się w Comarch Optima
5. Czy wszystkie produkty z Comarch ERP Optima 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) Produkty proste
Integracja prześle tylko produkty proste.
b) Produkty proste i usługi
Filtr obsługuje towary proste oraz usługi.
c) Produkty proste oraz złożone
Integracja przeniesie oprócz produktów prostych dodatkowo produkty złożone (skompletowane z innych towarów).
d) Przy zaznaczeniu tej opcji do Apilo będą przesyłane wszystkie typy produktów
Produkty o określonym typie wyfiltrowa w Comarch ERP Optima w lista zasobów

Typ konkretnego produktu można zweryfikować w handel -> lista zasobów -> pozycja cennika -> ogólne

Czy dodatkowo filtrować po statusie aktywności produktu?
Dostępne opcje:
b) Nie (przesyłaj aktywne oraz nieaktywne produkty)
Intgeracja przeniesie do Apiloa wszystkie produkty, nie filtrując ich po statusie aktywności.
a) Tak (prześlij jedynie aktywne produkty)
Do Apilo będą przesyłane tylko produkty oznaczone jako aktywne w Optimie.
Aktywność produktu można włączyć/wyłączyć w Comarch ERP Optima handel -> lista zasobów -> pozycja cennika -> dodatkowe

PAMIĘTAJ
Integracja przeniesie do systemu docelowego jedynie produkty spełniające wymagania powyższych filtrów.
6. Czy chcesz usuwać niepowiązane produkty?
Integracja usunie z określonego katalogu/kategorii Apilo produkty nie znajdujące swojego powiązanego produktu po stronie Comarch ERP Optima (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 Comarch ERP Optima.
b) Tak
Wszytkie produkty z wybranego katalogu/kategorii w Apilo nie zmapowane według wartości wybranej w pkt.10 z wybranym magazynem w Comarch ERP Optima zostaną usunięte.
UWAGA
Wybierając TAK usunie wszystkie produkty z wybranego katalogu/kategrii z Apilo jeśli nie znajdą swojego odpowiednika w wybranym magazynie Comarch ERP Optima.
7. Czy chcesz usuwać zduplikowane produkty?
Funkcjonalność pozwala zweryfikować oraz usuwać duplikaty produktów znajdujące się w Apilo.
Dostępne opcje:
a) Nie
Integracja nie będzie dokonywała weryfikacji pod kątem duplikatów produktów w Apilo.
b) Tak, usuń zduplikowane produkty po wskazanym polu
Integracja będzie dokonywała weryfikacji duplikatów w Apilo, po znalezieniu duplikatu zostanie on usunięty z Apilo.
opcje możliwe do wyboru:
SKU
Integracja będzie wyryfikowała SKU prduktów w Apilo, w poszukiwaniu duplikatów.
EAN
Integracja będzie wyryfikowała EAN prduktów w Apilo, w poszukiwaniu duplikatów.
Nazwa
Integracja będzie wyryfikowała nazwy prduktów w Apilo, w poszukiwaniu duplikatów.
UWAGA
Wybierając Tak, usuń zduplikowane produkty po wskazanym polu z systemu Apilo zostaną usunięte wszystkie duplikaty. Pozostawione zostaną produkty, które zostały dodane do systemu jako pierwsze.
8. Czy chcesz filtrować produkty po wartości atrybutów?
Funkcjonalność pozwala ograniczyć zakres przesyłanych produktów do pozycji z określonymi atrybutami w katrotece towaru Comarch ERP Optima.
Dostępne opcje:
a) Nie (ustawienie domyślne)
Integracja wyśle wszystkie produkty nie weryfikując filtrowania po wartości atrybutów.
b) Pobieraj z Comarch ERP Optima tylko produkty które w danym atrybucie mają określoną wartość:
Tabela mapowania atrybutów:
-
Symbol atrybutu w Comarch ERP Optima.
Wybieramy z ‘lupki’ atrybut produktu istniejący w Optimie lub wpisujemy ręcznie kod tego atrybutu z Optimy.
-
Wartość atrybutu w Comarch ERP Optima.
Wprowadzamy wartość atrybutu, który intgeracja rozpozna jako oznaczenie do synchronizacji towaru z Apiloem.
Dostępne atrybuty oraz ich wartości możemy zweryfikować/edytować w Comarch ERP Optima handel -> lista zasobów -> pozycja cennika -> atrybuty

PAMIĘTAJ
Wybrany atrybut musi być również dodany w kartotece towaru w zakładce 4. Atrybuty aby integracja poprawnie nałożyła filtr.
UWAGA
Tworząc nowe atrybuty produktów ich wartość jest zależna od formatu wybranego pola, tj nie wprowadzimy wartośc tekstowej jeśli pola jeśli wybraliśmy typ liczbowy atrybutu.
9. Jaką cenę chcesz użyć?
Funkcjonalność umożliwia wybór istniejącego cennika w Comarch ERP Optima. 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 Comarch ERP Optima handel -> lista zasobów -> pozycja cennika lub ogólne -> cennik

UWAGA!
Należy wprowadzić dokładną nazwę ceny z Optimy, znaczenie ma tutaj również wielkość liter i znaki specjalne.
10. W jaki sposób chcesz powiązać produkty z Comarch ERP Optima z produktami w magazynie Apilo?
Funkcjonalność ta pozwala integracji na odnalezienie produktów w systemie docelowym i źródłowym.
Powiąż kartotekę produktu z Comarch Optimą na podstawie następującego mapowania:
Dostępne opcje:
a) Po stronie Apilo
W Comarch ERP Optima potrzebne informacje możesz znaleźć w kartotece towaru.
b) W Comarch ERP Optima
Potrzebne informacje możesz znaleźć w Comarch ERP Optima handel -> zasoby -> pozycja cennika.

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. Może to również skutkować dublowaniem się towarów!
PAMIĘTAJ
SKU w Apilo jest odpowiednikiem KOD w Comarch ERP Optima.
11. Jakie zadania chcesz wykonać w trakcie synchronizacji produktów?
Funkcjonalność ta pozwala na wybór jakie wartości z kartoteki produktu w Comarch ERP Optima mają być przesyłane/aktualizowane do Apilo.
Dostępne opcje:
a) Dodaj produkty (zazwaczając rozwija się lista rozszerzona)
- Dodaj zdjęcie
Integracja prześle zdjęcia przy synchornizacji (maksymalnie do 2MB wielkości w formatach PNG, JPG lub GIF).
PODPOWIEDŹ
Wymaga konfiguracji w pytaniu Przenieś atrybuty własne do Apilo zgodnie z mapowaniem.
- Dodaj wagę
Integracja prześle wagi produktów.
- Dodaj opis
Integracja prześle opis produktów.
- Dodaj EAN
Integracja prześle EAN produktów.
PODPOWIEDŹ
Wymaga konfiguracji w pytaniu Przenieś atrybuty własne do Apilo zgodnie z mapowaniem.
- Dodaj atrbuty
Integracja prześle atrybuty produktów, które znajdują się w Comarch ERP Optima.
b) Aktualizuj produkty (zazwaczając rozwija się lista rozszerzona)
- Aktualizuj nazwy produktów
Integrcja przy odnotowaiu zmiany w nazwie produktu po stronie Comarch ERP Optima zaktualizuje go na Apilo.
- Aktualizuj zdjęcia
Integracja przy odnotowaniu zmiany w zdjęciach produktów po stronie Comarch ERP Optima zaktualizuje je na Apilo (Obowiązują te same limity co w przypadku przesyłania zdjęć - 2MB wielkości oraz formaty JPG, PNG, GIF)
- Aktualizuj EAN
Integracja przy odnotowaniu zmiany w EAN produktu po stronie Comarch ERP Optima zaktualizuje je na Apilo.
- Aktualizuj Symbole produktów
Integracja przy odnotowaniu zmiany symbolu produktu po stronie Comarch ERP Optima zaktualizuje go na Apilo.
PODPOWIEDŹ
Wymaga konfiguracji w pytaniu Przenieś atrybuty własne do Apilo zgodnie z mapowaniem.
- Aktualizuj atrybuty
Integracja przy odnotowaniu zmiany atrybutu produktu po stronie Comarch ERP Optima zaktualizuje go na Apilo.
PODPOWIEDŹ
Wymaga konfiguracji w pytaniu Przenieś atrybuty własne do Apilo zgodnie z mapowaniem.
- Aktualizuj wagę produktów
Integracja przy odnotowaniu zmiany wagi produktu po stronie Comarch ERP Optima zaktualizuje go na Apilo.
- Aktualizuj opisy produktów
Integracja przy odnotowaniu zmiany w opisie po stronie Comarch ERP Optima zaktualizuje go do Apilo.
PAMIĘTAJ
Aktualizacja produktu nastąpi dopiero kiedy intgeracja odnotuje zmianę wybranej wartości po stronie Comarch ERP Optima.
12. Przenieś atrybuty do Apilo zgodnie z mapowaniem
Funkcjonalność pozwala na przeniesienie atrybutu z Comarch ERP Optima do wybranego pola dodatkowego w Apilo.
Tabela mapowania przenoszenia atrybutów:
-
Pole w Comarch ERP Optima.
Wybieramy atrybut istniejący w Optimie z który chcemy aktualizować
-
Typ pola w Apilo
Wybieramy typ pola Apilo. Do wyboru:
-
Atrybut
-
Warość pola w Apilo
Wybieramy z ‘lupki’ nazwę pola w Apilo, do którego przenoszony ma być atrybut.
UWAGA
Aby pola były przenoszone zaznacz odpowiednie opcję w pytaniu **Jakie zadania chcesz wykonać w trakcie synchronizacji produktów**.