Wysyłka e-maila z fakturą przy włączonej integracji z KSeF
Ostatnia aktualizacja: 2025-09-25
📢 Przygotowania do KSeF – ważna informacja
Ten artykuł opisuje, jak działa integracja Fakturowni z Krajowym Systemem e-Faktur (KSeF).
Już teraz dzielimy się szczegółami, abyś mógł lepiej przygotować się na obowiązkowe e-fakturowanie.
👉 Integracja jest obecnie stale dostosowywana do wytycznych Ministerstwa Finansów – dlatego niektóre elementy mogą jeszcze ulec drobnym zmianom.
👉 Testowa wersja integracji zostanie udostępniona użytkownikom w ostatnim kwartale 2025 r. – wtedy będzie można samodzielnie sprawdzić wszystkie funkcje w praktyce.
Do tego czasu zachęcamy do śledzenia naszych aktualizacji na stronie: fakturownia.pl/ksef.
Utworzone w ramach konta faktury możesz wysyłać bezpośrednio do swoich klientów. Ze względu na automatyczną integrację Fakturowni z KSeF, czyli platformą do wystawiania i otrzymywania faktur drogą elektroniczną, wprowadzono zmiany co do samej wysyłki oraz domyślnej treści szablonu e-maila, która pozwoli automatycznie zaczytać numer KSeF wysyłanej faktury. Z tego artykułu dowiesz się jakie zmiany odnośnie do wysyłki e-maili wprowadza w Fakturowni KSeF.
Dowiedz się, jak skorzystać z tej funkcji, korzystając z interaktywnej instrukcji.
Kiedy wysłać e-mail z fakturą?
Integracja automatyczna z KSeF włączona – wysyłka wiadomości z fakturą z poziomu Fakturowni aktywna będzie dopiero w momencie, gdy fakturze zostanie nadany numer KSeF. Numer KSeF zostanie przypisany do dokumentu samoczynnie, po zaakceptowaniu faktury przez Krajowy System e-Faktur.
Integracja automatyczna wyłączona / tryb ręczny (eksport XML) – e-mail możesz wysłać zawsze, ale pamiętaj, by dodać numer KSeF ręcznie.
Pamiętaj jednak, aby przed wysłaniem e-maila z fakturą, przypisać do niej ręcznie numer KSeF. Możliwość przypisania numeru dostępna jest z poziomu podglądu dokumentu. Z menu podręcznego ponad fakturą wybierz Więcej opcji > Dodaj numer KSeF.

Więcej o numerze KSeF przeczytasz w tym artykule → Czym jest numer KSeF i gdzie zobaczysz go na fakturze w Fakturowni?
Szablon wysyłanej wiadomości - dodatkowe informacje związane z KSeF
W związku z wysyłaniem faktur do KSeF i przypisaniem im unikalnego numeru, w Fakturowni zmieniono domyślny szablon wysyłanych e-maili.
Do szablonu dodano zmienną {{ksef_id}}, która automatycznie zaczyta do treści wiadomości numer nadany przez Krajowy System e-faktur dla przesyłanego dokumentu.
Aby sprawdzić treść szablonu wysyłanej wiadomości przejdź do zakładki Ustawienia > Ustawienia konta > Wysyłanie e-mailem > Wysyłanie faktury e-mailem.

Oprócz zmiennej {{ksef_id}}, która dodana jest automatycznie do szablonu maila, możesz uzupełnić treść wiadomości dodatkowymi informacjami związanymi z KSeF.
Klikając przycisk Pomoc pod polem z treścią wiadomości wyświetlisz listę zmiennych, jakich możesz użyć we własnym szablonie.
Dodatkowe zmienne dodane w związku z integracją KSeF to {{ksef_if_below_qr}} oraz {{ksef_qrcode_img}}.
{{ksef_qrcode_img}}
-
Zmienna zawiera zakodowany kod QR KSeF do wyświetlania jako obrazek w treści maila
{{ksef_if_below_qr}}
-
Wyświetla identyfikator KSeF pod obrazkiem QR – tylko jeśli QR może być wyświetlony dla tej faktury.
Jeśli faktura nie ma jeszcze numeru KSeF, zmienne związane z KSeF (ID/QR) nie zwrócą treści – w szablonie warto używać warunków.
Przykład użycia w szablonie (z warunkami)
{{#if ksef_qrcode_img}}
<td class="qrs_{{#if many_qrs}}left{{else}}center{{/if}}">
<div class="qr_title">
{{tt "invoice.qrcode.ksef_title"}}
</div>
<img src='{{ksef_qrcode_img}}'>
<div class="ksef_id_below_qr">
{{ksef_if_below_qr}}
</div>
</td>
{{/if}}
{{#if ksef_id}}
Numer KSeF: {{ksef_id}}
{{/if}}
Jeśli dostępny jest QR, wstawi blok z tytułem, obrazem QR i (warunkowo) identyfikatorem pod QR.
Interaktywna instrukcja poprowadzi Cię krok po kroku przez instrukcje na rzeczywistych ekranach Fakturowni, umożliwiając łatwe zrozumienie i wykonanie potrzebnych działań.
Kliknij Start, aby rozpocząć, a następnie klikaj w niebieskie pola, lub użyj strzałek w prawym dolnym rogu do nawigowania po instrukcji.
Sprawdź również:
Szybkie płatności za pomocą QR kodu a integracja z KSeF
Eksport pliku Fakturowni do systemu KSeF za pomocą aplikacji
Powrót
Dodaj komentarz