Integracje

Integracja z Allegro

Jak połączyć Mobilną Fakturę z Allegro. Import zamówień, automatyczne fakturowanie, lista kupujących.

Zrzuty ekranu

ℹ️ Zmiana sposobu łączenia. Allegro wyłączyło stare logowanie loginem i hasłem. Konto podłączasz teraz 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?

  • Automatyczny import zamówień z Allegro
  • Seryjne fakturowanie - fakturuj wiele zamówień jednym kliknięciem
  • Lista kupujących - pełna historia klientów z Allegro
  • Synchronizacja stanów magazynowych - sprzedaż zdejmuje stan w Mobilnej Fakturze, a nowy stan wraca do oferty na 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 → 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 → 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 wystarczy kliknąć ponownie.

💡 Dlaczego własna aplikacja? Limity zapytań do Allegro liczone są wtedy osobno dla Twojego konta, a nie dzielone z innymi użytkownikami. Cofnięcie dostępu u Ciebie nie wpływa też 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.

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: SKU musi się zgadzać

Dopasowanie idzie po sygnaturze oferty (SKU) równej kodowi towaru w cenniku. W Ustawienia → Allegro kliknij „Dopasuj towary po sygnaturze” — system 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 (Ustawienia → Allegro) zaznacz „Włącz wysyłanie stanów do Allegro” — bez tego stany nie opuszczą panelu.

Po pierwszym dopasowaniu warto kliknąć „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: sprzedaż na Allegro zdejmie stan w Mobilnej Fakturze i w sklepie, ale oferta na Allegro nadal 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ół — bezpieczniej wystawić mniej niż sprzedać towar, którego nie ma.

Import zamówień

Automatyczny import

  1. Włącz Automatyczny import w ustawieniach
  2. Nowe zamówienia będą pobierane co godzinę
  3. Znajdziesz je w module AllegroZamówienia

Ręczny import

  1. Przejdź do AllegroZamówienia
  2. Kliknij Synchronizuj
  3. Wybierz okres do importu
  4. Pobrane zamówienia pojawią się na liście

Wystawianie faktur

Pojedyncza faktura

  1. Znajdź zamówienie na liście
  2. Kliknij Wystaw fakturę
  3. Sprawdź dane i zapisz

Seryjne fakturowanie

  1. Zaznacz zamówienia (checkbox)
  2. Kliknij AkcjeWystaw faktury zbiorczo
  3. Potwierdź - system wygeneruje faktury dla wszystkich zaznaczonych

Dane kupującego

Przy wystawianiu faktury system pobiera:

  • Imię i nazwisko / nazwę firmy
  • Adres dostawy lub firmy
  • NIP (jeśli kupujący podał)
  • Email do wysyłki faktury

Brak NIP na zamówieniu?

Jeśli kupujący nie podał NIP przy zamówieniu:

  • Możesz wysłać prośbę o NIP przez Allegro
  • Lub wystawić fakturę na osobę fizyczną

Lista kupujących

W zakładce Kupujący znajdziesz:

  • Wszystkich klientów, którzy kupili na Allegro
  • Historię zamówień każdego klienta
  • Łączną wartość zakupów

Rozwiązywanie problemów

”Błąd autoryzacji”

  • Ponownie połącz konto Allegro
  • Sprawdź czy nie zmieniłeś hasła

”Zamówienie już zafakturowane”

  • Faktura dla tego zamówienia już istnieje
  • Sprawdź w liście dokumentów

”Brak danych adresowych”

  • Kupujący nie podał pełnych danych
  • Skontaktuj się z kupującym przez Allegro

Zobacz także