Mobilna Faktura
Zaloguj
Integracje

Integracja z Allegro

Jak połączyć Mobilną Fakturę z Allegro (własna aplikacja OAuth2), przeglądać zamówienia i kupujących, wystawiać do nich faktury i wysyłać stany magazynowe do ofert (pakiet Max).

Zrzuty ekranu

Screenshot 1 - Integracja z Allegro

ℹ️ Zmiana sposobu łączenia. Allegro wyłączyło logowanie loginem i hasłem. Konto podłączasz przez oficjalne API Allegro (OAuth2) — wymaga to jednorazowej rejestracji własnej aplikacji, opisanej niżej. Konta połączone starym sposobem trzeba podłączyć ponownie.

Co daje integracja z Allegro?

Pakiet Max.

  • Lista zamówień z Allegro i lista kupujących,
  • faktura do zamówienia z danymi kupującego i pozycjami zamówienia,
  • synchronizacja stanów magazynowych — stan z panelu trafia do ofert na Allegro.

Menu: Sklepy → Allegro (Lista zamówień, Lista kupujących). Konfiguracja: Ustawienia → Integracje → Allegro.

Połączenie konta

Krok 1: Zarejestruj aplikację w Allegro

Robisz to raz, na swoim koncie Allegro:

  1. Wejdź na apps.developer.allegro.pl i zaloguj się (wymagane logowanie dwuskładnikowe).
  2. Dodaj nową aplikację, wybierz typ z dostępem do przeglądarki.
  3. Jako adres URI do przekierowania wklej adres podany w panelu (Ustawienia → Integracje → Allegro — jest tam gotowy do skopiowania).
  4. Zaznacz uprawnienia: odczyt zamówień, odczyt i zapis ofert oraz odczyt danych konta (profile:read — dzięki niemu panel pokaże, które konto Allegro jest podłączone).
  5. Po zapisaniu skopiuj nazwę aplikacji, Client ID i Client Secret.

Krok 2: Wklej dane w panelu

  1. Wejdź w Ustawienia → Integracje → Allegro i kliknij Dodaj konto.
  2. Wpisz nazwę aplikacji, Client ID i Client Secret, zapisz.
  3. Kliknij Połącz z Allegro i zatwierdź dostęp na Allegro.

Nazwa aplikacji musi zgadzać się co do znaku z tą z Allegro. Allegro sprawdza ją przy każdym zapytaniu i od 30 czerwca 2026 odrzuca połączenia, w których się nie zgadza.

Połączenie odnawia się samo. Jeśli zmienisz hasło w Allegro albo cofniesz dostęp aplikacji, konto pokaże się jako Wymaga ponownego połączenia — wtedy kliknij Połącz z Allegro jeszcze raz.

💡 Dlaczego własna aplikacja? Limity zapytań do Allegro liczone są osobno dla Twojego konta, a cofnięcie dostępu u Ciebie nie wpływa na nikogo innego.

Masz kilka kont sprzedażowych? Dodaj je osobno — każde ma własne dane aplikacji. Synchronizacja stanów wysyła je do ostatnio połączonego konta; żeby zmienić cel, połącz właściwe konto ponownie. Do testów możesz zaznaczyć środowisko testowe (Allegro Sandbox); wymaga osobnego konta i osobnej aplikacji zarejestrowanej w sandboxie.

Zamówienia i faktury

  1. Sklepy → Allegro → Lista zamówień.
  2. Wybierz Konto (gdy masz kilka) — zamówienia ładują się z Allegro.
  3. Zaznacz jedno zamówienie i kliknij:
    • Wystaw — panel od razu wystawia fakturę,
    • Edytuj — otwiera formularz faktury wypełniony danymi zamówienia, żeby go sprawdzić lub poprawić przed zapisem.

Faktury wystawiasz po jednej — zbiorczego fakturowania zaznaczonych zamówień nie ma. Do tego samego zamówienia nie powstanie druga faktura: przy ponownej próbie panel poinformuje, że faktura była już wystawiona (z jej numerem).

Lista kupujących

Sklepy → Allegro → Lista kupujących — login kupującego, wartość zamówienia i data ostatniego zamówienia. Tu również działają przyciski Edytuj i Wystaw dla zaznaczonego kupującego.

Synchronizacja stanów magazynowych (Max)

Działa tak samo jak dla WooCommerce: stan zmieniony w Mobilnej Fakturze trafia do kolejki i jest wysyłany do ofert Allegro w ciągu kilku minut.

Warunek: sygnatura oferty = kod towaru

Dopasowanie idzie po sygnaturze oferty (SKU) równej kodowi towaru w kartotece. W Ustawienia → Integracje → Allegro kliknij Dopasuj towary po sygnaturze — panel pobierze Twoje oferty i powiąże je z kartotekami.

Oferty bez sygnatury nie zostaną dopasowane, więc ich stan nie będzie synchronizowany.

Włącz wysyłanie stanów

Samo dopasowanie nie uruchamia synchronizacji. W tym samym miejscu zaznacz Włącz wysyłanie stanów do Allegro.

Po pierwszym dopasowaniu kliknij Wyślij wszystkie stany teraz, żeby nie czekać, aż każdy towar zmieni się z osobna.

Dlaczego to ważne przy dwóch kanałach sprzedaży

Jeśli sprzedajesz ten sam towar w sklepie i na Allegro, sama synchronizacja sklepu nie wystarczy: oferta na Allegro pokazywałaby starą ilość. Dopiero wysyłanie stanów w stronę Allegro zamyka tę lukę.

💡 Allegro operuje na pełnych sztukach, więc ilości ułamkowe zaokrąglane są w dół.

Rozwiązywanie problemów

„Wymaga ponownego połączenia” / błąd autoryzacji

  • Kliknij Połącz z Allegro jeszcze raz.
  • Sprawdź, czy nazwa aplikacji w panelu zgadza się z tą w Allegro.

„Faktura była już wystawiona”

  • Do zamówienia istnieje już faktura — znajdziesz ją na Liście dokumentów.

Stan nie zmienia się na Allegro

  • Sprawdź, czy oferta ma sygnaturę równą kodowi towaru i czy zaznaczone jest Włącz wysyłanie stanów do Allegro.

Zobacz także