Jedna platforma, oddzielne konta
CobaltPivot jest wewnętrznym narzędziem do zarządzania katalogiem produktów i operacjami e-commerce. Platforma jest przeznaczona dla uprawnionych użytkowników organizacji, która ją wdraża. Nie jest obecnie oferowana publicznie jako usługa SaaS.
Integracja zakłada jedną aplikację Allegro oraz oddzielną autoryzację OAuth każdego konta sprzedawcy. Tożsamość konta, autoryzacja oraz powiązania ofert są rozdzielone. Wspólny SKU nie powoduje połączenia kont ani ofert.
Ta strona jest publiczną dokumentacją. Nie jest panelem logowania ani miejscem wprowadzania kluczy lub danych sprzedawców. CobaltPivot jest niezależnym projektem, a nie oficjalnym produktem Allegro.
Zakres funkcjonalny
Funkcje dostępne w lokalnej aplikacji
- Katalog produktów, SKU, kody EAN przypisane do kont oraz informacje o asortymencie.
- Przygotowanie reguł nazw ofert i szablonów opisów, w tym kompatybilności produktów.
- Obsługa i kontrola zdjęć produktowych przechowywanych w Cloudflare R2.
Pierwszy etap integracji Allegro
Przygotowano autoryzację OAuth oraz odczyt danych profilu i listy własnych ofert. Uruchomienie połączenia wymaga rejestracji aplikacji, udzielenia zgody przez sprzedawcę i weryfikacji dostępu. Ten etap nie publikuje ani nie modyfikuje ofert.
Dodatkowe funkcje integracji będą udostępniane etapami, z odpowiednimi uprawnieniami i zgodą użytkownika.
Jak podłączyć konto Allegro
- Administrator otwiera w lokalnej aplikacji sekcję Integracje → Allegro. Jednorazowo konfiguruje dane zarejestrowanej aplikacji.
- Wybiera konto CobaltPivot i podaje oczekiwany login Allegro.
- Uruchamia połączenie. Przeglądarka przechodzi na stronę autoryzacji Allegro.
- Sprzedawca sprawdza konto oraz zakres dostępu i udziela zgody na stronie Allegro.
- Allegro przekierowuje przeglądarkę do CobaltPivot. Program sprawdza zgodność konta, a następnie zapisuje jego indywidualne tokeny.
- Administrator uruchamia kontrolę odczytu ofert. Dla kolejnego konta powtarza autoryzację osobno.
Stosowany mechanizm: OAuth 2.0 Authorization Code z PKCE (S256) i kontrolą parametru state. W obecnej instalacji autoryzację wykonuje się w przeglądarce na komputerze, na którym działa serwer aplikacji.
Aktualnie wymagane uprawnienia
allegro:api:profile:read— identyfikacja autoryzowanego konta.allegro:api:sale:offers:read— odczyt ofert tego konta.
Uprawnienia do zapisu, zamówień i wysyłek będą dodawane dopiero wraz z odpowiednimi funkcjami i ponowną zgodą użytkownika.
Dane i bezpieczeństwo
CobaltPivot nie prosi o hasło Allegro i go nie przechowuje. Logowanie odbywa się na stronie Allegro.
Backend przechowuje identyfikator i login konta, tokeny OAuth, ich ważność i zakres uprawnień oraz metadane połączenia. Sekrety są przechowywane po stronie serwera, z ograniczonym dostępem. Nie są wyświetlane użytkownikom jako wynik połączenia ani publikowane na tej stronie.
Dane odczytywane z Allegro służą obsłudze autoryzowanych kont. Ta strona dokumentacji nie zawiera danych kont, ofert, klientów ani kluczy API. Nie używa własnych skryptów analitycznych ani formularzy; dostawca hostingu może przetwarzać techniczne dane żądań zgodnie ze swoją polityką.
Odłączenie i pomoc
Przycisk Odłącz / Отключить w ustawieniach integracji usuwa lokalnie zapisane tokeny konta. Samo odłączenie nie usuwa produktów ani ofert na Allegro. Zgodę dla aplikacji można odwołać również w ustawieniach powiązanych aplikacji konta Allegro.
Po wygaśnięciu lub odwołaniu dostępu może być potrzebna ponowna autoryzacja. W razie niezgodności loginu należy wybrać właściwe konto Allegro i rozpocząć połączenie ponownie.
Użytkownicy wewnętrzni zgłaszają problemy administratorowi swojej instalacji CobaltPivot. Nie należy przesyłać haseł, Client Secret ani tokenów w zgłoszeniach.