Integracje

Połącz program do fakturowania

Połącz Fakturownię, wFirmę, iFirmę, inFakt, ING Księgowość lub fakturowanie Stripe, ustaw opcje VAT i konto domyślne oraz połącz konto ponownie, gdy klucz API lub token przestanie działać.

5 min czytaniaOstatnia aktualizacja: 30 wrz 2026

Po połączeniu programu do fakturowania Zanfia może wystawiać fakturę do każdego opłaconego zamówienia na Twoim własnym koncie w tym programie. Ta strona opisuje samo połączenie: dane, których wymaga każdy dostawca, opcje VAT, konto domyślne i to, co zrobić, gdy klucz przestanie działać. Jak faktury są potem wystawiane, wysyłane i poprawiane, opisuje artykuł Automatyczne faktury.

1

Otwórz zakładkę Faktury

W menu otwórz Integracje i wybierz Faktury (/integrations/invoices). Sekcja Fakturowanie lokalne zawiera Fakturownię, iFirmę, inFakt, wFirmę i ING Księgowość; sekcja Fakturowanie globalne zawiera Stripe. Kliknij Połącz na karcie swojego dostawcy. Okno ma tytuł Połącz z nazwą dostawcy.

2

Nazwij konto

Pole Nazwa konta jest wypełnione nazwą dostawcy. „Nazwa jest dla odróżnienia zapisanych kont”; zmień ją, jeśli planujesz połączyć więcej niż jedno konto tego samego dostawcy. Później nie da się jej edytować.

3

Wklej dane dostępowe

Wypełnij pola wymienione dla Twojego dostawcy w tabeli poniżej. Pola z podpowiedzią Gdzie to znajdę? pokazują krótkie kroki i link, który otwiera stronę dostawcy w nowej karcie.

4

Ustaw opcje VAT

Zostaw zaznaczone Płatnik VAT, jeśli naliczasz VAT, i ustaw pole Domyślna stawka VAT (na początku 23%). Odznacz je, jeśli korzystasz ze zwolnienia, i wypełnij pole Podstawa prawna zwolnienia z VAT (na początku „Art. 113 ust. 1”; inFakt podaje listę do wyboru). iFirma i inFakt pokazują też opcje Wysyłaj faktury B2B do KSeF (domyślnie włączona) i Wysyłaj faktury B2C do KSeF (domyślnie wyłączona).

5

Zapisz i ustaw konto domyślne

Kliknij Zapisz. Karta przechodzi do sekcji Połączone. Następnie kliknij Zarządzaj na karcie i przy koncie użyj opcji Ustaw jako domyślny system fakturowy. Potwierdzenie wyjaśnia: „Koszyki bez własnego ustawienia fakturowania zaczną wystawiać faktury z tego konta.” Karta pokazuje potem Domyślne z nazwą konta. Połączona karta z napisem Brak domyślnego konta nie ma ustawionego konta domyślnego. Przy jednym połączonym koncie koszyki bez własnego ustawienia fakturowania i tak z niego korzystają. Przy kilku kontach bez domyślnego zamówienie z koszyka, który nie wybrał żadnego, nie dostaje faktury i pokazuje Błąd wystawienia, dlatego ustaw konto domyślne albo wybierz konto w każdym koszyku.

Warto wiedzieć

Możesz połączyć kilka kont, także tego samego dostawcy: kliknij Zarządzaj, potem Dodaj konto. Każdy koszyk może korzystać z konta domyślnego albo z własnego, ustawionego w sekcji Fakturowanie koszyka.

Dane dostępowe każdego dostawcy

DostawcaPola w formularzuGdzie je znaleźć
FakturowniaAdres url do API, Klucz API/API Token, Id oddziału (opcjonalne)Adres to strona Twojej firmy w Fakturowni, na przykład https://zanfia.fakturownia.pl. Token znajdziesz w Fakturowni w sekcji Ustawienia → API. Id oddziału to liczba, nie nazwa.
wFirmaId firmy, Klucz dostępu (Access key), Poufny klucz API (secret key)W wFirma: Ustawienia → Bezpieczeństwo → Aplikacje → Klucze API. Poufny klucz wyświetla się jednorazowo, zaraz po utworzeniu klucza API.
iFirmaLogin konta, Klucz autoryzacji (faktura), Klucz autoryzacji (abonent)Login to najczęściej Twój adres e-mail w iFirma. Oba klucze są w iFirma w zakładce API, w podstawowych kluczach autoryzacji; jeśli ich nie masz, najpierw je wygeneruj.
inFaktKlucz API/API TokenW inFakt w sekcji Ustawienia → API.
ING KsięgowośćKlucz API/API Token, Numer rachunku bankowegoKlucz wygenerujesz w ING Księgowość: Dane i Ustawienia → Integracje → OpenAPI. Numer rachunku to rachunek sprzedawcy drukowany na każdej fakturze.
StripeBrakFakturowanie Stripe korzysta z połączenia płatności Stripe. Opis poniżej.

Dla Fakturowni, wFirmy i ING Księgowość formularz zamiast opcji KSeF pokazuje informację, że wysyłką faktur do KSeF zarządza dostawca i że konfigurujesz ją na swoim koncie u dostawcy, nie w Zanfii. ING Księgowość nie wysyła e-maili, więc Zanfia sama wysyła klientowi PDF faktury, a paragony nie są w niej obsługiwane.

Fakturowanie Stripe

Kliknij kartę Stripe w zakładce Faktury. Jeśli płatności Stripe nie są jeszcze połączone, okno informuje: „Fakturowanie Stripe działa tylko z płatnościami Stripe - korzysta z tego samego połączenia” i najpierw proponuje połączenie płatności (Połącz Stripe). Przy połączonych płatnościach ustaw opcje VAT i kliknij Włącz fakturowanie Stripe. Stripe wystawia wtedy faktury na Twoim połączonym koncie Stripe i wysyła każdą e-mailem do kupującego wraz ze stroną faktury i plikiem PDF. Dotyczy to tylko zamówień opłaconych przez Stripe.

Sprzedaż z Polski

Aplikacja ostrzega twórców z Polski: „Faktury Stripe nie spełniają polskich wymogów fiskalnych. Brak wysyłki do KSeF i polskiej numeracji sekwencyjnej. Jeśli wystawiasz faktury VAT w Polsce, do zgodnych faktur używaj Fakturowni, wFirmy, iFirmy, inFaktu lub ING Księgowość.”

Połącz ponownie, gdy klucz lub token przestanie działać

Dostawcy programów do faktur czasem unieważniają klucze API i tokeny albo kończy się ich ważność. Nowe zamówienia są wtedy nadal opłacane, a dostęp nadal przyznawany, ale faktury się nie wystawiają: zamówienie pokazuje Błąd wystawienia w kolumnie Faktura w Transakcjach (/orders), a Ty dostajesz e-mail „⚠️ Wystąpił błąd podczas wystawienia faktury [produkt]”.

1

Utwórz nowy klucz u dostawcy

Zaloguj się do swojego programu do faktur i wygeneruj lub skopiuj aktualny klucz API albo token, w tym samym miejscu, które wskazuje tabela powyżej.

2

Edytuj połączone konto

W Integracje → Faktury kliknij Zarządzaj na karcie dostawcy, a potem ikonę ołówka przy koncie. Okno ma tytuł Edytuj z nazwą dostawcy i informuje: „Ze względów bezpieczeństwa nie pokazujemy zapisanego sekretu. Wklej go ponownie, aby zaktualizować połączenie.” Wklej nowy klucz i kliknij Zapisz. Jeśli dostawca go odrzuci, zobaczysz „Przesłany klucz API nie jest poprawny!”; w przeciwnym razie „Edycja konta zakończyła się pomyślnie”.

3

Wystaw ponownie nieudane faktury

Edycja zachowuje to samo konto, więc pozostaje ono domyślne i wybrane w Twoich koszykach; niczego nie trzeba przypisywać od nowa. Faktury, które w międzyczasie się nie wystawiły, nie są wystawiane ponownie samoczynnie: w Transakcjach użyj ikony zębatki przy zamówieniu albo akcji Ponów w panelu na górze listy. Kroki opisuje artykuł Automatyczne faktury.

Usuń konto

W oknie Zarządzaj kliknij ikonę kosza przy koncie i potwierdź: „Czy na pewno chcesz usunąć integrację z wybranym kontem? Wszystkie powiązane produkty utracą możliwość wystawiania faktur z tego konta.” Jeśli usunięte konto było domyślne, ustaw potem inne konto jako domyślne, w przeciwnym razie koszyki bez własnego ustawienia fakturowania nie będą miały konta, z którego można wystawić fakturę.

Czy ten artykuł był pomocny?

Powiązane artykuły

Coś się nie zgadza? Napisz do nas na support@zanfia.com.