Narzędzie wewnętrzne · AlphaCar

Weryfikator Zwrotów Allegro

Skrypt automatycznie sprawdza czy dla każdego zamówienia z Sellasist wykonano zwrot w Allegro — i czy kwoty się zgadzają. Koniec z ręcznym klikaniem po każdym zamówieniu.

logowanie
na sesję
zamówień
w pliku
0
ręcznych
sprawdzeń
allegro_zwroty.py — Python 3.13
Podgląd działania skryptu — terminal z postępem pobierania zwrotów
01 / Zastosowania

Do czego
możesz to użyć?

01

Weryfikacja „Zwrotów zrealizowanych"

Sprawdź czy każde zamówienie oznaczone jako zrealizowane faktycznie ma wykonany zwrot w Allegro i czy kwota się zgadza.

02

Weryfikacja „Zwrotów oczekujących"

Znajdź zamówienia które są w kolejce — i sprawdź które faktycznie czekają, a które może już zostały obsłużone.

03

Kontrola pracy pracownika

Wygeneruj listę zamówień obsługiwanych przez konkretną osobę i sprawdź czy wszystkie zostały prawidłowo przeniesione do odpowiednich statusów.

04

Dowolna lista zamówień

Skrypt działa z każdym eksportem z Sellasist niezależnie od statusu. Eksportuj co chcesz — skrypt sprawdzi stan zwrotów w Allegro dla każdego wiersza.

05

Wykrywanie nadpłat

Znajdź przypadki gdy zwrócono więcej niż wynosi wartość zamówienia — błędy które trudno wychwycić ręcznie.

06

Audyt okresowy

Uruchamiaj skrypt raz w tygodniu lub miesiącu jako kontrolę stanu zwrotów. Wynik trafia do CSV gotowego do archiwizacji.

02 / Instrukcja

Krok po kroku

Zainstaluj Python

Pobierz Python 3.10 lub nowszy ze strony python.org. Podczas instalacji zaznacz „Add to PATH".

Zainstaluj bibliotekę

Otwórz wiersz poleceń i wpisz:

Eksportuj z Sellasist

Lista zamówień → filtruj według potrzeb → Eksportuj CSV. Zapisz plik w łatwo dostępnym miejscu.

Uruchom skrypt

Otwórz folder ze skryptem w wierszu poleceń i wpisz: python allegro_zwroty.py

Zaloguj się do Allegro

Skrypt automatycznie otworzy przeglądarkę. Kliknij „Zezwól" i wróć do okna skryptu.

Odbierz wynik

W folderze skryptu pojawi się plik CSV z analizą. Otwórz go w Excelu (separator: średnik).

# Instalacja jednorazowa
pip install requests

# Uruchomienie
python allegro_zwroty.py

Przy pierwszym uruchomieniu musisz założyć aplikację w panelu Allegro Developer (apps.developer.allegro.pl) i podać jej Client ID oraz Client Secret. Szczegółowe instrukcje znajdziesz w pliku README.md.

03 / Wyniki

Co znaczą
poszczególne statusy?

Status Kolumna AKCJA Co oznacza Co zrobić
PEŁNY ✅ OK — PRZENIEŚ DO ZREALIZOWANYCH Zwrot wykonany, kwota się zgadza Przenieś zamówienie do zrealizowanych
BRAK ZWROTU → PRZENIEŚ DO OCZEKUJĄCYCH W Allegro brak jakiegokolwiek zwrotu dla tego zamówienia Sprawdź zamówienie ręcznie, wykonaj zwrot jeśli należy
CZĘŚCIOWY → SPRAWDŹ (brakuje X PLN) Zwrot wykonany, ale kwota jest niższa niż wartość zamówienia Sprawdź czy celowo zwrócono tylko część kwoty
NADPŁATA → SPRAWDŹ (nadpłata X PLN) Zwrócono więcej niż wynosi wartość zamówienia Sprawdź czy nie był to błąd — podwójny zwrot lub zła kwota
BŁĄD API → SPRAWDŹ RĘCZNIE Skrypt nie mógł pobrać danych dla tego zamówienia z API Allegro Sprawdź zamówienie ręcznie w panelu Allegro
04 / Pytania

Najczęstsze
pytania

Jak długo trwa działanie skryptu?
Zależy od liczby zamówień i zwrotów na koncie. Pobranie wszystkich zwrotów z API to zazwyczaj kilkadziesiąt sekund. Następnie skrypt sprawdza ~3 zamówienia na sekundę. Dla 300 zamówień — około 2 minuty. Dla 1000 zamówień — około 6 minut. Nie zamykaj okna konsoli podczas działania.
Czy muszę się logować za każdym razem?
Tak — każde uruchomienie skryptu wymaga jednorazowego kliknięcia „Zezwól" w przeglądarce Allegro. To wymóg bezpieczeństwa API Allegro. Zajmuje to około 10 sekund.
Gdzie zapisują się wyniki?
W tym samym folderze co plik skryptu (allegro_zwroty.py). Tworzą się dwa pliki: wynik_zwroty_DATA_GODZINA.csv z analizą zamówień oraz wszystkie_zwroty_DATA_GODZINA.csv z pełną listą zwrotów z Allegro.
Plik CSV nie otwiera się poprawnie w Excelu
Pliki wynikowe używają separatora średnik (;) i kodowania UTF-8. W Excelu: Dane → Z tekstu/CSV → wybierz plik → ustaw separator „Średnik" → Załaduj. Ewentualnie otwórz plik w LibreOffice Calc — wykryje separator automatycznie.
Skrypt mówi „Brak kolumn w pliku"
Upewnij się że wrzucasz plik eksportowany bezpośrednio z Sellasist bez żadnych zmian. Nie otwieraj i nie zapisuj go ponownie w Excelu przed uruchomieniem — Excel może zmienić kodowanie lub separator.
Wszystkie zamówienia mają „BRAK ZWROTU" mimo że zwroty były wykonane
Sprawdź plik wszystkie_zwroty_...csv — czy zawiera jakiekolwiek dane. Jeśli jest pusty, problem leży po stronie uprawnień aplikacji Allegro (musi mieć dostęp do allegro:api:payments:read). Jeśli plik ma dane, zgłoś problem do osoby odpowiedzialnej za automatyzację.
Czy skrypt modyfikuje cokolwiek w Allegro lub Sellasist?
Nie. Skrypt wyłącznie odczytuje dane — nie wykonuje żadnych zmian, nie wysyła zwrotów, nie modyfikuje statusów. Jedyne co tworzy to pliki CSV na Twoim komputerze.