Odczyt dokumentów: XML z KSeF, PDF i zdjęcia
Odczyt to pierwszy krok po przyjęciu dokumentu: z pliku powstają kontrahent, numer, daty, pozycje i kwoty. Faktura z KSeF jest czytana z XML bez udziału AI. Skan i PDF czyta model. Ta strona mówi, skąd biorą się dane na karcie, jak Taxso je sprawdza i co robić, gdy coś się nie odczyta.
Trzy drogi odczytu
| Skąd dokument | Jak jest czytany | Pewność odczytu |
|---|---|---|
| KSeF (XML FA(3)) | Parser struktury FA(3), bez modelu i bez AI. Dane są brane wprost z pliku, który jest oryginałem faktury. | Pełna. Zostaje tylko dekretacja. |
PDF, PNG, JPG, WEBP (Dodaj plik, folder skanów, od klienta) | Mistral AI w UE: OCR tekstu, potem model wyciąga pola do struktury faktury. Po odczycie kontrola arytmetyczna. | Najwyżej 0,95. Przy problemie z kwotami albo NIP-em spada do 0,5 i dokument zostaje u księgowej. |
Dodaj ręcznie | Brak odczytu. Dokument otwiera się od razu w Edytuj fakturę z pustymi polami. | Nie dotyczy; flaga „uzupełnij go w formularzu” do czasu wpisania danych. |
Wgrany XML jest rozpoznawany po treści, więc plik faktury z KSeF przeciągnięty do Obiegu też idzie drogą bez AI. Skan faktury, która przyszła już z KSeF, nie tworzy dubla: kopia jest pomijana, a KSeF, który dotrze później, zastępuje nietkniętą kopię. Kanały dodawania: Dokumenty spoza KSeF.
Co się dzieje w czasie `W odczycie`
Od pliku do pozycji na karcie
Krok 1
Przyjęcie
Dokument pojawia się w Obiegu ze statusem W odczycie. W kolumnie Kontrahent widzisz Czeka w kolejce, a za chwilę Przetwarzanie….
Rodzaj dokumentu po odczycie
Księgowane są Faktura, Paragon, Rachunek (bez VAT) i Raport z kasy fiskalnej. Do archiwum firmy, bez księgowania i bez wysyłki do Optimy, trafiają Umowa, Potwierdzenie przelewu, Koncesja / zezwolenie, Kosztorys i Oferta. Plik, którego nie da się zaklasyfikować, ma rodzaj Dokument nierozpoznany.
Co gdy odczyt się nie uda
- W odczycie
- Odczyt trwa albo został wstrzymany, bo silnik odczytu chwilowo nie odpowiadał. Wstrzymany odczyt wraca sam po 15 minutach, do 5 prób.
- Nie udało się odczytać
- Błąd trwały (uszkodzony plik, pusty OCR). Czerwony napis w kolumnie
Kontrahent, na karcie alert „Nie udało się odczytać dokumentu”. Najprościej wgrać czytelniejszy plik. - Do uzupełnienia
- Dokument dodany ręcznie. Dane wpisujesz w
Edytuj fakturę. - Do akceptacji
- Odczyt był, ale z brakami albo niską pewnością. Uzupełnij pola na karcie.
Dokumenty bez odczytu wracają do kolejki automatycznie co 20 minut, po co najmniej godzinie od ostatniej próby, przez 7 dni od przyjęcia; w Aktywność widać wpis o automatycznym ponowieniu. Jeśli dokument stoi dłużej, lista przyczyn jest w Komunikatach.
`Ponów odczyt` z karty
GdziePanel biuraObiegKarta dokumentuPonów odczyt
Przycisk zleca odczyt pliku od nowa. Dialog mówi wprost, co stracisz: „Odczyt zastąpi dane faktury w całości - także to, co poprawiono na karcie („Edytuj fakturę”). Tego nie da się cofnąć”. Wybierasz Zostaw poprawki albo Odczytaj ponownie.
- Dokument, który jest już w Optimie, nie jest czytany ponownie. W
Aktywnośćzostaje „Ponowny odczyt pominięty - dokument jest już w Optimie, jego odczyt i dekretacja zostają”. - Po ponownym odczycie dokument przechodzi znów dekretację i walidację, więc kategorie i flagi mogą się zmienić.
- Gdy zlecenie się nie uda: „Nie udało się zlecić ponownego odczytu. Odśwież stronę i spróbuj ponownie.”
- Ponowna dekretacja to osobna akcja: zostawia odczyt bez zmian i pyta tylko o kategorie.
Oryginał obok danych
Lewa połowa karty pokazuje plik: dla KSeF wizualizację z nagłówkiem Wizualizacja KSeF · oryginałem faktury jest plik XML, dla reszty Podgląd faktury. Porównanie odczytu z oryginałem to najszybszy sposób sprawdzenia dokumentu z plakietką Do sprawdzenia. Więcej: Wizualizacja MF, PDF i XML.
Czy faktury z KSeF też przechodzą przez AI przy odczycie?+
Nie. XML FA(3) jest czytany parserem, bez modelu. AI pojawia się dopiero przy dekretacji, czyli dobieraniu kategorii pozycjom.
Gdzie są przetwarzane skany faktur?+
Odczyt PDF i zdjęć wykonuje Mistral AI w UE. Pełna lista dostawców i miejsc przetwarzania: Gdzie są dane.
Skan jest czytelny, a odczyt ma pewność 0,5. Dlaczego?+
Najczęściej kontrola arytmetyczna: netto plus VAT nie zgadza się z brutto albo suma pozycji z netto dokumentu. Zdarza się przy rabacie w stopce i fakturach wielostronicowych. Popraw kwoty w Edytuj fakturę, zamiast ponawiać odczyt.
Klient wgrał zdjęcie faktury, która potem przyszła z KSeF. Co się stanie?+
Faktura z KSeF zastępuje nietkniętą kopię. Jeśli kopia była już poprawiana, oba dokumenty dostają flagę duplikatu i żaden nie pojedzie do Optimy, dopóki nie wybierzesz, który zostaje.