Faden Zapytaj o ofertę

Dokumentacja

Jak udokumentować pracę nad programem w IP Box

Krótko: zapisuj, co zbudowałeś, kiedy i z jakim odwołaniem do commita, zgłoszenia albo wydania, przy konkretnym prawie.

Opublikowano 16 listopada 2026 · 4 min czytania · Autor: zespół Faden

Dobry dowód pracy odpowiada na cztery pytania

Dobry wpis o pracy nad programem mówi, co zostało zrobione, kiedy, przez kogo i gdzie to można sprawdzić. Jeśli po roku potrafisz z niego odtworzyć te cztery rzeczy bez pytania kogokolwiek, spełnia swoją rolę. Resztą jest nawyk, a nie wyszukany format.

Podatnik prowadzi ewidencję, z której da się ustalić przychody i koszty osobno dla każdego prawa. Urzędowego wzoru nie ma, więc forma jest Twoja. Ten wpis opisuje jedną z rozsądnych dróg, a nie wymóg. Nie obiecujemy, jak ocenią ją organy podatkowe, bo to zależy od konkretnej sprawy i od doradcy.

Co zapisać w pojedynczym wpisie

W Fadenie wpis pracy ma tytuł, datę, opcjonalne prawo IP oraz łącza i pliki. Dokładny opis pól znajdziesz w dokumentacji o wpisach IP Box, a ogólny przegląd na stronie o dowodach pracy. W praktyce zwykle wystarcza kilka elementów.

  • Tytuł, który mówi o efekcie, na przykład „Import faktur z pliku XML”, a nie „prace w maju”.
  • Krótki komentarz: jaki problem rozwiązywałeś i dlaczego było to nietrywialne.
  • Odwołanie do commita, zgłoszenia, pull requesta albo wydania, które da się otworzyć.
  • Prawo, do którego praca należy, żeby wpis nie wisiał luzem.
  • Załącznik tylko wtedy, gdy czegoś nie da się wskazać linkiem, na przykład notatka projektowa albo zrzut z datą.

Jak drobno zapisywać

Jeden wpis na commit to za dużo, a jeden na kwartał to za mało. Rozsądny środek to jeden wpis na zamknięte zadanie albo na funkcję, która ma wyraźny początek i koniec. Gdy zadanie trwało trzy tygodnie, możesz dołączyć do jednego wpisu kilka commitów jako kolejne łącza.

Zbyt drobne wpisy zasłaniają obraz i nikt ich potem nie czyta. Zbyt zgrubne nie pokazują, że praca faktycznie miała miejsce w danym okresie. Zdecyduj raz na początku roku i trzymaj się reguły.

Tygodniowy nawyk zamiast marcowego maratonu

Najtańszy sposób to dziesięć minut w piątek. Otwierasz listę zamkniętych zadań z tygodnia, wybierasz te, które dotyczą prawa objętego ulgą, i dopisujesz do każdego wpis z linkiem. Nie musisz pisać eseju, wystarczą dwa zdania.

W marcu różnica jest widoczna gołym okiem. Zamiast przeszukiwać historię repozytorium i zgadywać, co było czym, otwierasz listę wpisów, a raport składa się z zapisów, które już istnieją. Organy podatkowe zalecają prowadzenie ewidencji na bieżąco, a część wyroków uznaje ją za prawidłową, jeśli pozwala poprawnie rozliczyć ulgę w terminie. Ocenę ryzyka zostaw doradcy podatkowemu.

Jak wygląda słaby dowód

Najczęstszy słaby dowód to zrzut ekranu bez daty i bez wskazania, czego dotyczy. Podobnie działają: wpis „rozwój aplikacji” bez żadnego odwołania, link do prywatnego narzędzia, do którego nie da się nikomu dać dostępu, albo plik nazwany „final2” bez opisu.

Warto też unikać wpisów, w których nie widać Twojego udziału. Jeśli część pracy wykonał ktoś inny, zapisz to wprost, bo od tego zależy, czy koszt trafi do A, B czy C. Jak te kategorie wpływają na wynik, pokazuje przykład obliczeń nexusa.

Prywatne repozytorium: co wtedy podlinkować

Jeśli kod jest w prywatnym repozytorium, link do commita działa tylko dla osób z dostępem. To nie przeszkadza w prowadzeniu własnej ewidencji, ale warto zastanowić się, co pokażesz, gdy ktoś poprosi o wgląd. Zapisuj więc skróty commitów i numery zgłoszeń, a do wpisu dołącz plik, który da się udostępnić: wyciąg z historii, opis wydania albo notatkę projektową.

Nie wklejaj do wpisu fragmentów kodu klienta ani danych, których nie możesz ujawniać. Opisz, co zostało zbudowane, a szczegóły zostaw w repozytorium. Gdyby doszło do wglądu, ustal z doradcą, w jakiej formie pokazać materiał.

Jak powiązać dowody z prawem i kosztami

Wpis pracy ma sens dopiero wtedy, gdy wiadomo, do którego prawa należy. W Fadenie przypisujesz go do prawa z rejestru praw IP i możesz powiązać z fakturą, a faktury i koszty dostają klasę oraz kategorię nexus. Dzięki temu raport roczny łączy to, co zrobiłeś, z tym, ile to kosztowało. Pokazuje to strona o fakturach i kosztach.

Jak to wygląda na przykładzie jednego roku, zobaczysz w przypadku programisty, a ogólne podejście dla twórców oprogramowania opisuje strona dla programistów. Aplikacja niczego nie ocenia merytorycznie. Przechowuje zapisy i pokazuje braki, a to, czy praca ma charakter twórczy, rozstrzygasz Ty z doradcą.

Co może zapytać osoba, która sprawdza ewidencję

Kontrola, doradca albo księgowy mogą zapytać, które prawo powstało w jakim okresie, kto je rozwijał, skąd wynika podział przychodów i kosztów między prawa oraz czy dokumenty powstały na bieżąco. Zwykle chodzi o to, czy z zapisów da się odtworzyć logikę rozliczenia. Dobrze mieć odpowiedź na każde z tych pytań w jednym miejscu, razem z linkami.

Pytania o dokumentowanie pracy

Czy wystarczy sama historia commitów?

Sama historia pokazuje, że kod się zmieniał, ale nie mówi, do którego prawa należy ani jaki problem rozwiązywał. Wpis z opisem i odwołaniem do commita uzupełnia tę lukę. Czy to wystarcza w Twojej sprawie, oceni doradca.

Czy mogę dopisać wpisy za miniony kwartał?

Możesz uzupełnić zapisy, ale im bliżej wydarzenia, tym lepiej. Wpis z dzisiejszą datą opisujący pracę sprzed trzech miesięcy należy oznaczyć jako uzupełnienie. Zapytaj doradcę, jak podchodzić do dopisywania zaległości.

Ile czasu zajmuje prowadzenie takiej dokumentacji?

To zależy od liczby zamkniętych zadań, ale przy jednym wpisie na zadanie i dwóch zdaniach opisu zwykle jest to kilkanaście minut tygodniowo. Dokładny nakład sprawdzisz sam po miesiącu prowadzenia, na przykład w demo.

Zobacz to na przykładowych danych

Demo działa w przeglądarce, bez rejestracji i na fikcyjnych firmach. Interfejs demo jest po angielsku, dokumentacja po polsku. Możesz od razu otworzyć przykładowy raport, załącznik PIT/IP i dziennik zdarzeń.

Wolisz najpierw porozmawiać? Zajrzyj na stronę kontakt albo do pytań i odpowiedzi.