Allegro Shopify

Instalacja i uruchomienie

Aplikacja działa w panelu Shopify i udostępnia trzy główne obszary:

• Strona główna (onboarding),
• Oferty,
• Ustawienia.

Aby rozpocząć:

1. Zainstaluj aplikację w sklepie Shopify.
2. Otwórz aplikację z listy Aplikacje w panelu Shopify.
3. Przejdź do Ustawienia, aby połączyć konto Allegro.

Autoryzacja połączenia z Allegro

Połączenie z Allegro wykonujesz w Ustawienia → Ustawienia ogólne.

Jak wykonać autoryzację

1. W sekcji Połączenie z Allegro kliknij Połącz konto Allegro.
2. Otworzy się okno popup Allegro (oauth).
3. Zaloguj się do konta Allegro i potwierdź dostęp aplikacji.
4. Po poprawnej autoryzacji popup automatycznie zamknie się i status w aplikacji zmieni się na Połączono.

Co widzi użytkownik

• status połączenia: Połączono / Nie połączono,
• przycisk Połącz konto Allegro lub Rozłącz,
• komunikat sukcesu lub błędu po autoryzacji.

Rozłączenie konta

1. W tej samej sekcji kliknij Rozłącz.
2. Aplikacja usuwa połączenie OAuth i kanał Allegro w aplikacji.

Ustawienia aplikacji

W tym obszarze konfigurujesz połączenie z Allegro i dane, które aplikacja wykorzysta podczas tworzenia ofert. Dobrze uzupełnione ustawienia skracają czas wystawiania i ograniczają błędy walidacji.

Zakładka Ustawienia ma 3 karty.

1. Ustawienia ogólne

Ta karta służy do zarządzania połączeniem OAuth oraz podstawowymi parametrami pracy aplikacji. Ustawiasz tu lokalizację sklepu i język komunikacji z API Allegro.

• Połączenie z Allegro (connect/disconnect),
• Lokalizacja sklepu (aktywna lokalizacja Shopify dla ofert Allegro),
• Język API Allegro (Polski lub Angielski),
• przycisk Zapisz ustawienia (po pojawieniu się zmian).

2. Kategorie

W tej sekcji budujesz listę kategorii Allegro, z których później wybierasz kategorię dla oferty. Kategorie możesz dodać ręcznie albo wykryć automatycznie przez skan produktów po EAN.

• dodawanie kategorii Allegro ręcznie po ID,
• przeglądanie drzewa kategorii i wybór kategorii końcowych,
• zapis listy kategorii przyciskiem Zapisz kategorie,
• Skanuj produkty.

1. skanuje produkty Shopify po EAN,
2. pokazuje wykryte kategorie,
3. pozwala zaznaczyć i dodać je do konfiguracji.

3. Szablony opisu

Ta karta pozwala przygotować gotowe szablony opisu ofert, aby nie tworzyć treści od zera przy każdym produkcie. Szablony wspierają dynamiczne zmienne z danych Shopify.

• tworzenie wielokrotnego użytku szablonów opisu,
• bloki treści: tekst, obraz, tekst+obraz, lista cech,
• użycie zmiennych produktu Shopify (np. tytuł, opis, cena, SKU, EAN),
• zapis zmian przyciskiem Zapisz zmiany.

Wystawianie oferty Allegro z produktu Shopify

Przejdź do Oferty i wybierz Utwórz ofertę.

Formularz jest podzielony na sekcje:

1. Źródło produktu
2. Kategoria i specyfikacja
3. Parametry aukcji
4. Opis i zdjęcia
5. Dostawa i płatność
6. Polityki
7. GPSR

Typowy przebieg:

1. Wybierz produkt Shopify (i wariant).
2. Sprawdź/uzupełnij EAN.
3. Jeśli są dopasowania katalogowe Allegro, kliknij Pobierz z katalogu.
4. Wybierz kategorię i parametry.
5. Uzupełnij tytuł, cenę, stan, czas trwania.
6. Sprawdź opis i galerię zdjęć.
7. Ustaw dostawę, płatność i polityki.
8. Zapisz szkic, opcjonalnie Sprawdź z Allegro, następnie Opublikuj na Allegro.

Dokładny opis pól formularza oferty

Sekcja: Źródło produktu

Ta sekcja służy do wyboru produktu i wariantu z Shopify jako podstawy oferty. Na tym etapie aplikacja może też pobrać dane z katalogu Allegro na podstawie kodu EAN.

Pole	Opis działania	Wymagane
Produkt Shopify	Wyszukiwarka produktów. Po wyborze wariantu aplikacja automatycznie uzupełnia: nazwę oferty, cenę, stan, EAN, dane produktu i zdjęcia.	Tak (wariant)
Karta wybranego produktu	Podgląd miniatury, wariantu, SKU, ceny i stanu; przycisk Zmień czyści wybór.	Nie
Kod EAN	Uzupełnia się automatycznie z wariantu (barcode), ale można wpisać ręcznie.	Zalecane
Dopasowania z katalogu Allegro	Lista wyników po EAN. Przycisk Pobierz z katalogu ustawia kategorię, część parametrów i scala zdjęcia katalogowe z galerią.	Nie

Sekcja: Kategoria i specyfikacja

W tej sekcji określasz kategorię Allegro oraz parametry wymagane przez wybraną kategorię. Poprawne uzupełnienie parametrów wpływa na możliwość publikacji i widoczność oferty.

Pole	Opis działania	Wymagane
Kategoria	Wybór z wcześniej zapisanych kategorii w Ustawieniach.	Tak
Parametry wymagane	Parametry kategorii z Allegro. Typy pól: słownik (select), tekst, liczba całkowita, liczba zmiennoprzecinkowa.	Zależy od kategorii
Parametry opcjonalne	Dodatkowe parametry (domyślnie widoczne pierwsze 10).	Nie

Uwagi:

1. Wymagane parametry słownikowe mogą zostać automatycznie ustawione na pierwszą dostępną wartość, jeśli są puste.
2. Zmiana kategorii czyści wcześniej wybrane parametry.

Sekcja: Parametry aukcji

Tutaj ustawiasz podstawowe warunki sprzedaży: tytuł, cenę, ilość i czas trwania oferty. To kluczowa sekcja dla poprawnej walidacji i publikacji oferty.

Pole	Opis działania	Wymagane	Walidacja
Tytuł oferty	Nazwa oferty publikowanej na Allegro.	Tak	12-75 znaków, min. 3 słowa, bez nadmiarowych spacji
Cena	Cena sprzedaży (PLN lub waluta konta Allegro).	Tak	Liczba dodatnia, max 2 miejsca po przecinku
Ilość na stanie	Ilość dostępna w ofercie.	Tak	Liczba całkowita > 0
Czas trwania	Opcje: 3/5/7/10/20/30 dni lub Bezterminowo (GTC).	Tak	Format ISO 8601 po stronie API
Automatycznie odnawiaj po zakończeniu	Opcja automatycznego ponowienia oferty.	Nie	Dostępność zależna od wybranego czasu trwania

Sekcja: Opis i zdjęcia

Ta sekcja odpowiada za prezentację produktu na Allegro: galerię oraz treść opisu. Możesz użyć gotowego szablonu albo zbudować opis blokowo z własnymi zdjęciami i treścią.

Pole	Opis działania	Wymagane	Walidacja
Zdjęcia (galeria)	Minimum 1, maksimum 16 zdjęć. Drag&drop zmienia kolejność. Pierwsze zdjęcie to główne (image_1).	Tak	1-16 zdjęć
Upload zdjęć	Dodawanie własnych zdjęć do galerii.	Nie	Limit 16
Szablon opisu	Wybór zapisanych szablonów opisu.	Nie	–
Edytor opisu blokowego	Budowa opisu z bloków (tekst/obraz/lista cech).	Tak	Opis nie może być pusty
Sloty obrazów w opisie (image_1…image_16)	Bloki opisu mogą wskazywać zdjęcia z galerii.	Zależne	Sloty muszą istnieć w galerii

Sekcja: Dostawa i płatność

W tej części konfigurujesz logistykę i rozliczenia, czyli cennik dostawy, czas realizacji i typ faktury. Dane są pobierane z ustawień Twojego konta Allegro.

Pole	Opis działania	Wymagane
Cennik dostawy	Wybór szablonu dostawy z konta Allegro.	Tak
Czas realizacji	Tego samego dnia, 24h, 48h, 3/5/7/14/21/30 dni.	Tak (domyślnie ustawiony)
Rodzaj faktury	Faktura VAT, VAT marża, Bez VAT, Brak faktury.	Tak (domyślnie VAT)
Dodatkowe informacje o dostawie	Pole tekstowe (opisowe).	Nie

Sekcja: Polityki

Sekcja zawiera polityki posprzedażowe wymagane przez Allegro, takie jak reklamacje i zwroty. Dodatkowo możesz przypisać gwarancję i usługi dodatkowe.

Pole	Opis działania	Wymagane
Reklamacje	Wybór polityki reklamacji z konta Allegro.	Tak
Zwroty	Wybór polityki zwrotów z konta Allegro.	Tak
Gwarancja	Wybór polityki gwarancji z konta Allegro.	Nie
Dodatkowe usługi	Wybór usług dodatkowych z konta Allegro.	Nie

Sekcja: GPSR

Ta sekcja służy do podania informacji bezpieczeństwa produktu zgodnie z wymaganiami GPSR. W razie potrzeby można tu przypisać lub utworzyć producenta i odpowiedzialną osobę w UE.

Pole	Opis działania	Wymagane
Informacje o bezpieczeństwie	Pole tekstowe z ostrzeżeniami/instrukcjami.	Zależnie od kategorii/produktu
Odpowiedzialny producent	Wybór producenta z konta Allegro lub utworzenie nowego formularzem.	Zależnie od kategorii/produktu
Odpowiedzialna osoba w UE	Wybór osoby odpowiedzialnej lub utworzenie nowej formularzem.	Często wymagane dla produktów spoza UE

Formularz: nowy producent (GPSR)

Pola:

• Nazwa producenta (wewnętrzna),
• Nazwa handlowa,
• Kraj,
• Kod pocztowy,
• Miasto,
• Ulica,
• Telefon,
• E-mail.

Formularz: nowa odpowiedzialna osoba (GPSR)

Pola:

• Nazwa wewnętrzna,
• Nazwa osoby/firmy,
• Kraj,
• Kod pocztowy,
• Miasto,
• Ulica,
• Telefon,
• E-mail.

Lista ofert i dalsze akcje

W Oferty dostępne są:

• tabela ofert (produkt, status, cena, stan, data utworzenia, akcje),
• wyszukiwarka po nazwie produktu lub ID oferty,
• statusy ofert: Szkic, W trakcie weryfikacji, Aktywna, Nieaktywna, Zakończona.

Akcje dla oferty są zależne od statusu oferty. Poniżej lista wszystkich akcji:

• Edytuj,
• Zakończ ofertę,
• Wznów,
• Kopiuj,
• Zobacz na Allegro,
• Usuń z listy.

Akcje w widoku edycji/szkicu (panel boczny):

• Zapisz szkic / Aktualizuj szkic / Zaktualizuj aukcję,
• Sprawdź z Allegro,
• Opublikuj na Allegro,
• opcjonalnie Kopiuj jako nowy.