Obsługa faktur
OCR faktur PGNiG, Tauron, Veolii, Enea — czyta dostawcę, kwotę, okres, licznik. Bez ręcznego przepisywania.
Mieszkanie.app przyjmuje faktury trzema drogami — przez prywatny e-mail, ze zdjęcia z telefonu, oraz drag-and-drop z dysku — i wyciąga z nich dane, których potrzebuje rozliczenie miesięczne: dostawcę, kwotę, okres, mieszkanie, odczyty liczników. Nigdy nie wpisujesz tej samej liczby dwa razy.
W tym artykule pokazujemy ścieżkę na przykładzie faktury PGNiG za kwiecień 2026 dla mieszkania A83.
OCR faktur (PGNiG, Tauron, Veolia, Enea, PGE i ~40 innych) działa we wszystkich planach. Plan Free ma limit 50 dokumentów / miesiąc; Solo i PRO — bez limitu.
Trzy sposoby na wprowadzenie faktury
1. Prywatny adres e-mail
Każde konto Mieszkanie.app dostaje swój prywatny adres [email protected] (widoczny w Ustawienia → Inbox). Przekierowujesz tam wszystkie faktury z domu:
- Załóż regułę w Gmailu / Outlooku: faktury z
[email protected],[email protected],[email protected]itp. → forward do swojego adresu Mieszkanie.app. - Faktura wpada do systemu w ~5 sekund, OCR rusza automatycznie.
- Jeśli załącznik to PDF, czytamy bezpośrednio. Jeśli JPG/PNG — przepuszczamy przez Tesseract OCR + warstwę reasonującą.
2. Zdjęcie z telefonu
W portalu Dokumenty → Nowy → Zrób zdjęcie otwiera kamerę. Wskazówki:
- Faktura na płaskiej powierzchni, dobre światło, kadr obejmujący całą stronę.
- Jeśli faktura jest dwustronna (rzadkie dla PL mediów) — zrób dwa zdjęcia, system je połączy.
- Akceptujemy JPG, PNG, HEIC (iPhone), WebP.
3. Drag-and-drop
PDF z dysku lub e-maila przeciągasz na okno przeglądarki. Akceptujemy do 20 plików naraz (multi-upload).
Co OCR wyciąga
Każde pole ma wskaźnik pewności (confidence):
- Zielony (≥ 95%) — pole ekstrahowane z konkretnej linijki PDF, nie z nazwy pliku. Zatwierdzasz jednym kliknięciem.
- Pomarańczowy (70–94%) — model nie jest pewien, np. odczyt licznika niewyraźnie widoczny. System prosi o weryfikację.
- Czerwony (< 70%) — pole nie wystarczające do dalszej obróbki, np. brak kwoty „razem do zapłaty". Tryb manualny: wpisujesz sam.
Czytamy je z konkretnej linijki PDF — nie z nazwy pliku, nie z subject e-maila, nie z meta-danych. Jeśli faktura ma dopisek „— korekta" lub „nadpłata" zmieniający kwotę finalną, to złapiemy. PDF jest jedynym źródłem prawdy.
Krok po kroku
[email protected] na Twój prywatny adres [email protected]. System odbiera, parsuje załącznik (PDF), uruchamia OCR.A83. Bez przepisywania.Wspierane dostawcy
Z testów własnych (~12 000 faktur w 2025):
| Confidence pól krytycznych | Pokrycie taryf | |
|---|---|---|
| PGNiG (gaz) | 98% | wszystkie |
| Tauron (prąd) | 97% | G11, G12, G12w |
| Enea (prąd) | 96% | G11, G12 |
| PGE (prąd) | 97% | G11, G12 |
| Veolia (CO + woda) | 94% | Warszawa, Poznań, Łódź |
| MPWiK Warszawa | 95% | pełne |
| Aquanet Poznań | 93% | pełne |
| MZK / wywóz śmieci (samorządy) | 85–92% | TOP 40 miast |
| Wspólnoty mieszkaniowe | 72% | 60% wzorców PDF |
Dla wspólnot mieszkaniowych confidence jest niższy, bo każda wspólnota ma własny szablon PDF (czasem zeskanowany Word). Jeśli Twoja wspólnota nie jest rozpoznawana — wyślij nam próbkę PDF na [email protected], dodamy szablon w ciągu tygodnia.
Co jeśli OCR się pomyli
Każda zatwierdzona faktura ma button Zgłoś błąd OCR w dolnym pasku. Klik:
- Tworzy ticket do naszego zespołu z anonimowym snippet-em PDF (bez Twoich danych — tylko fragment z błędnie odczytanym polem).
- W ciągu 24 h dostajesz odpowiedź z poprawioną wersją.
- Reguła wchodzi do modelu — kolejne podobne faktury są już czytane lepiej.
Jeśli zmienisz wartość pola ręcznie (np. „Razem do zapłaty" z 312,84 na 312,48 PLN) — system zachowa oba zapisy: oryginał OCR + Twoja korekta, z notatką kto i kiedy. Audit log nigdy nie znika.
API: programatyczne wysyłanie faktur
curl -X POST https://api.mieszkanie.app/v1/documents \ -H "Authorization: Bearer $MIESZKANIE_TOKEN" \ -F "[email protected]" \ -F "hint_kind=utility_invoice" \ -F "hint_apartment_id=apt_a83"