Files
buryan-infra/ops/money/PAPERLESS-FINANCE.md

2.4 KiB
Raw Permalink Blame History

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 в регулярку.