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

54 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` в регулярку.