← MH-KSeF · wydanie 10.2 (stabilny, 2026-10-21) · Instrukcja obsługi · Polityka bezpieczeństwa programu · Historia zmian
MH-KSeF pobiera faktury sprzedaży i zakupu z Krajowego Systemu e-Faktur (KSeF 2.0) certyfikatem podatnika, generuje do nich PDF z kodem QR i linkiem weryfikacyjnym, pozwala je przeglądać, filtrować, drukować (kilka stron na A4) i archiwizować. Dla przedsiębiorcy i biura rachunkowego (wielu podatników, każdy z własnym folderem i rejestrem pobranych). Program NIE wystawia faktur i nie wysyła ich do KSeF. Instaluje się w C:\aplikacje\MH-KSeF bez praw administratora; dane zostają obok programu. Licencja na komputer przez portal damto.pl; po okresie próbnym bez licencji przeglądanie, druk i archiwum działają, zablokowany jest tylko import nowych faktur z KSeF.
INSTRUKCJA OBSŁUGI MH-KSeF (v10.2)
SZYBKI START
z Wykazu podatników VAT), Zapisz.
otrzymane dla KSeF) oraz "Hasło do klucza".
Program pobierze faktury i sam wygeneruje PDF-y z kodem QR.
PRACA Z PROGRAMEM
"bieżący" i dotyczy wszystkich funkcji. Wpisuj fragment NIP-u lub nazwy: lista rozwija się i zawęża sama; Enter lub klik zatwierdza.
bezpiecznie pobierać ten sam miesiąc wielokrotnie.
Fakturę można wyłączyć z rozliczenia (PPM w Przeglądaniu) - nie będzie drukowana, na liście ma czerwone tło.
w Archiwum\ podatnika i zwalnia foldery robocze.
token wklejany dla komputera bez internetu, przedłużenie, stempel instalacji). Pomoc -> Sprawdź aktualizacje pyta portal o nowszą wersję (nic nie instaluje samo).
Szczegóły funkcji - w pomocy kontekstowej poszczególnych okien. Zasady ochrony danych - Pomoc -> Polityka bezpieczeństwa.
OKNO GŁÓWNE
Pole NIP (u góry): wpisuj NIP lub fragment nazwy - lista podatników zawęża się w trakcie pisania i rozwija automatycznie. Strzałki ↑/↓ przesuwają podświetlenie, Enter lub kliknięcie myszą zatwierdza wybór. Wybrany podatnik staje się BIEŻĄCYM - dotyczy wszystkich funkcji programu. Jego nazwa i adres pojawiają się obok pola NIP.
Bez wybranego podatnika aktywne są tylko funkcje niepowiązane z podatnikiem (Podatnik->Nowy/Lista, Konfiguracja, Pomoc).
Menu:
certyfikat/klucz, hasło, folder, dziennik, usuwanie.
Awaryjny import dokumentów, Lista pobranych, Archiwizacja.
Ostatnio wybrany podatnik i geometrie wszystkich okien są zapamiętywane i przywracane przy następnym uruchomieniu.
DANE PODATNIKA / NOWY PODATNIK
Jedno okno obsługuje zakładanie i edycję podatnika.
podatników VAT (biała lista Ministerstwa Finansów) wszystkie dostępne dane: nazwę, adresy, REGON, KRS, status VAT, datę rejestracji i numery kont bankowych. Zapisz tworzy podatnika (folder dane/<NIP>/).
odblokowuje edycję (NIP nie podlega zmianie), tytuł okna zmienia się na "Modyfikacja danych podatnika". Zapisz utrwala zmiany, Anuluj przywraca stan sprzed edycji.
Sekcja Certyfikat i klucz:
do podfolderu certyfikat\ podatnika WYŁĄCZNIE w postaci zaszyfrowanej (patrz Polityka bezpieczeństwa). Pliki źródłowe pozostają nietknięte.
LISTA PODATNIKÓW
Przegląd wszystkich podatników programu. Dwuklik (lub przycisk "Wybierz") ustawia podatnika jako bieżącego.
Menu "Podatnik" w tym oknie:
PRZEGLĄDANIE DOKUMENTÓW
Lista faktur XML bieżącego podatnika z podglądem PDF po prawej. U góry: menu Plik (wszystkie narzędzia) i Konfiguracja (widoczność i kolejność kolumn, wskazanie PDF readera) oraz pasek narzędzi z ikonkami (import z KSeF, druk dokumentu, druk zaznaczonych, druk widocznych, podgląd wydruku, WYDRUK LISTY dokumentów - zestawienie widocznych pozycji z datą pobrania i podsumowaniem wartości per strona, folder wydruków; najedź na ikonę, dymek podpowie funkcję).
FILTRY (dwa wiersze, warunki łączą się ze sobą):
miesiąc / dowolny okres (własne od-do), przełącznik "wg": WYSTAWIENIA (P_1) albo SPRZEDAŻY (P_6/OkresFa, fallback P_1) - np. abonament za sierpień wystawiony 1.09 łapie się w sierpniu przy filtrze "wg sprzedaży".
drukowane / nie drukowane / wyłączone / data importu (pola od-do filtrują wtedy po dacie pobrania z KSeF).
ORAZ POZYCJI faktury (nazwy towarów i usług z XML).
STATUSY: każdy dokument ma status (nowa / drukowana / wyłączona) - kolumna Status. "NOWA" dostają WYŁĄCZNIE dokumenty świeżo pobrane w imporcie (znika po wydrukowaniu) - po ponownym imporcie okresu łatwo zweryfikować, co doszło. "Drukowana" nadawana automatycznie po wydruku; "wyłączoną" ustawiasz przez PPM ("Wyłączona z rozliczenia" - czerwone tło, pomijana przy drukowaniu). Statusy są zapamiętywane osobno dla każdego podatnika.
(nagłówek ✓ zaznacza/odznacza wszystkie widoczne).
numeracji (FAS2 przed FAS10; seria FAS.../P osobno za serią bazową - każdy punkt sprzedaży w komplecie, wg swojej numeracji, niezależnie od dat). Kolumna "Data" ma dogrywkę: kontrahent, potem numer naturalnie. Kolumna "Data sprzed." = data sprzedaży (P_6, fallback data wystawienia). Wybrane sortowanie jest pamiętane jako domyślne.
własnych serii można zdefiniować szablony, np. "FAS{nr}/{mm}/{rr}; FAS{nr}/{mm}/{rr}/P" (tokeny: {nr}=licznik, {mm}=miesiąc, {rr}/{rrrr}=rok). Numery pasujące do szablonu sortują się wg (rok, miesiąc, licznik) - poprawnie także w zakresach wielomiesięcznych i na przełomie roku; kolejność szablonów = kolejność serii. Numery bez szablonu - automatycznie seriami, naturalnie (wystarcza przy druku w obrębie miesiąca).
dokumenty drukują się dokładnie tak, jak je widzisz (wg bieżącego sortowania i filtrów).
otwarcie w readerze PDF (wskazanym w konfiguracji, a gdy brak - w domyślnym systemowym).
DRUKOWANIE
Całe drukowanie odbywa się z okna PRZEGLĄDANIA (toolbar / menu Plik): drukuj dokument, drukuj zaznaczone (checkbox ✓), drukuj widoczne. KOLEJNOŚĆ DRUKU = kolejność wyświetlania listy (bieżące sortowanie i filtry).
Dialog opcji drukowania:
na nowym arkuszu.
wydruki\ (wirtualna drukarka PDF jest wykrywana automatycznie).
Faktury "wyłączone z rozliczenia" (PPM) nie są drukowane. Po udanym wydruku dokument dostaje status "drukowana".
IMPORT Z KSEF (+ AUTOMATYCZNE PDF)
Codzienna droga to SZYBKI IMPORT (ikona na toolbarze Przeglądania). "Awaryjny import dokumentów" (menu) to wariant z edytowalnymi datami - do ponawiania starszych okresów.
Pobiera faktury bieżącego podatnika z KSeF 2.0 za podany zakres dat.
Domyślny zakres: od OSTATNIEGO importu do DZIŚ (daty można edytować - np. ponowić starszy okres, aby dociągnąć faktury, które trafiły do KSeF z opóźnieniem). Ikona szybkiego importu na toolbarze Przeglądania robi to samo bez pytań: od ostatniego importu do dziś, sprzedaż+zakup, start automatyczny.
okresu zweryfikuj dokumenty ze statusem "nowa".
najbliższym imporcie obejmującym jego okres POBRANY PONOWNIE i oznaczony jako "nowa". Dokument zarchiwizowany - nie.
importowanych Z.
każdego podatnika i porównuje go z zawartością KSeF. Ponowne pobranie tego samego zakresu ściąga wyłącznie faktury, które pojawiły się w KSeF od ostatniego razu.
zarchiwizowany (Archiwum) NIE jest pobierany ponownie.
i klikalnym linkiem weryfikacyjnym) dla wszystkich faktur bez PDF.
importu (patrz Polityka bezpieczeństwa).
LISTA POBRANYCH
Rejestr wszystkich pobranych dokumentów podatnika: historia pobrań (zakresy dat z licznikami: w KSeF / nowe / pominięte) oraz tabela dokumentów (data wystawienia, numer faktury, numer KSeF, kwota, kiedy pobrano, status pliku: jest / archiwum / BRAK).
w Excelu).
ponownie przy najbliższym imporcie.
ARCHIWIZACJA DOKUMENTÓW
Dokumenty (XML + PDF) z podanego okresu (wg daty wystawienia P_1) są pakowane do pliku ZIP nazwanego stemplem czasowym i zakresem, a ZIP trafia do podfolderu Archiwum\ podatnika. Oryginały są usuwane z folderów sprzedaz/zakup DOPIERO po udanym spakowaniu.
Zarchiwizowane faktury NADAL liczą się jako pobrane - nie zostaną ponownie ściągnięte z KSeF.
DZIENNIK PODATNIKA
Plik dane/<NIP>/log/dziennik.log - automatyczna historia operacji na podatniku: importy (z licznikami), generowanie PDF, archiwizacje, usunięcia dokumentów, wyłączenia z rozliczenia, zmiany danych.
USUWANIE PODATNIKA / DOKUMENTÓW
Dwa warianty (potwierdzane wpisaniem NIP):
wyłączonych; certyfikat, hasło, INI i folder Archiwum\ ZOSTAJĄ.
LOG PROGRAMU
Dzienne pliki log/MH-KSeF-RRRRMMDD.log z pełnym przebiegiem pracy programu (importy, błędy, operacje). Wybierz plik z listy, Odśwież przeładowuje zawartość.
LICENCJA (portal damto.pl)
Program jest licencjonowany przez portal https://damto.pl. Przy pierwszym uruchomieniu łączy się z portalem i zaczyna OKRES PRÓBNY (liczba dni ustalana przez wystawcę). Potem licencję kupuje się na stronie portalu albo otrzymuje od wystawcy; licencja jest przypisana do TEGO komputera (stempel instalacji) i działa bez internetu.
Okno Licencja (Pomoc -> Licencja, klik w pasek statusu):
dokupieniu podatników, przypisaniu licencji przez wystawcę),
"Kopiuj odcisk" (jedna linia tekstu), wyślij ją wystawcy e-mailem, a odesłany tekst licencji (token) skopiuj i wklej tym przyciskiem,
potem kluczem na nowym komputerze; gdy stary komputer padł - strona "Moja licencja" w portalu,
Po okresie próbnym (bez licencji) program działa w trybie ustalonym w portalu: zwykle PRZEGLĄDANIE, DRUK i ARCHIWIZACJA działają, a IMPORT Z KSeF jest zablokowany do czasu aktywacji. Danych program nigdy nie usuwa. Limit podatników z licencji blokuje tylko dodanie kolejnego podatnika ponad limit.
Brak internetu przy zapłaconej licencji NIE blokuje pracy: program pokazuje pasek "potwierdź licencję" i prosi o połączenie w podanym terminie.
Do portalu trafia wyłącznie odcisk komputera (ciąg znaków, z którego nie da się odtworzyć danych komputera), numer wersji programu i stan licencji. Nigdy dane podatników, faktur ani certyfikaty KSeF.
Odpowiada automat działający na tym serwerze — bez AI i bez wysyłania pytań gdziekolwiek. Rozmowa nie jest zapisywana. Jak to działa