Expense

---
name: expense
description: Dodaje fakturę zakupu (koszt) do rejestru SQLite — zapisuje sprzedawcę, NIP, kwoty, kategorię, datę wpływu. Obsługuje wprowadzanie ręczne ORAZ OCR z pliku (PDF/JPG/PNG) przez lokalny Pixtral 12B z fallbackiem na Claude Haiku 4.5. Na ryczałcie koszty NIE pomniejszają podatku, ale VAT naliczony idzie do JPK_V7M jako odliczalny. Użyj gdy user mówi "dodaj fakturę zakupu", "zarejestruj koszt", "wprowadź wydatek", "kupiłem laptopa za...", "fakturę za hosting/SaaS/internet/paliwo", "dorzuć fakturę kosztową", "zeskanuj fakturę", "wczytaj PDF-a z fakturą", lub gdy user przesyła plik faktury.
---

# Dodawanie faktury zakupu (koszt)

Zapisuje koszt do tabeli `expenses` w SQLite. Używane potem przez skill `jpk` do wyliczenia VAT naliczonego do odliczenia.

## Wymagane dane od usera

- **seller-name** — nazwa sprzedawcy
- **seller-nip** — NIP sprzedawcy (10 cyfr; dla zagranicznego: też string, ustaw `--seller-country`)
- **document-number** — numer faktury (z faktury sprzedawcy)
- **issue-date** — data wystawienia (`YYYY-MM-DD`)
- **netto** — kwota netto
- **vat** — kwota VAT (jeśli sprzedawca zwolniony — wpisz `0`)

Opcjonalnie:
- `receive-date` — data wpływu (domyślnie = issue-date). To ona decyduje o miesiącu w JPK_V7M.
- `description` — co kupiłeś
- `category` — `uslugi_obce | materialy | media | paliwo | samochod | biuro | sprzet | szkolenia | inne`
- `vat-rate` — stawka (domyślnie `23`)
- `--vat-deduction-pct` — procent VAT odliczalnego (0-100, domyślnie `100`):
  - `100` — pełne odliczenie (typowe usługi/towary firmowe)
  - `50` — auto osobowe użytkowanie mieszane lub auto prywatne służbowo (paliwo, serwis)
  - `0` — brak odliczenia (reprezentacja, prywatny zakup)
- `file-path` — ścieżka do PDF/JPG zachowanego skanu

Dopytaj usera jeśli czegoś brakuje, zwłaszcza NIP i kwot. Nie wymyślaj.

## Wywołanie

```bash
python3 skills/expense/scripts/add.py \
  --seller-name "Hetzner Online GmbH" \
  --seller-nip "DE812871812" \
  --seller-country DE \
  --document-number "R0012345" \
  --issue-date "2026-04-15" \
  --description "Hosting VPS kwiecien 2026" \
  --category uslugi_obce \
  --netto 100 \
  --vat 23
```

Zwraca JSON z `id` rekordu, datami i statusem `saved`.

## OCR z pliku (PDF/JPG/PNG)

Zamiast przepisywać dane, user może podać plik faktury:

```bash
# Podglad (preview, bez zapisu):
python3 skills/expense/scripts/scan.py --file faktura.pdf

# Zapis od razu:
python3 skills/expense/scripts/scan.py --file faktura.pdf --save
```

**Flow:**
1. Bez `--save` skrypt zwraca JSON z wyciągniętymi polami + `source` (`ollama` | `claude`).
2. Pokaż userowi preview i spytaj o akceptację/poprawki.
3. Po akceptacji odpal ten sam skrypt z `--save` lub `skills/expense/scripts/add.py` z poprawionymi polami.

Backend domyślny: **Pixtral 12B** przez Ollama (`http://localhost:11434`). Przy błędzie/timeout → fallback na **Claude Haiku 4.5** (wymaga `ANTHROPIC_API_KEY`).
Konfiguracja przez `OCR_PROVIDER` (`auto` | `ollama` | `claude`) w `.env`.

## Listowanie

```bash
python3 skills/expense/scripts/list.py --month 4 --year 2026
```

## Po zapisaniu

Pokaż userowi: sprzedawca, numer dokumentu, kwoty, procent odliczenia VAT.
Jeśli `vat_deduction_pct > 0` — przypomnij że ten koszt zwiększy VAT do odliczenia w JPK_V7M za dany miesiąc o `vat × pct / 100`.

## Auto osobowe — heurystyka 50%

Jeśli kategoria to `paliwo` lub `samochod`, **zapytaj usera** czy auto jest:
- prywatne używane służbowo / firmowe „mieszane" → `--vat-deduction-pct 50` (domyślny scenariusz JDG)
- firmowe wyłącznie do działalności (VAT-26 + ewidencja przebiegu) → `--vat-deduction-pct 100`
- prywatne bez związku z firmą → wpis w ogóle nie powinien być rejestrowany

## Uwagi

- **Ryczałt**: koszty nie zmniejszają podatku dochodowego. Jedyny powód rejestracji to (a) wymóg przechowywania dowodów (art. 15 ustawy o ryczałcie), (b) odliczenie VAT.
- **Zagraniczny sprzedawca** (kraj UE): wpisz NIP z prefiksem kraju (np. `DE812871812`), ustaw `--seller-country DE`. Standardowy reverse charge — VAT nadal idzie do K_42/K_43, ale skomplikuje się sprawozdawczo (poza zakresem tego skilla).
- **Rabat / korekta**: dodaj jako osobny wpis z ujemnymi kwotami i tym samym `document_number` z prefiksem `KOR-`.