54 lines
2.4 KiB
Markdown
54 lines
2.4 KiB
Markdown
# 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` в регулярку.
|