KSeFek Wystawiacz

Instrukcja obslugi modulu wystawiania i wysylania faktur elektronicznych do KSeF

1

📦 Instalacja i uruchomienie

1
Pobierz pliki programu

Pobierz i umiesc w jednym folderze 4 pliki:

  • KSeFek_Wystawiacz.exe — program glowny
  • libeay32.dll — biblioteka OpenSSL
  • ssleay32.dll — biblioteka OpenSSL
  • libxml2.dll — walidacja XML
2
Wybierz lokalizacje

Pliki mozesz umiescic w dowolnym folderze. Jesli uzywasz juz KSeFek Pobieracz — umiesc Wystawiacz w tym samym folderze. Oba programy wspoldziela baze ksefek.db i konfiguracje ksefek.ini.

3
Pierwsze uruchomienie

Przy pierwszym uruchomieniu program poprosi o uzupelnienie danych sprzedawcy (NIP, nazwa firmy, adres). Mozesz je pobrac automatycznie z bazy GUS wpisujac tylko NIP.

💡 Wskazowka

Jesli masz juz skonfigurowanego KSeFek Pobieracza w tym samym folderze, dane sprzedawcy i certyfikat KSeF zostana automatycznie odczytane z wspolnego pliku konfiguracyjnego.

2

Ustawienia sprzedawcy

🏢 Dane firmy

  • NIP, nazwa, adres (ulica, kod pocztowy, miejscowosc)
  • Przycisk Pobierz z GUS — automatyczne wypelnienie po wpisaniu NIP
  • Numer rachunku bankowego (wyswietlany na fakturach)

🔢 Numeracja faktur

  • Maska numeru faktury, np. FV/{NNN}/{MM}/{RRRR}
  • Maska numeru korekty, np. KOR/{NNN}/{MM}/{RRRR}
  • {NNN} — numer kolejny (3-cyfrowy)
  • {MM} — miesiac, {RRRR} — rok

🔒 Certyfikat KSeF

  • Sciezka do certyfikatu (.crt / .pem)
  • Sciezka do klucza prywatnego (.key / .pem)
  • Haslo klucza (szyfrowane PIN-em)
  • Tryb: przedprodukcyjny (api-demo.ksef.mf.gov.pl) lub produkcyjny
💡 Wskazowka

Uzyj tego samego certyfikatu co w KSeFek Pobieraczu. Certyfikat musi byc autoryzowany w panelu KSeF na stronie Ministerstwa Finansow.

📧 Konfiguracja email

Trzy tryby wysylki powiadomien email:

  • Plik EML — tworzy plik .eml otwierany w domyslnym kliencie pocztowym (Outlook, Thunderbird). Nie wymaga konfiguracji.
  • Wlasny SMTP — bezposrednia wysylka przez Twoj serwer pocztowy (host, port, login, haslo, SSL).
  • Wbudowany — wysylka z adresu noreply@ksefekburczymucha.pl. Nie wymaga konfiguracji.

BCC — opcjonalny adres do wiadomosci (kopia kazdego wyslanego maila).

📂 Sciezka eksportu XML

  • Katalog bazowy do zapisu plikow XML faktur
  • Struktura: katalog / NIP / rejestr / RRRR-MM / numer.xml

📖 Rejestry faktur PRO

  • Kazdy rejestr ma wlasna numeracje i maski
  • W wersji FREE dostepny jest 1 rejestr
  • Wersja PRO umozliwia tworzenie wielu rejestrow (np. dla oddzialow, projektow)
3

📋 Rejestr faktur — ekran glowny

Kolumny rejestru

Kolumna Opis
LpNumer porzadkowy
Nr fakturyPelny numer faktury wg maski
RodzajFV VAT lub Korekta
Data wyst.Data wystawienia
KontrahentNazwa nabywcy
NettoKwota netto
BruttoKwota brutto
Forma platn.Przelew, gotowka, karta itp.
Termin platn.Data terminu platnosci
Zapl.Zielony ✔ gdy zaplacona
StatusZapisana   Wystawiona   Blad
Nr KSeFNumer referencyjny nadany przez KSeF

🔍 Filtry

Dwa wiersze filtrow umozliwiaja precyzyjne wyszukiwanie:

  • Status — wszystkie, zapisana, wystawiona, blad
  • Rodzaj — wszystkie, FV VAT, Korekta
  • Zaplata — wszystkie, niezaplacone, zaplacone, przeterminowane
  • Forma platnosci — przelew, gotowka, karta itp.
  • Termin platnosci — przeterminowane, dzis, 3/7/14/30 dni, zakres
  • Szukaj — wyszukiwanie tekstowe (numer, kontrahent, NIP)
  • Okres — biezacy miesiac + 24 miesiace wstecz lub zakres dat

🎮 Pasek akcji

Dolny pasek z dzialaniami na wybranej fakturze:

  • Edytuj — otworz fakture do edycji (tylko zapisane)
  • Duplikuj — utworz kopie faktury jako nowy szkic
  • Koryguj — utworz korekte do wybranej faktury
  • Usun — usun fakture (tylko zapisane)
  • Wystaw (KSeF) — wyslij do Krajowego Systemu e-Faktur
  • Podglad — podglad PDF faktury
  • Email nabywcy — wyslij powiadomienie email z PDF PRO
  • Zaplacono — oznacz fakture jako zaplacona
ℹ Pasek gorny

Na gorze ekranu znajduja sie przyciski: Nowa FV (nowa faktura), wybor rejestru, wybor okresu, przycisk Ustawienia, oraz Eksport CSV PRO i Powiadomienia PRO.

4

📝 Wystawianie faktury VAT

👤 Kontrahent (nabywca)

  • Wpisz NIP i kliknij Pobierz z GUS — dane zostana wypelnione automatycznie
  • Mozesz tez wybrac kontrahenta z listy zapisanych
  • Edycja danych kontrahenta w osobnym dialogu
  • Email kontrahenta — potrzebny do wysylki powiadomien

📅 Daty i numer

  • Data wystawienia — domyslnie dzisiejsza (zmieni sie na dzien wysylki do KSeF)
  • Data sprzedazy — data dostawy/wykonania uslugi
  • Okres od-do — alternatywa dla daty sprzedazy (np. uslugi abonamentowe)
  • Nr faktury — generowany automatycznie wg maski

📜 Pozycje faktury

Tabela pozycji z kolumnami: nazwa, jednostka, ilosc, cena jednostkowa, stawka VAT, netto, VAT, brutto.

  • Slownik pozycji — zacznij wpisywac nazwe, a program podpowie z zapisanych pozycji (autouzupelnianie). Pozycje zapisuja sie automatycznie.
  • Ceny brutto/netto — przelacznik "Ceny w brutto" zmienia kierunek obliczen
  • Stawki VAT — 23%, 8%, 5%, 0%, zw. (zwolniony), np. (nie podlega), oo (odwrotne obciazenie)
  • PKWiU / GTU — opcjonalne kody klasyfikacji

📝 Adnotacje

Specjalne oznaczenia wymagane przepisami:

  • P_16 — oznaczenie rodzaju (np. metoda kasowa, samofakturowanie)
  • Zwolnienia VAT — podstawa prawna zwolnienia
  • Marza — procedura marzy (towary uzywane, turystyka itp.)
  • Adnotacje pojawiaja sie dynamicznie po zaznaczeniu odpowiednich pol

💳 Platnosc

  • Forma platnosci — przelew, gotowka, karta, kompensata, za pobraniem, barter, inna
  • Termin platnosci — liczba dni od daty wystawienia lub konkretna data
  • Numer konta — pobierany z ustawien sprzedawcy, mozna zmienic per faktura
⌨ Skroty klawiszowe

F2 — Zapisz fakture    F3 — Podglad PDF    Esc — Zamknij

💡 Wskazowka

Przy kazdym zapisie (F2) program automatycznie generuje XML faktury zgodny ze schematem FA(3). Nie musisz tego robic recznie — XML jest tworzony w tle.

5

🔄 Korekta faktury

1
Wybor faktury zrodlowej

Kliknij Koryguj na pasku akcji. Pojawi sie dialog z lista wystawionych faktur — wybierz fakture, ktora chcesz skorygowac.

2
Typ korekty
  • Ilosciowa — zmiana ilosci na pozycjach
  • Wartosciowa — zmiana cen na pozycjach
  • Danych — korekta danych nabywcy, dat itp.
3
Pozycje: stan przed / stan po

Kazda korygowana pozycja ma dwie linie: Stan przed (oryginalne dane) i Stan po (nowe dane). Roznica miedzy nimi stanowi wartosc korekty.

4
Powod korekty

Wpisz powod korekty — pole obowiazkowe. Np. "Pomylka w cenie", "Zmiana ilosci towaru", "Korekta danych nabywcy".

⚠ Wazne

Korekta musi odnosic sie do faktury wystawionej (wyslano do KSeF). Korekta szkicu (zapisana) nie jest mozliwa — po prostu edytuj fakture.

6

🚀 Wysylka do KSeF

1
Przygotowanie

Faktura musi byc w stanie Zapisana. Sprawdz poprawnosc danych — po wyslaniu edycja nie bedzie mozliwa.

2
Kliknij "Wystaw (KSeF)"

Program automatycznie zmienia date wystawienia na dzisiejsza i rozpoczyna proces wysylki.

3
Proces wysylki

Animowany pasek postepu pokazuje kolejne etapy:

  • Walidacja XML wg schematu FA(3)
  • Uwierzytelnianie w KSeF (certyfikat)
  • Szyfrowanie faktury (AES-256 + RSA)
  • Wysylka zaszyfrowanej faktury
  • Oczekiwanie na potwierdzenie (polling co 3 sekundy)
4
Wynik
  • Wystawiona — KSeF przyznaje numer referencyjny. Edycja zablokowana, dostepna korekta.
  • Blad — opis bledu w kolumnie Nr KSeF. Popraw fakture i wyslij ponownie.
🌐 Srodowisko przedprodukcyjne

W ustawieniach mozesz wlaczyc tryb przedprodukcyjny (api-demo.ksef.mf.gov.pl). Faktury przedprodukcyjne nie maja mocy prawnej — idealne do nauki i testow przed przejsciem na produkcje.

⚠ Wazne

Wysylka do KSeF jest dostepna zarowno w wersji FREE jak i PRO — jest to obowiazek prawny i nie podlega ograniczeniom licencyjnym.

7

📄 Podglad i eksport PDF

👁 PRO-FORMA

Przed wyslaniem do KSeF faktura ma status "Zapisana". Podglad PDF wyswietla ja z naglowkiem PRO-FORMA — mozesz wyslac nabywcy do akceptacji przed oficjalnym wystawieniem.

📄 Pelna faktura

Po wystawieniu w KSeF podglad PDF zawiera:

  • Numer KSeF
  • Kod QR do weryfikacji
  • Pelne dane faktury
  • Podsumowanie VAT, platnosc, adnotacje

📊 Eksport CSV PRO

Eksport calej listy faktur do pliku CSV:

  • Kodowanie UTF-8 z BOM
  • Separator: srednik lub przecinek
  • 15 kolumn (Lp, Nr, Rodzaj, Daty, Kontrahent, Kwoty, Status, Nr KSeF...)
8

📧 Email i powiadomienia PRO

📩 Email do nabywcy

Wysylka powiadomienia email z PDF faktury w zalaczniku. Dostepna po kliknieciu Email nabywcy na pasku akcji.

  • Email w formacie HTML z danymi faktury
  • PDF faktury w zalaczniku
  • Kopia BCC na Twoj adres (jesli skonfigurowany)
  • Wymaga adresu email kontrahenta

🔔 Asystent powiadomien

Zbiorcze wysylanie powiadomien dla wielu faktur jednoczesnie. Uruchom przyciskiem Powiadomienia na gornym pasku.

Typy powiadomien (wg priorytetow):

  • Przeterminowane — faktury po terminie platnosci
  • Zblizajacy sie termin — 0-7 dni do terminu
  • Wystawione — powiadomienie o nowej fakturze

⏱ Cooldowny

System zapobiega zbyt czestemu wysylaniu tych samych powiadomien:

  • Przeterminowane — kolejne przypomnienie mozliwe po 14 dniach
  • Zblizajacy sie termin — kolejne po 7 dniach
  • Wystawione — wyslane tylko raz (bez powtorzen)

W gridzie asystenta pozycje w cooldownie sa domyslnie odznaczone, ale mozesz je recznie zaznaczyc.

📈 Tryby wysylki w asystencie

  • Plik EML — sekwencyjne wysylanie: przycisk "Wyslij 1/N ›" otwiera kolejno kazdy email w kliencie pocztowym
  • SMTP / Wbudowany — batch: przycisk "Wyslij zaznaczone (N)" wysyla wszystkie naraz z paskiem postepu
💡 Wskazowka

Asystent analizuje przefiltrowana liste faktur — uzyj filtrow rejestru, aby zawezic zakres powiadomien (np. tylko niezaplacone, tylko wybrany kontrahent).

9

💰 Kontrola platnosci

✔ Oznaczanie zaplaty

  • Przycisk Zaplacono na pasku akcji
  • Dialog potwierdzenia z data zaplaty
  • Menu kontekstowe: "Oznacz jako zaplacone" / "Oznacz jako niezaplacone"
  • Kolumna "Zapl." z zielonym ✔

🔍 Filtrowanie wg platnosci

  • Niezaplacone — faktury bez oznaczenia zaplaty
  • Zaplacone — faktury oznaczone jako zaplacone
  • Przeterminowane — niezaplacone po terminie
  • Filtr terminu: dzis, 3/7/14/30 dni

⚠ Dialog przeterminowanych PRO

Przy starcie programu wyswietla sie lista przeterminowanych faktur z dostepnymi akcjami:

  • Wyslij przypomnienie email
  • Oznacz jako zaplacone
  • Przejdz do faktury
10

🗃 Wspolna baza danych z Pobieraczem

🔌 Jeden plik — dwa programy

KSeFek Wystawiacz i KSeFek Pobieracz uzywaja wspolnego pliku bazy danych ksefek.db (SQLite).

  • Kazdy program korzysta z oddzielnych tabel — nie ma ryzyka konfliktow
  • Tabela kontrahentow jest wspolna — kontrahent dodany w jednym programie jest widoczny w drugim
  • Konfiguracja (ksefek.ini) rowniez jest wspolna — dane sprzedawcy i certyfikat KSeF konfiguruje sie raz
💡 Wskazowka

Umiesc oba programy w tym samym folderze. Jesli baza lub konfiguracja nie istnieje, program utworzy je automatycznie przy pierwszym uruchomieniu.

⚠ Uwaga

Nie uruchamiaj obu programow jednoczesnie na roznych komputerach z tego samego folderu sieciowego — SQLite nie obsluguje wspolbieznego dostepu zdalnego. Lokalna praca na jednym komputerze jest w pelni bezpieczna.