Zgłaszanie problemów z programu, umowy zlecenia w księdze i naprawiona pomoc kontekstowa

Wydanie poświęcone zgłaszaniu problemów: sprawę można teraz założyć wprost z programu, razem z kompletem informacji technicznych, których wcześniej trzeba było szukać ręcznie. Druga zmiana dotyczy wszystkich użytkowników niezależnie od wersji — pomoc kontekstowa znów otwiera właściwe tematy. Wieczorem doszła porcja zmian dla ksiąg rachunkowych: wydruk e-faktury razem z dekretacją, dwie poprawki podglądu dokumentów oraz spora rozbudowa możliwości asystenta AI. Zmiany w programie dostępne są po aktualizacji do najnowszej wersji (instalator: pobieranie programów).

Zgłaszanie problemów wprost z programu

Na wstążce Pomoc doszedł przycisk Zgłoś problem. Otwiera okno, w którym opisujesz sprawę i wysyłasz ją bezpośrednio do naszego systemu zgłoszeń — bez przechodzenia na witrynę i bez wypełniania captchy.

Największa różnica wobec formularza na stronie: program sam dołącza dane techniczne, o które dotąd trzeba było pytać w korespondencji — wersję programu, rodzaj i wersję bazy danych, wersję i architekturę Windows, numer licencji oraz wykryty program antywirusowy.

Do zgłoszenia można dołączyć załączniki diagnostyczne — o każdym decydujesz osobno, wszystkie są zaznaczone na starcie:

log programu z bieżącej sesji — zapis tego, co program robił przed wystąpieniem problemu,
raport diagnostyki pamięci — jeżeli diagnostyka była włączona,
log serwera MCP — przy zainstalowanej usłudze asystenta AI.

Pliki są pakowane w jedno archiwum ZIP, więc nawet obszerne logi wysyłają się szybko. W archiwum ląduje też metryczka środowiska: ścieżka bazy danych, wersja struktury bazy i katalogi programu.

Osobne, domyślnie odznaczone pole pozwala dołączyć kopię bazy danych — przydatne, gdy problem dotyczy konkretnych dokumentów albo wyliczeń. Kopia powstaje tak, jak przy każdej kopii bezpieczeństwa w programie: baza plikowa jest przepisywana bezpieczną metodą SQLite, a baza na serwerze MariaDB/MySQL zrzucana do pliku SQLite. Duże kopie dzielą się na części, a gdy baza jest naprawdę obszerna (typowo przez zapisane skany, PDF-y i pocztę), program zaproponuje wysłanie kopii bez treści dokumentów i wiadomości — dane księgowe i e-faktury zostają wtedy w komplecie, znika sam balast plików. Przygotowanie kopii i wysyłkę widać na pasku postępu, z możliwością przerwania.

Do zgłoszenia dołączysz też własne pliki — przycisk Dodaj własne pliki… przyjmuje zrzuty ekranu, PDF-y, deklaracje czy pliki JPK. Zrzut zrobiony skrótem Win+Shift+S wklejasz wprost do zgłoszenia przyciskiem Wklej zrzut ze schowka albo skrótem Ctrl+V; program zapisze go jako plik PNG i dołączy razem z resztą. Tą samą drogą wkleisz pliki skopiowane w Eksploratorze.

Zgłoszenie niesie także numer i klucz licencji, dzięki czemu od razu wiadomo, o którą licencję chodzi.

Po wysłaniu dostajesz numer sprawy i link do jej strony — dalsza korespondencja toczy się tam, tak samo jak przy zgłoszeniach z formularza.

Zgłoszenie z programu wysyłasz świadomie: nic nie jest wysyłane automatycznie ani w tle, a treść załączników możesz wcześniej obejrzeć — logi leżą w katalogu wskazanym w Konfiguracja → Katalogi programu. Więcej o samych logach: logi z wykonania programu.

Księgowanie e-faktur przez asystenta AI — naprawione

Przy księgowaniu e-faktur poleceniem wydanym asystentowi AI (serwer MCP) dokumenty bywały pomijane z komunikatem o nieczytelnym pliku XML, a we wcześniejszych wersjach całe księgowanie kończyło się błędem. Te same faktury księgowały się bez zarzutu z poziomu programu — i to była wskazówka, bo przyczyna nie leżała w dokumentach.

Usługa asystenta obsługuje żądania na osobnych wątkach, na których nie było przygotowane środowisko do odczytu plików XML. Efekt: czytnik faktur zawodził przy każdej próbie, niezależnie od zawartości dokumentu. Po poprawce księgowanie e-faktur przez asystenta działa normalnie.

Ważne: poprawka jest w usłudze, więc po aktualizacji programu trzeba też przyjąć propozycję aktualizacji usług (osobne pytanie przy starcie, z uprawnieniami administratora). Wersję usługi widać w oknie Konfiguracja → Serwery MCP.

Przy okazji komunikat o pominiętej fakturze rozróżnia teraz przyczyny: brak treści dokumentu w bazie, dokument w innym formacie oraz błąd czytnika. Przy tym ostatnim program nie sugeruje już usuwania i ponownego pobierania faktur z KSeF — to niczego nie naprawia. Usługa zapisuje też więcej w dzienniku i podaje przy starcie ścieżkę do katalogu z logami.

Koniec z przypominaniem o odinstalowanych serwerach

Jeżeli serwer MCP albo portal akceptacji był testowany, a potem odinstalowany, program po każdym uruchomieniu proponował aktualizację tych usług. Sprawdzał bowiem obecność plików w katalogu programu, a te zostają na dysku również po deinstalacji.

Teraz o istnieniu usługi rozstrzyga system Windows — przypomnienie pojawia się wyłącznie dla usług faktycznie zainstalowanych.

Umowy zlecenia: zestawienie rachunków i księgowanie do KPiR

Rachunki do umów zleceń miały dotąd gorzej niż listy płac — nie było ani zestawienia, ani przeniesienia do księgi. Doszło jedno i drugie.

Zestawienie rachunków do umów zleceń (raporty, kategoria Płace) pokazuje wiersz na rachunek i sumy: zleceniobiorca, numer rachunku i umowy, data wypłaty, brutto, składki zleceniobiorcy, koszty uzyskania, zaliczka PIT i kwota do wypłaty. Po prawej — obciążenia zleceniodawcy (ZUS, FP/FGŚP, PPK, koszt łączny), które można ukryć jednym kliknięciem. Okres liczony według daty wypłaty, więc zestawienie zgadza się z tym, co poszło do PIT-4 i ZUS.

Księgowanie do KPiR — przycisk Księguj rachunki do umów zleceń zapisuje każdy rachunek osobno, wynagrodzenie brutto do kolumny 12, pod datą wypłaty. Powtórne uruchomienie niczego nie dubluje.

Składki ZUS zleceniodawcy mają osobny przycisk — i to nie przeoczenie. Przy umowach zlecenia są one kosztem dopiero po opłaceniu do ZUS, czyli zwykle w kolejnym miesiącu, więc księgowanie ich razem z wynagrodzeniem wpisywałoby je do księgi o miesiąc za wcześnie. Księguj składki ZUS od zleceń bierze rachunki z poprzedniego miesiąca, podpowiada sumę składek i ustawowy termin zapłaty, a Ty potwierdzasz kwotę i datę przelewu — bo jeden przelew do ZUS obejmuje zwykle także składki z umów o pracę.

Przy okazji poprawka w księgowaniu list płac: jeżeli w jednym miesiącu były dwie listy bez numeru (np. podstawowa i premiowa), do księgi trafiała tylko pierwsza — druga była po cichu uznawana za już zaksięgowaną. Teraz księgują się wszystkie.

Koszty pracownicze także w ryczałcie. Księgowanie list płac, rachunków zleceń i składek ZUS odmawiało wcześniej pracy przy ryczałcie komunikatem „tylko KPiR". Kosztów w ryczałcie nie odlicza się od przychodu, ale wiele biur prowadzi je, żeby znać rzeczywisty dochód — i program ma do tego własny rodzaj dokumentu. Wpisy trafiają teraz do ewidencji jako wydatki: nie wchodzą do podstawy opodatkowania, nie ruszają zaliczek ani limitów (zwolnienia z VAT, kasy fiskalnej), a dają pełny obraz kosztów.

Kopia bazy z serwera nie zatrzymuje się już na mapowaniu rachunków

Przy tworzeniu kopii bazy MariaDB/MySQL do pliku SQLite — a więc także przy aktualizacji struktury bazy, która taką kopię robi na wszelki wypadek — program przerywał pracę komunikatem o błędzie. Dotyczyło to firm prowadzących księgi rachunkowe, które korzystały z przypisań rachunków bankowych do kont (zapamiętywanych przy księgowaniu wyciągów przez asystenta AI): tabela z tymi przypisaniami ma klucz złożony z dwóch pól, czego dotychczasowy zapis do SQLite nie obsługiwał.

Poprawka usuwa też cichszy problem: numer rachunku bankowego trafiał w kopii do pola liczbowego, choć jest ciągiem znaków. Kopia zachowuje teraz oryginalne typy danych.

Pomoc w programie znów otwiera właściwe tematy

Po przeniesieniu pomocy na taxmachine.pl przyciski pomocy w oknach programu oraz odnośniki z komunikatów prowadziły do strony „nie znaleziono" — dotyczyło to niemal wszystkich tematów, bo nowa pomoc ma układ działowy, a program odwoływał się do dawnych, płaskich adresów.

Poprawka jest po stronie witryny, więc działa od razu i we wszystkich wersjach programu — nie trzeba go w tym celu aktualizować.

Drobne poprawki na witrynie

Duże załączniki w zgłoszeniach. Pliki większe niż 10 MB przesyłane w zgłoszeniach i odpowiedziach docierały do nas obcięte — bez żadnego ostrzeżenia, przez co bywały bezużyteczne (dotyczyło to m.in. kopii baz i dłuższych logów). Limit podniesiony do 100 MB, a pliki wysyłają się w całości.

Wydruk e-faktury prosto z dokumentów księgowych

W księgach rachunkowych, w grupie Wydruki, obok Drukuj dekretację pojawił się przycisk Drukuj e-fakturę. Dla zaznaczonych dokumentów odnajduje e-faktury z KSeF, z których powstały dekrety, i drukuje je razem z dekretacją dokumentu na końcu wydruku — jeden wydruk zamiast pary „faktura osobno, dekretacja osobno".

Zaznaczyć można wiele dokumentów naraz; każda faktura drukuje się osobno, a gdy kilka dekretów pochodzi z tej samej faktury, wydruk powstaje tylko raz. Dokumenty, które nie powstały z e-faktury (wyciągi, listy płac, polecenia księgowania), są pomijane z informacją, ile ich było.

Podgląd e-faktury: koniec z błędem i mylącym komunikatem o przeglądarce

W podglądzie dokumentu księgowego, w sekcji Źródło księgowania, przycisk Otwórz e-fakturę (KSeF) kończył się błędem programu — okno faktury nie pokazywało treści, a przy zamykaniu programu pojawiał się komunikat Błąd inicjalizacji wbudowanej przeglądarki z radą, żeby przeinstalować program albo samą przeglądarkę. Rada była myląca: przeglądarka działała poprawnie, komunikat był echem nieudanego otwarcia faktury.

Po poprawce faktura otwiera się normalnie, a komunikat nie pojawia się przy zamykaniu programu. Prawdziwe problemy z przeglądarką nadal są zgłaszane — zmieniło się tylko to, że program nie straszy nimi bez powodu.

Podgląd nie zastyga po przełączeniu pulpitu zdalnego

Po przełączeniu się z pulpitu zdalnego na komputer lokalny (albo odwrotnie) podgląd dokumentów potrafił zastygnąć: przy przechodzeniu między dokumentami wyświetlał wciąż tę samą treść, aż do ponownego uruchomienia programu.

Teraz podgląd odtwarza się sam i pokazuje bieżący dokument. W sekcji Źródło księgowania poprawiliśmy przy okazji drobiazg: przycisk otwierający wyciągi bankowe pokazuje się już tylko przy dokumentach faktycznie pochodzących z wyciągu — wcześniej trafiał się też na listach płac i fakturach, gdzie prowadził donikąd.

Asystent AI: numery dokumentów i poprawianie tego, co już zaksięgowane

Dokumenty zaksięgowane poleceniem wydanym asystentowi trafiały do ksiąg bez pełnego symbolu — w oknie ksiąg kolumna z symbolem dokumentu zostawała pusta, choć numer faktury czy listy płac był podany. Teraz dokumenty dostają symbol w tej samej postaci, co przy księgowaniu w programie, na przykład FV 10/S/03/26/FV albo Lista wynagrodzeń 3/2026.

Asystent potrafi też poprawić dokument już zaksięgowany, zamiast prosić o skasowanie go i księgowanie od nowa. Poprawić można numer i rodzaj dokumentu, opis, datę w obrębie miesiąca, dane kontrahenta oraz parametry dokumentu (u fundacji i stowarzyszeń m.in. źródło finansowania i działanie) — przydatne, gdy dekret powstał bez przypisanego wymiaru. Doszła również możliwość poprawienia pozycji dekretu i usunięcia dokumentu; przy usuwaniu powiązania wracają do stanu sprzed księgowania: operacja wyciągu wraca do kolejki, lista płac znów czeka na zaksięgowanie, a e-faktura wraca do niezaksięgowanych.

Wszystko działa zarówno w księgach rachunkowych, jak i w księgach podatkowych (KPiR, ewidencja przychodów, rejestry VAT). Dokument otwarty w oknie edycji albo należący do zamkniętego miesiąca jest chroniony — asystent odmówi zmiany zamiast nadpisać czyjąś pracę.

Ważne: te zmiany są w usłudze asystenta, więc po aktualizacji programu trzeba przyjąć propozycję aktualizacji usług (osobne pytanie przy starcie, z uprawnieniami administratora).

Asystent AI: dekrety ze schematem, uzgodnienie salda, subkonta

Trzy poprawki dla ksiąg rachunkowych prowadzonych z pomocą asystenta.

Dekrety księgowane według schematu otwierały się w oknie tak, jakby były wprowadzone ręcznie: pozycje nie miały przypisanych nazw wartości ze schematu, więc nie działało przeliczanie kwot z wartości ani rozpoznanie dokumentu jako schematowego. Teraz dekret dostaje komplet — także w firmach, w których wybrany wymiar dokumentu podmienia konta kosztowe (u fundacji robi to źródło finansowania, przestawiając koszty między kontami finansowanymi z 1,5% podatku a finansowanymi ze środków pozostałych).

Uzgodnienie salda bankowego dla rachunku, na którym prowadzone są subkonta — na przykład subkonta podopiecznych w fundacji — pokazywało nieprawdziwą, wielomilionową różnicę wobec wyciągu. Teraz saldo liczy się poprawnie i zgadza z wyciągiem co do grosza, co pozwala domknąć miesiąc bez ręcznego sprawdzania.

Zakładanie subkonta z własnym numerem. Asystent mógł nadać nowemu kontu wyłącznie kolejny numer automatyczny, co nie pasuje do subkont, których numery wynikają z numeracji zbiórek i pojawiają się w tytułach przelewów. Teraz numer konta można wskazać wprost.

Wysyłka do KSeF certyfikatem — koniec z błędem podpisu

Logowanie do KSeF certyfikatem potrafiło skończyć się komunikatem o nieudanym uwierzytelnieniu z niezrozumiałym opisem technicznym w tle. Przyczyna nie leżała w samym certyfikacie: program prosił o podpis zawsze w ten sam sposób, a certyfikaty, które nie deklarują wprost zastosowania „podpis cyfrowy", zwracały w odpowiedzi pustkę — i dopiero na niej wysyłka się wykładała.

Teraz program rozpoznaje przeznaczenie certyfikatu i podpisuje tak, jak dany certyfikat na to pozwala. A gdy certyfikat naprawdę nie nadaje się do logowania — bo służy do czegoś innego, na przykład do podpisywania faktur wystawianych w trybie offline — program mówi to wprost: wymienia faktyczne zastosowania tego certyfikatu, podpowiada, jakiego użyć zamiast niego, i odsyła do przycisku Sprawdź poprawność certyfikatu w karcie firmy, który po zalogowaniu pokazuje nadane uprawnienia do wysyłki i odbioru.

Do uwierzytelniania w KSeF służy certyfikat pobrany z aplikacji Ministerstwa Finansów, wystawiony w celu „uwierzytelnienie". Poprawka powstała na podstawie zgłoszeń użytkowników — dziękujemy.

Asystent AI: listy płac w księgach rachunkowych, pewniejszy start usługi, wykrywanie Claude Code

Trzy zmiany w usłudze asystenta.

Księgowanie list płac do ksiąg rachunkowych zlecone asystentowi kończyło się komunikatem o niezainicjowanych ustawieniach ksiąg. Wbrew pierwszemu wrażeniu nie była to usterka nowej wersji — ta droga nie działała od początku, a wcześniejsze księgowania list przechodziły inną ścieżką, co tworzyło złudzenie regresji. Teraz polecenie działa: powstaje jeden dekret na listę, według schematu księgowania płac, a powtórzenie polecenia niczego nie dubluje.

Usługa sama wraca do sprawności po starcie komputera. Jeżeli usługa asystenta ruszyła szybciej niż serwer bazy danych, zostawała bez dostępu do danych i odmawiała księgowania aż do ręcznego zrestartowania — mimo że co minutę ponawiała próbę połączenia. Ponowienia nie miały prawa się udać; teraz naprawdę odbudowują dostęp do danych, zwykle w ciągu minuty.

Wykrywanie Claude Code. Przy podłączaniu asystenta program szukał wyłącznie wersji instalowanej przez npm i twierdził, że nie znajduje polecenia, choć było ono zainstalowane instalatorem natywnym. Teraz sprawdzane są obie postacie i typowe katalogi instalacji — także wtedy, gdy nie ma ich na liście ścieżek systemowych — a komunikat o braku mówi, gdzie program szukał i co zrobić.

Stabilność: utrata połączenia z bazą i paski postępu

Po utracie połączenia z bazą danych (zerwana sieć, uśpiony serwer) program pokazywał komunikat o utraconym połączeniu, a chwilę po jego zamknięciu kończył pracę błędem krytycznym. Teraz zamknięcie komunikatu zostawia program w stanie, z którego można spokojnie połączyć się ponownie albo zamknąć go normalnie.

Paski postępu. Zamknięcie okna — albo całego programu — w trakcie długiej operacji z paskiem postępu potrafiło zakończyć się błędem krytycznym. Dotyczyło to pobierania e-faktur z KSeF dla pojedynczego klienta oraz zamykania okna wiadomości w momencie, gdy program zapamiętywał układ podglądu. Obie sytuacje są już obsłużone.