Dokumentacja
Ostatnia aktualizacja: 2026-09-15
1. Czym jest Orbilyn
Orbilyn to narzędzie B2B do porządkowania danych i operacji e-commerce. Porównujesz dwa zestawy produktowe obok siebie — z plików (CSV, Excel, XML IOF) albo przez API sklepu — i widzisz rozjazdy cen, stanów, SKU oraz statusów ofert. Wykrywa niespójności danych; nie jest ogólnym hubem synchronizacji, ERP, PIM-em ani panelem sprzedaży.
Aplikacja działa pod adresem /app, w sekcjach: Obszar roboczy, Źródła i Ustawienia.
2. Start
Wejdź na orbilyn.com i załóż konto Free albo zaloguj się. Bez konta możesz wczytać **pełne Demo** (Zestaw A / Zestaw B) w Przeglądzie — własne pliki i API są zablokowane (kierują do cennika). Konto Free odblokowuje pracę na własnych plikach; pakiet Pro dodaje źródła API i integracje.
Po zalogowaniu otwórz aplikację. Dane robocze (zestawy A/B, konektory, zbiory oferty/cen/stanów) oraz preferencje (tolerancje porównania, mapowania kolumn) są zapisane na Twoim koncie i działają w każdej przeglądarce, w której się zalogujesz. Bez konta dane zostają tylko w tej przeglądarce.
3. Wczytywanie danych (pliki)
W obszarze roboczym wczytaj zestaw A i zestaw B. Bez konta dostępne jest tylko pełne Demo (wbudowane katalogi Zestaw A / Zestaw B). Na Free: własne pliki — CSV (UTF-8 lub eksport z Excela, separator przecinek albo średnik), Excel (.xlsx, .xlsm, .xls) oraz XML produktowy (IOF). Przy Excelu wybierany jest arkusz z największą liczbą wierszy; nagłówek może być w pierwszych 50 wierszach.
W pliku powinny być kolumny przydatne do porównania: SKU, identyfikator oferty, nazwa, cena brutto, stan magazynowy i status oferty. Jeśli nagłówki różnią się od domyślnych, zmapuj kolumny ceny i stanu w oknie mapowania.
4. Źródła i import przez API
Sekcja Źródła ma dwie zakładki: Integracje i Zestawienia. W Integracjach dodajesz konektory sklepów i marketplace’ów: IdoSell, Allegro, Erli, PrestaShop, WooCommerce i BaseLinker — każdy obsługiwany równorzędnie do odczytu/importu. Podajesz domenę albo token, zapisujesz integrację i testujesz połączenie. Na karcie konektora (Pro) możesz też pobrać pełną odpowiedź API (JSON) do diagnostyki. Allegro łączy się przez OAuth (odczyt ofert); BaseLinker i Erli używają tokena; PrestaShop i WooCommerce — klucza webservice / REST.
Import API jest dostępny w pakiecie Pro. Po zapisaniu konektora wczytujesz oferty do zestawu A lub B w Przeglądzie. Zakładka Zestawienia buduje plik z 1–6 konektorów (jeden kanał = czysty katalog; wiele = pola obok siebie). Klucze API są przechowywane po stronie serwera i nie wracają w podglądzie.
5. Obszar roboczy
Przegląd: jedna tabela zestawu A i B. Widzisz dopasowanie po SKU, różnice cen i stanów, statusy ON/OFF, duplikaty oraz produkty tylko w A albo tylko w B. Filtry i wyszukiwanie pomagają przejść listę wyjątków. Przycisk „Eksportuj” wybiera zakres (bieżący widok porównania albo wczytany zestaw A/B) i format (XLSX / CSV). Eksport zestawu bierze dane już w przeglądarce — bez ponownego odpytywania API. Free: CSV samych rozbieżności z widoku porównania (do 100 wierszy) oraz pełny eksport zestawu wczytanego z pliku; Pro: pełny eksport porównania (CSV/XLSX z liczbami i arkuszem Podsumowanie) oraz eksport zestawów z API.
Rozbieżności: karty wyjątków — cena, stan, status i brak pary — z wczytanego porównania.
Historia porównań: Pro — ostatnie 30 dni uruchomień Przeglądu, z ponownym porównaniem z zapisanych źródeł API, gdy są dostępne.
Struktura: podgląd surowych kolumn wczytanego pliku albo odpowiedzi API — arkusze, wiersz nagłówka, filtry kolumn.
Szczegóły: karta jednego produktu (opis krótki i długi oraz pola ze Struktury) z nawigacją po liście.
Katalog: lista produktów z wczytanego importu (nazwa, link oferty, wyszukiwanie) dla zestawu A lub B — zakładka Obszaru roboczego na Free i Pro, nie osobny produkt Scale.
6. Ustawienia
W Ustawieniach masz zakładki: Konto, Przegląd, Dane i Pakiet. Zmieniasz konto, język, zgody marketingowe, tolerancje porównania (procentowa lub bezwzględna różnica ceny, ignorowanie spacji w SKU, reguły statusów) oraz widzisz status pakietu.
W pakiecie Pro zakładka Dane oferuje kopię zapasową i przywracanie danych roboczych zapisanych na koncie. Jednorazowy katalog z API pobierasz w Źródła → Zestawienia (CSV/XLSX) albo pełną odpowiedź JSON z karty konektora w Integracjach.
7. Pakiety
Free (0 zł): praca na plikach CSV, Excel i XML (IOF) w obszarze roboczym (Przegląd, Rozbieżności, Struktura, Szczegóły, Katalog) oraz ograniczony CSV rozbieżności z Przeglądu (do 100 wierszy).
Pro (39 zł / mies. lub 349 zł / rok): wszystko z Free plus źródła API, integracje, pełny eksport Przeglądu (CSV/XLSX), kopia zapasowa obszaru i historia porównań (30 dni). Oba warianty rozliczeniowe dają ten sam plan Pro i te same uprawnienia. Płatności obsługuje Paddle (Merchant of Record); dla Polski obowiązują ceny PLN zdefiniowane w Paddle. Zmiana okresu (miesięczny ↔ roczny) możliwa w portalu Paddle. Scale z Monitoringiem jest wkrótce — bez sprzedaży. Push do sklepów nie wchodzi w pakiet Pro. Aktualny cennik. Zwroty.
8. Dobre praktyki
Porównuj eksporty z tego samego momentu (ten sam dzień / ta sama godzina), żeby nie mylić rozjazdów z opóźnieniem synchronizacji.
Ujednolic SKU między systemami — to główny klucz parowania. Jeśli SKU jest w innej kolumnie, ustaw mapowanie albo sprawdź Struktury.
Zacznij od filtrów „brak pary” i „różnica ceny / stanu”, potem duplikaty i braki EAN. Zmiany w sklepie wprowadzaj w systemie źródłowym — Orbilyn pokazuje rozjazdy, nie zastępuje ERP ani panelu sklepu.
9. Wsparcie
Pytania o działanie produktu, konto lub dane: strona Kontakt. Regulamin. Polityka prywatności.