# Paperless → Firefly: чеки в расходы ## Поправка к прошлому выводу Раньше я записал, что «Paperless не хранит документы из-за NUL в OCR». **Это было неверно.** Ошибка была в моём тестовом PDF: я собрал его с кодировкой cp1251 при заявленном WinAnsi — OCR получил мусор. Проверка с корректным PDF: ``` upload → id 3 документов: 1 текст: "TEST STORE Receipt N 0042 ... TOTAL 455.40 Payment: card" ``` Paperless **работает** и хранит документы. Причина прошлых 0 документов — не баг сервиса, а отсутствие нормальных загрузок плюс мой кривой тест. ## Пайплайн `/opt/hub-core/finance_receipts.py`: 1. берёт документы из Paperless API (`/api/documents/`); 2. вытаскивает сумму: `ИТОГО`, `к оплате`, `всего`, `сумма`, `TOTAL`, `amount due`, `grand total`, `sum`; 3. пишет CSV в формате импорта Firefly III: `date,description,amount,currency_code`; 4. помнит обработанные (`/var/lib/hub-finance/processed.json`), не дублирует. ## Проверено ``` добавлено чеков: 1 → /mnt/media/finance/receipts-202610.csv ['2026-10-21', 'Receipt test correct PDF', 455.4] ``` ## Как попадает в Firefly Вариант 1 (сейчас): Firefly → Импорт → CSV → файл `/mnt/media/finance/*.csv`. Вариант 2 (когда будет токен): Firefly API `POST /api/v1/transactions` с типом `withdrawal`. Токен создаётся только через веб-интерфейс (Профиль → OAuth → Personal Access Token) — автоматически не создать, нужен вход. ## Ловушки 1. **PDF должен быть валидным.** Мой самодельный PDF с cp1251 ломал OCR и давал `unsupported Unicode escape sequence` при сохранении. 2. **Paperless отвечает 200 на загрузку**, но документ появляется позже — нужна пауза и проверка `count`. 3. Английские чеки не распознавались, пока не добавил `TOTAL` в регулярку.