Wysyłka e-maila z fakturą przy włączonej integracji z KSeF

Utworzono: 2024-02-02
Ostatnia aktualizacja: 2026-02-05
Liczba odwiedzin posta: 3713

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.
Instrukcja

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.

Komunikat o błędzie podczas wysyłania faktury – brak nadanego numeru KSeF w systemie Fakturownia.


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.

Jeśli nie korzystasz z automatycznej integracji Fakturowni z KSeF (korzystasz z ręcznego eksportu), możliwość wysyłki dokumentu do Klienta będzie aktywna cały czas.

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.

Widok faktury z rozwiniętym menu „Więcej opcji” i podświetloną funkcją „Dodaj numer KSeF” w Fakturowni.

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ą {{{required_ksef_information}}}, 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.

Podgląd domyślnego szablonu e-maila z fakturą, zawierającego zmienną {{ksef_id}} dla numeru KSeF.

Oprócz zmiennej {{{required_ksef_information}}}, 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.

 
Sprawdź działanie systemu korzystając z interaktywnej instrukcji

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ż: 
KSeF w Fakturowni – od czego zacząć, prosto i krok po kroku
KSeF: Uprawnienia użytkowników w Fakturowni – kto może wysyłać dokumenty i jak to ustawić
KSeF w Fakturowni – kluczowe informacje
Jak pobierać faktury kosztowe (wydatki) z KSeF do Fakturowni?
Tryb hybrydowy KSeF w Fakturowni: odbiór kosztów i dobrowolna wysyłka sprzedaży do 1.04.2026 
Tryby awaryjne offline i offline24
Jak wysyłać faktury z Fakturowni do KSeF?
Wysyłka e-maila z fakturą przy włączonej integracji z KSeF
KSeF a wygląd faktury w Fakturowni: kod QR, link weryfikacyjny i numer KSeF (PDF/wydruk)

Czym jest numer KSeF i gdzie zobaczysz go na fakturze w Fakturowni?
Jak połączyć Fakturownię z KSeF (DEMO) – autoryzacja integracji krok po kroku
Autoryzacja manualna (zaawansowana) – wgranie certyfikatów z KSeF do Fakturowni
Szybkie płatności za pomocą QR kodu a integracja z KSeF

Eksport pliku Fakturowni do systemu KSeF za pomocą aplikacji


Powrót


Komentarze

Avatar sugester medium
Weronika
A co w przypadku włączonej automatyzacji i faktury dla konsumenta (mogą być one wystawiane poza KSeF, więc nie muszą mieć nadawanego numeru)? Jak odblokować możliwość wysyłki bez, na przykład każdorazowego przełączania z trybu automatycznego na ręczny?

2025-11-09 20:43


daniels
daniels
Odpowiedź główna   Dzień dobry,
ustawienia automatycznej wysyłki będzie można odpowiednio dostosować i dookreślić, czy wysyłać również dobrowolnie dokumenty b2c.

Przy wysyłce ręcznej, wystarczy je po prostu pomijać.

Pozdrawiam

2025-11-12 16:26


Avatar sugester medium
Krzyszof
Czy w API fakturowni https://app.fakturownia.pl/api pojawią się również funkcje związane z KSEF?
W jaki sposób zachowa się API Fakturowni dla wysyłki faktur dla których nie będzie jeszcze przypisanego numeru faktury z KSEF?

Faktury które wystawiam przez API chciałbym od razu wysyłać do KSEF z API żeby od razu pobrać PDF i wysłać fakturę.

Faktury wystawiane w Fakturowni (w interfejsie) chciałbym wysyłać do KSEF "ręcznie" dopiero po zakończeniu edycji faktury kiedy mam pewność, że wszystkie Towary/Usługi są dobrze wprowadzone.

2026-01-19 10:59


daniels
daniels
Odpowiedź główna   Dzień dobry,
w dokumentacji API powstała dodatkowa sekcja dot. KSeF https://github.com/fakturownia/API/blob/master/KSeF.md

Znajdują się tam zaktualizowane informacje i wskazane dodatkowe endpointy. Po API będzie można odpytać m.in. o takie informacje jak status wysyłki oraz nadany numer KSeF.

Jeśli dokument nie będzie miał nadanego Numeru KSeF nie zostanie wysłany do klienta.

Dokumenty wysyłane za pomocą API jak i ręcznie z poziomu danego konta w Fakturowni będą miały tą samą logikę działania, czyli przy tworzeniu połączenia należy zdecydować, czy mają być wysyłane automatycznie po ich stworzeniu do KSeF, czy klient będzie je wysyłał ręcznie z poziomu Panelu w Fakturowni.

Pozdrawiam

2026-01-20 12:35


Avatar sugester medium
Adam
Od wczoraj nie działa wysyłanie maili do klientów - komunikat o błędzie dostarczenia. Co z tym zrobić ?

2026-02-03 20:40


daniels
daniels
Odpowiedź główna   Dzień dobry,
prosimy o przesłanie zgłoszenia na adres info@fakturownia.pl wraz z podaniem nazwy Państwa konta w Fakturowni.

Pozdrawiam

2026-02-05 11:59


Dodaj komentarz