Dokumentacja Sync2Sys

Pierwsze kroki

Tworzenie konta

Aby zacząć korzystać z Sync2Sys, wejdź na panel.sync2sys.com/register i utwórz konto, używając adresu e-mail lub Google OAuth. Po rejestracji trafisz do panelu.

Przegląd panelu

Panel pokazuje podsumowanie Twojego systemu w czasie rzeczywistym:

• Aktywni dostawcy – liczba podłączonych feedów dostawców
• Wszystkie produkty – wszystkie zaimportowane produkty w Twoim katalogu
• Aktywne produkty – produkty aktualnie aktywne i dostępne na stanie
• Brak na stanie – produkty bez dostępnych stanów magazynowych

Organizacja i zespół

Każde konto należy do organizacji. Możesz zapraszać członków zespołu z różnymi rolami:

• Owner – pełny dostęp, zarządzanie rozliczeniami
• Admin – zarządzanie dostawcami, produktami, kanałami i feedami
• Member – dostęp do podglądu z ograniczoną edycją

Członkami zespołu zarządzasz w sekcji Ustawienia → Zespół w panelu.

Dostawcy

Dostawcy są źródłem Twoich danych produktowych. Sync2Sys obsługuje import od wielu dostawców jednocześnie, a każdy z nich może mieć własne feedy i mapowanie pól.

Dodawanie dostawcy

1. Przejdź do sekcji Dostawcy w menu bocznym
2. Kliknij Dodaj dostawcę
3. Wpisz nazwę dostawcy i jego dane
4. Dodaj co najmniej jeden feed (produktowy, magazynowy lub cenowy)

Typy feedów

Każdy dostawca może mieć wiele feedów różnych typów:

• Produkty – pełny katalog produktów ze wszystkimi polami
• Stany magazynowe – tylko aktualizacje stanów magazynowych
• Ceny – tylko aktualizacje cen
• Zdjęcia – dedykowany feed do pobierania i synchronizacji multimediów produktów

Obsługiwane formaty feedów

• XML – najpopularniejszy format feedów dostawców
• CSV – wartości rozdzielane przecinkiem lub średnikiem
• XLS / XLSX – pliki Excel (automatycznie konwertowane do CSV przy wgrywaniu)
• JSON – ustrukturyzowane feedy JSON

Feedy można podłączyć przez URL (do automatycznej synchronizacji) lub wgrywać ręcznie jako pliki.

Mapowanie pól

Po dodaniu feedu Sync2Sys automatycznie wykrywa dostępne pola. Następnie mapujesz pola dostawcy na standardowe pola Sync2Sys (nazwa, cena, stany magazynowe, EAN itd.). Mapowanie może odbywać się automatycznie lub ręcznie.

Walidacja i testowanie feedów

Przed importem możesz przetestować dowolny URL feedu, aby sprawdzić, czy jest dostępny, i zobaczyć przykładowe dane. Pomaga to wcześnie wychwycić problemy z formatem.

Produkty (katalog dostawców)

Produkty zaimportowane z feedów dostawców pojawiają się w sekcji Produkty. To Twój katalog oparty na danych dostawców, ze wszystkimi oryginalnymi danymi i wzbogaceniami Sync2Sys.

Importowanie produktów

1. Przejdź do Produkty → Import lub użyj akcji importu przy dostawcy
2. Wybierz dostawcę i feed, z którego chcesz importować
3. Zweryfikuj mapowanie pól
4. Uruchom import – postęp będzie widoczny w czasie rzeczywistym

Zarządzanie produktami

Produkty można przeglądać, filtrować i edytować pojedynczo lub masowo:

• Wyszukiwanie – po nazwie, SKU, EAN lub dostawcy
• Filtrowanie – po statusie (aktywne, nieaktywne, brak na stanie), dostawcy, kategorii
• Akcje masowe – zmiana statusu, modyfikacja pól lub usunięcie wielu produktów naraz

Historia synchronizacji

Każdy import i każda synchronizacja są rejestrowane. Pełną historię, w tym liczbę wierszy, błędy i czasy wykonania, znajdziesz w Produkty → Historia synchronizacji.

PIM (zarządzanie informacją produktową)

Moduł PIM pozwala stworzyć dopracowany, wzbogacony katalog produktów, oddzielony od surowych danych dostawców. Produkty PIM są Twoim „źródłem prawdy” dla wszystkich kanałów sprzedaży.

Tworzenie produktów PIM

Produkty PIM możesz tworzyć na dwa sposoby:

• Z produktów dostawców – wybierz jeden lub więcej produktów dostawcy i przenieś je do PIM
• Ręcznie – utwórz nowy produkt od zera, z pełną kontrolą nad polami

Tłumaczenia

Każdy produkt PIM obsługuje treści wielojęzyczne. Dodawaj tłumaczenia dla dowolnego języka, z osobnym tytułem, opisem i polami meta w każdym języku.

Warianty

Produkty PIM mogą mieć warianty (np. rozmiar, kolor). Każdy wariant ma własne SKU, cenę, stany magazynowe i atrybuty.

Multimedia

Dodawaj zdjęcia produktów przez URL lub wgrywanie plików. Zarządzaj kolejnością zdjęć, ustawiaj zdjęcie główne i dodawaj teksty alternatywne pod SEO.

Generowanie treści przez AI

Sync2Sys może generować treści produktowe z pomocą AI. Funkcja jest dostępna dla pól: tytuł, krótki opis, długi opis, meta tytuł i meta opis. Zużycie AI jest liczone w ramach miesięcznego limitu tokenów Twojego planu.

Masowy import CSV

Importuj tłumaczenia i dane produktów masowo za pomocą plików CSV:

1. Przejdź do PIM → Szybkie akcje → Import tłumaczeń
2. Wgraj plik CSV z danymi produktów
3. Zmapuj kolumny CSV na pola PIM (tytuł, opis, krótki opis, pola SEO)
4. Wybierz język docelowy
5. Przejrzyj wyniki walidacji – produkty są dopasowywane po SKU lub kodzie kreskowym
6. Uruchom import – działa w tle, a postęp widzisz w czasie rzeczywistym

Historia wersji

Każda zmiana produktu PIM jest wersjonowana. Możesz przeglądać historię zmian i przywrócić dowolną wcześniejszą wersję.

Silnik wzbogacania (reguły)

Silnik wzbogacania pozwala automatyzować czyszczenie i modyfikację danych. Możesz tworzyć własne reguły, które zamieniają tekst, formatują wartości, mapują pola lub dynamicznie wzbogacają dane produktów na podstawie określonych warunków przed publikacją.

Kategorie

System kategorii pozwala zbudować jednolitą taksonomię i mapować kategorie dostawców na własną strukturę.

Zestawy kategorii

Zestawy kategorii to niezależne drzewa kategorii. Możesz mieć jeden zestaw dla sklepu internetowego, a drugi dla marketplace’u. Każdy zestaw ma własną hierarchię.

Budowanie drzewa kategorii

1. Przejdź do sekcji Kategorie
2. Utwórz nowy zestaw kategorii (lub użyj domyślnego)
3. Dodawaj kategorie pojedynczo lub masowo
4. Ułóż je w hierarchię nadrzędne–podrzędne

Mapowanie kategorii

Mapuj kategorie dostawców na własne kategorie. To decyduje o tym, jak zaimportowane produkty są uporządkowane w Twoim katalogu.

• Mapowanie ręczne – przeciągnij i upuść lub wybierz kategorie docelowe
• Mapowanie wspierane przez AI – Sync2Sys podpowiada mapowania na podstawie analizy AI
• Mapowanie masowe – mapuj wiele kategorii naraz
• Automatyczne wykrywanie – automatyczne wyodrębnianie unikalnych kategorii z feedów dostawców

Reguły kategorii (dopasowanie po słowach kluczowych)

Automatyzuj przypisywanie kategorii za pomocą reguł opartych na słowach kluczowych. Definiuj dla każdego feedu dostawcy reguły, które dopasowują nazwy lub opisy produktów i automatycznie przypisują właściwą kategorię.

1. Przejdź do Dostawcy → [Dostawca] → Feed → Mapowanie
2. Przewiń do sekcji Reguły kategorii
3. Dodaj reguły ze słowami kluczowymi i kategoriami docelowymi
4. Reguły są stosowane automatycznie podczas importu oraz w momencie eksportu

Reguły cenowe

Reguły cenowe pozwalają definiować automatyczne formuły, które przekształcają ceny dostawców w Twoje ceny sprzedaży.

Jak to działa

Reguły są stosowane w kolejności priorytetów. Każda reguła może mieć warunki, które określają, których produktów dotyczy. Gdy produkt spełnia warunki reguły, jej formuła jest stosowana do wyliczenia ceny końcowej.

Tworzenie reguły

1. Przejdź do sekcji Reguły cenowe
2. Kliknij Dodaj regułę
3. Ustaw formułę (np. narzut %, stała marża, własna formuła)
4. Zdefiniuj warunki (opcjonalnie): dostawca, kategoria, marka, wzorzec EAN, ilość na stanie
5. Ustaw kolejność priorytetów

Symulacja cen

Zanim zastosujesz reguły do katalogu, użyj narzędzia symulacji, aby zobaczyć podgląd wyników. Wpisz cenę dostawcy i opcjonalne warunki, aby sprawdzić, które reguły zadziałają i jaka będzie wyliczona cena końcowa.

Kanały sprzedaży

Kanały sprzedaży to platformy, na których sprzedajesz swoje produkty. Sync2Sys wysyła dane produktów, ceny i stany magazynowe do każdego podłączonego kanału.

Obsługiwane platformy

• WooCommerce – przez klucze REST API lub wtyczkę Sync2Sys
• Shopify – przez integrację OAuth
• PrestaShop – przez połączenie API
• Magento 2 – przez klucz integracji REST API
• OpenCart – przez klucz REST API
• Allegro – przez autoryzację OAuth 2.0 (Allegro REST API)
• eBay – przez autoryzację OAuth 2.0 (eBay REST API)
• Amazon – przez autoryzację SP-API (Amazon Selling Partner API)

Podłączanie WooCommerce

Masz dwie możliwości:

1. Za pomocą wtyczki Sync2Sys – zainstaluj wtyczkę z WordPressa, a ona automatycznie połączy Twój sklep
2. Ręczne klucze API – wygeneruj klucze WooCommerce REST API (Consumer Key + Secret) i wklej je w Sync2Sys

Podłączanie Shopify

1. Przejdź do Kanały sprzedaży → Dodaj kanał
2. Wybierz Shopify
3. Wpisz domenę swojego sklepu Shopify (np. mystore.myshopify.com)
4. Autoryzuj połączenie przez Shopify OAuth

Podłączanie PrestaShop

Zanim podłączysz sklep PrestaShop do Sync2Sys, musisz włączyć funkcję webservice w zapleczu (Back Office) PrestaShop. Jeśli webservice nie jest włączony, zobaczysz następujący błąd:

Aby podłączyć PrestaShop, wykonaj następujące kroki:

1. Zaloguj się do zaplecza (Back Office) PrestaShop
2. Przejdź do Parametry zaawansowane → Webservice
3. Ustaw opcję „Enable PrestaShop's webservice” (włącz webservice PrestaShop) na Tak i kliknij Zapisz
4. Kliknij „Add new webservice key” (dodaj nowy klucz webservice) – zostanie wygenerowany nowy klucz API
5. Ustaw uprawnienia dla wygenerowanego klucza – musisz przyznać dostęp do następujących zasobów:
   • products – pełny dostęp (GET, PUT, POST, DELETE)
   • categories – pełny dostęp
   • stock_availables – pełny dostęp
   • combinations – pełny dostęp
   • images – pełny dostęp
   • manufacturers – GET
   • languages – GET
   • currencies – GET
6. Zapisz i skopiuj wygenerowany klucz API
7. W panelu Sync2Sys przejdź do Kanały sprzedaży → Dodaj kanał → PrestaShop
8. Wpisz adres URL swojego sklepu (np. https://your-store.com) oraz klucz API

Podłączanie Magento 2

Aby podłączyć sklep Magento 2, musisz utworzyć integrację API w panelu administracyjnym Magento:

1. Zaloguj się do panelu administracyjnego Magento
2. Przejdź do System → Integrations
3. Kliknij Add New Integration (dodaj nową integrację)
4. Wpisz nazwę (np. „Sync2Sys”) oraz swoje hasło administratora w celu potwierdzenia
5. W zakładce API zaznacz następujące zasoby:
   • Catalog – pełny dostęp (produkty, kategorie, atrybuty)
   • Inventory – pełny dostęp (stany magazynowe)
6. Zapisz i kliknij Activate
7. Skopiuj wygenerowane klucze: Consumer Key, Consumer Secret, Access Token oraz Access Token Secret
8. W panelu Sync2Sys przejdź do Kanały sprzedaży → Dodaj kanał → Magento 2
9. Wpisz adres URL sklepu i wszystkie 4 klucze API

Podłączanie OpenCart

Aby podłączyć sklep OpenCart do Sync2Sys:

1. Zaloguj się do panelu administracyjnego OpenCart
2. Przejdź do System → Users → API
3. Kliknij Add New lub edytuj istniejącego użytkownika API
4. Wpisz nazwę użytkownika API, wygeneruj klucz API i ustaw status na Enabled
5. W zakładce IP Addresses dodaj adres IP serwera Sync2Sys (wyświetlany w panelu Sync2Sys podczas konfiguracji)
6. Zapisz i skopiuj klucz API
7. W panelu Sync2Sys przejdź do Kanały sprzedaży → Dodaj kanał → OpenCart
8. Wpisz adres URL sklepu, nazwę użytkownika API i klucz API

Podłączanie Allegro

Allegro to polski marketplace. Sync2Sys obsługuje bezpośrednią integrację z Allegro przez OAuth 2.0 – nie musisz tworzyć żadnej aplikacji deweloperskiej.

1. W panelu Sync2Sys przejdź do Kanały sprzedaży → Dodaj kanał → Allegro
2. Kliknij Połącz z Allegro
3. Nastąpi przekierowanie na stronę logowania Allegro – zaloguj się na swoje konto Allegro
4. Potwierdź, że przyznajesz Sync2Sys dostęp do swojego konta Allegro
5. Po udanej autoryzacji wrócisz do panelu Sync2Sys, a Twój kanał Allegro będzie podłączony

Podłączanie eBay

eBay to międzynarodowy marketplace. Sync2Sys obsługuje bezpośrednią integrację z eBay przez OAuth 2.0 – nie musisz tworzyć żadnej aplikacji deweloperskiej.

1. W panelu Sync2Sys przejdź do Kanały sprzedaży → Dodaj kanał → eBay
2. Wybierz region marketplace’u eBay (np. eBay.de, eBay.co.uk, eBay.com itd.)
3. Kliknij Połącz z eBay
4. Nastąpi przekierowanie na stronę logowania eBay – zaloguj się na swoje konto eBay
5. Potwierdź, że przyznajesz Sync2Sys dostęp do swojego konta eBay
6. Po udanej autoryzacji wrócisz do panelu Sync2Sys, a Twój kanał eBay będzie podłączony

Podłączanie Amazon

Amazon to największy marketplace na świecie. Sync2Sys obsługuje bezpośrednią integrację z Amazon przez Selling Partner API (SP-API) – nie musisz tworzyć żadnej aplikacji deweloperskiej.

1. W panelu Sync2Sys przejdź do Kanały sprzedaży → Dodaj kanał → Amazon
2. Wybierz region marketplace’u Amazon (np. Amazon.de, Amazon.co.uk, Amazon.com, Amazon.fr itd.)
3. Kliknij Połącz z Amazon
4. Nastąpi przekierowanie na stronę logowania Amazon Seller Central – zaloguj się na swoje konto sprzedawcy Amazon
5. Potwierdź, że przyznajesz Sync2Sys dostęp do swojego konta sprzedawcy Amazon
6. Po udanej autoryzacji wrócisz do panelu Sync2Sys, a Twój kanał Amazon będzie podłączony

Synchronizacja

Po podłączeniu możesz uruchomić pełną synchronizację lub monitorować jej status. Każda synchronizacja tworzy log ze szczegółami: utworzone i zaktualizowane produkty oraz napotkane błędy.

Import produktów z e-sklepu

Oprócz wysyłania produktów do kanałów sprzedaży możesz też importować istniejące produkty z podłączonego sklepu do Sync2Sys. Przydaje się to przy migracji do Sync2Sys lub gdy chcesz wzbogacić istniejące dane sklepu funkcjami PIM.

Przejdź do Produkty → Import i wybierz kanał sprzedaży jako źródło.

Przeliczanie walut

Jeśli Twój kanał sprzedaży używa innej waluty niż dostawcy, skonfiguruj kurs przeliczenia w ustawieniach kanału. Ceny będą automatycznie przeliczane podczas synchronizacji.

Feedy eksportu

Feedy eksportu pozwalają generować pliki z danymi produktów dla marketplace’ów, porównywarek cen i platform reklamowych.

Tworzenie feedu eksportu

1. Przejdź do sekcji Feedy eksportu
2. Kliknij Utwórz feed
3. Wybierz format wyjściowy: XML, CSV lub JSON
4. Skonfiguruj filtry, aby wybrać produkty do uwzględnienia
5. Zmapuj pola produktów na format docelowy

Filtry

Dostępne są dwa tryby filtrów:

• Prosty – wybór po dostawcy, kategorii, statusie, stanach magazynowych
• Zaawansowany – budowanie złożonych drzew reguł z logiką AND/OR i warunkami na dowolnym polu, w tym na atrybutach

Publikacja

Opublikowane feedy otrzymują bezpieczny publiczny URL z unikalnym hashem (np. panel.sync2sys.com/api/public/feeds/your-feed-a1b2c3.xml), z którego mogą korzystać zewnętrzne platformy. Feedy są cachowane dla wydajności, a limit zapytań wynosi 30 na minutę.

Język i język zapasowy tłumaczeń

Skonfiguruj, w jakim języku eksportować treści produktów:

• Wybierz język eksportu w banerze feedu
• Włącz lub wyłącz język zapasowy – gdy jest wyłączony, produkty bez pełnego tłumaczenia (tytułu i opisu) w wybranym języku zostaną wykluczone z feedu

Dzięki temu do każdego marketplace’u eksportujesz tylko w pełni przetłumaczone produkty.

Harmonogram

Skonfiguruj automatyczne generowanie feedu według harmonogramu (co godzinę, codziennie lub według własnego wyrażenia cron), aby opublikowane feedy zawsze zawierały najnowsze dane.

Dostarczanie przez FTP

Opcjonalnie wysyłaj wygenerowane feedy na serwer FTP/SFTP. Skonfiguruj host, dane logowania, ścieżkę i nazwę pliku w ustawieniach feedu.

Pola dynamiczne

Pola dynamiczne pozwalają tworzyć wyliczane pola wyjściowe z regułami warunkowymi. Na przykład ustaw pole „shipping” na „free”, gdy cena przekracza 50 €, albo ustaw pole „label” w zależności od ilości na stanie.

Szablony marketplace’ów

Sync2Sys zawiera gotowe szablony eksportu dla popularnych marketplace’ów:

• Verskis.lt – litewski marketplace z automatyczną publikacją produktów
• Varle.lt (etrade) – format XML z hierarchicznymi kategoriami, kodem kreskowym i ustrukturyzowanymi atrybutami
• Pigu.lt – format XML z automatycznie generowanymi numerycznymi ID kategorii

Wybierz odpowiedni szablon podczas tworzenia nowego feedu eksportu. Struktura feedu od razu spełnia wymagania marketplace’u.

Silnik wzbogacania i pola dynamiczne

Zintegrowany silnik wzbogacania pozwala tworzyć reguły, które przekształcają dane produktów osobno dla każdego feedu eksportu. Reguły mogą:

• Zamieniać lub formatować tekst w dowolnym polu
• Dynamicznie mapować wartości (np. tłumaczyć kody rozmiarów na wartości wymagane przez dany marketplace)
• Stosować warunki (np. jeśli marka = „X”, ustaw pole na „Y”)
• Czyścić dane przed eksportem (usuwać zbędne spacje, poprawiać kodowanie)

Reguły konfiguruje się osobno dla każdego feedu, w zakładce ustawień feedu.

Rozliczenia i plany

Dostępne plany

Sync2Sys oferuje kilka planów dopasowanych do wielkości Twojego biznesu. Każdy plan ma limity dotyczące:

• Liczby produktów
• Liczby dostawców
• Liczby feedów eksportu
• Liczby kanałów sprzedaży (sklepów)
• Liczby członków zespołu
• Liczby produktów PIM (jeśli włączony jest dodatek PIM)

Aktualne plany i ceny znajdziesz na stronie sync2sys.com/pl/pricing.html.

Płatności

Płatności są obsługiwane przez Paysera. Możesz płacić miesięcznie lub rocznie (z rabatem). Faktury są generowane automatycznie i dostępne w Ustawienia → Rozliczenia.

Bezpłatny okres próbny

Każde nowe konto zaczyna od 14-dniowego bezpłatnego okresu próbnego, który obejmuje wszystkie funkcje. Karta płatnicza nie jest wymagana.