---
title: "Szczegóły dokumentu"
description: "Widok detalu pojedynczego dokumentu (PDF, skan faktury, zdjęcie paragonu) — podgląd oryginału, metadane, status parsingu AI oraz lista powiązanych transakcji wyciągniętych z dokumentu. Punkt audytowy dla dowodów źródłowych wg ustawy o rachunkowości."
url: https://numifyai.com/docs/korzystanie-z-numify/document-detail
review_status: internal
updated: 2026-04-17
---


**Szczegóły dokumentu** to widok detalu pojedynczego pliku wgranego
do <FeatureRef slug="dokumenty">dokumentów</FeatureRef> — PDF
faktury, skan, zdjęcie paragonu. Pozwala zobaczyć oryginał, metadane
i transakcje wyciągnięte z niego przez parser AI.

<ComplianceDisclaimer />

{/* SCREENSHOT: ekran /documents/[id] — z lewej podgląd PDF w iframe, z prawej panel Details i lista Extracted Transactions */}

## Rola dokumentu w rachunkowości [#rola-dokumentu-w-rachunkowości]

Dokumenty wgrane do Numify pełnią rolę **dowodów księgowych** w
rozumieniu <LegalRef act="UoR" art="20" paragraph="2" />. Najczęściej
są to **dowody zewnętrzne obce** — faktury zakupowe otrzymane od
dostawców.

<LegalRef act="UoR" art="20" paragraph="5" /> dopuszcza komputerowe
prowadzenie ksiąg pod warunkiem:

1. **trwałej czytelności** zapisów zgodnej z dowodami,
2. **możliwości stwierdzenia źródła** i osoby odpowiedzialnej,
3. **poprawności przetwarzania** i kompletności,
4. **ochrony danych źródłowych** przed zmianą.

Numify spełnia te wymogi: oryginał pliku przechowywany jest w
Cloudflare R2 (niemutowalne obiekty), każdy upload ma zapisanego
użytkownika i timestamp, parser zapisuje wyniki atomowo, a
transakcje powstałe z dokumentu są powiązane z ID dokumentu w
bazie.

## Struktura ekranu [#struktura-ekranu]

### Nagłówek [#nagłówek]

* **Przycisk powrotu** — nawiguje do listy <FeatureRef slug="dokumenty" />.
* **Ikona + nazwa pliku** — oryginalna nazwa przy uploadzie.
* **Badge statusu** — `Oczekujący` / `Przetwarzanie` / `Przetworzony` / `Błąd` (kolor zależy od statusu).
* **Rozmiar i MIME type** — dane techniczne pliku.
* **Przycisk „Open Original"** — otwiera oryginał w nowej karcie (bezpośredni link do obiektu R2 przez tymczasowy podpisany URL).

### Preview — podgląd oryginału [#preview--podgląd-oryginału]

Lewa (szeroka) kolumna na większych ekranach:

* **PDF** — osadzony w iframe z natywnym podglądem przeglądarki.
* **Obraz** (JPG, PNG, WEBP) — wyświetlany jako `<img>` z `object-contain`.
* **Inne typy** — ikona placeholder z komunikatem „Preview not available".

Podgląd jest **tylko do odczytu** — nie pozwala na modyfikację,
komentarze ani zaznaczenia. Wymóg niezmienności dowodu
(<LegalRef act="UoR" art="20" paragraph="5" />) jest spełniony
architektonicznie: Numify nie daje narzędzi do edycji pliku
źródłowego.

### Details — metadane [#details--metadane]

Prawa kolumna, pierwsza karta:

| Pole             | Opis                                                          |
| ---------------- | ------------------------------------------------------------- |
| **Created**      | Data i czas uploadu do Numify                                 |
| **Last Updated** | Ostatnia modyfikacja rekordu (np. zmiana statusu po parsingu) |
| **File name**    | Oryginalna nazwa z uploadu                                    |
| **Size**         | Rozmiar w bajtach (formatowany do KB/MB)                      |
| **MIME type**    | Typ pliku (np. `application/pdf`)                             |
| **Status**       | Aktualny stan parsingu                                        |

### Extracted Transactions — transakcje wyciągnięte z dokumentu [#extracted-transactions--transakcje-wyciągnięte-z-dokumentu]

Prawa kolumna, druga karta. Parser AI (<ServiceRef path="src/lib/services/document-parser.ts" />)
próbuje rozpoznać w dokumencie jedną lub więcej transakcji:

* faktura zakupowa → typowo jedna transakcja główna z pozycjami,
* paragon / rachunek → jedna lub kilka transakcji,
* wyciąg bankowy → wiele transakcji (tu używa się zwykle osobnej ścieżki importu CSV — patrz <FeatureRef slug="konta-bankowe" />).

Każda wyciągnięta transakcja pokazuje:

* **Datę** operacji,
* **Kontrahenta** (jeśli rozpoznany),
* **Kwotę** (netto + VAT + brutto),
* **Status powiązania** — `Linked` (przekonwertowane na rekord <FeatureRef slug="transakcje">transakcji</FeatureRef> w dzienniku) lub `Pending` (wymaga ręcznego potwierdzenia).

### Status parsingu — co oznaczają stany [#status-parsingu--co-oznaczają-stany]

| Status            | Znaczenie                                                              | Co zrobić                                                                             |
| ----------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Oczekujący**    | Plik w kolejce do parsera                                              | Poczekaj — kolejka BullMQ przetwarza w tle                                            |
| **Przetwarzanie** | Parser aktualnie analizuje dokument                                    | Typowo 10–60 s                                                                        |
| **Przetworzony**  | Parsing zakończony, dane dostępne                                      | Zweryfikuj transakcje; jeśli parser pominął / źle rozpoznał coś, dodaj/popraw ręcznie |
| **Błąd**          | Parser nie poradził sobie (np. zdjęcie złej jakości, format nietypowy) | Dodaj transakcję ręcznie na podstawie obejrzanego oryginału                           |

Status jest aktualizowany **asynchronicznie** — ekran nie odświeża
się automatycznie, ale odświeżenie karty pokaże nowy stan.

## Dowody księgowe wg UoR art. 21 ust. 1 [#dowody-księgowe-wg-uor-art-21-ust-1]

Numify nie walidacje automatycznie, czy każdy wgrany dokument
spełnia kryteria dowodu księgowego z <LegalRef act="UoR" art="21" paragraph="1" /> — kryteria obejmują:

1. **Rodzaj i numer dowodu** — faktura zazwyczaj ma (Nr faktury).
2. **Strony operacji** — nazwy i adresy sprzedawcy i nabywcy.
3. **Opis i wartość** — treść operacji + kwota.
4. **Data operacji** — i (jeśli inna) data sporządzenia dowodu.
5. **Podpis wystawcy** — w praktyce zastępowany znakami elektronicznymi (<LegalRef act="UoR" art="21" paragraph="4" />) dla faktur elektronicznych.
6. **Dekretacja** — „stwierdzenie sprawdzenia i zakwalifikowania do ujęcia w księgach" — to robi się przy księgowaniu w <FeatureRef slug="journal">dzienniku</FeatureRef>, nie na samym dokumencie.

W praktyce: dokument wgrany do Numify + zaksięgowana transakcja w
dzienniku (z numerem pozycji dziennika i kontami Wn/Ma) stanowią
razem kompletny ślad audytowy.

## Archiwizacja — ile i jak długo [#archiwizacja--ile-i-jak-długo]

<LegalRef act="UoR" art="74" paragraph="2" /> pkt 8: dowody księgowe
przechowuje się przez **co najmniej 5 lat** licząc od początku roku
następującego po roku obrotowym, którego dotyczą. Dla faktury z 2026
r. oznacza to archiwizację do końca 2031 r. — przez cały ten okres
plik musi pozostać odtwarzalny.

Numify przechowuje pliki w **Cloudflare R2** z polityką niemutowalności:

* pliki nie są nadpisywane,
* usunięcie rekordu dokumentu nie usuwa natychmiast obiektu z R2 (soft delete, retencja zgodna z <LegalRef act="UoR" art="74" paragraph="2" />),
* kopie zapasowe bazy metadanych + obiektów R2 wykonywane zgodnie z polityką backupu (<ServiceRef path="src/lib/services/backup-retention.ts" />).

<LegalRef act="UoR" art="73" paragraph="2" /&#x3E; dopuszcza przeniesienie
treści dowodów na informatyczne nośniki danych — pod warunkiem, że
system pozwala na odtworzenie dokumentu w postaci wydruku. Przycisk
&#x2A;*„Open Original"** realizuje ten wymóg.

## Usuwanie dokumentu — uwaga [#usuwanie-dokumentu--uwaga]

Dokument można usunąć z UI (z poziomu listy <FeatureRef slug="dokumenty" />),
ale:

* **Transakcje powiązane** (z dziennika) **nie są usuwane** — zostają, tracąc odwołanie do dokumentu źródłowego. To naruszenie wymogu identyfikacji źródła (<LegalRef act="UoR" art="20" paragraph="5" />). Unikaj usuwania dokumentów, które zostały już zaksięgowane.
* Usunięcie wprowadza **soft delete** w bazie; plik R2 pozostaje przez okres retencji. Fizyczne usunięcie z R2 wymaga osobnego procesu administracyjnego.

Praktyczna reguła: jeśli dokument został zaksięgowany, **nie usuwaj
go** z systemu aż do upływu 5-letniego okresu archiwizacji.

## Powiązania [#powiązania]

* <FeatureRef slug="dokumenty">Dokumenty</FeatureRef> — lista wszystkich dokumentów spółki, skąd nawigujesz do tego widoku.
* <FeatureRef slug="transakcje">Transakcje</FeatureRef> — pozycje `Linked` w ekranie to rekordy transakcji z referencją do ID dokumentu.
* <FeatureRef slug="faktury">Faktury</FeatureRef> — faktury zakupu wystawione na podstawie dokumentów; numer faktury jest polem transakcji.
* <FeatureRef slug="journal">Dziennik</FeatureRef> — zaksięgowanie transakcji tworzy zapis w dzienniku; dokument pozostaje dowodem źródłowym dla tego zapisu.
* <FeatureRef slug="ksef">KSeF</FeatureRef> — faktury pobrane z KSeF trafiają automatycznie jako „dokumenty" z oryginałem XML FA(3).