Faktura do zamówienia na Allegro to jedna z tych czynności, które w małym sklepie robi się ręcznie, a w większym zaczynają zabierać godziny: wystawić dokument, pobrać PDF, otworzyć zamówienie, dołączyć plik. Integracja może zrobić to sama. W 2026 roku zmieniły się jednak dwie rzeczy naraz: Allegro wprowadziło nowy sposób dodawania faktur przez API, a firmy weszły w obowiązek KSeF.
To nie jest porada podatkowa. Terminy KSeF podajemy za stroną Ministerstwa Finansów. O tym, jakie dokumenty i w jakiej formie przekazać kupującemu, rozstrzyga księgowy albo doradca podatkowy. My opisujemy stronę techniczną.
Skąd integracja bierze dane do faktury
Allegro prowadzi dziennik zdarzeń zamówień. Integracja czyta go porcjami i czeka na zdarzenie „gotowe do realizacji” (READY_FOR_PROCESSING). Dopiero wtedy adres i dane do faktury są pewne. Wcześniej kupujący może je jeszcze zmienić.
Szczegóły zamówienia pobiera się osobno. Dane do faktury stoją w nich w osobnym bloku (invoice). To z niego program do faktur dostaje dane nabywcy.
Dwie praktyczne uwagi:
- zdarzenia mogą przyjść w innej kolejności i w duplikatach, więc integracja musi pamiętać, do których zamówień faktura już powstała;
- dziennik zdarzeń sięga 60 dni wstecz, więc integracja, która stała dłużej, nie odtworzy z niego wszystkiego.
Nowy sposób: plik PDF albo link
Allegro ma dziś dwie drogi dodania dokumentu do zamówienia:
| Droga | Co przyjmuje | Ograniczenia |
|---|---|---|
Plik (POST /order/{orderId}/billing-documents/files) |
dokument wysłany jako plik | tylko PDF, najwyżej 3 MB; numer faktury bywa wymagany |
Link (POST /order/{orderId}/billing-documents/links) |
adres paragonu albo faktury | najwyżej 10 linków na zamówienie, tylko z domen z listy Allegro |
Po ludzku: albo integracja wysyła sam plik, albo tylko adres, pod którym kupujący go znajdzie. Link jest wygodny, jeśli program do faktur przechowuje dokumenty online, ale jego domena musi być na liście zatwierdzonej przez Allegro. Którą drogę wybrać, zależy więc od programu do faktur, a nie od preferencji.
Czy do zamówienia dodano już dokument spoza Allegro, integracja sprawdza w liście faktur zamówienia (pole hasExternalInvoices).
Stary sposób oznaczony jako wycofywany
Wcześniej faktury dodawało się przez POST /order/checkout-forms/{id}/invoices, a plik wgrywało osobnym zapytaniem PUT .../invoices/{invoiceId}/file. Oba zasoby Allegro oznaczyło w dokumentacji jako wycofywane (Deprecated).
Co to oznacza w praktyce: integracje zbudowane wcześniej działają dziś na zasobach, które Allegro planuje usunąć. Daty wyłączenia nie ma w źródłach, z których korzystaliśmy, dlatego warto ją sprawdzić w dokumentacji Allegro i zaplanować przejście, zanim stary sposób przestanie działać.
KSeF: terminy według Ministerstwa Finansów
Krajowy System e-Faktur to system Ministerstwa Finansów do wystawiania i odbierania faktur ustrukturyzowanych. Według strony KSeF obowiązek wystawiania faktur w KSeF obowiązuje:
- od 1 lutego 2026 roku dla firm, które w 2024 roku miały sprzedaż powyżej 200 mln zł (z VAT);
- od 1 kwietnia 2026 roku dla pozostałych.
Do 31 grudnia 2026 roku można jeszcze wystawiać faktury poza KSeF (papierowe albo elektroniczne), jeśli suma sprzedaży z VAT na takich fakturach w danym miesiącu nie przekroczy 10 000 zł. Limit dotyczy każdego miesiąca osobno.
Szczegóły i wyjątki są na stronie KSeF. Jeśli nie wiadomo, czy wyjątek dotyczy Twojej firmy, to pytanie do księgowego.
Jak połączyć jedno z drugim
KSeF i Allegro to dwa różne miejsca:
- KSeF to miejsce, w którym faktura powstaje i jest przechowywana jako dokument podatkowy;
- Allegro to miejsce, w którym kupujący widzi dokument dołączony do zamówienia.
Integracja z Allegro nie zastępuje programu do faktur ani połączenia z KSeF. Spina je w jeden przepływ:
- Zamówienie na Allegro dostaje zdarzenie „gotowe do realizacji”.
- Integracja pobiera dane do faktury i przekazuje je do programu do faktur.
- Program wystawia fakturę, w KSeF, jeśli obowiązek już Cię dotyczy.
- Integracja pobiera z programu PDF albo link i dodaje go do zamówienia na Allegro.
- Integracja zapisuje, że faktura do tego zamówienia już jest, żeby nie dodać jej drugi raz.
Na wyszukiwanie „integracja Allegro z programem do faktur” Google pokazywał 23.10.2026 głównie strony programów do faktur, m.in. Fakturowni, Fakturowo i Afaktury. Jeśli Twój program ma połączenie z Allegro i robi wszystkie pięć kroków, osobna integracja nie jest potrzebna. Ma sens wtedy, gdy program nie ma wtyczki, gdy faktury powstają w innym systemie (np. w programie magazynowym) albo gdy przepływ obejmuje też korekty po zwrotach. API Allegro podaje zwroty klientów, więc korekta może powstać z danych zwrotu.
Pytania
Czy integracja może sama dodać fakturę do zamówienia na Allegro?
Tak. API przyjmuje plik PDF do 3 MB albo link do dokumentu (do 10 linków na zamówienie, z domen z listy Allegro). Fakturę wystawia program do faktur, a integracja dołącza ją do zamówienia.
Czy faktury z Allegro trafiają do KSeF?
Pytanie ma dwa znaczenia. Faktury sprzedaży dla kupujących wystawia sprzedawca, więc o KSeF decydują jego obowiązek i jego program do faktur. Allegro przyjmuje do zamówienia plik albo link. Faktury, które Allegro wystawia sprzedawcy za swoje opłaty, to osobne dokumenty, opisane w pomocy Allegro.
Jaki program do faktur można zintegrować z Allegro?
W wynikach wyszukiwania na to pytanie stoją głównie strony programów do faktur; zakres ich połączenia z Allegro trzeba sprawdzić u producenta. Z technicznego punktu widzenia da się połączyć każdy program, który pozwala pobrać fakturę jako PDF albo link, przez jego API albo eksport.
Jak zrobić integrację z KSeF?
Najprościej przez program do faktur, który sam łączy się z KSeF. Własne połączenie z KSeF to osobny projekt. Integracja z Allegro przenosi wtedy dane zamówienia do programu i gotowy dokument z powrotem na Allegro.
Co, jeśli PDF faktury ma więcej niż 3 MB?
Trzeba go zmniejszyć albo dodać link do dokumentu, jeśli domena programu do faktur jest na liście Allegro.
Faktury, zamówienia, magazyn i Allegro w jednym przepływie to typowy zakres integracji Allegro na zamówienie. Masz taki proces? Opisz go, a dopytamy o szczegóły.
Źródła (odczyt 23.10.2026): Allegro: obsługa zamówień, Allegro: dokumentacja REST API, KSeF: od kiedy trzeba wystawiać faktury w KSeF.