Dokumentacja Sync2Sys

Pierwsze kroki

Tworzenie konta

Aby rozpocząć korzystanie z Sync2Sys, odwiedź stronę panel.sync2sys.com/register i utwórz konto, korzystając ze swojego adresu e-mail lub Google OAuth. Po rejestracji zostaniesz przeniesiony do panelu kontrolnego.

Przegląd panelu

Pulpit nawigacyjny zapewnia podsumowanie systemu w czasie rzeczywistym:

• Aktywni dostawcy — liczba podłączonych kanałów dostawców
• Wszystkie produkty — wszystkie importowane produkty w Twoim katalogu
• Produkty aktywne — produkty aktualnie aktywne i znajdujące się w magazynie
• Brak w magazynie — produkty, których nie ma w magazynie

Organizacja i zespół

Każde konto należy do organizacji. Możesz zapraszać członków zespołu o różnych rolach:

• Właściciel — pełny dostęp, zarządzanie rozliczeniami
• Administrator — zarządzaj dostawcami, produktami, kanałami, kanałami
• Członek — dostęp do przeglądania z ograniczoną edycją

Zarządzaj członkami zespołu z Ustawienia → Zespół w panelu.

Dostawcy

Dostawcy są źródłem danych o Twoich produktach. Sync2Sys obsługuje import od wielu dostawców jednocześnie, każdy z własnymi kanałami i mapowaniami pól.

Dodawanie dostawcy

1. Przejdź do Dostawcy na pasku bocznym
2. Trzask Dodaj dostawcę
3. Wprowadź nazwę dostawcy i szczegółowe informacje
4. Dodaj co najmniej jeden plik danych (plik danych o produktach, zapasach lub cenach)

Typy kanałów

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

• Produkty — pełny katalog produktów ze wszystkimi polami
• Magazyn — tylko aktualizacje zapasów/inwentarza
• Cena — tylko aktualizacje cen

Obsługiwane formaty plików danych

• XML-a — najpopularniejszy format plików danych dostawców
• CSV — wartości oddzielone przecinkami/średnikami
• XLS/XLSX — Pliki Excel (automatycznie konwertowane do formatu CSV po przesłaniu)
• JSON — strukturyzowane kanały JSON

Kanały można łączyć poprzez adres URL (w celu automatycznej synchronizacji) lub przesyłać je ręcznie jako pliki.

Mapowanie pola

Po dodaniu kanału Sync2Sys automatycznie wykrywa dostępne pola. Następnie mapujesz pola dostawców na standardowe pola Sync2Sys (nazwa, cena, stan magazynowy, EAN itp.). Mapowanie może odbywać się automatycznie lub ręcznie.

Walidacja i testowanie paszy

Przed importem możesz przetestować adres URL dowolnego kanału, aby sprawdzić, czy jest on dostępny i zobaczyć przykładowe dane. Pomaga to wcześnie wykryć problemy z formatowaniem.

Produkty (katalog dostawców)

Produkty zaimportowane z kanałów dostawców pojawiają się w sekcji Produkty. To jest katalog Twojego dostawcy, zawierający wszystkie oryginalne dane i wzbogacenia Sync2Sys.

Importowanie produktów

1. Idź do Produkty → Importuj lub skorzystaj z akcji importowej dostawcy
2. Wybierz dostawcę i kanał, z którego chcesz importować
3. Sprawdź mapowanie pola
4. Rozpocznij import — postęp będzie wyświetlany w czasie rzeczywistym

Zarządzanie produktami

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

• Szukaj — według nazwy, SKU, EAN lub dostawcy
• Filtr — według statusu (aktywny, nieaktywny, niedostępny), dostawcy, kategorii
• Działania zbiorcze — zaktualizuj status, zmodyfikuj pola lub usuń wiele produktów na raz

Synchronizuj historię

Każda operacja importu i synchronizacji jest rejestrowana. Wyświetl pełną historię, w tym liczbę wierszy, błędy i czas od Produkty → Historia synchronizacji.

PIM (zarządzanie informacjami o produkcie)

Moduł PIM umożliwia utworzenie wyselekcjonowanego, wzbogaconego katalogu produktów niezależnego 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 dostawcy — wybierz jeden lub więcej produktów dostawcy i promuj je w PIM
• Ręcznie — stwórz nowy produkt od podstaw z pełną kontrolą terenową

Tłumaczenia

Każdy produkt PIM obsługuje treści wielojęzyczne. Dodaj tłumaczenia dla dowolnych ustawień regionalnych z osobnym tytułem, opisem i metapolami dla każdego języka.

Warianty

Produkty PIM mogą mieć warianty (np. rozmiar, kolor). Każdy wariant ma swój własny numer SKU, cenę, stan magazynowy i atrybuty.

Głoska bezdźwięczna

Dodaj zdjęcia produktów poprzez adres URL lub przesłanie pliku. Zarządzaj kolejnością obrazów, ustaw obraz główny i dodaj tekst alternatywny dla SEO.

Generowanie treści AI

Sync2Sys może generować zawartość produktu za pomocą sztucznej inteligencji. Dostępne dla pól: tytuł, krótki opis, długi opis, meta tytuł i meta opis. Wykorzystanie sztucznej inteligencji jest śledzone w oparciu o miesięczny limit tokenów Twojego planu.

Zbiorczy import CSV

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

1. Przejdź do PIM → Szybkie akcje → Importuj tłumaczenia
2. Prześlij plik CSV z danymi produktów
3. Mapuj 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. Rozpocznij import — działa w tle ze śledzeniem postępu w czasie rzeczywistym

Historia wersji

Każda zmiana w produkcie PIM podlega wersjonowaniu. Możesz przeglądać historię zmian i przywracać dowolną poprzednią wersję.

Silnik wzbogacania danych (Reguły)

Silnik wzbogacania danych pozwala zautomatyzować czyszczenie i modyfikację danych. Twórz niestandardowe reguły zastępowania tekstu, formatowania wartości lub dynamicznego wzbogacania danych przed ich publikacją.

Kategorie

System kategorii umożliwia budowanie ujednoliconej taksonomii i mapowanie kategorii dostawców do własnej struktury.

Zestawy kategorii

Zestawy kategorii są niezależnymi drzewami kategorii. Możesz mieć jeden zestaw dla swojego sklepu internetowego, a drugi dla rynku. Każdy zestaw ma swoją własną hierarchię.

Budowanie drzewa kategorii

1. Przejdź do Kategorie
2. Utwórz nowy zestaw kategorii (lub użyj domyślnego)
3. Dodaj kategorie pojedynczo lub zbiorczo
4. Uporządkuj je w hierarchię rodzic-dziecko

Mapowanie kategorii

Mapuj kategorie dostawców na własne kategorie. Określa to sposób uporządkowania importowanych produktów w katalogu.

• Mapowanie ręczne — przeciągnij i upuść lub wybierz kategorie docelowe
• Mapowanie wspomagane sztuczną inteligencją — Sync2Sys sugeruje mapowanie przy użyciu analizy AI
• Mapowanie zbiorcze — mapuj wiele kategorii jednocześnie
• Automatyczne wykrywanie — automatycznie wyodrębniaj unikalne kategorie z kanałów dostawców

Reguły kategorii (słowa kluczowe)

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

1. Przejdź do Dostawcy → [Dostawca] → Kanał → 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 i eksportu

Zasady cenowe

Reguły cenowe umożliwiają definiowanie automatycznych formuł cenowych, które przekształcają ceny dostawców w ceny sprzedaży.

Jak to działa

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

Tworzenie reguły

1. Idź do Zasady cenowe
2. Trzask Dodaj regułę
3. Ustaw formułę (np. marża %, stała marża, formuła)
4. Zdefiniuj warunki (opcjonalnie): dostawca, kategoria, marka, wzór EAN, ilość towaru
5. Ustaw kolejność priorytetów

Symulacja cen

Przed zastosowaniem reguł do katalogu użyj narzędzia symulacyjnego, aby wyświetlić podgląd wyników. Wprowadź cenę dostawcy i opcjonalne warunki, aby zobaczyć, które zasady mają zastosowanie i obliczoną cenę końcową.

Kanały sprzedaży

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

Obsługiwane platformy

• WooCommerce — poprzez klucze REST API lub wtyczkę Sync2Sys
• Shopify — poprzez integrację OAuth
• PrestaShop — poprzez połączenie API
• Magento 2 — poprzez klucz integracyjny REST API
• OpenCart — poprzez klucz API REST
• Allegro — poprzez autoryzację OAuth 2.0 (Allegro REST API)
• eBay'u — poprzez autoryzację OAuth 2.0 (eBay REST API)
• Amazonka — poprzez autoryzację SP-API (Amazon Selling Partner API)

Łączenie WooCommerce

Dwie opcje:

1. Korzystanie z wtyczki Sync2Sys — zainstaluj wtyczkę z WordPressa, a automatycznie połączy się ona z Twoim sklepem
2. Ręczne klucze API — wygeneruj klucze API REST WooCommerce (klucz konsumenta + sekret) i wklej je w Sync2Sys

Łączenie Shopify

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

Łączenie z PrestaShopem

Przed połączeniem sklepu PrestaShop z Sync2Sys musisz włączyć funkcję WebService w swoim panelu administracyjnym PrestaShop. Jeśli usługa WebService nie jest włączona, pojawi się następujący błąd:

Wykonaj poniższe kroki, aby połączyć się z PrestaShop:

1. Zaloguj się do swojego panelu administracyjnego PrestaShop
2. Przejdź do Parametry zaawansowane → Serwis internetowy
3. Ustawić „Włącz usługę internetową PrestaShop” Do Tak i kliknij Ratować
4. Trzask „Dodaj nowy klucz usługi internetowej” — zostanie wygenerowany nowy klucz API
5. Ustaw uprawnienia dla wygenerowanego klucza — musisz przyznać dostęp do następujących zasobów:
   • produkty — pełny dostęp (GET, PUT, POST, DELETE)
   • kategorie — pełny dostęp
   • zapasy_dostępne — pełny dostęp
   • kombinacje — pełny dostęp
   • obrazy — pełny dostęp
   • producenci - DOSTAWAĆ
   • języki - DOSTAWAĆ
   • waluty - DOSTAWAĆ
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://Twój-sklep.com) i klucz API

Podłączanie Magento 2

Aby połączyć sklep Magento 2 należy stworzyć integrację API w panelu administracyjnym Magento:

1. Zaloguj się do swojego panelu administracyjnego Magento
2. Przejdź do System → Integracje
3. Trzask Dodaj nową integrację
4. Wprowadź nazwę (np. „Sync2Sys”) i hasło administratora w celu potwierdzenia
5. w API wybierz następujące zasoby:
   • Katalog — pełny dostęp (produkty, kategorie, atrybuty)
   • Spis — pełny dostęp (zapas)
6. Zapisz i kliknij Aktywować
7. Skopiuj wygenerowane klucze: Klucz Konsumenta, Sekret konsumenta, Token dostępu, I Dostęp do tajnego tokena
8. W panelu Sync2Sys przejdź do Kanały sprzedaży → Dodaj kanał → Magento 2
9. Wpisz adres URL swojego sklepu i wszystkie 4 klucze API

Podłączanie OpenCart

Aby połączyć swój sklep OpenCart z Sync2Sys:

1. Zaloguj się do panelu administracyjnego OpenCart
2. Przejdź do System → Użytkownicy → API
3. Trzask Dodaj nowy lub edytuj istniejącego użytkownika API
4. Wprowadź nazwę użytkownika API, wygeneruj klucz API i ustaw status na Włączony
5. w Adresy IP na karcie dodaj adres IP serwera Sync2Sys (pokazany 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. Wprowadź adres URL swojego sklepu, nazwę użytkownika API i klucz API

Podłączenie Allegro

Allegro to polski rynek. Sync2Sys umożliwia bezpośrednią integrację z Allegro poprzez OAuth 2.0 — nie musisz tworzyć żadnej aplikacji deweloperskiej.

1. W panelu Sync2Sys przejdź do Kanały sprzedaży → Dodaj kanał → Allegro
2. Trzask Połącz się z Allegro
3. Zostaniesz przekierowany na stronę logowania Allegro — zaloguj się za pomocą swojego konta Allegro
4. Potwierdź, że przyznajesz Sync2Sys dostęp do swojego konta Allegro
5. Po pomyślnej autoryzacji zostaniesz przekierowany z powrotem do panelu Sync2Sys i Twój kanał Allegro zostanie podłączony

Łączenie z eBayem

eBay to rynek międzynarodowy. Sync2Sys obsługuje bezpośrednią integrację z eBay poprzez OAuth 2.0 — nie musisz tworzyć żadnej aplikacji programistycznej.

1. W panelu Sync2Sys przejdź do Kanały sprzedaży → Dodaj kanał → eBay
2. Wybierz region rynku eBay (np. eBay.de, eBay.co.uk, eBay.com itp.)
3. Trzask Połącz się z eBayem
4. Zostaniesz przekierowany na stronę logowania do serwisu eBay — zaloguj się przy użyciu swojego konta eBay
5. Potwierdź, że przyznajesz Sync2Sys dostęp do swojego konta eBay
6. Po pomyślnej autoryzacji zostaniesz przekierowany z powrotem do panelu Sync2Sys i Twój kanał eBay zostanie podłączony

Łączenie Amazona

Amazon to największy rynek na świecie. Sync2Sys obsługuje bezpośrednią integrację z Amazon poprzez 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 rynku Amazon (np. Amazon.de, Amazon.co.uk, Amazon.com, Amazon.fr itp.)
3. Trzask Połącz się z Amazonem
4. Zostaniesz przekierowany 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 pomyślnej autoryzacji zostaniesz przekierowany z powrotem do panelu Sync2Sys i Twój kanał Amazon zostanie podłączony

Synchronizacja

Po nawiązaniu połączenia możesz uruchomić pełną synchronizację lub monitorować stan synchronizacji. Każda synchronizacja tworzy dziennik zawierający szczegółowe informacje na temat utworzonych, zaktualizowanych produktów lub napotkanych błędów.

Import produktów ze sklepu

Oprócz wysyłania produktów do kanałów sprzedaży możesz również importować istniejące produkty z podłączonego sklepu do Sync2Sys. Jest to przydatne podczas migracji do Sync2Sys lub gdy trzeba wzbogacić dane sklepu funkcjami PIM.

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

Konwersja walut

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

Eksportuj kanały

Kanały eksportu umożliwiają generowanie plików danych produktów dla platform handlowych, porównywarek cenowych i platform reklamowych.

Tworzenie kanału eksportu

1. Idź do Eksportuj kanały
2. Trzask Utwórz kanał
3. Wybierz format wyjściowy: XML, CSV lub JSON
4. Skonfiguruj filtry, aby wybrać produkty do uwzględnienia
5. Mapuj pola produktów do formatu docelowego

Filtry

Dostępne są dwa tryby filtrowania:

• Prosty — wybierz według dostawcy, kategorii, statusu, zapasów
• Zaawansowany — buduj złożone drzewa reguł z logiką AND/OR, warunkami na dowolnym polu, w tym atrybutami

Wydawniczy

Opublikowane kanały otrzymują bezpieczny publiczny adres URL z unikalnym kodem (np. panel.sync2sys.com/api/public/feeds/your-feed-a1b2c3.xml).

Język i zapasowe tłumaczenie

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

• Wybierz język eksportu w ustawieniach kanału
• Włącz lub wyłącz język zapasowy — po wyłączeniu produkty bez pełnego tłumaczenia (tytuł i opis) w wybranym języku zostaną pominięte

Gwarantuje to, że eksportowane są tylko w pełni przetłumaczone produkty.

Planowanie

Skonfiguruj automatyczną regenerację zgodnie z harmonogramem (co godzinę, codziennie lub niestandardowe wyrażenie cron), aby publikowane kanały zawsze zawierały najnowsze dane.

Dostawa FTP

Opcjonalnie wyślij wygenerowane kanały na serwer FTP/SFTP. Skonfiguruj host, poświadczenia, ścieżkę i nazwę pliku w ustawieniach kanału.

Pola dynamiczne

Pola dynamiczne umożliwiają tworzenie obliczonych pól wyjściowych za pomocą reguł warunkowych.

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 atrybutami
• Pigu.lt — format XML z automatycznie generowanymi numerycznymi ID kategorii

Wybierz odpowiedni szablon podczas tworzenia nowego kanału eksportu.

Silnik wzbogacania i dynamiczne pola

Zintegrowany silnik wzbogacania pozwala tworzyć reguły transformujące dane produktów dla każdego kanału eksportu. Reguły mogą:

• Zastępować lub formatować tekst w dowolnym polu
• Dynamicznie mapować wartości (np. konwertować kody rozmiarów)
• Stosować warunki (np. jeśli marka = "X", ustaw pole "Y")
• Czyścić dane przed eksportem (usunąć spacje, naprawić kodowanie)

Reguły są konfigurowane osobno dla każdego kanału w jego ustawieniach.

Rozliczenia i plany

Dostępne plany

Sync2Sys oferuje kilka planów dostosowanych do wielkości Twojej firmy. Każdy plan obejmuje limity dotyczące:

• Liczba produktów
• Liczba dostawców
• Liczba kanałów eksportowych
• Liczba kanałów sprzedaży (sklepów)
• Członkowie zespołu
• Produkty PIM (jeśli włączony jest dodatek PIM)

Zobacz aktualne plany i ceny na stronie sync2sys.com/en/pricing.html.

Płatności

Płatności realizowane są poprzez Paysera. Możesz płacić miesięcznie lub rocznie (ze zniżką). Faktury są generowane automatycznie i dostępne w Ustawienia → Rozliczenia.

Bezpłatny okres próbny

Wszystkie nowe konta rozpoczynają się od 14-dniowego bezpłatnego okresu próbnego, który obejmuje wszystkie funkcje. Nie jest wymagana karta kredytowa.