Pierwsza oferta

Żeby Uploader miał gdzie wysyłać dane, potrzebuje dwóch rzeczy: adresu panelu Twojego sklepu i klucza API. Podajesz je raz, w profilu dostępowym.

Klucz API z panelu IdoSell

Klucz wystawia się w panelu sklepu, w ustawieniach dostępu do API. Musi mieć uprawnienia do zapisu towarów — bez nich Uploader połączy się i odczyta dane, ale każda wysyłka zostanie odrzucona.

Sprawdź klucz, zanim zaczniesz paczkę

W oknie profilu jest przycisk testu połączenia. Warto go użyć od razu: kilkanaście minut importu, które kończą się odmową na każdym towarze, to najdroższy sposób dowiedzenia się, że kluczowi brakuje uprawnień.

Założenie profilu

Profil to jeden sklep. Podajesz w nim:

pole	przykład	uwagi
nazwa profilu	sklep-glowny	Twoja etykieta, widoczna tylko u Ciebie
domena panelu	twojsklep.pl	bez https:// — program dokleja je sam
klucz API	—	wklejasz raz; dalej patrz niżej

Po zatwierdzeniu program zakłada katalog oferty z trzema podkatalogami:

sourceDataBase/<profil>_<sklep>/
    dataBase/   <- bazy tej oferty: postęp, zdjęcia, grupy
    files/      <- pliki roboczo przetworzone
    logs/       <- dzienniki przebiegów

Gdzie trafia klucz API

Klucz idzie do Menedżera poświadczeń Windows od razu po zatwierdzeniu profilu — bez osobnego kliknięcia i bez pytania. W pliku profili zostaje samo odwołanie do niego, nie wartość.

Jeśli Menedżer poświadczeń jest z jakiegoś powodu niedostępny, program zapisze klucz w pliku profilu, ale powie Ci o tym wprost osobnym ostrzeżeniem. To nie jest stan, w którym należy zostawać.

Czego w pliku .env oferty celowo NIE ma

W katalogu oferty powstaje plik .env z adresem panelu (IDOSELL_URL=https://twojsklep.pl). Klucza w nim nie ma i nie będzie. Import dostaje go zmienną środowiskową, więc plik byłby trzecią kopią sekretu leżącą otwartym tekstem.

Czemu nie w argumentach polecenia

Uploader uruchamia import jako osobny proces. Klucz przekazuje mu zmienną środowiskową, nigdy argumentem wiersza poleceń — argumenty procesów widzi każdy program działający na tym samym koncie, a także Menedżer zadań. Maskowanie klucza w oknie programu zasłania zapis, nie rzeczywistość w systemie.

Wiele sklepów, wiele ofert

Profili może być tyle, ile obsługujesz sklepów, a w każdym tyle ofert, ile potrzebujesz partii pracy. Oferty nie dzielą ze sobą niczego: każda ma własne bazy postępu i własne dzienniki, więc przerwany import jednej nie dotyka drugiej.