Zwroty Allegro
Zwroty Allegro
Moduł Zwroty Allegro automatycznie pobiera zwroty klienckie zarejestrowane na Twoich kontach sprzedawcy Allegro i zamienia każdy z nich w zgłoszenie w Reklamatorze. Zmiany statusu zwrotu w Allegro (nadanie paczki, dostarczenie, zakończenie itd.) trafiają do historii zgłoszenia i mogą uruchamiać reguły biznesowe.
Konfiguracja dostępna jest pod Konfiguracja → Moduły → Zwroty Allegro.
Wymagania
Do zarządzania modułem potrzebne jest uprawnienie Ustawienia Allegro Zwroty (grupa uprawnień Allegro Zwroty). Liczba kont Allegro, które można podłączyć, zależy od planu abonamentowego.
Jak to działa
- Podłączasz jedno lub kilka kont sprzedawcy Allegro (logowanie przez Allegro — Reklamator nie zna Twojego hasła).
- Dla każdego konta ustawiasz typ zgłoszenia, organizację, opcjonalnie właściciela zgłoszeń oraz mapowanie danych zwrotu na pola zgłoszenia.
- Reklamator co około 30 minut sprawdza w Allegro nowe zwroty i tworzy z nich zgłoszenia — jedno zgłoszenie na jeden zwrot.
- Przy każdym kolejnym pobraniu sprawdzane są też statusy otwartych zwrotów. Zmiana statusu jest zapisywana w historii zgłoszenia, a pola zmapowane z danych zmiennych (status, list przewozowy, przewoźnik) są aktualizowane.
Zwrot jest śledzony do momentu osiągnięcia statusu końcowego: Zakończony, Zakończony (Allegro Ochrona Kupujących), Odrzucony lub Prowizja zwrócona.
Podłączanie konta Allegro
- Przejdź do Konfiguracja → Moduły → Zwroty Allegro i kliknij Dodaj konto Allegro.
- Zostaniesz przekierowany do Allegro — zaloguj się na konto sprzedawcy i zatwierdź dostęp dla Reklamatora.
- Po powrocie do Reklamatora połączenie pojawi się na liście. Nowe połączenie jest wstrzymane — pobieranie trzeba włączyć po uzupełnieniu konfiguracji.
Każde konto Allegro można podłączyć tylko raz. Jeśli spróbujesz podłączyć konto, które już jest na liście, zobaczysz komunikat „To konto Allegro jest już podłączone”.
Lista połączeń
Lista pokazuje dla każdego konta: nazwę połączenia, login konta Allegro, status, datę ostatniego pobrania oraz ostatni błąd. Z menu wiersza dostępne są akcje:
- Edytuj — konfiguracja połączenia
- Pobierz teraz — natychmiastowe pobranie nowych zwrotów i zmian statusów (bez czekania na automatyczny cykl); po zakończeniu wyświetla się podsumowanie: liczba nowych zgłoszeń, zmian statusu i błędów
- Podgląd zwrotów — lista zwrotów w Allegro (patrz niżej)
- Połącz ponownie — odnowienie dostępu, gdy Allegro go unieważniło
- Usuń — usuwa połączenie; zgłoszenia utworzone ze zwrotów pozostają w systemie
| Status | Znaczenie |
|---|---|
| Połączone | Dostęp do konta Allegro działa |
| Wymaga ponownego połączenia | Allegro unieważniło dostęp (np. po zmianie hasła lub usunięciu aplikacji w „Powiązanych aplikacjach” w Allegro) — pobieranie jest zatrzymane do czasu kliknięcia Połącz ponownie |
| Wstrzymane | Pobieranie wyłączone w ustawieniach połączenia |
Przy ponownym łączeniu trzeba zalogować się na to samo konto Allegro, które było podłączone wcześniej.
Konfiguracja połączenia
| Pole | Opis |
|---|---|
| Nazwa | Nazwa połączenia widoczna w Reklamatorze (np. nazwa sklepu) |
| Typ zgłoszenia | Typ, z jakim tworzone są zgłoszenia ze zwrotów |
| Organizacja | Organizacja, do której trafiają zgłoszenia |
| Właściciel zgłoszeń | Użytkownik ustawiany jako właściciel nowych zgłoszeń (opcjonalnie). Zgłoszenia bez właściciela widzą tylko użytkownicy z uprawnieniem do przeglądania wszystkich zgłoszeń |
| Pobieraj zwroty utworzone od | Data, od której pobierane są zwroty — najwyżej 60 dni wstecz |
| Pobieranie włączone | Włącza automatyczne pobieranie zwrotów. Wymaga ustawienia typu zgłoszenia i organizacji |
Mapowanie pól
Mapowanie określa, jakie dane z Allegro trafiają do których pól zgłoszenia. Każdy wiersz to pole zgłoszenia oraz:
- Z Allegro — wartość pobierana ze zwrotu lub zamówienia, albo
- Stała — stała wartość wpisywana do każdego zgłoszenia z tego konta (np. kategoria lub źródło)
Mapować można pola, które są aktywne i edytowalne w wybranym typie zgłoszenia. Listy podpowiadają tylko zgodne pary — pole daty przyjmie tylko datę, pole liczbowe tylko liczbę, pole tekstowe dowolne dane. Każde pole zgłoszenia może być zmapowane tylko raz. Przed mapowaniem trzeba wybrać typ zgłoszenia.
Dla nowego połączenia proponowane jest mapowanie domyślne: numer zamówienia ← Id zamówienia, data zakupu ← Data zakupu, opis ← Pozycje (podsumowanie).
Dostępne dane z Allegro:
| Grupa | Dane |
|---|---|
| Zwrot | Numer zwrotu, Id zwrotu, Status zwrotu, Data zgłoszenia zwrotu, Serwis Allegro, List przewozowy, Przewoźnik, Konto do zwrotu, Nazwa konta Allegro |
| Kupujący | Login kupującego, E-mail kupującego |
| Pozycje zwrotu | Pozycje (podsumowanie), Powody zwrotu, Komentarze kupującego, Numery seryjne, Nazwy pozycji |
| Zamówienie | Id zamówienia, Data zakupu, Kwota zamówienia, Imię, Nazwisko, Imię i nazwisko, Firma, Telefon, Ulica, Miasto, Kod pocztowy, Kraj |
Pozycje (podsumowanie) to jedna linia na każdą zwracaną pozycję w formacie Nazwa ×ilość: powód — komentarz kupującego. Dane z grup Pozycje zwrotu są łączone w jeden tekst, jeśli zwrot obejmuje kilka pozycji.
Pola zmapowane ze Statusu zwrotu, Listu przewozowego i Przewoźnika są aktualizowane przy każdej zmianie statusu zwrotu. Pozostałe pola są wypełniane tylko przy tworzeniu zgłoszenia.
Kwota zamówienia a pole Koszt
Pole Koszt przyjmuje tylko liczby całkowite, dlatego nie można do niego zmapować Kwoty zamówienia z Allegro.
Klient
Sekcja Klient określa, czy i jak zgłoszenie ma zostać powiązane z klientem:
| Tryb | Działanie |
|---|---|
| Dopasuj albo załóż | Reklamator szuka klienta powiązanego z kupującym Allegro, a następnie po adresie e-mail; jeśli go nie znajdzie, zakłada nowego klienta z danych wskazanych w mapowaniu |
| Tylko dopasuj istniejącego | Zgłoszenie jest wiązane wyłącznie z istniejącym klientem; nowi klienci nie są zakładani |
| Bez klienta | Zgłoszenie powstaje bez klienta |
W trybie zakładania klientów możesz wskazać, które dane z Allegro trafiają do pól klienta (nazwa, e-mail, telefon, telefon komórkowy, adres, NIP). Dane istniejącego klienta nie są nadpisywane.
Produkty
Opcja Dodawaj pozycje zwrotu jako produkty dodaje każdą zwracaną pozycję jako produkt zgłoszenia — z ilością i numerami seryjnymi. Produkt jest dopasowywany do katalogu po ofercie Allegro lub po kodzie produktu sprzedawcy (sygnaturze oferty); jeśli nie istnieje, jest zakładany automatycznie z nazwą z Allegro.
Podgląd zwrotów
Podgląd zwrotów pozwala przejrzeć zwroty bezpośrednio w Allegro, zanim (lub niezależnie od tego, czy) zostaną pobrane do Reklamatora. Ustaw zakres dat utworzenia oraz opcjonalnie status i kliknij Pokaż.
Tabela pokazuje numer zwrotu, datę, status, kupującego, numer zamówienia, pozycje, list przewozowy oraz informację o zgłoszeniu: link Otwórz zgłoszenie, nie zaimportowany lub zgłoszenie usunięte.
Podgląd działa także dla wstrzymanych połączeń i niczego nie importuje — dobrze nadaje się do sprawdzenia konfiguracji przed włączeniem pobierania. Allegro udostępnia ograniczoną liczbę wyników na jedno zapytanie — przy dużej liczbie zwrotów zawęź zakres dat.
Zgłoszenie ze zwrotu
Zgłoszenia utworzone ze zwrotów mają kanał Zwrot Allegro. Na karcie takiego zgłoszenia widoczna jest sekcja Zwrot Allegro z danymi: numer zwrotu, zamówienie, status, kupujący, list przewozowy, konto Allegro i data zgłoszenia zwrotu.
W historii zgłoszenia pojawiają się wpisy typu Zwrot Allegro:
- utworzenie zgłoszenia ze zwrotu (numer zwrotu, login kupującego, nazwa konta),
- każda zmiana statusu zwrotu (status poprzedni → nowy),
- zmiany pól zgłoszenia wynikające ze zmiany statusu (źródło zmiany: Zmiana z Allegro).
Jeśli zgłoszenie utworzone ze zwrotu zostanie usunięte, ten zwrot nie zostanie zaimportowany ponownie.
Statusy zwrotu
| Status | Opis |
|---|---|
| Zgłoszony | Kupujący zarejestrował zwrot |
| Nadany | Paczka zwrotna została nadana |
| W drodze | Paczka jest w transporcie |
| Dostarczony | Paczka dotarła do sprzedawcy |
| Dostarczony do magazynu Allegro | Paczka dotarła do magazynu Allegro (Allegro One Fulfillment) |
| Weryfikacja w magazynie | Zwrot jest weryfikowany w magazynie Allegro |
| Wniosek o zwrot prowizji | Złożono wniosek o zwrot prowizji |
| Zakończony | Zwrot zakończony (status końcowy) |
| Zakończony (Allegro Ochrona Kupujących) | Zwrot zakończony w ramach Allegro Ochrony Kupujących (status końcowy) |
| Odrzucony | Zwrot odrzucony (status końcowy) |
| Prowizja zwrócona | Prowizja została zwrócona (status końcowy) |
Reguły biznesowe
W regułach biznesowych dostępna jest grupa zdarzeń Allegro:
| Zdarzenie | Kiedy |
|---|---|
| Utworzenie zgłoszenia ze zwrotu Allegro | Po utworzeniu zgłoszenia ze zwrotu (dodatkowo, po zwykłym zdarzeniu Utworzenie zgłoszenia) |
| Zmiana statusu zwrotu Allegro | Po wykryciu zmiany statusu zwrotu w Allegro |
Warunek Status zwrotu Allegro (operatory równa się / nie równa się) pozwala np. wysłać klientowi wiadomość dopiero wtedy, gdy paczka zwrotna dotrze do sprzedawcy (status Dostarczony). Warunek Źródło zgłoszenia ma wartość Zwrot Allegro dla zgłoszeń z tego modułu.
Zmienne w szablonach
W szablonach wiadomości dostępna jest sekcja zmiennych Zwrot Allegro:
| Zmienna | Opis |
|---|---|
{{allegro_return_number}} | Numer zwrotu |
{{allegro_return_status}} | Status zwrotu |
{{allegro_return_reasons}} | Powody zwrotu |
{{allegro_buyer_login}} | Login kupującego |
{{allegro_waybill}} | List przewozowy |
Zmienne działają w treści i temacie wiadomości. Dla zgłoszeń, które nie pochodzą ze zwrotu Allegro, są puste.
Komunikaty o błędach
| Komunikat | Co zrobić |
|---|---|
| Allegro unieważniło dostęp — połącz konto ponownie | Kliknij Połącz ponownie przy połączeniu |
| Zalogowano na inne konto Allegro niż podłączone | Przy ponownym łączeniu zaloguj się na to samo konto Allegro |
| Osiągnięto limit kont Allegro w planie | Usuń nieużywane połączenie lub zmień plan |
| Ustaw typ zgłoszenia i organizację przed włączeniem pobierania | Uzupełnij konfigurację połączenia |
| Data startu może być najwyżej 60 dni wstecz | Ustaw późniejszą datę w polu Pobieraj zwroty utworzone od |
| Mapowanie zawiera błędy — popraw zaznaczone wiersze | Popraw wiersze mapowania oznaczone błędem (np. pole nieaktywne w typie lub niezgodny typ danych) |
| Przekroczono limit zapytań do Allegro — spróbuj za minutę | Błąd przejściowy — kolejne pobranie spróbuje ponownie |
| Anulowano autoryzację w Allegro | Autoryzacja została przerwana w Allegro — spróbuj podłączyć konto jeszcze raz |
Błędy pobierania są też widoczne w kolumnie Ostatni błąd na liście połączeń oraz w logu systemowym.
FAQ
Jak często pobierane są zwroty?
Automatycznie co około 30 minut. Jeśli potrzebujesz zwrotu od razu, użyj akcji Pobierz teraz na liście połączeń.
Czy mogę podłączyć kilka kont Allegro?
Tak, w ramach limitu planu. Każde konto ma własną konfigurację — typ zgłoszenia, organizację, właściciela i mapowanie.
Czy ten sam zwrot może utworzyć dwa zgłoszenia?
Nie. Każdy zwrot tworzy najwyżej jedno zgłoszenie — także po usunięciu i ponownym podłączeniu tego samego konta Allegro.
Co się stanie po usunięciu połączenia?
Połączenie i dostęp do konta Allegro zostaną usunięte, a pobieranie zatrzymane. Zgłoszenia utworzone wcześniej ze zwrotów pozostaną bez zmian.
Czy Reklamator zmienia coś w zwrocie na Allegro?
Nie. Moduł tylko odczytuje zwroty i zamówienia — status zwrotu zmieniają kupujący, przewoźnik i Allegro.
Czy mogę pobrać starsze zwroty?
Tak, ustawiając datę w polu Pobieraj zwroty utworzone od — najwyżej 60 dni wstecz.
Co, jeśli brakuje pola wymaganego w typie zgłoszenia?
Zgłoszenie ze zwrotu zostanie utworzone mimo braku wartości w polu wymaganym — uzupełnij je ręcznie lub dodaj je do mapowania.
Czy wstrzymane połączenie pobiera zwroty?
Nie — ani automatycznie, ani przez Pobierz teraz. Dla wstrzymanego połączenia działa tylko Podgląd zwrotów.