Przesyłanie produktów z Subiekt nexo PRO do Apilo
Kod wtyczki: NXO_CAI_COM_PRD_ERB
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 nexo PRO 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 i automatycznie aktualizuje magazyn na przykład w momencie, kiedy zostało otwarte nowe konto w programie Apilo.
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 Subiekt nexo PRO.
5. Czy wszystkie produkty z Subiekt nexo PRO 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 aktyne 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 określonej kategorii Apilo produkty nie znajdujące swojego powiązanego produktu po stronie Subiekt nexo PRO (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 nexo PRO.
b) Tak
Wszytkie produkty z wybranej kategorii w Apilo nie zmapowane według wartości wybranej w pkt.11 z wybranym magazynem w Subiekt nexo PRO zostaną usunięte.
UWAGA
Wybierając TAK usunie wszystkie produkty z wybranej kategrii z Apilo jeśli nie znajdą swojego odpowiednika w wybranym magazynie Subiekt nexo PRO.
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 pól własnych?
Funkcjonalność pozwala ograniczyć zakres przesyłanych produktów do pozycji z określonymi polami własnymi w katrotece towaru Subiekt nexo PRO.
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 Subiekt nexo PRO tylko produkty które w danym polu własnym mają określoną wartość:
Tabela mapowania pól własnych:
Pole własne w Subiekt nexo PRO.
Wybieramy z ‘lupki’ pole własne produktu istniejące w Subiekt nexo PRO.
Wartość pola własnego w Subiekt nexo PRO.
Wprowadzamy wartość pola własnego, który intgeracja rozpozna jako oznaczenie do synchronizacji towaru z Apiloem.
Dostępne pola własne oraz ich wartości możemy zweryfikować/edytować w nexo PRO wpisując w pole “Szukaj poleceń” -> Pole własne -> Asortyment -> Popraw
9. Jaki cennik chcesz użyć?
Funkcjonalność umożliwia wybór istniejącego cennika w Subiekt nexo PRO. Cena we wskazanym cenniku będzie przesłana razem z produktem do Apilo.
Listę dostępnych cenników znajdziemy w Subiekt nexo PRO po lewej stronie Polityka cenowa -> Cenniki
UWAGA!
Należy wprowadzić dokładną nazwę cennika z nexo PRO, znaczenie ma tutaj również wielkość liter i znaki specjalne.
10. Magazyn w Subiekt nexo PRO
Funkcjonalność ta pozwala integracji na odnalezienie produktów w systemie źródłowym.
Wskaż, z którego magazynu Subiekt nexo PRO mają być pobierane stany magazynowe:
Należy wpisać SYMBOL magazynu w Subiekt nexo PRO
PAMIĘTAJ
Wpisanie kilku symboli magazynów po przecinku spowoduje sumowanie stanów z tych magazynów.
11. W jaki sposób chcesz powiązać produkty z Subiekt nexo PRO z produktami w magazynie Apilo?
Funkcjonalność umożliwia wybór mapowania produktów pomiedzy magazynami Subiekt nexo PRO a Apilo.
Dostępne opcje:
a) Po stronie Apilo
W Apilo potrzebne informacje możemy znaleźć w kartotece produktu.
b) Po stronie Subiekt nexo PRO
- Symbol
- Nazwa
- Podstawowy kod kreskowy
- Pole własne 1-8
W Subiekt nexo PRO potrzebne informacje możemy znaleźć w kartotece asortymentu.
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żą pętlą programu.
Dostępne opcje:
a) Dodaj produkty
- Dodaj zdjęcie - opcja doda zdjęcia produktu, które są na kartotece produktu w Subiekt nexo PRO.
- Dodaj wagę - opcja doda wagi produktów, które są na kartotece produktu w Subiekt nexo PRO.
- Dodaj opisy - opcja umożliwia przeniesienie pola opisu produktów, które są na kartotece produktu w Subiekt nexo PRO
(Do pola ‘Krótki opis’ w Apilo zostanie dodany opis z pola ‘Opis’ z Nexo, do pola ‘Opis’ w Apilo zostanie dodany opis z pola ‘Pełna charakterystyka’ z Nexo)
- Dodaj EAN - opcja doda EAN produktów, które są na kartotece produktu w Subiekt nexo PRO.
PODPOWIEDŹ
Wymaga konfiguracji w pytaniu Przenieś pola własne do Apilo zgodnie z mapowaniem.
- Dodaj atrybuty - opcja doda atrybuty produkty, które znajdują się w kartotece produktu w Subiekt nexo PRO - zgodnie z mapowaniem w pkt 13
b) Aktualizuj produkty
- Aktualizuj nazwy produktów - opcja zaktualizuje nazwy produktów, które zostały zmienione po stronie Subiekt nexo PRO
- Aktualizuj EAN - opcja zaktualizuje EAN produktów, które zostały zmienione po stronie Subiekt nexo PRO.
- Aktualizuj Symbole produktów - opcja zaktualizuje symbole produktów, które zostały zmienione po stronie Subiekt nexo PRO.
- Aktualizuj pola dodatkowe - opcja zaktualizuje pola dodatkowe produktów, które zostały zmienione po stronie Subiekt nexo PRO.
PODPOWIEDŹ
Wymaga konfiguracji w pytaniu Przenieś pola własne do Apilo zgodnie z mapowaniem.
- Aktualizuj parametry - opcja zaktualizuje parametry produktów, które zostały zmienione po stronie Subiekt nexo PRO - - zgodnie z mapowaniem w pkt 13
- Aktualizuj opisy produktów - opcja umożliwia aktualizację opisu produktów, które są na kartotece produktu w Subiekt nexo PRO.
(Do pola ‘Krótki opis’ w Apilo zostanie dodany opis z pola ‘Opis’ z Nexo, do pola ‘Opis’ w Apilo zostanie dodany opis z pola ‘Pełna charakterystyka’ z Nexo)
UWAGA!
Należy pamiętać, aby przy wyborze checboxa 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 nexo PRO do utworzonego pola w Apilo.
Dostępne opcje:
a) Pole w Subiekt nexo PRO
- Pole własne od 1 do 8
Należy w Subiekt nexo PRO dodać i zdefiniować pola własne dla asortymentu.
Dostępne pola własne oraz ich wartości możemy zweryfikować/edytować w Subiekt nexo PRO wpisując w pole Ewidencje dodatkowe -> Konfiguracja -> Pola własne -> Asortyment -> 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) Wartość pola w Apilo
- Po wybraniu “lupki” wybieramy w Apilo wartość, w którą integracja przepisze dane z Subiekt nexo PRO.
Integrcja przeniesie np. pole własne 1 z Subiekt nexo PRO do wybranego atrybutu w Apilo. Przy wyborze atrybutów Apilo, pierwszym krokiem jest stworzenie atrybutu Apilo
Towary i usługi > Atrybuty
Następnie w tabeli mapowania dostępne pole będzie po kliknieciu w lupkę
UWAGA!
Aby pola były przenoszone zaznacz odpowiednie opcję w pytaniu Jakie zadania chcesz wykonać w trakcie synchronizacji produktów .