Przejdź do treści

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

Wyświetleń: 4544 3 min czytania
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.

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

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

Powiązane wpisy

Czy ten wpis był pomocny?

Udostępnij

Główna odpowiedź Daniel Śmiech 2025-11-12 16:26

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

Komentarze (8)

Daniel Śmiech 2026-02-27 08:55 Odpowiedź
Dzień dobry, jeśli wspomniane dokumenty znajdują się również na Państwa koncie w Aplikacji Podatnika, to oznacza, że program odbiorcy ich nie pobrał i to on musi się skontaktować z jego producentem. O ile z takiego programu korzysta. Pozdrawiam
Anonymous 2026-02-26 13:31
witam,17 lutego wysłałam dwie faktury do ksef ,nadano mi numer ksef ale mój odbiorca podobno ich nie widzi,czym jest spowodowany problem? i czy problem jest po mojej czy odbiorcy stronie?
Daniel Śmiech 2026-02-05 11:59 Odpowiedź
Dzień dobry, prosimy o przesłanie zgłoszenia na adres info@fakturownia.pl wraz z podaniem nazwy Państwa konta w Fakturowni. Pozdrawiam
Anonymous 2026-02-03 20:40
Od wczoraj nie działa wysyłanie maili do klientów - komunikat o błędzie dostarczenia. Co z tym zrobić ?
Daniel Śmiech 2026-01-20 12:35 Odpowiedź
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
Anonymous 2026-01-19 10:59
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.
Daniel Śmiech 2025-11-12 16:26 Główna odpowiedź
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
Anonymous 2025-11-09 20:43
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?