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

Utworzono: 2024-02-02
Ostatnia aktualizacja: 2025-09-25
Liczba odwiedzin posta: 3

📢 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.
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ą {{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.

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

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.

 
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ż:
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