jpk

Files (1)

• SKILL.md

SKILL.md (first lines)

# Generator JPK_V7M

Generuje miesięczną deklarację VAT (`JPK_V7M(3)`) na podstawie faktur zapisanych w `data/jdg_ksiegowy.db`.
Plik wynikowy: `data/jpk/JPK_V7M_YYYY_MM.xml` — gotowy do wysyłki przez bramkę MF lub e-Mikrofirma.

## Wymagane dane

- **month** — miesiąc (1-12)
- **year** — rok (np. 2026)

Jeśli user mówi "JPK za poprzedni miesiąc" — policz miesiąc/rok względem daty bieżącej (`2026-04-17`), nie wymyślaj.

## Wywołanie

```bash
python3 skills/jpk/scripts/generate_jpk.py --month 3 --year 2026
```

Zwraca JSON:
```json
{
  "period": "03/2026",
  "invoice_count": 4,
  "total_net": "42000.00",
  "total_vat": "9660.00",
  "file_path": "data/jpk/JPK_V7M_2026_03.xml"
}
```

## Korekta złożonego JPK

`--correction` (+ opcjonalnie `--reason "..."`) generuje korektę z `CelZlozenia=2` do osobnego pliku
`data/jpk/JPK_V7M_YYYY_MM_K1.xml` (oryginał zostaje jako dowód). Pełny przebieg — skill `jpk-korekta`.

## Po wygenerowaniu

Pokaż userowi: okres, liczbę faktur, sumę netto + VAT, ścieżkę pliku (jako klikalny markdown link).
Przypomnij: termin wysyłki JPK_V7M to **25-ty następnego miesiąca**.
Przed wysyłką zwaliduj XSD: `python3 skills/jpk/scripts/validate_jpk.py --xml-path <plik>`
(bramka nie waliduje lokalnie). Wysyłka — skill `jpk-submit`.

## Wymagane dane sprzedawcy (z .env)

`SELLER_NIP`, `SELLER_FIRST_NAME`, `SELLER_LAST_NAME`, `SELLER_BIRTH_DATE`, `SELLER_TAX_OFFICE_CODE`.
Jeśli skrypt rzuci błąd o braku któregoś — przerwij i powiedz userowi żeby uzupełnił `.env`.

## Import usług / odwrotne obciążenie

Koszty oznaczone `reverse_charge` (skill `expense --reverse-charge`) są rozliczane automatycznie:
samonaliczony VAT należny trafia do **K_27/K_28** (dostawca spoza UE) lub **K_29/K_30**
(dostawca z UE, art. 28b) po stronie sprzedaży, a jednocześnie do odliczenia (**K_42/K_43**) —
więc dla działalności opodatkowanej efekt na kwotę do zapłaty (P_51) jest **zerowy**. Ta sama
faktura pojawia się w ewidencji sprzedaży i zakupu.

## Uwagi

- Skrypt liczy sumy z rejestru, nie z surowych XML — upewnij się że wszystkie faktury miesiąca zostały wygenerowane przez skill `invoice` (czyli są w SQLite).
- Jeśli `invoice_count == 0` — ostrzeż usera, prawdopodobnie zapomniał wystawić faktury albo pomylił miesiąc.

From dithiothreitol/jdg-ksiegowy, MIT.

More from dithiothreitol/jdg-ksiegowy