2.4 KiB
2.4 KiB
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:
- берёт документы из Paperless API (
/api/documents/); - вытаскивает сумму:
ИТОГО,к оплате,всего,сумма,TOTAL,amount due,grand total,sum; - пишет CSV в формате импорта Firefly III:
date,description,amount,currency_code; - помнит обработанные (
/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) — автоматически не создать,
нужен вход.
Ловушки
- PDF должен быть валидным. Мой самодельный PDF с cp1251 ломал OCR
и давал
unsupported Unicode escape sequenceпри сохранении. - Paperless отвечает 200 на загрузку, но документ появляется позже —
нужна пауза и проверка
count. - Английские чеки не распознавались, пока не добавил
TOTALв регулярку.