39 lines
2.0 KiB
Markdown
39 lines
2.0 KiB
Markdown
# Paperless → Firefly: чек в расход
|
||
|
||
## Статус: подготовлено, ждёт документов
|
||
|
||
| Часть | Состояние |
|
||
|---|---|
|
||
| Токен Paperless | ✅ создан (`/root/.paperless-token`) |
|
||
| Firefly | ✅ работает (`http://192.168.1.110:8080`) |
|
||
| Пользователь Firefly | `maloyakapg@gmail.com` (id 1) |
|
||
| Документы в Paperless | **0** — обрабатывать нечего |
|
||
|
||
## Почему остановились
|
||
|
||
Paperless пуст: ни одного чека/документа. Интеграция «чек → расход» имеет
|
||
смысл только когда есть что разбирать. Создавать фиктивные документы ради
|
||
теста — шум в архиве.
|
||
|
||
## План, когда появятся чеки
|
||
|
||
1. Скрипт читает `/api/documents/?tags=чек` из Paperless.
|
||
2. Из OCR-текста извлекается итоговая сумма (regex по «ИТОГО», «К оплате»).
|
||
3. Создаётся withdrawal в Firefly:
|
||
`POST /api/v1/transactions` с типом `withdrawal`, суммой и описанием.
|
||
4. Отметка в Paperless (tag `в бюджете`), чтобы не задваивать.
|
||
|
||
## Что понадобится
|
||
|
||
- Firefly personal access token (Profile → OAuth → Create token).
|
||
- Счёт-источник и категория расходов (id из `/api/v1/accounts`).
|
||
- Правило в Paperless: тег или correspondent для чеков.
|
||
|
||
## Ловушки
|
||
|
||
1. `pg_dumpall`-дампы не годятся для черновой базы — нужен дамп одной БД
|
||
(уже знаем по учениям восстановления).
|
||
2. Firefly не имеет `artisan tinker` — пользователей смотрим в БД
|
||
(`firefly_db.users`).
|
||
3. Paperless-контейнер называется `paperless`, не `paperless-ngx`.
|