Claude Skill

vat-jpk

Deklaracja VAT JPK_V7M (miesiecznie) i ewidencja JPK_EWP (rocznie) — budowa z rejestru, walidacja XSD, wysylka do bramki MF z UPO, status, korekty. Uzyj gdy user mowi "wygeneruj JPK", "JPK za pazdziernik", "deklaracja VAT", "wyslij JPK do MF", "zloz deklaracje", "korekta JPK", "b

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Download dithiothreitol-jdg-ksiegowy-plugins_jdg-ksiegowy_skills_vat-jpk-b2e95ea.zip · 2 KB

Install

skills CLI npx skills add https://github.com/dithiothreitol/jdg-ksiegowy/tree/main/plugins/jdg-ksiegowy/skills/vat-jpk
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install dithiothreitol-jdg-ksiegowy@llmmart
Git git clone https://github.com/dithiothreitol/jdg-ksiegowy.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole dithiothreitol/jdg-ksiegowy collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

JPK_V7M i JPK_EWP

Narzedzia: serwer MCP jdg, gdy jest dostepny — kazda komenda z tego opisu to narzedzie o nazwie z podkreslnikami (jdg invoice issue → invoice_issue, --buyer-nip → buyer_nip). Bez MCP: CLI jdg (gdy nie ma go w PATH: uv run jdg w katalogu repozytorium). Kontrakt wyniku i kody bledow: jdg schema.

Budowa

jdg jpk build                                # poprzedni miesiac (domyslnie)
jdg jpk build --year 2026 --month 10
jdg jpk build-ewp --year 2026                # ewidencja ryczaltu, sklada sie do 30.04
jdg jpk validate data/jpk/JPK_V7M_2026_10.xml

Wynik zawiera P_38 (vat_due), P_39 (vat_carry_forward — nadwyzka z poprzedniej deklaracji, pobierana automatycznie z P_62 poprzedniego okresu), P_48 (vat_deductible), P_51 (vat_to_pay), P_62 (vat_surplus — przechodzi na nastepny miesiac) i xsd_valid. invoice_count == 0 → ostrzez usera (brak faktur albo zly miesiac). Faktury z numerem KSeF dostaja w JPK NrKSeF, pozostale BFK — przed budowa sprawdz, czy faktury z okresu zostaly wyslane do KSeF. Sprzedaz z kodami np, zw, 0_wdt, 0_exp trafia do wlasciwych pol (K_11/K_12, K_10, K_21, K_22); GTU z pozycji faktury.

Wysylka — nieodwracalna

jdg jpk submit data/jpk/JPK_V7M_2026_10.xml            # kod 4: summary + token
jdg jpk submit data/jpk/JPK_V7M_2026_10.xml --confirm <token>
  1. Pierwsze wywolanie (bez --confirm / confirm) waliduje XSD i zwraca podsumowanie (formularz, okres, cel, P_38/P_48/P_51/P_62, srodowisko) oraz token. Nic nie wysyla. W podsumowaniu sa tez:
    • poprzednio — obowiazujaca deklaracja do porownania (przy zlozeniu: za poprzedni okres, przy korekcie: korygowana) z wartoscia i zmiana kazdego pola, albo informacja, ze jej brak;
    • uwaga (tylko przy rozbieznosci) — kwoty pliku roznia sie od rejestru, np. deklaracja zerowa mimo faktur za okres albo plik zbudowany przed dopisaniem faktury.
  2. Pokaz podsumowanie razem ze zmianami wzgledem poprzednio i zapytaj usera o zgode. env: prod = realna deklaracja w urzedzie. Pole uwaga pokaz na poczatku i zapytaj wprost, czy wysylac mimo niego; zwykle wlasciwe jest przebudowanie pliku (jdg jpk build).
  3. Dopiero po wyraznym "tak" na to podsumowanie — --confirm <token>. Nigdy bez zgody; zgoda "z gory", zanim user zobaczyl podsumowanie, nie wystarcza.

Odpowiedz z wysylki zapisuje sie w rejestrze deklaracji. Status submitted (MF jeszcze przetwarza) → pozniej jdg jpk status --reference <numer> albo jdg jpk status --year 2026 --month 10 (bez ponownej wysylki). accepted = UPO w data/upo/ — dowod zlozenia.

Korekta

Gdy za okres jest juz przyjety plik (twoj lub pelnomocnika) — korekta, nie ponowne zlozenie (jdg jpk submit odmowi zlozenia pierwotnego, jesli zna przyjeta deklaracje):

jdg jpk build --year 2026 --month 3 --correction \
  --reason "Pelnomocnik omylkowo zlozyl deklaracje zerowa; korekta przywraca rozliczenie."

Powstaje JPK_V7M_2026_03_K1.xml (kolejne: _K2...), oryginal zostaje. W urzedzie obowiazuje ostatni przyjety plik. Przed wysylka pokaz P_38/P_48/P_51 korekty obok oryginalu. Nie wiesz, co jest w urzedzie → user sprawdza w e-Urzedzie Skarbowym; brak UPO lokalnie nie znaczy, ze nic nie zlozono. Pelnomocnik skladal za usera → przypomnij o OPL-1.

Terminy i dane

JPK_V7M do 25. dnia nastepnego miesiaca; JPK_EWP do 30.04 za rok poprzedni (terminy w weekend lub swieto przesuwaja sie na najblizszy dzien roboczy). VAT placi sie na mikrorachunek (tax_microaccount w jdg status); po zaplacie jdg tax pay vat --amount ... --year R --month M. Wymagane w .env: SELLER_NIP/FIRST_NAME/LAST_NAME/BIRTH_DATE/TAX_OFFICE_CODE, MF_PESEL, MF_PRIOR_INCOME (przychod z PIT za rok N-2; brak zeznania = 0), MF_ENV (test|prod). Klucz publiczny MF jest wbudowany; po rotacji przez MF — MF_CERT_PATH/MF_CERT_URL.

Files (jdg-ksiegowy)
  • SKILL.md 4.2 KB
    ---
    name: vat-jpk
    description: Deklaracja VAT JPK_V7M (miesiecznie) i ewidencja JPK_EWP (rocznie) — budowa z rejestru, walidacja XSD, wysylka do bramki MF z UPO, status, korekty. Uzyj gdy user mowi "wygeneruj JPK", "JPK za pazdziernik", "deklaracja VAT", "wyslij JPK do MF", "zloz deklaracje", "korekta JPK", "biuro wyslalo zerowa deklaracje", "ewidencja przychodow / JPK_EWP", "czy MF przyjelo".
    ---
    
    # JPK_V7M i JPK_EWP
    
    Narzedzia: serwer MCP `jdg`, gdy jest dostepny — kazda komenda z tego opisu to narzedzie
    o nazwie z podkreslnikami (`jdg invoice issue` → `invoice_issue`, `--buyer-nip` → `buyer_nip`).
    Bez MCP: CLI `jdg` (gdy nie ma go w PATH: `uv run jdg` w katalogu repozytorium).
    Kontrakt wyniku i kody bledow: `jdg schema`.
    
    ## Budowa
    
    ```bash
    jdg jpk build                                # poprzedni miesiac (domyslnie)
    jdg jpk build --year 2026 --month 10
    jdg jpk build-ewp --year 2026                # ewidencja ryczaltu, sklada sie do 30.04
    jdg jpk validate data/jpk/JPK_V7M_2026_10.xml
    ```
    
    Wynik zawiera P_38 (`vat_due`), P_39 (`vat_carry_forward` — nadwyzka z poprzedniej deklaracji,
    pobierana automatycznie z P_62 poprzedniego okresu), P_48 (`vat_deductible`), P_51 (`vat_to_pay`),
    P_62 (`vat_surplus` — przechodzi na nastepny miesiac) i `xsd_valid`.
    `invoice_count == 0` → ostrzez usera (brak faktur albo zly miesiac).
    Faktury z numerem KSeF dostaja w JPK `NrKSeF`, pozostale `BFK` — przed budowa sprawdz, czy
    faktury z okresu zostaly wyslane do KSeF. Sprzedaz z kodami `np`, `zw`, `0_wdt`, `0_exp`
    trafia do wlasciwych pol (K_11/K_12, K_10, K_21, K_22); GTU z pozycji faktury.
    
    ## Wysylka — nieodwracalna
    
    ```bash
    jdg jpk submit data/jpk/JPK_V7M_2026_10.xml            # kod 4: summary + token
    jdg jpk submit data/jpk/JPK_V7M_2026_10.xml --confirm <token>
    ```
    
    1. Pierwsze wywolanie (bez `--confirm` / `confirm`) waliduje XSD i zwraca podsumowanie (formularz, okres, cel, P_38/P_48/P_51/P_62,
       srodowisko) oraz token. Nic nie wysyla. W podsumowaniu sa tez:
       - `poprzednio` — obowiazujaca deklaracja do porownania (przy zlozeniu: za poprzedni okres,
         przy korekcie: korygowana) z wartoscia i zmiana kazdego pola, albo informacja, ze jej brak;
       - `uwaga` (tylko przy rozbieznosci) — kwoty pliku roznia sie od rejestru, np. deklaracja
         zerowa mimo faktur za okres albo plik zbudowany przed dopisaniem faktury.
    2. **Pokaz podsumowanie razem ze zmianami wzgledem `poprzednio` i zapytaj usera o zgode.**
       `env: prod` = realna deklaracja w urzedzie. Pole `uwaga` pokaz na poczatku i zapytaj wprost,
       czy wysylac mimo niego; zwykle wlasciwe jest przebudowanie pliku (`jdg jpk build`).
    3. Dopiero po wyraznym "tak" na to podsumowanie — `--confirm <token>`. Nigdy bez zgody; zgoda
       "z gory", zanim user zobaczyl podsumowanie, nie wystarcza.
    
    Odpowiedz z wysylki zapisuje sie w rejestrze deklaracji. Status `submitted` (MF jeszcze przetwarza)
    → pozniej `jdg jpk status --reference <numer>` albo `jdg jpk status --year 2026 --month 10`
    (bez ponownej wysylki). `accepted` = UPO w `data/upo/` — dowod zlozenia.
    
    ## Korekta
    
    Gdy za okres jest juz przyjety plik (twoj lub pelnomocnika) — korekta, nie ponowne zlozenie
    (`jdg jpk submit` odmowi zlozenia pierwotnego, jesli zna przyjeta deklaracje):
    
    ```bash
    jdg jpk build --year 2026 --month 3 --correction \
      --reason "Pelnomocnik omylkowo zlozyl deklaracje zerowa; korekta przywraca rozliczenie."
    ```
    
    Powstaje `JPK_V7M_2026_03_K1.xml` (kolejne: `_K2`...), oryginal zostaje. W urzedzie obowiazuje
    ostatni przyjety plik. Przed wysylka pokaz P_38/P_48/P_51 korekty obok oryginalu.
    Nie wiesz, co jest w urzedzie → user sprawdza w e-Urzedzie Skarbowym; brak UPO lokalnie nie
    znaczy, ze nic nie zlozono. Pelnomocnik skladal za usera → przypomnij o OPL-1.
    
    ## Terminy i dane
    
    JPK_V7M do 25. dnia nastepnego miesiaca; JPK_EWP do 30.04 za rok poprzedni (terminy
    w weekend lub swieto przesuwaja sie na najblizszy dzien roboczy). VAT placi sie na mikrorachunek
    (`tax_microaccount` w `jdg status`); po zaplacie `jdg tax pay vat --amount ... --year R --month M`.
    Wymagane w `.env`: `SELLER_NIP/FIRST_NAME/LAST_NAME/BIRTH_DATE/TAX_OFFICE_CODE`, `MF_PESEL`,
    `MF_PRIOR_INCOME` (przychod z PIT za rok N-2; brak zeznania = 0), `MF_ENV` (test|prod).
    Klucz publiczny MF jest wbudowany; po rotacji przez MF — `MF_CERT_PATH`/`MF_CERT_URL`.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.