Fakturownia integracja ze sklepem - wtyczki i API
Dla sklepów internetowych Fakturownia ma gotowe integracje z popularnymi platformami, m.in. Shoper, WooCommerce, PrestaShop i Shopify, a przy płatnościach przez Stripe - automatyczne fakturowanie i import płatności. Gotowa integracja przenosi dane zamówienia do Fakturowni i pozwala wystawić dokument bez kopiowania danych. Przed uruchomieniem ustal, w którym momencie ma powstać faktura: po złożeniu zamówienia, po opłaceniu czy po wysyłce. Przy płatności za pobraniem i przy zamówieniach anulowanych zbyt wczesne wystawienie faktury oznacza później dodatkowe korekty, dlatego bezpieczniej wiązać dokument z opłaceniem lub wysyłką.
Kiedy wybrać API Fakturowni?
API Fakturowni jest otwarte i dobrze udokumentowane, z autoryzacją tokenem i przykładami zapytań. Wybierasz je, gdy sklep działa na własnym silniku, sprzedajesz subskrypcje albo usługi z własnego systemu lub potrzebujesz nietypowej logiki, na przykład osobnej serii faktur dla każdej marki. API wymaga jednak programisty, testów i utrzymania: każda zmiana w sklepie czy w przepisach może oznaczać poprawki w kodzie.
Zalety API - pełna kontrola nad tym, kiedy i jaki dokument powstaje, brak zależności od wtyczki.
Wady API - koszt programisty, odpowiedzialność za błędy i aktualizacje, brak gotowej obsługi zwrotów.
Dla kogo - sklepy na własnym silniku, platformy usługowe, firmy z działem IT.
Fakturownia i Base - integracja przez integrator
Base to integrator, który zbiera zamówienia z Allegro, sklepów i marketplace'ów w jednym panelu i obsługuje wysyłki, stany oraz dokumenty. Integracja Base z Fakturownią według opisu Base pozwala ustawić reguły, po których Base automatycznie tworzy fakturę lub paragon w Fakturowni, na przykład po opłaceniu zamówienia albo zmianie statusu. Dokumenty można też tworzyć dla wielu zamówień naraz, a kopie wysyłać klientom automatycznie.
Ważna funkcja przy Allegro to korekty: po zwrocie Base przygotowuje korektę na podstawie danych z Allegro i przekazuje ją do Fakturowni. Porównanie obu dróg dla sprzedawcy Allegro pokazuje poniższe zestawienie.
[#chart:ksg44b]
Przy Base kluczowa zasada brzmi: dokumenty do zamówień z Allegro wystawia albo Base, albo aplikacja Allegro w Fakturowni - nigdy obie naraz. Inaczej do jednego zamówienia powstaną dwie faktury z dwoma numerami, a obie mogą trafić do KSeF.
Aplikacja Allegro, API czy integrator - porównanie
Tabela zbiera najważniejsze różnice między ścieżkami połączenia Fakturowni z kanałami sprzedaży.
| Kryterium | Aplikacja Allegro / wtyczka sklepu | API Fakturowni | Base + Fakturownia |
|---|
| Liczba kanałów | Jeden lub dwa | Dowolna, ale każdy trzeba oprogramować | Wiele marketplace'ów i sklepów |
| Gdzie obsługujesz zamówienia | Na Allegro lub w panelu sklepu | We własnym systemie | W Base |
| Stany magazynowe | Allegro, sklep lub magazyn Fakturowni | Według własnej logiki | W Base, synchronizowane z kanałami |
| Korekty po zwrotach | Korekta wystawiana w Fakturowni | Według własnej logiki | Korekta przygotowana w Base na danych z Allegro |
| Koszt | W ramach planu Fakturowni | Praca programisty i utrzymanie | Plan Fakturowni + abonament Base |
| Dla kogo | Start, jeden kanał | Sklep na własnym silniku | Sprzedaż wielokanałowa |
Jak skonfigurować Fakturownię z Base krok po kroku?
Integracja Base z Fakturownią wymaga kilku decyzji, zanim powstanie pierwszy dokument. Najważniejsze to: który system jest źródłem stanów, przy jakim statusie powstaje faktura i kto wysyła dokumenty do KSeF. Kolejność wdrożenia pokazuje diagram.
[#chart:ksg44c]
[#uwaga] Zanim włączysz integrację Base z Fakturownią, wyłącz automatyczne wystawianie faktur w aplikacji Allegro w Fakturowni dla tych samych kont. Sprawdź też, czy działy w Fakturowni mają osobne formaty numeracji, jeśli Base ma wystawiać dokumenty w różnych seriach dla różnych kanałów.
Szczegółowe porównanie integracji Base z popularnymi programami do faktur znajdziesz we wpisie Base i program do faktur - integracja z Fakturownią, wFirma i inFaktem. Jeśli Fakturownia przestaje wystarczać i rozważasz system ERP, przeczytaj, kiedy integracja Base z ERP jest potrzebna i jak ją zaplanować.
Fakturownia integracja a KSeF - kto wysyła e-faktury?
Od 1 kwietnia 2026 roku większość firm wystawia faktury w KSeF (stan na lipiec 2026 - sprawdź aktualne przepisy). Fakturownia ma integrację z KSeF w każdym planie i może wysyłać faktury automatycznie zaraz po ich zapisaniu, jeśli użytkownik ma uprawnienia do KSeF. Gdy dokument tworzy integracja - aplikacja Allegro, wtyczka sklepu albo Base - faktura i tak powstaje w Fakturowni, więc to Fakturownia wysyła ją do KSeF według ustawień integracji.
Trzeba jednak pilnować dwóch rzeczy. Po pierwsze, uprawnienia: jeśli integracja działa na koncie użytkownika bez prawa wysyłki do KSeF, faktury nie wyjdą automatycznie. Po drugie, jedno miejsce wysyłki: jeśli inny system też ma połączenie z KSeF, ustal, który wysyła dokumenty, żeby uniknąć duplikatów.
Jak wybrać integrację Fakturowni do skali sprzedaży?
Wybór najlepiej oprzeć na tym, jak wygląda Twoja sprzedaż dziś i za rok. Proste reguły, które sprawdzają się w praktyce:
Tylko Allegro, jedno konto - aplikacja Allegro w Fakturowni, paragony przez Paragony.pl.
Allegro i jeden sklep na popularnej platformie - aplikacja Allegro i wtyczka sklepu, osobne serie numeracji w działach.
Kilka kanałów albo kilka kont Allegro - Base jako centrum zamówień, Fakturownia jako program do dokumentów.
Sklep na własnym silniku - API Fakturowni albo połączenie sklepu z Base, jeśli Base ma do niego integrację.
Sprzedaż za granicę na kilku marketplace'ach - Base, waluty i OSS ustawione w Fakturowni.
[#przyklad] Przykład: sprzedawca zaczynał na jednym koncie Allegro z aplikacją Allegro w Fakturowni. Po roku doszedł sklep na Shoperze, Empik Place i drugie konto Allegro. Zamówienia przeniósł do Base, w Fakturowni wyłączył automatyczne faktury z aplikacji Allegro, a w Base ustawił reguły: faktura po opłaceniu zamówienia, osobna seria numeracji dla każdego kanału, korekta po zwrocie. Fakturownia nadal wysyła dokumenty do KSeF i daje dostęp księgowej.
Paragony i faktury do paragonów w integracji z Fakturownią
Sprzedawca konsumencki musi zdecydować, czy zamówienie dokumentuje paragonem, czy fakturą. W Fakturowni automatyczne paragony wymagają modułu Paragony.pl, który obsługuje drukarki fiskalne Posnet, Novitus i Elzab oraz e-paragony. Przy integracji przez Base reguły mogą rozróżniać zamówienia z prośbą o fakturę od pozostałych, którym wystawiany jest paragon.
Gdy klient firmowy po zakupie prosi o fakturę do paragonu, według informacji Fakturowni wystawia się ją w KSeF z oznaczeniem FP. Do końca 2026 roku paragony z NIP do 450 zł nie są wysyłane do KSeF (stan na lipiec 2026 - sprawdź aktualne przepisy). Takie prośby najlepiej obsługiwać jednym, opisanym procesem, żeby nie wystawić faktury podwójnie.
Najczęstsze problemy z integracją Fakturowni i jak im zapobiec
Integracje rzadko psują się same z siebie. Zwykle problem wynika z ustawień, które ktoś zmienił w jednym systemie, nie sprawdzając drugiego. Najczęstsze sytuacje to:
Podwójne faktury - aktywna aplikacja Allegro i reguła w Base dla tych samych zamówień.
Faktura nie powstaje - zamówienie nie osiąga statusu wybranego w ustawieniach integracji, na przykład przy płatności za pobraniem.
Faktury nie trafiają do KSeF - integracja działa na użytkowniku bez uprawnień do wysyłki.
Zła stawka VAT - produkt w sklepie lub w Base ma inną stawkę niż w Fakturowni, a przy OSS nie ustawiono kraju.
Wygasła autoryzacja - po zmianie hasła lub uprawnień konta Allegro trzeba ponownie połączyć integrację.
Dlatego po każdej zmianie w integracji - nowym kanale, nowym statusie czy nowym użytkowniku - warto przepuścić przez system jedno testowe zamówienie i sprawdzić dokument, jego numer i status KSeF.
Jak Vinson pomaga zintegrować Fakturownię z Allegro i sklepem
Vinson to agencja e-commerce z Bochni, działająca od 2021 roku: certyfikowany partner Base, Allegro Ads Partner+, Google Partner, Meta Business Partner, partner Empik Place i autoryzowany partner Shoper. Nie jesteśmy partnerem Fakturowni. Wdrażamy i integrujemy Fakturownię ze sklepem, Allegro, marketplace'ami i Base: dobieramy ścieżkę integracji do skali sprzedaży, ustawiamy reguły faktur, paragonów i korekt, numerację oraz wysyłkę do KSeF. Na bezpłatnej konsultacji podpowiemy, która integracja będzie dla Ciebie najprostsza w utrzymaniu.
Najczęściej zadawane pytania
Jak zintegrować Fakturownię z Allegro?
W Fakturowni wejdź w Ustawienia > Integracje i dodatki, znajdź Allegro i kliknij Aktywuj. Następnie wygeneruj kod autoryzacyjny w Allegro, połącz konto i wybierz statusy zamówień, przy których mają powstawać faktury. Integracja jest według producenta dostępna w każdym planie.
Czy Fakturownia wysyła faktury do Allegro?
Tak, według producenta po wystawieniu faktury przez aplikację Allegro system automatycznie przesyła ją do Allegro i podpina pod zamówienie. Kupujący widzi dokument w swoim koncie, więc nie trzeba wysyłać go osobno ani wgrywać ręcznie w panelu sprzedawcy. Paragony automatyczne wymagają modułu Paragony.pl.
Czy Fakturownia działa z Base?
Tak, Base ma integrację z Fakturownią. Base tworzy faktury i paragony w Fakturowni według reguł, na przykład po opłaceniu zamówienia, i przygotowuje korekty po zwrotach z Allegro. To najlepsza opcja przy sprzedaży w wielu kanałach.
Czy mogę używać jednocześnie aplikacji Allegro w Fakturowni i Base?
Nie do wystawiania dokumentów dla tych samych zamówień. Jeśli obie integracje będą aktywne dla jednego konta Allegro, do zamówienia mogą powstać dwie faktury. Wybierz jedno źródło dokumentów - przy wielu kanałach zwykle jest to Base.
Kiedy warto użyć API Fakturowni?
API ma sens, gdy sklep działa na własnym silniku albo potrzebujesz nietypowej logiki wystawiania dokumentów. Wymaga programisty i utrzymania przy każdej zmianie w sklepie lub przepisach. Przy popularnych platformach sklepowych i marketplace'ach zwykle szybciej działa gotowa integracja lub Base.
Chcesz wybrać właściwą integrację Fakturowni dla swojej sprzedaży? Umów bezpłatną konsultację z Vinson. Więcej o automatyzacji dokumentów przeczytasz w artykule automatyczne fakturowanie zamówień z Allegro i sklepu.
